Skip to main content
Hitachi Vantara Knowledge

Install or upgrade Hitachi Ops Center products by using the Server Express installer

If you want to install or upgrade more than one Hitachi Ops Center product at the same time, you can easily install Common Services and one or more of the following products by running the Server Express installer:

  • Hitachi Ops Center Administrator
  • Hitachi Ops Center Protector
  • Hitachi Ops Center Analyzer
  • Hitachi Ops Center Analyzer detail view

Workflow for installing and setting up Hitachi Ops Center

The following figure shows the workflow for using the Server Express installer.
GUID-9DECBA7B-FF61-42CA-B6EF-8A368BB4AF72-low.png

After setting up access control, configure the settings for each product as necessary. For details, see the documentation for each product.

If you are upgrading, the previous settings are preserved. If you upgrade Hitachi Ops Center products that were registered in Common Services, you do not need to configure SSL communication or perform the subsequent steps.

Preparing the management server

Make sure that the management server on which you plan to install Hitachi Ops Center products meets the system requirements.

For the Common Services system requirements, see the Common Services Release Notes. For the system requirements of other Hitachi Ops Center products, see the documentation or Release Notes for each product.

For a complete list of Hitachi Ops Center system requirements, go to the Ops Center documentation site and select Get Started with Ops Center Hitachi Ops Center system requirements.

Note
  • Hitachi Ops Center does not support installing other software products on the management server, but allows for installing software required by corporate policy such as anti-virus programs and third-party monitoring agents. Note that Hitachi Vantara does not take responsibility for or support any interactions between the third-party programs and the Hitachi Ops Center software.
  • When Common Services is installed, the following RPM packages are installed:
    • Amazon Corretto 11
    • PostgreSQL 11
  • Common Services starts the Common Services service by using the postgres user and postgres group created on the management server.

    Configurations where postgres users and postgres groups do not exist on the management server are not supported.

    If the users on the management server are managed by an external authentication server, the Common Services service cannot start when the OS starts.

Make sure that you complete the following actions on the installation destination management server:

  • Specify the repository settings for the yum command because the Server Express installer uses the yum command to install prerequisite packages. For details, see the documentation for the relevant OS.
  • Administrator requires a supported version of container runtime as follows:
    • Docker (for Red Hat Enterprise Linux 7 or Oracle Linux 7)

      Install Docker in advance.

    • Podman (for Red Hat Enterprise Linux 8 or Oracle Linux 8)

      If a supported version of Podman is not installed on the management server, it is installed from the repository by using the yum command when Administrator is installed. Configure the repository settings in advance so that the package can be installed over the network. For the installation method, see the Administrator manual.

NoteIf you run the Server Express installer, the iptables and firewalld settings are changed so that required communications can be established. If you use nftables, you must make the changes manually.

Installing or upgrading Common Services and additional products (article)

Installing or upgrading Common Services and additional products

To install or upgrade Common Services and one or more products, use the Server Express installer.

Before you begin

  • 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.

  • In Common Services version 10.9.1 and later versions, 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 normal purposes. For this reason, if you want to upgrade from version 10.9.0 or an earlier version, first make sure that the support-services group has not been created.
    • If the support-services group was imported through linkage with the 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 has created the support-services group through means other than linkage with the Active Directory server, delete or rename the group before upgrading from version 10.9.0 or an earlier version.
    NoteIf you upgrade Common Services from version 10.9.0 or an earlier version while the support-services group exists, you will need to delete or rename the support-services group and then perform an overwrite installation of Common Services.

