Upgrading Pivotal Web Server

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

Important: If you are upgrading from VMware vFabric Web Server 5.3.x or earlier, complete the instructions in Migrating from VMware vFabric Web Server 5.x instead.

Upgrade Pivotal Web Server 5.4.x


  1. Move your Pivotal Web Server 5.4.x installation from its current location (typically /opt/pivotal/webserver) to /opt/pivotal/webserver.5.4.
  2. Complete the installation instructions to deploy Pivotal Web Server to your preferred location (typically /opt/pivotal/webserver). See Installing Pivotal Web Server.
  3. Either copy or move the /opt/pivotal/webserver.5.4/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 /opt/pivotal/webserver.5.4/instance prior to moving the directory tree, as documented in Step 7 below.
  4. Change to the /opt/pivotal/webserver directory.

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

    ./newserver --server={instance} --update
  6. Update the module and path names and the authorization sections in the instance/conf/httpd.conf file to match the 2.4 version. For guidance, see the Apache HTTP Server documentation.

  7. Stop and uninstall the old instance if not performed before Step 3. above:

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

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

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

    instance/bin/httpdctl install

    instance/bin/httpdctl start

  9. Repeat steps Step 3 through Step 8 for each previously deployed server instance.