Install > Content Pack Installation

Content Pack Installation

The following procedure explains how to install Content Pack 27.00 for Universal CMDB.

Note Rolling back the installation is not supported as it can lead to system inconsistencies. If you are upgrading from earlier versions of the content pack, it is strongly recommended to ensure that you have backed up your database.

  1. Prerequisites

    • The UCMDB Server must be running when you install the Content Pack.
    • During installation, Setup may restart the Probe to load the new content jar file.
    • Back up your database.

    Note: If you have deployed the ASM_Enhanced.zip package, delete all Service Connection Point CIs and undeploy the package before you proceed with the installation.
  2. Retrieve the Content Pack 27.00 ZIP file

    The name of the installation file is CP27_installation.zip. This file is located on the ITOM Marketplace.

    The ZIP file contains the following resources:

    • Packages (CP27.zip)
    • Online Help
  3. Extract packages from the Content Pack 27.00 ZIP file

    Unpack the contents of the CP27_installation.zip file to <UCMDB_Server_Home>.

  4. Back up existing packages

    1. Launch a Web browser and enter the following address:

      https://localhost:8443/jmx-console

      Log in using the JMX console authentication credentials.

      Note Starting with UCMDB version 10.30, by default the HTTPS protocol is enabled for UCMDB server, with the HTTP protocol being disabled.

      If necessary, you can enable HTTP communication for UCMDB Server. For instructions, see "How to Enable HTTP Communication for UCMDB Server" in the Administer section of the UCMDB Help.

    2. Click the UCMDB:service=Packaging Services link.
    3. On the JMX MBEAN View page, locate the following JMX function: exportPackages ().

      Note The JMX function exportPackages () exports packages that contain OOTB Jython scripts customized by the UCMDB administrator. The customizations will be lost after the CP27 deployment.

      • In the customerID field, enter 1.
      • In the packagesNames field, leave this field empty to export all packages.
      • In the outputDir field, enter the full path to a directory where UCMDB should place the backed-up packages, for example, <UCMDB_Server_Home>\content\my_packages_backup. The directory is created automatically.
      • In the userOnly field, select False to export all packages (and not only the user-created packages).
    4. Click Invoke.
    5. Verify that all relevant packages have been backed up to the folder mentioned in the previous step, and that there are no errors in the mam.packaging.log file, located in <UCMDB_Server_Home>\runtime\log.
  5. Install Content Pack 27.00

    You can install the Content Pack from the Universal CMDB user interface, using JMX Console, or using CMS UI 2018.05.

    Note When you install a Content Pack, you may want to retain your customized resources separate from the installed Content Pack. Therefore, starting from UCMDB 10.31, the functionalities of comparing and merging packages or Content Packs are introduced. For more details, see the "Compare and Merge Packages or Content Packs" section in the Administer section of the UCMDB Help.

    • From Universal CMDB:

      1. Stop UCMDB.
      2. Make sure that CP27.zip is in the following directory:

        <UCMDB_Server_Home>\content\content_packs

      3. Start UCMDB server.
      4. Log in to the UCMDB.
      5. Access the Package Manager (Administration > Package Manager).
      6. On the toolbar, click the Install Content Pack button.
      7. In the Install Content Pack dialog box that opens, select the CP27 version of the Content Pack and click Install.
    • Using JMX Console:

      1. Log in to JMX Console (https://localhost:8443/jmx-console).
      2. Open UCMDB > Content Pack Services.
      3. Invoke displayAvailableContentPackVersions to see available versions of the Content Pack.
      4. Enter the CP27 version in the version field, and invoke installContentPack.
    • Using CMS UI 2018.05

      1. Go to CMS UI, click the Menu icon () to expand the CMS Modules pane, and then click Package Manager.

      2. Click Install Package.
      3. Click the Content Pack tab.
      4. Click Explore Content Pack, select CP27.zip, and then click Install Selected.

        Note Make sure that CP27.zip is in the following directory:

        <UCMDB_Server_Home>\content\content_packs

      For more details on using CMS UI 2018.05, see the "How to Install/Deploy a Discovery and Integration Content Pack" section of the Universal CMDB Package Manager Online Help.

  6. Verify installation

    Verify that there are no errors in the mam.packaging.log file, located in <UCMDB_Server_Home>\runtime\log.

  7. If you are installing the Content Pack on a High Availability system, copy all files from the following folder on the active UCMDB server to the same folder on the passive UCMDB server: <UCMDB_Server_Home>\runtime\fcmdb\CodeBase\.