Install > Install the UCMDB Browser on a Different Server than the UCMDB > Install the UCMDB Browser on an Existing Tomcat

Install the UCMDB Browser on an Existing Tomcat


  • Starting with UCMDB Browser 4.12, HPE strongly recommends to secure the existing Tomcat installation. To do this, enable the HTTPS protocol, use the latest TLS, and use the latest ciphers.

  • The installation directory must not contain spaces, and can use only English letters (a-z), digits (0-9), the hyphen sign ('-'), and the underscore sign (_).

Important Starting with UCMDB Browser 4.13, HTTP Protocol is disabled by default, and standalone UCMDB Browser is no longer accessible with the HTTP protocol. However, if necessary, you can still enable HTTP communications by setting to False the following settings into the <Tomcat installation path>\conf\esapi\ file, and then restart the UCMDB Server:

  1. Download and install Apache Tomcat version 8.5.15

  2. Unzip the file UCMDB-Browser-<version_number>.<build_number> to an accessible location.

  3. Go to the folder where you extracted the contents and in the ucmdb_browser_config.xml file (located at <UCMDB_Browser_installation_folder>\conf), configure the connection to UCMDB as follows:

    • protocol. CMDB Server protocol

    • host_name. CMDB Server name
    • host_port. CMDB Server port
    • context_name. CMDB Server context name

      Note If the root context has a default value “/” this setting can be omitted.

  4. Update the context.xml file in the Tomcat conf folder to include the configuration files in the class path. It can be found under <Tomcat installation path>\conf\context.xml.

    Add under the <context> tag:

    <Environment name="ucmdb_browser_home" value="<folder path of the UCMDB_Browser_installation_folder>" type="java.lang.String" override="false"/>

    For example:

    <Environment name="ucmdb_browser_home" value="C:\ucmdb-browser-install\" type="java.lang.String" override="false"/>

    Note The conf folder should not be part of the path setting for value, as shown in the example above.

  5. Place the .war files under the webapps folder of Tomcat (located at <Tomcat installation path>\webapps).

  6. Start the Tomcat server.

  7. Go to http://<server name>:<tomcat port>/ucmdb-browser.