Procedure

  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 in the installation media:

    root-directory-of-the-installation-media/install.sh

  3. Choose the product you want to install, and then press Enter.

    To select multiple products, separate the numbers with commas. (Example: 2,3)
  4. When performing a new installation of Analyzer, set the memory size by choosing one of the following scale values:

    • 1: Small-scale configuration
    • 2: Medium-scale configuration
    • 3: Large-scale configuration
    NoteFor details on the system requirements for each product according to the scale, see Hitachi Ops Center System Requirements.
  5. 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.

      Common Services will be installed in the following directory:

      specified-directory/CommonService

      The default installation destination for Common Services is as follows:

      /opt/hitachi/CommonService

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

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

      NoteYou cannot specify the following directories:
      • /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:

      • Hitachi Ops Center Protector
      • Hitachi Ops Center 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 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 destination by using no more than 150 bytes and only the following characters:

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

      NoteYou 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 Protector:
    Setting items

    Description

    Install directory

    For a new installation:

    Specify the directory in which to install Protector:

    specified-directory/protector

    The default installation destination for Protector 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 Analyzer:
    Setting items

    Description

    Install directory

    For a new installation:

    • Specify the directory in which to install Analyzer:

      specified-directory/Analytics

      The default installation destination for Analyzer 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 storage destination is /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.

  6. Check the information you entered. If there are no problems, press y to begin the installation.

  7. 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.

    NoteIf registration with Common Services displays Failed. status, you must register the product manually after the installer completes. For details, see Registering products in Common Services.

Configuring SSL communications

By default, Common Services uses SSL/TLS communications. Immediately after installation, the system uses SSL communication by using a self-signed certificate. However, you must set up SSL communications to use a valid server certificate before any of the products can communicate with Common Services and the Hitachi Ops Center Portal.

For details on how to configure SSL communications, see Configuring SSL communications.

Next steps

When you finish configuring SSL communications, return to this chapter and go to the next section.

Registering products in Common Services

To use the functions provided by Common Services, you must register products in Common Services.

Products installed by using the Server Express installer can be registered during installation. In the following cases, you must run the setupcommonservice command for each product:

  • If you did not register the product during installation
  • If the product registration failed
  • If you installed a product separately
NoteYou cannot unregister a Hitachi Ops Center product using the setupcommonservice command. Instead, delete the product instance in the Hitachi Ops Center Portal.

Next steps

Logging into the Ops Center Portal

Before you begin

To avoid issues with windows not displaying correctly, configure your browser settings as follows:

  • Accept cookies, or register the portal URL as a trusted site.
  • Enable active scripting in the security settings.

Procedure

  1. In a web browser, access the following URL:

    https://host-name-or-IP-address-of-Portal:port-number/portal/

    When entering the URL to access the portal, enter the host name or IP address and the port number that were specified during installation. The default port number is 443.

    TipBy default, you can access the Hitachi Ops Center Portal by using both the host name and IP address. To change the settings so that users can only access the Portal by using the host name, or to change the host name or IP address used to access the Hitachi Ops Center Portal, use the cschgconnect command. For details about the cschgconnect command, see Changing the management server host name, IP address, or port number.
  2. Use the following built-in account to log in:

    User name: sysadmin

    Password: sysadmin

    The Hitachi Ops Center Portal main window opens.

    NoteFor security, be sure to change the password of the built-in account.

Next steps

If you performed a new installation, perform the following setup on the Hitachi Ops Center Portal. If you performed an upgrade installation, the previous settings are inherited, so you do not need to perform the following setup.

For details, see the Hitachi Ops Center Portal Help.

Installing OS updates and other products after installation

The following table outlines the installation tasks for operating system patches and Hitachi Ops Center updates where the installer is used.

Task

Implementation method

Apply operating system patches

Apply as needed.

Update the operating system

You can update the OS as described in Applying Linux security updates using yum.

Upgrade Hitachi Ops Center products

For an upgrade installation or overwrite installation, use the express installer or product installer.

Install additional Hitachi Ops Center products

Confirm the system requirements of the products, install prerequisite packages, and reconfigure kernel parameters as necessary. For details on the product system requirements, see the documentation or Release Notes for each product.

Settings required when using a virus detection program

If a virus detection program accesses database-related files used by Common Services, an error might occur for reasons such as I/O delays or file locks. To prevent such errors while Common Services is running, exclude the following directories from the targets scanned by the virus detection program:

  • /usr/pgsql-11/bin
  • installation-directory-of-Common-Services/nginx/temp
  • /var/installation-directory-of-Common-Services
For details on the directories of other Ops Center products to exclude from the scanning targets, see the manual for each product.