Installing or upgrading Common Services and additional products

Ops Center Installation and Configuration Guide
Version
11.0.x
Audience
anonymous
Part Number
MK-99OPS001-23
To install or upgrade Common Services and one or more products, use the Server Express installer.
Note:
  • If you install Common Services, Amazon Corretto 21 and PostgreSQL 15 are installed. If you upgrade Common Services, Amazon Corretto 8 (version 10.6.0 and earlier), Amazon Corretto 11 (versions 10.6.1 to 10.9.1), Amazon Corretto 17 (versions 10.9.2 to 11.0.2), and PostgreSQL 11 (version 10.9.2 and earlier) that were installed with the previous version are not removed. If you do not need these programs, remove them by using the rpm command. If you cannot remove the programs by using this command, use the rpm command with the --nopreun option specified.
    The package names are as follows:

    • Amazon Corretto 8: java-1.8.0-amazon-corretto-devel

    • Amazon Corretto 11: java-11-amazon-corretto-devel

    • Amazon Corretto 17: java-17-amazon-corretto-devel

    • PostgreSQL 11: postgresql11, postgresql11-server, postgresql11-libs
  • If the Analyzer viewpoint server was deployed by using an OVF version earlier than 10.5.1, you cannot use the Server Express installer to upgrade Common Services or Analyzer viewpoint. In this case, deploy the latest version of the Analyzer viewpoint OVF to upgrade.

    For details on how to upgrade Analyzer viewpoint, see the Analyzer documentation.

  • For best results, close all other programs, including:
    • Security-monitoring programs
    • Virus-detection programs
    • Process-monitoring programs

    If the Services window is open, close it.

  • If you are logged in to the Hitachi Ops Center Portal, close the web browser before beginning the upgrade. If you upgrade Common Services while logged in to the Hitachi Ops Center Portal, an internal server error might occur. If this error occurs, restart the web browser.
  • In Common Services version 10.9.1 and later, a special group named support-services has been added as a default user group. This group is used for support services, so it cannot be used for standard purposes. For this reason, if you want to upgrade from version 10.9.0 or earlier, first make sure that the support-services group does not exist.
    • If the support-services group was imported by linking with an Active Directory server, delete the group. In addition, from the Hitachi Ops Center Portal, change the Group entry list setting for user directories so that the support-services group will not be imported.
    • If the system administrator created the support-services group using a method other than linking with an Active Directory server, delete or rename the group before upgrading from version 10.9.0 or earlier.
    Note: If you upgrade Common Services from version 10.9.0 or earlier while the support-services group exists, you must delete or rename the group and then perform an overwrite installation of Common Services.
  1. Log in to the management server as the root user.
    If you log in as an ordinary user, use the sudo command to complete the following procedure as the root user.
  2. To start the Server Express installer, run install.sh, which is in the following location on the installation media:
    root-directory-of-the-installation-media/install.sh
    Note: If one or more products cannot be installed in the same environment as a currently installed product, the Server Express installer will not install the applicable products and a warning message is displayed.
  3. If the yum repository settings are not configured or cannot be used, a message appears asking if you want to run the Yum Setup Helper tool. Follow the displayed message to configure the settings.
    1. To configure the settings, enter y. The Yum Setup Helper window is displayed.
    2. From Content in Current Dir, use the cursor keys and then the Enter key to select the directory that includes the OS media file (ISO file).
      Note: The Yum Setup Helper tool uses the OS media file to configure the yum repository settings, so the OS media file must be stored on the management server. If the OS media file does not exist, get it from the distribution website. Click Help to see information about the corresponding OS media file.
    3. Select the ISO file. The file name is displayed for Selected Item.
    4. Click OK. Configuration of the yum repository settings starts, and a processing window is displayed.
      Tip: You can also use the tab key to move the cursor between items in the window.
    5. When configuration of the yum repository settings is complete, a message is displayed. Select OK. If the configuration fails, an error message is displayed. If you select OK, the window where you can select an OS media file is displayed again.
  4. Choose the product you want to install, and then press Enter.
    If you select 1 All, the products listed within the parentheses are installed.

    To select multiple products, separate the numbers with commas. (Example: 2,3)

    Note: You cannot select products that have ** displayed for the product number.
  5. For new Analyzer installations, set the memory size by choosing one of the following scale values:
    • 1: Small-scale configuration
    • 2: Medium-scale configuration
    • 3: Large-scale configuration
    Note: For details on the system requirements for each product based on scale, see Hitachi Ops Center System Requirements.
  6. Follow the prompts and specify the required information.
    For Common Services:

    Setting items

    Description

    Install directory

    For a new installation:

    • Specify the directory in which to install Common Services.

      It will be installed in the following location:

      specified-directory/CommonService

      The default location is as follows:

      /opt/hitachi/CommonService

    • Specify a directory by using 64 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the following paths:
      • /usr
      • /usr/local
      • /var
      • root directory (/)

    Host name or IP address

    For a new installation:

    • You can specify a host name in FQDN format.
    • The host name (or FQDN) or IP address specified in this step is used in the URL for accessing the Hitachi Ops Center Portal. To change the host name (or FQDN) or IP address that is used to access the Hitachi Ops Center Portal, run the cschgconnect command after installation. For details about the cschgconnect command, see Changing the management server host name, IP address, or port number.
    • The management server on which Common Services and other relevant products are installed and the web browser used to access the Hitachi Ops Center Portal must be able to resolve and reach the host name (or FQDN) and IP address.
    • If you specify a host name (or FQDN), specify a value using no more than 128 characters.
    • You cannot specify uppercase characters in the host name (or FQDN). If you do, they are converted to lowercase characters and then registered.

    Port number

    For a new installation:

    • Specify a value in the range 1 - 65535.

    • Default: 443

      If you install the following products on the same management server, there will be conflicts with the default port number 443:

      • Protector
      • Administrator
      Change the port number so that it does not conflict between the products. If you want to change the port number for Common Services to a number other than 443, we recommend using port number 20950.

    Do you want to access to Hitachi Ops Center Portal by using both host name and IP address ?

    For a new installation where a host name or FQDN is specified:

    • Specify y or n.

    • Default: n
    Do you want to back up the Common Services database first ?

    For an upgrade or overwrite installation:

    • Specify y or n.

    • Default: y

    Database backup location

    For an upgrade or overwrite installation where you want to back up the database:

    • Specify a directory by using 150 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the root directory (/).

    • Default: /var/installation-directory/backup

    Admin user name

    For a new installation of another product when Common Services has already been installed:

    Specify the username of the Common Services administrator.

    Specify a user who belongs to the user group to which the opscenter-system-administrator or the opscenter-security-administrator role is assigned.

    Password

    For a new installation of another product when Common Services has already been installed:

    Specify the password of the Common Services administrator.
    For Administrator:
    Setting items

    Description

    IP address

    For a new installation:

    • Specify a value in IPv4 format.

    • Default: IP address of the system

    Port number

    For a new installation:

    • Specify a value in the range 1 - 65535.

    • Default: 20961

    User name

    For an upgrade installation:

    Default: sysadmin

    Password

    For an upgrade installation:

    Default: None
    For API Configuration Manager:

    Setting items

    Description

    Install directory

    For a new installation:

    • Specify the directory in which to install API Configuration Manager.

      It will be installed in the following location:

      specified-directory/ConfManager

      The default location is as follows:

      /opt/hitachi/ConfManager

    • Specify a directory by using 64 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the following paths:
      • /usr
      • /usr/local
      • /var
      • root directory (/)
    Do you want to back up the API Configuration Manager database first ?

    For an upgrade installation:

    • Specify y or n.

    • Default: y

    Database backup location

    For an upgrade installation where you want to back up the database:

    • Specify a directory by using 64 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the following paths:
      • /usr
      • /usr/local
      • /var
      • root directory (/)

    • Default: specified-directory/backup/bak_CONFIG_MGR
    For Protector:
    Setting items

    Description

    Install directory

    For a new installation:

    Specify the directory in which to install Protector.

    It will be installed in the following location:

    specified-directory/protector

    The default location is as follows:

    /opt/hitachi/protector

    Node name

    For a new installation:

    Default: Node name of the operating system

    User account on the local system

    For a new installation:

    Default: root

    Port number

    For a new installation:

    Default: 20964
    For Automator:

    Setting items

    Description

    Install directory

    For a new installation:

    • Specify the directory in which to install Automator.

      It will be installed in the following location:

      specified-directory/Automation

      The default location is as follows:

      /opt/hitachi/Automation

    • Specify a directory by using 64 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the following paths:
      • /usr
      • /usr/local
      • /var
      • root directory (/)

    Host name or IP address

    For a new installation:

    If you specify a host name specify a value using no more than 128 characters.

    Database directory

    For a new installation:

    • Specify a directory by using 90 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the root directory (/).

    • Default: /var/specified-directory/database
    Do you want to back up the Automator database first ?

    For an upgrade or overwrite installation:

    • Specify y or n.

    • Default: y

    Database backup location

    For an upgrade or overwrite installation where you want to back up the database:

    • Specify a directory by using 150 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the root directory (/).

    • Default: /var/specified-directory/Automation_backup
    For Analyzer:
    Setting items

    Description

    Install directory

    For a new installation:

    • Specify the directory in which to install Analyzer.

      It will be installed in the following location:

      specified-directory/Analytics

      The default location is as follows:

      /opt/hitachi/Analytics

    • If you specify a directory other than the default, refer to the product manual for the requirements.
    For Analyzer detail view:
    Setting items

    Description

    Installation-destination device

    For a new installation:

    • A list of devices on the management server is displayed.

      Default: Devices with enough free space for the installation are displayed.

    • If you want to use a device other than the default, specify a device name from the displayed list.

    Directory for storing application data

    For a new installation:

    • Specify the directory where the application data will be stored.

      The default location is as follows:

      /data

    • If you specify a directory other than the default, refer to the product manual for the requirements.

    HTTP access port for internal communication

    For a new installation:

    If port number 8080 is being used by another program, specify a value from 10000 to 65530.

    HTTPS access port

    For a new installation:

    If port number 8443 is being used by another program, specify a value from 10000 to 65530.
    For Analyzer viewpoint:
    Setting items

    Description

    HTTPS access port for internal communication

    If port number 25442 is being used by another program, specify a value from 1 to 65535.
    For Command Control Interface:
    Setting items Description
    Install directory

    For a new installation (when installing API Configuration Manager or Protector):

    • Specify the directory in which to install Command Control Interface.

      It will be installed in the following location:

      specified-directory/HORCM

      The default location is as follows:

      /opt/hitachi/HORCM

    • Specify a directory by using 64 or fewer bytes and the following characters:

      A-Z, a-z, 0-9, underscores (_), and forward slashes (/)

      Note: You cannot specify the following paths:
      • Paths containing /ConfManager/
      • Root directory (/)
  7. Check the information you entered and the message that appears.

    If both API Configuration Manager and Protector are included as products to install, a message related to Command Control Interface might appear. Check the message and then continue.

    If there are no problems, press y to begin the installation.

  8. When the installation is complete, the results are displayed:
    • If all installation tasks finished successfully, Completed successfully. is displayed.
    • If any task fails, Failed. is displayed.

    If Common Services registration displays a Failed. status, you must register the product manually after the installer completes. For details, see Registering Hitachi Ops Center products with Common Services.

    Note: When it takes a long time to install Automator, a KNAE04747-E message might be shown on the console even if the installation is successful. If "Hitachi Ops Center Automator installation completed successfully." is output after the KNAE04747-E message, the installation processing might have completed successfully. Wait a while, check whether the Automator service is running, and if the service is running, log in to Automator. If the Automator service is stopped, start the Automator service, and log in to Automator. If the login is successful, the installation processing is done, and you can ignore the KNAE04747-E message.
  9. If you are upgrading from Common Services version 10.9.2 or earlier using the SAML protocol to link with AD FS, you must register the metadata re-acquired from Common Services in AD FS when the upgrade is complete.
    For the registration procedure, see:
  10. If you are upgrading Common Services from version 10.9.3 or earlier and Common Services is linked with an Active Directory server, after upgrading check the settings of Add all users under Base DN to opscenter-users group in the Hitachi Ops Center Portal Edit user directory service window.
    Note: Active Directory users are displayed in the Hitachi Ops Center Portal Users window. If there are a large number of users, it might take time to display the screen. If necessary, specify a search filter in Custom user LDAP filter to narrow down the Active Directory users to display. The search-filter syntax must conform to RFC 2254.
    • If Enable is specified, all Active Directory users under the Base DN are retrieved. Specify a search filter in Custom user LDAP filter.
    • If Disable is specified, the value of Group entry list is automatically specified in Custom user LDAP filter when you upgrade. Change the setting as needed.