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.
If you used an individual installer to install each product, run the setupcommonservice command to register each product in Common Services.
If you do not need to register products in Common Services, go to Initial setup using the Hitachi Ops Center Portal.
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 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}
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.