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

Install CMS UI on an Existing Tomcat

Note  

  • 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 HTTP Protocol is disabled by default, and the standalone CMS UI is not accessible with the HTTP protocol. However, if necessary, you can 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.24.

  2. Unzip the file CMS_UI-<display_version_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 <CMS_UI_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 CMS UI 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 CMS_UI_installation_folder>" type="java.lang.String" override="false"/>

    For example:

    <Environment name="ucmdb_browser_home" value="C:\cms-ui-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.