Install > Introduction

Introduction

Before installing the UCMDB Browser, ensure that your system meets the following requirements:

  • UCMDB version. Any UCMDB 10.10 or later version.
  • UCMDB Browser Server. 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 UCMDB Browser installation currently comes in five formats:

  • Web Application Package. A zip file called UCMDB-Browser-<version_number>.<build_number>-all-in-one-standalone.zip that consists of the ucmdb-browser.war file, discovery-log.war file, and a /conf folder with the UCMDB Browser configuration files. Use this format if you already have an Apache Tomcat Server installed, or you want to install the Tomcat server on your own.

    Note If you are planning to install the UCMDB Browser with a Tomcat server, it is not recommended to do this on the same machine that runs the UCMDB Server. For details about installing both applications on the same machine, see Install the UCMDB Browser on the Same Machine that Runs the UCMDB Server.

  • Pre-configured Apache Tomcat Server package for Windows. A zip file called UCMDB-Browser-<version_number>.<build_number>-tomcat-assembly-windows.zip that consists of a pre-configured Apache Tomcat server for Windows with the ucmdb-browser.war file, and discovery-log.war file. The UCMDB Browser configuration files reside under the /conf folder.
  • Pre-configured Apache Tomcat Server package for Linux. An archive file called UCMDB-Browser-<version_number>.<build_number>-tomcat-assembly-unix.tar.gz that consists of a pre-configured Apache Tomcat server for Linux with the ucmdb-browser.war file, and discovery-log.war file. The UCMDB Browser configuration files reside under the /conf folder.
  • Existing Apache Tomcat server package. A zip file called UCMDB-Browser-<version_number>.<build_number>-ucmdb-browser-standalone.zip that consists of the ucmdb-browser.war file, and a /conf folder with the UCMDB Browser configuration files. Use this format if you have an Apache Tomcat sever installed and you want to upgrade the UCMDB Browser to the latest version.
  • Embedded UCMDB Browser package. A zip file called UCMDB-Browser-<version_number>.<build_number>-ucmdb-browser-embedded.zip that consists of the ucmdb-browser.war file. Use this format if:

    • You want to install the UCMDB Browser on the same machine that runs the UCMDB server.
    • You have a UCMDB Server installed and you want to upgrade the UCMDB Browser to the latest version.

    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.

Caution Apart from the OOTB files, DO NOT ADD any additional resources into the <UCMDB_Server_Home>\deploy directory. Because UCMDB will try to deploy every file from this location, which may cause the ucmdb-browser.war file not deployed completely, and as a result the UCMDB Browser will fail to start.

Caution Apart from the OOTB files, DO NOT ADD any additional resources into the <UCMDB_Server_Home>\deploy directory. Because UCMDB will try to deploy every file from this location, which may cause the ucmdb-browser.war file not deployed completely, and as a result the UCMDB Browser will fail to start.