Installing or upgrading Hitachi Ops Center products by using the installer

To install or upgrade, or to create a new Hitachi Ops Center system without using the OVA, install the products by using
the Common Services installer first and then install one or more products using the product installer.

Workflow for installing and setting up Hitachi Ops Center

The general workflow for using the installer for each product is as follows:

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.

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
1
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 17
◦ 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 there are no conflicts among the following port numbers.

• Port number used to access Common Services:

443/tcp (default)

• Port numbers used for internal communication:

◦ 20951/tcp
◦ 20952/tcp
◦ 20954/tcp
◦ 20955/tcp
◦ 20956/tcp

If necessary, register the port number that is used to access Common Services in the firewall exceptions. For details on
how to register firewall exceptions, see the OS documentation.

Installing or upgrading Common Services

To install or upgrade Common Services in an existing environment or to create a Hitachi Ops Center system without
using the OVA, install Common Services by using the installer.
Note

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
2
 • If you install Common Services version 10.9.2 or later, Amazon Corretto 17 is installed. If you upgrade Common
Services, Amazon Corretto 8 (version 10.6.0 and earlier) and Amazon Corretto 11 (versions 10.6.1 to 10.9.1) that
were installed with the previous version are not removed. If you no longer need Amazon Corretto 8 or Amazon
Corretto 11, remove one or both by using the rpm command. If you cannot remove the program 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

• If the Analyzer viewpoint server was deployed by using a version of the OVF earlier than 10.5.1, you cannot use the
installer to upgrade Common Services or Analyzer viewpoint on that server. In this case, deploy the newest version
of the Analyzer viewpoint OVF to upgrade Analyzer viewpoint and Common Services.

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

Before you begin

• 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 the Common Services
to start.
• 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 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 has not
been created.
◦ 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.
NoteIf you upgrade Common Services from version 10.9.0 or earlier while the support-services group exists, you
must 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 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 location in the installation media:

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

3. To install Common Services, follow the prompts and specify the required information.

You must specify the following information during installation:

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
3
◦ 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, we recommend using
port number 20950.
▪ Hitachi Ops Center Protector (formerly Hitachi Data Instance Director)
▪ Hitachi Ops Center Administrator
▪ Hitachi Ops Center Analyzer viewpoint
▪ 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

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
4
 there is not enough free space on the disk

Installing or upgrading each product

You install other products after you install Common Services. For details on the installation procedure, see the
documentation for the individual product.

If you complete an upgrade or overwrite installation of an existing product, the installation destination is the same as the
current installation destination.

NoteIf you upgrade to Hitachi Ops Center Automator or Hitachi Ops Center Analyzer from a version earlier than 10.0,
verify that SSL communication is configured.

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. When you use an
individual installer to install each product, run the setupcommonservice command to register each product in Common
Services.
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

• If you must register products in Common Services, go to the next section.

• If you do not need to register products in Common Services, go to Logging in to the Hitachi Ops Center Portal.

Registering Ops Center products with Common Services (setupcommonservice)

Use the setupcommonservice command to register Ops Center products with Common Services.

Before you begin

• Ensure that each product can resolve the host name where Common Services is installed. If you want to use a host
name that is not a fully qualified domain name (FQDN), set the IP address and the host name in the /etc/hosts
file for name resolution. If you want to use an IP address instead of a host name, log in to the management server

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
5
 where Common Services is installed and run the cschgconnect.sh command.
• Ensure that the Ops Center product server and the Common Services server are running.
• Use a Common Services account with the "Application Administrator" role to run setupcommonservice command.

NoteProducts deployed by using the Ops Center OVA are already registered in Common Services.

If you change the Common Services host name, IP address, or server port number changes, you must register each
product again.

The setupcommonservice command also sets each Ops Center product as an authentication server that uses Common
Services. You can then access the application from the portal using the Ops Center credentials.
Administrator

Default location: /opt/rainier/bin

Command syntax:

setupcommonservice --csUri CommonService_URL --applicationPort port_number --applicationHostAddress ip_

address --applicationName app_name [--appDescription app_description] [--csUsername CommonService_
Username] [--tlsVerify --csUriCACert Certificate_FileName]

Command example:

setupcommonservice --csUri https://example.com/portal --csUsername sysadmin --tlsVerify --csUriCACert

certificate.cer --applicationPort 443 --applicationHostAddress 192.0.2.11 --applicationName MyAdministrator1

