2.1 Installing CMS

Before installing CMS, verify that all of the requirements have been met. Because CMS is a separate product with its own installation CD or download, it is not installed as part of Operations Center server. For more information about installing Operations Center, see the Operations Center Server Installation Guide.

During installation, various configuration values must be set for CMS. After installation, you must start the CMS service.

Do the following in order:

2.1.1 Updating and Verifying Your Operations Center Configuration Settings

Because CMS must communicate with the Operations Center server, we recommend verifying Operations Center server configuration settings before you start to install. It is also important to verify and update (if necessary) Server Java Runtime Options values, which can cause memory errors if not set properly.

To verify and update Operations Center Configuration Settings:

  1. Open the Operations Center Configuration Manager, and select NOC Server.

  2. To avoid memory issues, verify the JRE Flag is set as –XX:MaxPermSize=256m in the NOC Server Java Runtime Options setting, as shown in this illustration:

  3. Click the Tasks tab, and select Networking.

    The Tasks tab in the Operations Center Configuration Manager allows you to view all Networking settings in a single list, as shown in the following illustration:

  4. Verify the following Operations Center server settings, which are important for open communication between Operations Center and CMS:

    Hostname: The hostname for the Operations Center server.

    Client/Server Communication Mode: The method of communication for the Operations Center server. Select between Unsecured Communication or Secured Communication Using SSL.

    Web Server Ports: The Web server HTTP and HTTPS ports for the Operations Center server.

    Remote Services Port (RMI): The RMI server port for the Operations Center server.

  5. Continue to Section 2.1, Installing CMS.

2.1.2 Installing CMS

Usually, CMS is installed by using the Installation Wizard. It can also be installed using a console installation or an unattended (or silent) installation as detailed in the following note.

For more information about any of the installation methods, see the Operations Center Server Installation Guide.

Installing CMS Using a GUI Wizard

To install CMS:

  1. (Recommended) Stop all programs before continuing especially those any programs that might interfere with the Operations Center installation.

  2. If installing on Windows 2012 and using a DVD/CD, mounted ISO or mounted network install, do the following:

    1. Locate the installation .exe file:

      mount_location\CMS\Disk1\InstData\Windows\VM\install.exe
      
    2. Right-click the file and select Properties.

    3. Open the Compatibility tab, mark the Run this program in compatibility mode for option and select Windows 7.

  3. Do one of the following:

    • Windows: Do one of the following:

      • Insert the CMS CD into the CD drive of the server on which the software is to be installed.

        The Installation Wizard should launch automatically. If not, enter install.bat at a command prompt to manually launch the Installation Wizard.

      • Access the downloaded CMS files, then enter install.bat at a command prompt to manually launch the Installation Wizard.

    • UNIX Do one of the following:

      • Set the variable path to where the Java executable is, mount the CD, then run install.sh from the root.

      • Set the variable path to where the Java executable is, change to the directory where the downloaded CMS files exist, then run install.sh from the root.

  4. On the License Agreement page, review the contents of the license agreement and select the I accept the terms of the License Agreement radio button if you agree with the terms.

  5. On the Choose Java Virtual Machine page, do the following:

    1. To install the Java VM, do one of the following:

      • (Windows 32-bit) Select the Choose a Java VM already installed on this application radio button and select the desired Java VM from the list.

      • Select Search For Others to list additional installed VMs.

      • Select Choose Another to navigate to the location of the Java VM you want to use.

        IMPORTANT:If installing on a Windows 32-bit platform, select a 32-bit JVM. If installing on a Windows 64-bit platform, select a 64-bit JVM. CMS cannot run if the wrong JVM is selected.

  6. On the Choose Install Set page, do one of the following:

    • Click Next to accept the default typical install set and install the most common application features.

    • Click Web Application for the installer to save the .war files to your server.

  7. On the Choose Install Folder page, click Next to accept the default installation directory or click Choose to browse for a different location.

  8. On the CMS Server Configuration page, do the following:

    1. Specify the CMS communications mode by selecting one of the following CMS Communications Mode radio buttons:

      • http only to only use unsecure communications.

      • https only to only use secure communications.

      • both to allow both unsecure and secure communications.

    2. Specify the http port CMS is to use for http communications in the CMS Web Server Port (HTTP) field.

    3. Specify the http port CMS is to use for https communications in the CMS Web Server Port (HTTPS) field.

    4. Click Next.

    5. Specify the communications mode that CMS uses to communicate with the Operations Center server by selecting one of the following Operations Center Communications Mode radio buttons:

      • http to use unsecure communication with Operations Center.

      • https to use secure communications with Operations Center.

    6. Specify the host name for the Operations Center server in the NOC Host Name field.

    7. Specify the Web port for the Operations Center server in the NOC Web Port field.

    8. Click Next.

    9. Select the Run Configuration Manager after install option to launch the Configuration Manager during installation.

    10. Click Next.

  9. On the Pre-Installation Summary page, review all installation details and then click Install. During installation:

  10. After installation is complete, continue with Section 2.1.3, Configuring CMS Settings.

Installing CMS Using a Console

A console installation runs a text-based version of the Installation Wizard. Options are the same as the Windows-based version, except that you must provide responses.

  1. To run a console installation, do one of the following:

    • Run install.bat ‑i console at a command prompt in Windows.

    • Run install.sh ‑i console at a command prompt in UNIX.

  2. Reply to responses as they appear.

Installing CMS Using an Unattended Mode

An unattended installation installs CMS without opening the installation wizard. The installation takes all default values and runs silently in the background.

To run an unattended installation, issue one of the following commands replacing installation_path with the complete path to the location where CMS is installed:

In Windows:

install.bat –i silent –D USER_INSTALL_DIR=installation_path 

On UNIX:

