Upgrading vFabric Web Server

The instructions for upgrading vFabric Web Server differ slightly depending on your operating system and how you installed the original version. See:

RHEL: Upgrade Using the VMware RPM Repository

You use yum upgrade to upgrade an existing RHEL installation of vFabric Web Server to the latest version. It is assumed that you used yum install to originally install the older version.

The yum upgrade process:

  • Installs the latest version of the Apache HTTPD Web Server binaries in a new directory (such as httpd-2.2.22.1) and removes the older versions.

  • Adjusts the httpd-2.2 symbolic link to point to the new binaries.

  • Automatically updates all existing Web Server instances to start using the new binaries.

Prerequisites

Procedure

  1. From the RHEL VM on which you will upgrade vFabric Web Server, log in as the root user.

  2. Execute the following yum command:

    prompt# yum upgrade vfabric-web-server

    The yum command begins the upgrade process, resolves dependencies, and displays the packages it plans to upgrade.

    Depending on the versions of vFabric components you have previously installed on this computer, the yum command might also install a newer version of the vfabric-eula RPM and prompt you to accept the VMware license agreement.

  3. Enter y at the prompt to begin the actual upgrade.

    When the upgrade process finishes, you will see a Complete! message at the end. Check the output of the command to ensure that the upgrade was successful.

Unix: Upgrade Using a Self-Extracting ZIP

Upgrading vFabric Web Server on Unix is very similar to installing, except you unzip the self-extracting ZIP file into the existing vFabric Web Server installation directory.

Prerequisites

Procedure

  1. Download the appropriate vFabric Web Server self-extracting ZIP from the VMware Download Web site and place it in the parent directory of the main Web Server installation directory (vfabric-web-server.)

    For example, if you originally installed Web Server in /opt/vmware/vfabric-web-server, which in turn means that the HTTPD binaries are located in /opt/vmware/vfabric-web-server/httpd-2.2.version, then place the downloaded ZIP file in /opt/vmware.

    Be sure to choose the correct Unix operating system and chip architecture. For example, the file to install vFabric Web Server on a 64-bit Linux platform is vfabric-web-server-version-x86_64-linux-glibc2.zip.sfx.

  2. Log in as the root user on to the Unix computer on which you want to upgrade vFabric Web Server and start a terminal.

  3. Change to the parent directory of the main Web Server installation directory, which is also the directory in which you downloaded the ZIP file of the new Web Server version. For example:

    prompt# cd /opt/vmware
  4. If necessary, change the permissions of the downloaded ZIP file to make it executable:

    prompt# chmod 755 vfabric-web-server-version-x86_64-linux-glibc2.zip.sfx
  5. Self-extract the files from the downloaded ZIP by using the file name as a command. For example:

    prompt# ./vfabric-web-server-version-x86_64-linux-glibc2.zip.sfx

    At the prompt to replace vfabric-web-server/fixrootpath.pl, answer All.

    When it completes, the new vFabric Web Server files are located in the vfabric-web-server subdirectory. If the new version of Web Server includes a more recent version of the Apache HTTPD binaries, you will see a new corresponding directory, such as vfabric-web-server/httpd-2.2.22.1-64.

  6. Change to the vfabric-web-server directory and run the fixrootpath.pl Perl script to correct the root paths and adjust the httpd-2.2 symbolic link:

    prompt# cd vfabric-web-server
    prompt# perl fixrootpath.pl

When you next start your existing Web Server instances, they will automatically use the new Apache HTTPD binaries you just installed.

Windows: Upgrade Using a Self-Extracting ZIP

Upgrading vFabric Web Server on Windows is very similar to installing, except you unzip the self-extracting ZIP file into the existing vFabric Web Server installation directory.

Prerequisites

Procedure

  1. Log in as the Administrator user on the Windows computer on which you want to upgrade vFabric Web Server and start a command window.

  2. Download the appropriate vFabric Web Server self-extracting ZIP from the VMware Download Web site and place it in the parent directory of the main Web Server installation directory (vfabric-web-server.)

    For example, if you originally installed Web Server in c:\opt\vmware\vfabric-web-server, which in turn means that the HTTPD binaries are located in c:\opt\vmware\vfabric-web-server\httpd-2.2.version, then place the downloaded ZIP file in c:\opt\vmware.

    Be sure to choose the correct architecture (32- or 64-bit). For example, the file to install vFabric Web Server on a 64-bit Windows platform is vfabric-web-server-version-x64-windows.zip.exe.

  3. Execute the downloaded *.zip.exe file to self-extract the files into the installation directory. You can do this, for example, by opening Window Explorer, navigating to the directory, and double-clicking on the *.zip.exe file.

    At the prompt to replace vfabric-web-server/fixrootpath.pl, answer All.

    When the extraction completes, the new vFabric Web Server files are located in the vfabric-web-server subdirectory. If the new version of Web Server includes a more recent version of the Apache HTTPD binaries, you will see a new corresponding directory, such as vfabric-web-server\httpd-2.2.22.1-64.

  4. From your command window, change to the main Web Server installation directory. Following our example:

    prompt> cd c:\opt\vmware\vfabric-web-server
  5. Run the fixrootpath.vbs VBScript to correct the root paths using the cscript command:

    prompt> cscript fixrootpath.vbs
  6. Remove the existing httpd-2.2 symbolic link and recreate it so that it points to the new Apache HTTP binary directory.

    For example:

    prompt> rmdir httpd-2.2
    prompt> mklink /d httpd-2.2 httpd-2.2.22.1-64

When you next start your existing Web Server instances, they will automatically use the new Apache HTTPD binaries you just installed.

What to do next