Installing or upgrading Common Services

Ops Center Installation and Configuration Guide
Version
11.0.x
Audience
anonymous
Part Number
MK-99OPS001-25
To install or upgrade Common Services in an existing environment or to create a Hitachi Ops Center system without using the OVA or Express installer, install Common Services by using the individual 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 individual 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.

  • Confirm that one of the following settings is configured on the management server installation destination:
    • The management server can access your DNS server.
    • The host name is set in the hosts file.

    If the system cannot resolve the management server host name, it might take a long time for Common Services to start.

  • 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, on the User directories window of the Hitachi Ops Center Portal, click the Edit user directory service icon for the Active Directory server, and then change the Group entry list setting 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.
  • Before performing an upgrade installation of Common Services in an environment integrated with an Active Directory or LDAP server: on the Active Directory or LDAP server editing window of Hitachi Ops Center Portal, run a Test connection and Test authentication to ensure that they are successful. For details, see Configuring Active Directory as a directory service for Ops Center or Configuring a non-AD directory service for Ops Center (LDAP server).

    If you perform an upgrade installation without a proper connection or authentication, Active Directory users might be unable to log in to the Hitachi Ops Center Portal.

    Note: If Active Directory users cannot log in to the Hitachi Ops Center Portal in an environment integrated with an Active Directory server, check the connection and authentication with the Active Directory server. After that, log in to Hitachi Ops Center Portal, and click Sync groups on the User directories window to synchronize Active Directory groups with Common Services.
  1. Log in to the management server as the root user.
    If you log on as an ordinary user, use the sudo command to complete the following procedure as the root user.
  2. Run install.sh, which is in the following directory on the installation media:
    root-directory-of-installation-media/COMSERV
  3. To install Common Services, follow the prompts and specify the required information as follows:
    For new installations of Common Services:
    • Installation destination for Common Services
      • The default installation destination for Common Services is as follows:

        /opt/hitachi/CommonService

      • User data for Common Services is stored in the following user data directory:

        /var/installation-directory-of-Common-Services

    • Host name (or FQDN) or IP address
      • 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 of the access URL

      If you install the following products on the same management server, there will be conflicts with the default port number 443. 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, the best practice is to use port number 20950.

      • Protector
      • Administrator
    • Whether access is possible by using an IP address
      Specify whether an IP address can be used to access the Hitachi Ops Center Portal when a host name or FQDN is specified in the access URL.
      • To maintain the default setting of not permitting access by using an IP address, specify y.
      • To permit access by using an IP address, specify n.

        An IP address acquired from the system is automatically set for the access URL.

    For overwrite or upgrade installations of Common Services:
    • Whether to back up the existing Common Services database
    • If yes, the database backup destination
    • If you are upgrading from version 10.9.1 or earlier, whether to continue or interrupt the installation when there is not enough free space on the disk
  4. Check the information you entered and any messages displayed. If there are no problems, press y to begin the installation.
  5. Check the message that appears when installation is complete.
  6. Change the initial password for the built-in account (the sysadmin user) on the Hitachi Ops Center Portal.
    If you use the initial password to log in to the Hitachi Ops Center Portal, the Change password window is displayed. Specify a new password. For details, see Logging in to the Hitachi Ops Center Portal.
  7. 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:
  8. 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 User 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 User 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.