Install > Install CMS UI on a Different Server than the UCMDB > Install CMS UI with Preconfigured Apache Tomcat Server on Windows

Install CMS UI with Preconfigured Apache Tomcat Server on Windows

Note  

  • The Tomcat Server comes with a configured self-signed certificate. However, if you want to change the SSL, follow the steps described in Configure SSL.

    The SSL protocol is TLSv1.2.

    TLSv1.1 and older versions are not supported.

  • The default port value of the Tomcat Server is 8443, and the default protocol is HTTPS.

    If the port value of the UCMDB server is 8443, you need to change the port value of the Tomcat Server, as described in Change the Default Port of the Tomcat Server.

  • 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 (_).
  • To edit the Tomcat service properties, run the CMS-Browserw.exe file.

    When upgrading from UCMDB Browser to CMS UI 2018.05 or later versions, open the \bin folder and manually rename the tomcat7w.exe file to CMS-Browserw.exe.

  • To run Tomcat as a service, OpenJDK 8 for Win 64 bit should be installed (not JRE). The Apache Tomcat version gets its Java from the JAVA_HOME environment variable.
  • The pre-configured Apache Tomcat Server has pre-defined user credentials to access the Tomcat Manager Application. The user credentials for the pre-configured Apache Tomcat Server are: admin/admin. It is strongly recommended to change these credentials after installation to prevent unauthorized access to the Tomcat Manager Application.

    To change the user credentials for the pre-configured Apache Tomcat Server go to the Tomcat conf folder, and change the credentials in the file tomcat-users.xml. For more details, see the Tomcat online documentation at: http://tomcat.apache.org/tomcat-8.5-doc/manager-howto.html

Important HTTP Protocol is disabled by default, and 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

To install CMS UI:

  1. Unzip the file CMS_UI-<display_version_number>-tomcat-assembly-windows.zip to an accessible location.

  2. 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 the UCMDB server as follows:

    • protocol. CMDB Server protocol
    • host_name. CMDB Server name
    • host_port. CMDB Server port

    Note UCMDB and CMS UI must have the same protocol.

  3. Change the UCMDB integration user credentials, as described in Change the UCMDB Integration User Credentials
  4. Install the Tomcat server as a service using <CMS_UI_installation_folder>/install_ucmdb_browser_service.bat.

    Note The above step must be performed using administrator privilege.

  5. Start the Tomcat server using <CMS_UI_installation_folder>/start_ucmdb_browser_service.bat.

  6. Go to https://<server name>:8443/ucmdb-browser.

    Note After restarting your computer, the Tomcat server starts automatically. To stop the Tomcat server, run: <CMS_UI_installation_folder>/stop_ucmdb_browser_service.bat. To uninstall the Tomcat server, run: <CMS_UI_installation_folder>/uninstall_ucmdb_browser_service.bat.