install.sh –i silent –D USER_INSTALL_DIR=installation_path

2.1.3 Configuring CMS Settings

Configurations must be made for general CMS operation and communications with the Operations Center server. CMS configuration settings are defined using the CMS Configuration Manager during the installation process.

The CMS Configuration Manager and the Operations Center Configuration Manager are two different configuration managers.

After making changes in the Configuration Manager, it is necessary to restart CMS for any changes to take affect. Changing the settings through the Configuration Manager replaces all existing configuration files and any manual changes are lost.

For information about securing Operations Center and CMS across servers, see Communications Security in the Operations Center Security Management Guide.

To configure CMS settings:

  1. To access the CMS Configuration Manager, do one of the following:

    • Execute /OperationsCenter_CMS_install_path/bin/customizer.exe.

    • From the Start menu in Windows, select NetIQOperations Center > NetIQ Operations CenterCMS > Configure NetIQ Operations Center CMS.

  2. To configure Operations Center server Communication, do the following:

    1. Click the Components tab, and select NetIQ Operations Center.

      In order for CMS to communicate with the Operations Center server, some configuration settings must match the settings of the Operations Center server’s configuration.

    2. Match the same settings as in the Operations Center Configuration Manager:

      The myCMDB Configuration Manager showing Managed Objects Server Settings

      Configure the following CMS settings to be the same as for the Operations Center server:

      Operations Center Host Name: The hostname for the Operations Center server.

      Operations Center Communication Mode: The method of communication for the Operations Center server. Select between Unsecured Communication or Secured Communication Using SSL.

      Operations Center Web Server Port: The Web server port for the Operations Center server. If using unsecured communication, specify the Web Server Port number for HTTP from the Operations Center server. Or, if using Secured communication using SSL, specify the Web Server Port number for HTTPS from the Operations Center server.

      Operations Center RMI Server Port: The RMI server port for the Operations Center server. The default RMI port is 1099. The value must match the RMI server port specified in the Operations Center configuration manager. If the port is changed in the CMS Configuration Manager, the port must be updated in the Operations Center Configuration Manager, and vice versa.

    3. Click Apply to save the settings.

  3. To configure CMS, do the following:

    1. In the CMS section, click the Components tab.

    2. Configure the following which configure how the user accesses CMS:

      Configuration Management System Communication Mode: The method of communication for CMS. Select Unsecured Communication, Secured Communication Using SSL, or Support Both Unsecured and Secured Communication.

      Configuration Management System Web Server Port (HTTP): The port to access CMS if using an unsecured communication protocol.

      Configuration Management System Web Server Port (HTTPS): The port to access CMS if using a secure communication protocol.

      Configuration Management System Web Server Shutdown Port: The TCP/IP port number to which CMS listens for a shutdown command.

    3. Configure the following to enable the Operations Center server to use standard metamodel validation rules to evaluate CI information:

      NOC Server Field Validation: Set to Enabled to enable the Operations Center server to perform field validation when the CI Edit dialog is updated. Enabling this property, enables the following properties related to field validation.

      Delay Validation During Create: Set to true to turn off validation so that a list of property pages and fields can be returned for the CI prior to actual CI registration. During this process, an internal ORG element is used in Operations Center until CI fields are valid, at which point the actual element is created.

      If set to false, the element is created in Operations Center when the Register button is clicked. If any CI fields are invalid, then the CI is removed after confirmation when the Allow Validation Override property is set to true. It is recommended to set the Delay Validation During Create property to false when using a complex custom matching script or script validation rules.

      Validate On Page Load: Set to true to perform server-side validation when attributes are first populated in the Attributes page of the CI Edit dialog.

      Allow Validation Override: Set to true to prompt the user if the CI has invalid fields. The user is given a choice to continue with CI registration or update, or to return and correct the information. If set to false, the CI cannot be registered or updated until all validation rules are satisfied.

      Show Validate Button: Set to true to show a Validate button in the CI Edit dialog.

      Allow non-admin producers to delete CIs: Set to true to allow producers who are not Operations Center administrators to delete CIs. When set to false, all delete CI options are hidden for producers who are not also Operations Center administrators.

    4. Specify Java configuration options:

      Java Development Kit Directory: The location of the JDK used by CMS. Click Browse to select a new location.

      Java Initial Memory Pool: (Windows only) Initial and minimum Java heap size in megabytes.

      Java Max Memory Pool: (Windows only) Maximum Java heap size in megabytes.

      Java Runtime Options: List of command line options in the form of -D or -X that are passed to the JDK. For Windows, separate entries with a semicolon. For UNIX, separate entries with a space.

      For more information about JRE requirements, see Requirements for the Dashboard and CMS in the Operations Center Getting Started Guide.

    5. Click Apply to save the settings.

    6. Continue to Section 2.1.4, Starting CMS and Verifying the Installation.

2.1.4 Starting CMS and Verifying the Installation

The last step to installing CMS is to start the CMS service and log in to verify a successful connection.

For more information about starting and stopping CMS, see Section 2.3.1, Starting CMS.

To log in to CMS:

  1. From your Web browser, access the CMS, then enter the following URL:

    http://server:CMS_port

    For example, if you have installed CMS on your current machine and set the HTTP port in the CMS Configuration Manager to 8888, then point your browser to:

    http://localhost:8888

  2. Log in to the CMS.

    Use the Operations Center default admin account credentials.

  3. If authentication fails, do the following as necessary:

    • Confirm your administrator default account credentials.

    • Verify you are using the correct HTTP or HTTPS port.

    • Confirm that the RMI connections specified in the CMS Configuration Manager and the Operations Center Configuration Manager match.

      If settings are changed in the Configuration Manager, restart the associated server.

    • Check the CMS.trc file for error messages.

    • Verify the correct JVM is installed for the platform you are running.