Migrating from VMware vFabric Web Server 5.x

Note: This product has been discontinued. Technical Guidance ends July 15th 2018.

Important: If you are upgrading from Pivotal Web Server 5.4.0 or later, complete the instructions in Upgrading Pivotal Web Server instead.

If you are migrating from VMware vFabric Web Server 5.3.x or earlier to Pivotal Web Server 5.5 , you will notice that the default installation path has changed. The path, formerly /opt/vmware/vfabric-web-server/, now defaults to /opt/pivotal/webserver/. The structure of the application and instance directories is unchanged.

There are three basic options available for migrating from VMware vFabric Web Server depending on your preferred application installation path and the the preferred location of your previous user-created server instances.

Retain the Current Installation Path and Instance Directories

This option is available if you download the .zip.sfx/exe self-extracting distribution files. The process is complicated by the fact that the Pivotal Web Server distributions unpack into a webserver/ directory, and is recommended as a short-term solution only.

  1. Log in to the computer as the root user.
  2. Change to the vfabric_web_server_dir. For example, /opt/vmware.
  3. Unpack the pivotal-web-server-*.zip.sfx/exe distribution file. Unpack the pivotal-web-server-devel-*.zip.sfx/exe distribution file at the same time, if desired.
  4. Copy the files and symlinks links from the webserver folder into the vfabric-web-server directory.

    For example:

    cp -r /opt/vmware/webserver/* /opt/vmware/vfabric-web-server

  5. Change to the vfabric-web-server/ directory.

  6. Verify that the httpd- and newserver symlinks refers to the correct directory and file, where httpd-version is the directory name moved in step 4:

    httpd- 2.2 -> httpd-version

    newserver -> httpd- 2.2 /bin/newserver.pl

Update Deployed Instances Using the httpdctl Script

When you upgrade Pivotal Web Server, the individual instances are not updated automatically. The instance/bin/httpdctl script is the most frequently refreshed component. The defacto service name changes from vfabric-web-server to pivotal-web-server with the migration.

Note: - The instructions in this sections are required only when you upgrade your instances using the httpdctl script. - If httpdctl is not installed as a service, then complete Step 2 only.

Complete the following steps for each instance to refresh the instance control scripts and service names:

  1. Uninstall the service.

    instance/bin/httpdctl stop

    instance/bin/httpdctl uninstall

  2. Update the service with new features plus the revised pivotal httpd instance service names.The following command refreshes the httpdctl script for the instance. The command cannot be automated, because it is impossible to determine your instance locations.

    ./newserver –update –server=instance

  3. Reinstall the service.

    instance/bin/httpdctl install

    instance/bin/httpdctl start

Update the Installation Path, but Retain the Current Instance Directories

This option is available for all distributions, and is viable as a longer term solution.

  1. Complete the installation instructions to deploy Pivotal Web Server to your preferred location (typically /opt/pivotal/webserver). See Installing Pivotal Web Server.
  2. Log in to the computer as the root user.
  3. Change to the vfabric_web_server_dir. For example, /opt/vmware.
  4. Symlink the /opt/pivotal/webserver/httpd-version (-64, for example) directory as vfabric-web-server/httpd-, replacing any previous symlink. These httpd revisioned directory names are unique to each specific release of either vFabric or Pivotal Web Server. Note: You must refresh this link manually on each subsequent Pivotal Web Server update.

  5. Verify that the httpd- and newserver symlinks refers to the correct directory and file, where httpd-version is the directory name symlinked in step 4:

    httpd- 2.2 -> httpd-version

    newserver -> httpd- 2.2 /bin/newserver.pl

Update Deployed Instances Using the httpdctl Script

When you upgrade Pivotal Web Server, the individual instances are not updated automatically. The instance/bin/httpdctl script is the most frequently refreshed component. The defacto service name changes from vfabric-web-server to pivotal-web-server with the migration.

Note: - The instructions in this sections are required only when you upgrade your instances using the httpdctl script. - If httpdctl is not installed as a service, then complete Step 2 only.

Complete the following steps for each instance to refresh the instance control scripts and service names:

  1. Uninstall the service.

    instance/bin/httpdctl stop

    instance/bin/httpdctl uninstall

  2. Update the service with new features plus the revised pivotal httpd instance service names.The following command refreshes the httpdctl script for the instance. The command cannot be automated, because it is impossible to determine your instance locations.

    ./newserver –update –server=instance

  3. Reinstall the service.

    instance/bin/httpdctl install

    instance/bin/httpdctl start

Update the Installation Path and Relocate All Instances

This option is available for all distributions, and is preferred as a longer term solution.

  1. Complete the installation instructions to deploy Pivotal Web Server to your preferred location (typically /opt/pivotal/webserver). See Installing Pivotal Web Server.
  2. Either copy or move the /opt/vmware/vfabric-web-server/instance tree to /opt/pivotal/webserver/instance, including all file permissions and ownership.

    • Copy the tree to minimize downtime of active instances.
    • If you move the tree instead, stop and uninstall vfabric-web-server/instance prior to moving the directory tree, as documented in 8 below.
  3. Change to the /opt/pivotal/webserver/instance directory.

  4. Invoke the fixrootpath as follows:

    ../fixrootpath.pl –srcdir=/opt/vmware/vfabric-web-server –dstdir=/opt/pivotal/webserver

  5. Change to the /opt/pivotal/webserver directory.

  6. Update the httpdctl script with new features plus the revised pivotal httpd instance service names:

    ./newserver –server=instance –update

  7. Optional. Update the user and group names from vfhttpd to pwshttpd by modifying the User and Group directives in the instance/conf/httpd.conf file. Invoke the following commands from /opt/pivotal/webserver/instance to locate and replace the corresponding file and directory ownership:

    find . -group vfhttpd | xargs chgrp pwshttpd

    find . -user vfhttpd | xargs chown pwshttpd

  8. Stop and uninstall the old instance if not performed before step 2. above:

    /opt/vmware/vfabric-web-server/instance/bin/httpdctl stop

    /opt/vmware/vfabric-web-server/instance/bin/httpdctl uninstall

  9. Install and start the service from the new path:

    instance/bin/httpdctl install

    instance/bin/httpdctl start

  10. Repeat steps Step 2 through Step 10 for each previously deployed server instance.