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

Install the UCMDB Browser with Preconfigured Apache Tomcat Server on Linux

Note  

  • Starting with UCMDB Browser 4.15.1, the SSL protocol is TLSv1.2.

  • Starting with UCMDB Browser 4.13, 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.
  • Starting with UCMDB Browser 4.12, 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 UCMDB Browser (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 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

To install the UCMDB Browser:

  1. Extract the contents of the archive file UCMDB-Browser-<version_number>.<build_number>-tomcat-assembly-unix.tar.gz into the folder ucmdb-browser on your home directory.
  2. Go to the ucmdb_browser_config.xml file in the folder ./ucmdb-tomcat/conf and configure the connection to UCMDB as follows:

    • protocol. CMDB Server protocol
    • host_name. CMDB Server name
    • host_port. CMDB Server port
  3. Ensure that all shell scripts (./ucmdb-browser/bin/*.sh files) have ‘execute’ permission. You can use the command ls –l ./ucmdb-browser/bin/ to do this.

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

  4. Start the Tomcat server with the pre-installed UCMDB Browser by invoking ./ucmdb-browser/bin/startup.sh.

Note  

  • To stop the Tomcat server, use the command ./ucmdb-browser/bin/shutdown.sh.
  • When the UCMDB Browser is embedded on the UCMDB Server and installed on Linux, ensure that the /etc/hosts file is updated with: 127.0.0.1 localhost.