How to Discover HPE SIM Data Center Infrastructure

This task describes how to discover data center infrastructure information stored in an HPE Systems Insight Manager (SIM) system.

This task includes the following steps:

1. Prerequisites

   Important: If you set up an HTTPS connection to connect to the SIM WebService API (that is, an SSL enabled HTTP connection), the SIM Integration job performs no validation of any certificates presented by the SIM server. The job trusts any certificate issued by the HPE SIM server and uses it for SSL enabled communication.

   The following additional requirements must be satisfied for the mapping file to be valid for SIM (for details on the mapping files, see SIM Integration Mechanism):

   • Verify that source and target are SIM and UCMDB respectively.

   • Verify that attribute names specified in the HostCitIdentifierAttributes parameter are included as attributes of each host CIT in the XML file.

     That is, the OSName and DeviceType attributes must be included for each host_node (Computer), chassis (Chassis), netprinter (Net Printer), switch (Switch), nt (Windows), unix (UNIX), hp_complex (Complex), and management_processor (Management Processor) CIT.

   • Verify that default attributes (that is, non-extended attributes) of a node have a Node. prefix in the mapping file.

     That is, you should specify attributes such as OSName, DeviceType, and IPAddress as Node.OSName, Node.DeviceType, and Node.IPAddress.

   • Verify that each Node CIT has the following attribute mapping to enable the generation of the host_key attribute:

     <target_attribute name="host_key" datatype="StrProp" >
         <map type="direct" source_attribute="host_key" />
     </target_attribute>

     Note The host_key attribute is the primary key attribute on Node and derived CITs. Since SIM uses a different type of key attribute, the XML definition for the host_key attribute is included in the mapping file, to enable generation of the host_key primary key attribute.

   • Verify that the IP Address mapping section has the following attribute to enable automatic population of the IP domain attribute:

     <target_attribute name="ip_domain" datatype="StrProp">
         <map type="direct" source_attribute="ip_domain" />
     </target_attribute>
     

     Note For details on the list of SIM nodes and attributes, refer to the SIM documentation.

2. Perform setup on the Probe machine

   1. Copy mxpartnerlib.jar from this directory:

   <DataFlowProbe_Home>\runtime\probeManager\
   discoveryResources\hpsim

   to this directory:

   <DataFlowProbe_Home>\content\lib

   2. Open <DataFlowProbe_Home>\bin\WrapperEnv.conf for editing.

   3. Comment out line ~51 with a hash sign (#) at the beginning so that it looks as follows:

   #set.SYSTINET_CLASSES=%lib%/webservice;.........
   

   4. Save and close the file.

   5. Restart the Probe.

3. Enable chunking - optional

   If the SIM server being discovered contains or manages a large number of nodes (more than 1,000), you should consider enabling chunking (Data Flow Management > Adapter Management > select an adapter > Adapter Management tab > Adapter Parameters pane):

   

   1. To reduce load on the SIM server, if necessary, you can set the ChunkSize parameter in the SIM Integration adapter to a lower value than the default 500.

   2. Populate the dbIP parameter in the SIM Integration adapter with the IP address of the SIM CMS database.

   3. Populate the SIM Database ... fields in the SIM protocol with connection details for the SIM CMS database.

      Note SIM CMS database details (except for the password) are located in the Systems Insight Manager\config\database.props file on the SIM server.

4. Run the job

   Note For details on running an integration job, see "Integration Studio" in the Data Flow Management section of the UCMDB Help.

   In the Integration Studio, create a new integration point.

   1. Provide a name and description for the integration point.

   2. Under Integration Properties > Adapter, select the Systems Insight Manager adapter.

   3. Complete the dbIP field with the IP address of the SIM CMS database.

   4. Under Adapter Properties > Data Flow Probe, select the Data Flow Probe.

   5. Under Adapter Properties > Trigger CI instance select:

   1. Select Existing CI (if you have a valid, existing CI). The Select Existing CI pane appears. Select the CI or

   2. Create New CI (if you need to create a new CI). The Topology CI Creation Wizard appears. Complete the creation of the CI using the Wizard.

   Note For details on the Topology CI Creation Wizard, see "Topology CI Creation Wizard" in the Data Flow Management section of the UCMDB Help.

   6. Save the integration point.

   7. Run the job.