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

Note  

  • Starting with UCMDB Browser 4.12, it is strongly recommended 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\esapi.properties file, and then restart the UCMDB Server:

HttpUtilities.SecureSession=false
HttpUtilities.ForceSecureCookies=false

  1. Download and install Apache Tomcat version 8.5.23

  2. Unzip the file UCMDB-Browser-<version_number>.<build_number>-all-in-one-standalone.zip 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.
      • UCMDB and UCMDB Browser must have the same protocol.
  4. Change the UCMDB integration user credentials, as described in Change the UCMDB Integration User Credentials

  5. 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.

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

  7. Start the Tomcat server.

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

Send Help Center feedback