Upgrade > Upgrade the UCMDB Browser

Upgrade the UCMDB Browser

If you have a version of the UCMDB Browser that is older than the current version, you can upgrade to the latest version as follows:

  1. Unzip one of the following files to an accessible location (depending on the type of installation you have):

    • If the Browser is installed on the same machine that runs the UCMDB server: UCMDB-Browser-<version_number>.<build_number>-ucmdb-browser-embedded.zip

      Important  

      • You can upgrade the embedded UCMDB Browser to the version 4.15.1, only if the version of the UCMDB server is 10.33.
      • You can upgrade the embedded UCMDB Browser to the version 4.14, only if the version of the UCMDB server is 10.33.
      • You can upgrade the embedded UCMDB Browser to the version 4.13, only if the version of the UCMDB server is 10.32.
      • You can upgrade the embedded UCMDB Browser to the version 4.12, only if the version of the UCMDB server is 10.31.
      • You can upgrade the embedded UCMDB Browser to the version 4.10, only if the version of the UCMDB server is 10.30.
    • For all other installations: UCMDB-Browser-<version_number>.<build_number>-ucmdb-browser-standalone.zip
  2. Stop the web application (Tomcat or UCMDB Server).

  3. Clear the user preferences for the users that have scheduled reports as follows:

    1. Go to JMX Console > UCMDB-UI:name=User Preferences > clearUserPreferences.

    2. In the user name field, enter the user's name.
    3. Click Invoke.
  4. Delete the old ucmdb-browser.war file as follows:

    • If the Browser is installed on the same machine that runs the UCMDB server: Delete the ucmdb-browser.war file, and the ucmdb-browser folder from the %UCMDB-Server%deploy/ folder, where %UCMDB-Server% is the UCMDB server root folder.
    • For all other installations: Delete the ucmdb-browser.war file from <Tomcat installation path>\webapps. Also, in <Tomcat installation path>\webapps delete the ucmdb-browser folder.

  5. Copy the new ucmdb-browser.war file to the appropriate locations as follows:

    • If the Browser is installed on the same machine that runs the UCMDB server: Copy the file ucmdb-browser.war to %UCMDB-Server%deploy/. Clear the ucmdb-browser.war folder from C:\hp\UCMDB\UCMDBServer\runtime\jetty-cache before starting the UCMDB server.
    • For all other installations: Copy ucmdb_browser.war to <Tomcat installation path>\webapps.

    Note If the server is running, use a cut-and-paste operation to put the new WAR file in place, rather than copy-and-paste. Using cut-and-paste copies the file instantly and causes the server to deploy the full application (instead of possibly deploying an incomplete WAR file).

    %UCMDB-Server% is the UCMDB server root folder. For example: C:\hp\UCMDB\UCMDBServer.

  6. Copy the necessary update resources, depending on the type of installation you have, as follows:

  7. Read the release notes for the latest version to determine which features and functionality you want to use and update your Browser settings accordingly.
  8. Open the ucmdb_browser_lwsso_config.xml file in the \conf folder, and replace the following lines:

    <logoutURLs>
    <url>.*/logout.jsp.*</url>
    </logoutURLs>

    with:

    <logoutURLs>
    <url>.*/logout*</url>
    </logoutURLs>

    Note The above step is available for UCMDB Browser standalone, when upgrading from an older version to UCMDB Browser 4.05 or later versions.

  9. Check if the following lines exist in the <Tomcat installation path>\conf\context.xml file, and delete them:

    <JarScanner>
            <JarScanFilter defaultPluggabilityScan="false" />
    </JarScanner>
  10. Start the Tomcat server or UCMDB server (depending on your installation).

All features and functionality from the previous installation are active in the new installation, as well as the new features and functionality for the latest version.