Protector

Default location: /opt/hitachi/protector/bin/

Command syntax:

setupcommonservice --cs-uri CommonService_URL [--cs-username CommonService_Username] --app-scheme

protocol --app-hostname host_name --app-port port_number

Command example:

setupcommonservice --cs-uri https://example.com/portal --cs-username sysadmin --app-scheme https --app-

hostname MyHost --app-port 443

Automator

For Linux:

Default location: /opt/hitachi/Automation/bin/

Command syntax:

setupcommonservice {[-csUri CommonService_URL | -csUri CommonService_URL -csUsername

CommonServiceUsername] [-appName app_name] [-appDescription app_description] [-auto] | -help}

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
6
Command example:

setupcommonservice -csUri https://example.com/portal -appName MyAutomator1

For Windows:

Default location: Program-Files-folder\hitachi\Automation\bin

Command syntax:

setupcommonservice {[/csUri CommonService_URL | /csUri CommonService_URL /csUsername

CommonServiceUsername] [/appName app_name] [/appDescription app_description] [/auto] | /help}

Command example:

setupcommonservice /csUri https://example.com/portal /appName MyAutomator1

Analyzer

Default location: /opt/hitachi/Analytics/bin/

Command syntax:

setupcommonservice -csUri CommonService_URL [-csUsername CommonService_Username] [-appPort port_

number] [-appHostname ip_address_or_host_name] [-appName app_name] [-appDescription app_description] [-
auto]

Command example:

setupcommonservice -csUri https://example.com/portal -appPort 22016 -appHostname 192.0.2.10 -appName

MyAnalyzer1

Analyzer detail view

Default location: /usr/local/megha/bin/

Command syntax:

setupcommonservice -csUri CommonService_URL -csUsername CommonService_Username -appHostname

ip_address_or_host_name -appPort port_number -appName app_name -appDescription app_description

Command example:

setupcommonservice -csUri https://example.com/portal -csUsername sysadmin -appHostname MyHost -appPort

8443 -appName MyAnalyzerdetailview1 -appDescription ""

Analyzer probe

Default location: /usr/local/megha/bin/

Command syntax:

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
7
 setupcommonservice -csUri CommonService_URL -csUsername CommonService_Username -appHostname
ip_address_or_host_name -appPort port_number -appName app_name -appDescription app_description

Command example:

setupcommonservice -csUri https://example.com/portal -csUsername sysadmin -appHostname MyHost -appPort

8443 -appName MyAnalyzerprobe1 -appDescription ""

Analyzer viewpoint

Default location: /opt/hitachi/analyzer_viewpoint/bin/

Command syntax:

setupcommonservice --csUri CommonService_URL [--csUsername CommonServiceUsername] [--

applicationName app_name]

Command example:

setupcommonservice --csUri https://example.com

Logging in to the Hitachi Ops Center Portal

Log in to the Hitachi Ops Center Portal from your browser.

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.

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.

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
8
Configuring initial settings in the Hitachi Ops Center Portal
After using an OVA to deploy a Hitachi Ops Center product, you must configure the following settings in the Hitachi Ops
Center Portal.

Configure the following required settings:

• Apply the product licenses.

You must apply the product licenses before using the products.
• Create users and configure settings for user groups.

You must configure settings to control access to the Hitachi Ops Center Portal.

Configure the following settings as needed:

• Link with an Active Directory, LDAP, or identity provider server.

For Active Directory and LDAP, see Linking with an Active Directory or LDAP server. For identity providers, see
Linking with an identity provider.
• Configure the password policy.

Based on your security requirements, you can configure user account password complexity and controls for locking
user accounts after consecutive failed authentication attempts.
• Configure the warning banner for the Hitachi Ops Center Portal.

You can display a message on the login window of the Hitachi Ops Center Portal.

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

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

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
9
Task Implementation method

Upgrade Hitachi Ops Center For an upgrade installation or overwrite installation, use the express installer or
products product installer.

Confirm the system requirements of the products, install prerequisite packages,

Install additional Hitachi Ops and reconfigure kernel parameters as necessary. For details on the product
Center products system requirements, see the documentation or Release Notes for each
product.

https://knowledge.hitachivantara.com/Documents/Management_Software/Ops_Center/10.9.x/Get_Started_with_Ops_Center/…
Updated: Fri, 29 Sep 2023 16:05:42 GMT
Powered by
10