This article walks you through creating an installation of VMware vFabric Enterprise Ready Server (ERS) on Linux. This article provides only the basic process of obtaining, installing, and running ERS. It is not a complete installation reference.
Note: For a walkthrough of this process on Windows, see Installing VMware vFabric Enterprise Ready Server on Windows (2001977).
Installing and running ERS includes these steps:
- If you have a current ERS contract, you can download the binary from the VMware Download Center.
- If you do not have a current ERS contract, you can perform a 60-day evaluation.
Download VMware vFabric Enterprise Ready Server 4.0.3. Select the offering specific to your OS.
The download type is an
.sfx - a self-extracting executable. In this example, the file is downloaded to the home directory.
Note: There is no need to download a license file or use a license code to activate ERS.
- Open a terminal window. Interaction with ERS requires only the command line. For more information, see Opening a command or shell prompt (1003892).
- Create an ERS install root directory and change to it, by running these commands:
- Mark the downloaded
.sfxfile as executable, by running this command:
chmod u+x ~/ers-4.0.3-apache-2.2.17-x86-linux-glibc2.zip.sfx
- Invoke the file to self-extract the contents, by running this command:
The archive unpacks all files into the current directory.
- Invoke a Perl script to set the current directory as the installation root, by running this command:
Note: If your system does not have Perl installed, you can use the version which comes with ERS. Run this command to do so:
./perl5.8/bin/perl5.8.8 -I./perl5.8/bin fixrootpath.pl
The script may take a few minutes as it checks all the files in the installation.
- Verify the installation with the provided test-apache2.2 instance. Start the test-apache2.2 instance by running these commands:
You should see this mesage:
Server started OK
Note: If there is a failure at this point, it is likely that another service is occupying port 8080, where the instance is trying to listen. Stop the other service and attempt to start the instance again.
- Go to http://localhost:8080/.
- To authenticate to the home page, use:
- Username: spring
- Password: spring
- Test the examples by clicking the links.
- When you have completed testing, stop the instance by running this command:
You should see the following mesage:
Server stopped OK
The instances that come with the installation are intended for testing purposes only.
To create your own instance:
- Return to the root ERS directory by running this command:
- Use the
ers-server.plscript to create a new instance, by running this command:
Note: In this example, the instance is named
perl5.8/bin/perl ers-server.pl --server=example --apachever=2.2
This process asks you some questions interactively in order to configure the new instance.
Note: In this example, you can answer most prompts with the default answers, or use the answers supplied. This creates a secure server with a self-signed SSL certificate.
ers-server.pl - install an ERS 4.0 server instance
from the default (_instance/ trees) template
Creating new server instance /opt/ers/servers/example
Apache httpd version 2.2
Configuring for Apache 2.2
Use threaded 'worker' MPM [y/n]? y
Enable mod_php5 [y/n]? n
Enable mod_perl [y/n]? n
Enable mod_snmp [y/n]? n
Modify the httpsd.conf to make additional adjustments.
Server hostname (e.g. www.example.com) [example]? www.example.com
Administrator email [email@example.com]?
Port for http:// traffic ?
Port for https:// SSL traffic ?
Port for ajp13, jk->tomcat ?
Tomcat ajp13 servername [localhost]?
Modify workers.properties to make additional adjustments.
Creating a sample conf/userfile, add initial users
New username (or <Enter> if done):
Enable SSL and create a default key [y/n]? y
Size of SSL RSA key, in bits ?
Generating RSA private key, 2048 bit long modulus
e is 65537 (0x10001)
Choose a passphrase to encrypt the .pem backup copy of this key
writing RSA key
Enter PEM pass phrase:
Verifying - Enter PEM pass phrase:
Fill in information for this certificate.
(The Common Name (CN) below MUST match ServerName!):
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
Country Name (2 letter code) [AU]:XX
State or Province Name (full name) [Some-State]:XX
Locality Name (eg, city) :
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) :
Common (Server) Name (eg, www.example.com) :www.example.com
Email Address :
Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password :
An optional company name :
subject=/C=XX/ST=XX/O=Internet Widgits Pty Ltd/CN=www.example.com
Getting Private key
SSL files generated as /opt/ers/servers/example/ssl/example.*
.key - unencryped private key (perm 0600 for security).
.pem - des3 encrypted private key - back up this file!
.csr - certificate signing request - submit this to the CA.
.crt - self-signed certificate, replace with cert signed by the CA.
Be certain to record the passphrase to decrypt the .pem file.
Never transmit the .key file or cause it to be readable by others!
New server instance created in
Thank you for choosing SpringSource Enterprise Ready Server.
- Change to the instance directory, by running this command:
- Start the instance, by running this command:
- Go to https://localhost:8443/.
Note: You receive a certificate error from the browser, both because the certificate name does not match the URL and because it is self-signed. VMware recommends using a proper certificate for a production system. For this example, accept the certificate in order to continue and view the default home page.
UninstallingTo remove a server instance from ERS:
- Shut down the instance, if it is running, by running this command:
- Remove the directory containing the instance from the
serversdirectory, by running these commands:
rm -rf example
To remove ERS entirely, make sure that all instances have been stopped, then remove the ERS root directory that you created when installing.