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

Install CMS UI with Preconfigured Apache Tomcat Server on Linux

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 (_).
  • OpenJDK 8 (64 bit) must be installed on the server where you install the CMS UI (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 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

To install CMS UI:

  1. Extract the contents of the archive file CMS_UI-<display_version_number>.<build_number>-tomcat-assembly-unix.tar.gz into the folder CMS_UI on your home directory.

  2. Go to the ucmdb_browser_config.xml file in the folder ./CMS_UI/conf and configure the connection to UCMDB 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. Ensure that all shell scripts (./CMS_UI/bin/*.sh files) have ‘execute’ permission. You can use the command ls –l ./CMS_UI/bin/ to do this.

    If the shell scripts do not have 'execute' permissions, add them by invoking chmod a+x ./CMS_UI/bin/*.sh.

  5. Start the Tomcat server with the pre-installed CMS UI by invoking ./CMS_UI/bin/startup.sh.

Note  

  • To stop the Tomcat server, use the command ./CMS_UI/bin/shutdown.sh.

  • When CMS UI is embedded on the UCMDB Server and installed on Linux, ensure that the /etc/hosts file is updated with: 127.0.0.1 localhost.

Send Help Center feedback