Install > Install the UCMDB Browser on the Same Machine that Runs the UCMDB Server

Install the UCMDB Browser on the Same Machine that Runs the UCMDB Server

Note  

  • 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 (_).
  • The UCMDB Browser should not be installed on the same machine that runs the UCMDB server if you want the UCMDB Browser to work with multiple UCMDB Servers (as described in Configure Multiple UCMDB Servers). Rather, you should install the UCMDB Browser on a separate machine.

Important Starting with UCMDB Browser 4.13, HTTP Protocol is disabled by default, and embedded UCMDB Browser is no longer accessible with the HTTP protocol. However, if necessary, you can still enable HTTP communications by adding the following setting into the <UCMDB installation folder>\conf\esapi\ESAPI.properties file, and then restart the UCMDB Server:

HttpUtilities.SecureSession=false

Important

The latest version of UCMDB Browser can be embedded only in the latest released version of UCMDB server.

  • UCMDB Browser can be embedded in UCMDB server as follows:

    • UCMDB Browser version 4.15.1 can be embedded only in UCMDB server version 10.33.
    • UCMDB Browser version 4.14 can be embedded only in UCMDB server version 10.33.
    • UCMDB Browser version 4.13 can be embedded only in UCMDB server version 10.32.
    • UCMDB Browser version 4.12 can be embedded only in UCMDB server version 10.31.
    • UCMDB Browser version 4.10 can be embedded only in UCMDB server version 10.30.

  • UCMDB server supports embedded UCMDB Browser as follows:

    • UCMDB server version 10.33 supports embedded UCMDB Browser version 4.14, and UCMDB Browser version 4.15.1.

    • UCMDB server version 10.32 supports embedded UCMDB Browser version 4.13.
    • UCMDB server version 10.31 supports embedded UCMDB Browser version 4.12.

    • UCMDB server version 10.30 supports embedded UCMDB Browser version 4.10.

For available options, see Move the UCMDB Browser embedded to UCMDB Browser standalone in the Universal CMDB Browser Installation and Configuration Guide.

  1. Unzip the file UCMDB-Browser-<version_number>.<build_number>-ucmdb-browser-embedded.zip to an accessible location.
  2. Stop the UCMDB server.
  3. Go to the folder where you extracted the content and copy the file ucmdb-browser.war to the UCMDB server in the folder %UCMDB-Server%\deploy\, overriding the existing file.

    Note %UCMDB-Server% is the UCMDB server root folder. For example: C:\hp\UCMDB\UCMDBServer.

  4. Start the UCMDB server.

  5. After starting the UCMDB server, open the UCMDB Browser with the following URL:

    https://<UCMDB_server_name>:8443/ucmdb-browser