Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Installing VMware vFabric Enterprise Ready Server on Windows (2001977)

Purpose

This article walks you through creating an installation of VMware vFabric Enterprise Ready Server (ERS) on Windows. 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 Linux, see Installing VMware vFabric Enterprise Ready Server on Linux (2001867).

Resolution


Installing and running ERS includes these steps:

Note: For instructions on uninstalling ERS, see the Additional Information section of this article.

Obtaining ERS

  • If you have an ERS contract, you can download the binary for Windows 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. Choose Apache HTTP 2.2.17 - Windows . In this example, the binary is downloaded to C:.

Note: There is no need to download a license file or use a license code to activate ERS.

Installing ERS

  1. Open a command prompt. Interaction with ERS requires only the command line.
  2. Run this command to create an ERS install root directory:

    C:\> mkdir ERS

  3. Run this command to change to the newly created directory:

    C:\> cd ERS

  4. Invoke the file to self-extract the contents:

    C:\ERS> ..\ers-4.0.3-apache-2.2.17-x86-winnt.zip.exe

    The archive unpacks all files into the current directory.

  5. Invoke the fixrootpath.pl Perl script to set the current directory as the installation root:

    C:\ERS> perl5.8\bin\perl.exe fixrootpath.pl

    The script may take a few minutes as it checks all files in the installation.

Verifying the installation

  1. Verify the installation with the provided test-apache2.2 instance.

    To install and start the test-apache2.2 instance, run these commands:

    C:\ERS> cd servers\test-apache2.2

    C:\ERS\servers\test-apache2.2> bin\apache_startup.bat install
    C:\ERS\servers\test-apache2.2> bin\apache_startup.bat start

    You should see these messages:

    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. Using a browser, navigate to http://localhost:8080/.
  3. Enter spring for both the username and password..
  4. Test the examples by clicking the links.
  5. After testing, run this command to stop the instance:

    C:\ERS\servers\test-apache2.2> bin\apache_startup.bat stop

    You should see these mesages:

    Stopping Apache

    Server stopped OK

  6. Run this command to uninstall the service:

    C:\ERS\servers\test-apache2.2> bin\apache_startup.bat uninstall

Creating an instance

The instance that comes with the installation is intended for testing purposes only.
 
To create your own instance:
  1. Return to the root ERS directory:

    C:\ERS\servers\test-apache2.2> 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.exe ers-server.pl --server=example --apachever=2.2


    You are prompted to answer a few questions to configure the new instance.

    Note: In this example, you can answer most questions with the default answers, or use the answers supplied.:

    ers-server.pl - install an ERS 4.0 server instance
    from the default (_instance/ trees) template

    Creating new server instance C:/ERS/servers/example
    Apache httpd version 2.2

    Configuring for Apache 2.2

    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 [80]? 8080
    Port for https:// SSL traffic [443]? 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]?

    Loading 'screen' into random state - done
    Generating RSA private key, 2048 bit long modulus
    ........+++
    ........................+++
    e is 65537 (0x10001)

    Created C:/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!):

    Loading 'screen' into random state - done
    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 []:
    Loading 'screen' into random state - done
    Signature ok
    subject=/C=XX/ST=XX/O=Internet Widgits Pty Ltd /CN=www.example.com
    Getting Private key

    SSL files generated as C:/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
    C:/ERS/servers/example

    Thank you for choosing SpringSource Enterprise Ready Server.

    A secure server with a self-signed SSL certificate is created.

  3. Run this command to change to the instance directory:

    C:\ERS> cd servers\example

  4. Run these commands to start the instance:

    C:\ERS\servers\example> bin\apache_startup.bat install
    C:\ERS\servers\example> bin\apache_startup.bat startssl

  5. Using a browser, navigate to https://localhost:8443/.

    Note: You receive a certificate error from the browser because the certificate name does not match the URL and is self-signed. VMware recommends using a proper certificate for a production system. For this example, you can accept the certificate in order to view the default home page.

Additional Information

Uninstalling

To remove a server instance from ERS:

  1. Run these commands to shut down the instance, if it is running, and uninstall the service:

    C:\ERS\servers\example> bin\apache_startup.bat stop
    C:\ERS\servers\example> bin\apache_startup.bat uninstall

  2. Run these commands to remove the directory containing the instance from the servers directory:

    C:\ERS\servers\example> cd ..
    C:\ERS\servers> rmdir /s example

To uninstall ERS, ensure that all instances are stopped and uninstalled and then remove the ERS root directory that you created.

Tags

how-to  install-ers  install-application

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 0 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 0 Ratings
Actions
KB: