Registering the Ops Center Administrator server with Ops Center

You can register the Ops Center Administrator server with the Ops Center portal by running a script that comes with the software. After running this script, you can access Ops Center Administrator from the portal using the Ops Center credentials and call Ops Center Administrator APIs using the Ops Center access token.

Note: If you installed using the Ops Center OVA, Ops Center Administrator is already registered in Common Services.

Note: You cannot unregister Ops Center Administrator using the setupcommonservice command. To delete products, use the Ops Center portal.

If Ops Center Administrator was installed with the application installer (not preconfigured media), install Python3 to run the script.
Verify the following:
- Host name of Ops Center Common Services is resolvable from the Ops Center Administrator server. If you want to use a host name that is not an FQDN, set the IP address and the host name in the /etc/hosts file for name resolution.
  Note: After modifying the /etc/hosts file, run the following command to restart the Ops Center Administrator-related service.
  For the Docker environment, run:
```
# systemctl restart docker
```
  For the Podman environment, run:
```
# systemctl restart rainier
```
- Ops Center Administrator server and the Common Services server are running.
- Ops Center Common Services server is running v10.0.0-01 or later.
- A user account exists with Common Services that has the "Application Administrator" role to run the script.

To register Ops Center Administrator with the Ops Center portal:

Either open an SSH connection to the VM or open the VMware console and press Alt F2 to reach the console.
Log in as a root user or a normal user. If you log in as a normal user, use the sudo command to complete the following procedure as the root user.
Run the /opt/rainier/bin/setupcommonservice script with the following parameters:

csUsername

The Common Services username (optional). If you do not specify the csUsername option, you can input the Common Services username using interactive mode.

csUri

The URL of the Common Services server (required).

applicationHostAddress

The Ops Center Administrator server host name or an IP address (required).

applicationPort

The Ops Center Administrator port number (required).

applicationName

The Ops Center Administrator name to display in the Ops Center portal (required).

applicationDescription

A description of the Ops Center Administrator server to display in the Ops Center portal (optional).

tlsVerify

Indicates that Ops Center Administrator must perform SSL certificate verification when communicating with Ops Center. If set, you must select the csUriCACert option (optional).

csUriCACert

The CA certificate file to use for certificate verification when communicating with Ops Center. This option is mandatory if you set the tlsVerify option.
After the command runs successfully, Ops Center Administrator is shown in the portal.

Note: If both Ops Center Administrator and Ops Center Common Services are v10.9.0 or later, the token authentication time-out configured in Ops Center Common Services is reflected in Ops Center Administrator automatically. This time-out configuration applies not only to users managed in Ops Center Common Services, but also to local users in Ops Center Administrator. For more details, please check the Portal Help for Ops Center Common Services.

Note: In Ops Center Administrator, the Auto-refresh setting configured in the Ops Center Portal is ignored.

The following is an example of running the command:

# /opt/rainier/bin/setupcommonservice --csUsername sysadmin --applicationPort 443 --csUri https://common-services.example.com/portal --applicationHostAddress administrator1.example.com --applicationName MyAdministrator1 --applicationDescription foobar
Registering with following values:
Hostname: administrator1.example.com
Application Port: 443
Display Name: MyAdministrator1
Application Description: foobar
Registration Successful

You can change the registered Ops Center Administrator server name and description in the portal. If you want to change other properties such as host name, port number, and so on, first remove Ops Center Administrator from the portal, and then run the script again with the required parameters.

Note: You must synchronize the time between the Ops Center Administrator server and the Ops Center Common Services server. Use NTP to synchronize the time between the servers.