Pivotal Knowledge Base

Follow

Installing VMware vFabric Enterprise Ready Server on Linux (2001867)

Installing VMware vFabric Enterprise Ready Server on Linux (2001867)

Purpose

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).

Resolution




Installing and running ERS includes these steps:
  1. Obtaining ERS
  2. Installing ERS
  3. Verifying the installation
  4. Creating an instance
Note: For instructions on uninstalling ERS, see the Additional Information section of this article.

Obtaining ERS

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.

Installing ERS

  1. Open a terminal window. Interaction with ERS requires only the command line. For more information, see Opening a command or shell prompt (1003892).
  2. Create an ERS install root directory and change to it, by running these commands:

    mkdir ~/ers
    cd ~/ers

  3. Mark the downloaded .sfx file as executable, by running this command:

    chmod u+x ~/ers-4.0.3-apache-2.2.17-x86-linux-glibc2.zip.sfx

  4. Invoke the file to self-extract the contents, by running this command:

    ~/ers-4.0.3-apache-2.2.17-x86-linux-glibc2.zip.sfx


    The archive unpacks all files into the current directory.
  5. Invoke a Perl script to set the current directory as the installation root, by running this command:

    perl fixrootpath.pl


    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.

Verifying the installation

  1. Verify the installation with the provided test-apache2.2 instance. Start the test-apache2.2 instance by running these commands:

    cd servers/test-apache2.2

    bin/apache_startup.sh start

    You should see this mesage:

    Starting Apache

    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.

  2. Go to http://localhost:8080/.
  3. To authenticate to the home page, use:
    • Username: spring
    • Password: spring

  4. Test the examples by clicking the links.
  5. When you have completed testing, stop the instance by running this command:

    bin/apache_startup.sh stop


    You should see the following mesage:

    Stopping Apache

    Server stopped OK

Creating an instance

The instances that come with the installation are intended for testing purposes only.

To create your own instance:

  1. Return to the root ERS directory by running this command:

    cd ../..

  2. Use the ers-server.pl script to create a new instance, by running this command:

    Note: In this example, the instance is named example.

    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 [webmaster@www.example.com]?
    Port for http:// traffic [8080]?
    Port for https:// SSL traffic [8443]?
    Port for ajp13, jk->tomcat [8009]?
    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 [2048]?

    Generating RSA private key, 2048 bit long modulus
    ...........+++
    .....+++
    e is 65537 (0x10001)

    Created /opt/ers/servers/example/ssl/example.key

    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 []:
    Signature ok
    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
    /opt/ers/servers/example

    Thank you for choosing SpringSource Enterprise Ready Server.

  3. Change to the instance directory, by running this command:

    cd servers/example

  4. Start the instance, by running this command:

    bin/apache_startup.sh startssl

  5. 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.

Additional Information

Uninstalling

To remove a server instance from ERS:
  1. Shut down the instance, if it is running, by running this command:

    bin/apache_startup.sh stop


  2. Remove the directory containing the instance from the servers directory, by running these commands:

    cd ..
    rm -rf example
The instance is now gone.

To remove ERS entirely, make sure that all instances have been stopped, then remove the ERS root directory that you created when installing.

Tags

how-to  install-ers  install-application

See Also

©VMware 2013

Comments

Powered by Zendesk