Integrate > SA-uCMDB integration > Set up the integration

Set up SA-uCMDB integration

To set up this integration as an administrator:

  • Download the SA-uCMDB Connector
  • Enable and start the SA-uCMDB Connector

set up the SA-uCMDB Connector, customize SA data sent to the SA-uCMDB Connector, transfer SA custom attributes to uCMDB, and customize data conversion functions.

Downloading the SA-uCMDB Connector

With the SA-uCMDB Connector, the SA Client provides the ability to launch the uCMDB Browser-Impact widget against an SA managed server.

The SA-uCMDB Connector is installed when you install SA. No separate installation is required.

If you are upgrading to Server Automation 10.50 and later, the uCMDB Server must already be upgraded to release 10.01 or later.

To download the latest Cumulative Update Package:

This SA version requires uCMDB 10.01 or later. uCMDB 10.01 includes Content Pack 12.

The latest CUP HPE Software Patch is available on the SSO Portal at the following locations:

Linux:   https://softwaresupport.hpe.com/group/softwaresupport/search-result/-/facetsearch/document/LID/UCMDB_00150

Windows:  h
ttps://softwaresupport.hpe.com/group/softwaresupport/search-result/-/facetsearch/document/LID/UCMDB_00150

This site requires that you register for an HPE Passport and sign in.

For version support information, see the SA Support and Compatibility Matrix on the HPE Software Support site.

Starting and enabling the SA-uCMDB connector

Run the start command to restart the SA-uCMDB Connector:

/etc/init.d/opsware-sas start telldaemon

(Optional) Check the status of the SA-uCMDB Connector with the following command:

/etc/init.d/opsware-sas status telldaemon

For more information, see Displaying the status of the SA-uCMDB connector.

Before starting the SA-uCMDB connector, you must enable it to provide the following information: uCMDB server name or IP address, port number, login, and password. The enable command is located on your SA core server in the directory /opt/opsware/tell/bin.

To enable and start the SA-uCMDB connector, run the enable command to change the configurations of the SA-uCMDB Connector. There are multiple options for the enable command depending on your configuration.

The following is a simple example of this command:

enable --host myserver01.hpe.com --port 8888 --user ucmdb-admin

 --password leM93A3dme

For more information about the complete set of parameters, syntax, and options, see The enable command.

The enable command

Before you can start the SA-uCMDB Connector, you must enable it with the enable command. When you enable it, you provide the uCMDB server name or IP address, port number, login, and password.

Use the enable command to configure and enable the SA-uCMDB Connector. This section describes the enable command. You must enable the SA-uCMDB Connector before you can start it.

The enable command does the following:

Creates a custom SA-uCMDB Connector configuration file, /etc/opt/opsware/tell/tell_custom.conf, if it does not already exist. (By default, the custom configuration file does not pre-exist upon deployment unless one has been created manually.)

Modifies the custom configuration file, /etc/opt/opsware/tell/tell_custom.conf, and enters the uCMDB server’s host name or IP address, port number, and login into this file.

Saves the user’s password.

Modifies the file /opt/opsware/oi_util/startup/components.config and uncomments the lines for the telldaemon, which is the process for the SA-uCMDB Connector.

If you modify any of the uCMDB configuration parameters while the SA-uCMDB Connector is running, you must stop and restart the SA-uCMDB Connector for your changes to take effect.

Location of the enable Command

The enable command is located on your SA core server in the directory /opt/opsware/tell/bin.

New syntax in the enable command

In SA 9.14, additional parameters were added to the SA-uCMDB Connector’s enable command in order to support the new uCMDB Browser. The new parameters are described in this section and in New parameters for the enable command.

enable [--protocol <ucmdb_protocol>] [--host <ucmdb_host_ip>] [--port <ucmdb_host_port_number>] [--browser_protocol <ucmdb_browser_protocol>] [--browser_host <ucmdb_browser_host_ip>] [--browser_port <ucmdb_browser_host_port>] [--user <ucmdb_admin_user>] [--password <ucmdb_admin_password>] [--help]

New parameters for the enable command

Parameter

Description

New

--protocol <ucmdb_protocol> 

uCMDB server protocol, http or https. Default is http.

New

--host <ucmdb_host_ip>

This option gives the IP address or host name of your HPE uCMDB server. The default value is localhost.

--port <ucmdb_host_port_number>

This option gives the port number of your HPE uCMDB server. The default value is 8080.

--browser_protocol <ucmdb_browser_protocol> 

uCMDB Browser server protocol, http or https. Default is http.

New

--browser_host <ucmdb_browser_host_ip> 

This option gives the IP address or host name of your HPE uCMDB Browser host name or IP. The default value is localhost.

New

--browser_port <ucmdb_browser_host_
port>

This option gives uCMDB Browser host port. The default value is 8080.

New

--user <ucmdb_admin_user>

This option gives the user name of an administrative user for your HPE uCMDB server. The default value is admin.

--password <ucmdb_admin_password>

This option gives the password for the user provided in the --user option. The default value is admin.

Example of enable command without SSL enabled:

enable –-protocol http --host 192.168.8.93 --port 9999 –-browser_protocol http –-browser_host 192.168.8.100 –-browser_port 8888 --user john-ucmdb --password mypass1234

Example of enable command with SSL enabled for the uMCDB Server and the uCMDB Browser:

enable –-protocol https --host 192.168.8.93 --port 9999 –-browser_protocol https –-browser_host 192.168.8.100 –-browser_port 8888 --user john-ucmdb --password mypass1234

Displaying the status of the SA-uCMDB connector

To display the status of the SA-uCMDB Connector, enter the following command on an SA core server:

/etc/init.d/opsware-sas status telldaemon

If the SA-uCMDB Connector is enabled but not running, the output will look like the following:

Verify "telldaemon" running: FAILURE (pidfile does not exist)
Failed to perform "status" operation on Opsware SAS components.

If the SA-uCMDB Connector is disabled, the output will look like the following:

opsware-sas: One or more of the specified components does not exist in the following file:
/opt/opsware/oi_util/startup/components.config

Stopping and disabling the SA-uCMDB connector

If the SA-uCMDB Connector is running, you must stop and disable the Connector before making any kind of configuration change.

The stop command

When you stop the SA-uCMDB Connector, it will stop transferring data from the SA database to uCMDB. To stop the SA-uCMDB Connector, enter the following command on an SA core server:

/etc/init.d/opsware-sas stop telldaemon

This stops the SA-uCMDB Connector.

If the SA-uCMDB Connector is disabled, the output will look like the following:

opsware-sas: One or more of the specified components does not exist in the following file:

/opt/opsware/oi_util/startup/components.config

If you no longer need the SA-uCMDB Connector, you can disable it with the disable command. For more information, see The disable command.

The disable command

Use the disable command to disable the SA-uCMDB Connector. If the SA-uCMDB Connector is running, the disable command will stop it before disabling it. If the SA-uCMDB Connector is disabled, you will not be able to start it.

The disable command modifies the file /opt/opsware/oi_util/startup/components.config and comments out the lines for the telldaemon, which is the process for the SA-uCMDB Connector.

Location of the disable Command

The disable command is located on your SA core server in the directory /opt/opsware/tell/bin.

Syntax of the disable Command

/opt/opsware/tell/bin/disable

To stop and disable the SA-uCMDB Connector:

Run the stop command to stop the SA-uCMDB Connector:
/etc/init.d/opsware-sas stop telldaemon

Run the disable command to disable the SA-uCMDB Connector:
disable

Note Make sure the connector is stopped and disabled before making any configuration change. If the connector is not stopped and disabled, you may encounter problems when you try to restart the Connector.