If you want to use the functions provided by Common Services, such as the Portal window, user
management, or single sign-on, run the setupcommonservice
command to register each product with Common Services.
When you deploy the Hitachi Ops Center OVA file, each product is registered
with Common Services. In
this case, go to Initial setup using the Hitachi Ops Center Portal. In the following cases, you must run the setupcommonservice command for each product:
- If you want to use a product that was installed by using a method other than the Ops Center OVA, register the product in Common Services.
- If you deployed the Ops Center OVA to multiple management servers, decide which management server to use as the Common Services host, and then re-register the products installed on the other management servers to the central Common Services instance.
Note: You cannot unregister a Hitachi Ops Center product using the setupcommonservice command. To delete products, use the Hitachi Ops Center
Portal.
- 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 where Common Services is installed and run the cschgconnect.sh command.
- Ensure that the Hitachi Ops Center product server and the Common Services server are running.
- For the Common Services account to be specified for the setupcommonservice command, specify a user who belongs to the opscenter-administrators group.
Note: If you change the Common Services host name, IP
address, or server port number changes, you must register each product again.
The location of the setupcommonservice command, command syntax, and command examples for each
product are as follows:
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 20961 --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 20964
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}
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:
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
When the Hitachi Ops Center products are registered in Common Services, go to Initial setup using the Hitachi Ops Center Portal.