Opswise Windows Apache Upgrade

1. Preinstall

1.1. Take Server snapshot

  • Ask the Windows team to take a snapshot of the Opswise server.

    This step and the eventual reconfiguration step are necessary to avoid performance issues with Opswise post Tomcat upgrade

1.2. Take Screen Shot of Apache Tomcat Java Memory Settings

  1. Launch E:\Program Files\Apache Software Foundation\Tomcat 8.5\bin\Tomcat8w.exe

  2. Take a screen shot of the following setting. We will need to restore these values later…​

    Apache-Tomcat-Java-mem-settings

2. Uninstall Apache Tomcat

2.1. Stop Opswise Related Services

  1. Stop the Ubroker Service

  2. Stop the Apache Service

2.2. Backup Apache Folder

  1. Make a backup of the E:\Program Files\Apache Software Foundation\Tomcat 8.5 folder.

    Apache-Tomcat-folder-backup.png

2.3. Uninstall

  1. Run Apps & features or the equivalent and search for apache:

    Apache-Tomcat-apps-features.png

  2. Now Uninstall

    Apache-Tomcat-uninstall.png

  3. During the install, you will be prompted for removal of the Tomcat directory.

    Choose the No button in order to keep our original Tomcat directory containing Opswise related data and config files!

    Apache-Tomcat-folder-rename.png

2.4. Rename Apache Folder

  • If the original Tomcat folder name contains a version number, rename it to: Tomcat:

    Apache-Tomcat-folder-rename.png

3. Install

Start the install…​

  • Confirm that this install folder points to our original folder containing our Opswise related files.

    Apache-Tomcat-folder-rename.png

4. Post Install

4.1. Confirm Apache is Running and its Current Version

  1. On the Opswise server, launch a browser and browse to: http://localhost:8080

  2. You should see the following page with the current Apache Tomcat version in the upper left corner.

    Apache-Tomcat-post-install-version.png

4.2. Configure Apache Service for Auto Start

  • The newly installed Apache Service is not configured for automatic start.

  • Perform the following to configure it to start automatically when the server is restarted:

    Apache-Tomcat-service-autostart-config.png

4.3. Restore Apache Tomcat Java Memory Settings

  1. Launch E:\Program Files\Apache Software Foundation\Tomcat\bin\Tomcat8w.exe

  2. Update the values so that they match your earlier screen shot.

    Apache-Tomcat-Java-mem-settings-restored

    The Apache service may need to be restarted in order for the updated values to take effect…​

4.4. Confirm Opswise functionality

  • Perform appropriate checkout procedures.

5. Cleanup

  • Ask the Windows team to delete snapshot.