To prepare BMC Atrium CMDB for Entuity
To prepare the Entuity server for integration
Scheduling the transfer of data to BMC Atrium CMDB
Configuring the integration
Configuring the Entuity server
Creating the export database
Configuring the integration
Configuring the Entuity server
Creating the export database
To complete the module configuration
Populating the target Data Export database
Exporting data to the intermediate Atrium database
Viewing the transferred data
Exporting data to the intermediate Atrium database
Viewing the transferred data
To use the integration in Entuity multi-server environments
To install the Entuity integration for BMC Atrium CMDB, you must have Administrator rights.
Entuity Support advises that Entuity and BMC Atrium CMDB are installed to different servers to avoid potential resource conflict issues.
To prepare BMC Atrium CMDB for Entuity:
- Copy the BMC Atrium CMDB server configuration files from the Entuity server to the BMC Atrium CMDB server. You do this by copying the directory entuity_home/integ/Atrium/extension to the local file system on the Atrium server. The extensions folder includes ExtensionLoader.xml and the sub-folder 200-EYE which contains the integration configuration files.
- Run the BMC Atrium Extension Loader. Access to the loader and instructions on how to run it vary, depending on your environment and BMC Atrium CMDB version. Consult the BMC documentation for details on using the BMC Atrium Extension Loader. The loader installs the changes required to the Atrium installation, e.g. scheme changes, job definitions, reconciliation rules, federated link definitions, dataset definitions.
For example:
To install the Entuity integration to a Windows install of Atrium 8.1.00:
To install the Entuity integration to a Windows install of Atrium 8.1.00:
- From atrium_install_folder/BMC Software/AtriumCore\atriumcore, run
AtriumCoreMaintenanceTool. - From the Extensions tab, enter the path to the Entuity extension file ExtensionLoader.xml and click Next.
- Enter the administrator login details.
- Click Next to install the Entuity extension.
To prepare the Entuity server for integration:
- Scheduling the transfer of data to BMC Atrium CMDB:
- atriumExporter controls the transfer of data from the Data Export database to the BMC Atrium CMDB import database. By amending its configuration files, you can schedule atriumExporter so it is run automatically by provost:
- In entuity_home/etc/provost_site_specific.conf, uncomment (remove the hash sign (#)) the reference to provost_atrium_exporter.conf:
!${ENTUITY_HOME}/etc/provost_atrium_exporter.conf
provost_atrium_exporter.conf configures provost to run atriumExporter every day at 03:00:
job atriumExporter {
count 1, start @03:00:00, repeat forever, interval 24h, command '${ENTUITY_HOME}${FPS}integ${FPS}Atrium${FPS}bin${FPS}atriumExporter'
}
- In entuity_home/etc/provost_site_specific.conf, uncomment (remove the hash sign (#)) the reference to provost_atrium_exporter.conf:
- To schedule provost to run atriumExporter at a different time than the supplied configuration file, you can create your own configuration file. This preserves your changes during Entuity upgrades. For example, to run atriumExporter every 12 hours, rename the file to provost_atrium_exporter_12.conf and amend its configuration:
- Copy provost_atrium_exporter.conf, rename the copy and amend its definition:
job atriumExporter {
count 1, start @03:00:00, repeat forever, interval 12h, command
'${ENTUITY_HOME}${FPS}integ${FPS}Atrium${FPS}bin${FPS}atriumExporter'
} - In entuity_home/etc/provost_site_specific.conf, include a reference to the new
configuration file:
!${ENTUITY_HOME}/etc/provost_atrium_exporter12.conf
- Copy provost_atrium_exporter.conf, rename the copy and amend its definition:
- atriumExporter controls the transfer of data from the Data Export database to the BMC Atrium CMDB import database. By amending its configuration files, you can schedule atriumExporter so it is run automatically by provost:
- Configuring the integration:
Through configure, you can define the location of the Entuity server, the connection to the Data Export database, and the connection to the BMC Atrium CMDB server.
- You can set the connection to the Data Export database on the BMC Atrium Integration page in configure:
Field Name Field Description Entuity Server enter a fully qualified DNS name or an IP address of the Entuity server. The utility will try to resolve the IP address if localhost or loopback address is specified. Database Server enter the name of the server that holds the Data Export database. You can also enter the database port using the format server:port, e.g. compressor:3306. Database User enter the name of the user account used to manage the Data Export target database. Database Password enter the password of the user account used to manage the Data Export target database. Database Name enter the of the Data Export database to which Entuity data is written before it is transferred to BMC Atrium CMDB. When you run atriumExplorer with the create database parameter, it uses this value to name the database. - You can also set the connection to the BMC Atrium CMDB server on the BMC Atrium Integration page in configure:
Field Name Field Description Atrium Server enter the name of the Atrium server. Atrium Port enter the port. When set to 0, the default port is used. Atrium User enter the name of the Atrium user account. Atrium Password enter the password of the Atrium user account. Atrium Dataset ID enter the name of the import dataset to which the Entuity data is written before reconciliation rules are applied. E.g. for the sample integration, the dataset is ENTUITY.IMPORT.TOPO. Atrium Dataset Trusted enter either true or false. When true, BMC Atrium CMDB considers the dataset as trusted. When set to false, it does not consider the dataset as trusted. The trustedDataset setting should match the setting for the dataset in BMC Atrium CMDB.
- You can set the connection to the Data Export database on the BMC Atrium Integration page in configure:
- Configuring the Entuity server:
- Install a license enabling the Entuity integration for BMC Atrium CMDB.
- Stop the Entuity server, run configure and include the Entuity integration for BMC Atrium CMDB.
- Complete the Entuity integration for BMC Atrium CMDB page.
- Complete configure and start the Entuity server.
- Creating the export database:
- From the command line, navigate to entuity_home/integ/Atrium/bin.
- Run atriumExporter:
atriumExporter --createDatabase
To complete the module configuration:
Entuity Support recommend that you check the flow of information by initiating the first data export and monitoring its progress.
- Populating the target Data Export database:
- In the Main Menu, click Administration.
- Under Export, click Jobs. This will open the Jobs page.
- Under Existing Jobs, find the ~AtriumExport job.
- Click View and then from the Data Export Job details page, click Test Connection. This tests the connection to the Data Export target database, using details entered through Atrium.cfg.
- Click Enabled. Entuity will display a window indicating the export job is scheduled to run.
- Click Run. Entuity will display a window indicating the export job is running.
- Click History to view the success or failure of the export.
- Exporting data to the intermediate Atrium database:
- From the command line on the Entuity server, navigate to entuity_home/integ/Atrium/bin.
- Run atriumExporter:
atriumExporter
atriumExporter reports the progress of the transfer.
- Viewing the transferred data:
- By default, atriumExport will transfer data to the reserved location, which is the ENTUITY.IMPORT.TOPO dataset. You can use the BMC Atrium CMDB console to identify transferred data.
To use the integration in Entuity multi-server environments:
To use the Entuity integration for BMC Atrium CMDB when you have installed more than one Entuity server:
- Install multiple Entuity servers as usual.
- On each server, configure the Entuity integration for BMC Atrium CMDB, ensuring all instances of atriumExporter export to the same BMC Atrium CMDB. The exported data includes the identity of the exporting Entuity server, which allows you to access Entuity in context from BMC Atrium CMDB.
Comments
0 comments
Please sign in to leave a comment.