EMC VoyenceControl Integration Module version 4.1.0 BMC Atrium Configuration Management Data Base (CMDB) Guide P/N 300-008-456 REV A01 EMC Corporation Corporate Headquarters Hopkinton, MA 01748-9103 1-508-435-1000 www.emc.com
COPYRIGHT Copyright 2009 EMC Corporation. All rights reserved. Published June 2009 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners. Page 2
TABLE OF CONTENTS COPYRIGHT... 2 TABLE OF CONTENTS... 3 INTRODUCING THE INTEGRATION MODULE FOR BMC ATRIUM CMDB... 4 Introduction...4 Summary of the CMDB Integration...4 System and Platform Requirements...4 VoyenceControl 4.1.0... 4 BMC Atrium CMDB version 2.0.1... 4 Port Requirements...4 INSTALLING THE INTEGRATION FOR BMC ATRIUM CMDB... 5 CMDB-side Installation and Configuration Instructions...5 Create a User...5 Create a Data Set...5 Create the Product Catalog Information for Network Devices...6 Make the VoyenceControl Data Set a Trusted Data Set...6 Add the VoyenceControl ID to the CMDB...7 VOYENCECONTROL-SIDE INSTALLATION AND CONFIGURATION INSTRUCTIONS... 8 Install the Integration Module...8 Configure the Integration Module...8 USING INTEGRATION FOR BMC ATRIUM CMDB... 9 CONCLUSION... 10 WHERE TO GET HELP... 11 Where to get help... 11 INDEX... 12 Page 3
INTRODUCING THE INTEGRATION MODULE FOR BMC ATRIUM CMDB Introduction VoyenceControl provides automation and standardization of network configuration and change management at the device level. Devices include routers, switches, firewalls, Virtual Private Network (VPN) concentrators, and others. These devices are at the foundation of IT infrastructure, and as such, are important configuration items for the Configuration Management Data Base (CMDB). This integration with the CMDB involves VoyenceControl populating network devices and their basic attributes into a data set inside the BMC Atrium CMDB. Note: Reconciliation is not within the scope of the integration. Each customer may have various providers of data into the CMDB, and the reconciliation of the various data sets is a customized process. If you require customization of this module such as customized data mapping, contact your sales representative or EMC professional services. See the Where to Get Help section of this document for more information. Summary of the CMDB Integration The Integration populates the CMDB with Network Devices as CIs (configuration items) The Integration creates instances in the VoyenceControl Data Set The Integration is initiated by an Auto-Discovery of the network, or by updates to devices The Integration retrieves Instance IDs from the CMDB, and stores them within a data field in VoyenceControl called CMDB_ID The Integration uses CMDB API System and Platform Requirements VoyenceControl 4.1.0 Supported Operating Systems: o Red Hat Enterprise Linux 4 o Windows Server 2003 o Solaris 10 BMC Atrium CMDB version 2.0.1 The BMC Atrium CMDB integration module is installed on the application server. Port Requirements Following are the Port Requirements needed for Atrium and Voyence Integration. Java plugin - 9999 Normalization Engine 9555 Atrium plugin 9556 Ais listener port - 1824 Page 4
INSTALLING THE INTEGRATION FOR BMC ATRIUM CMDB CMDB-side Installation and Configuration Instructions The following instructions assume the CMDB has already been installed on the AR System, and the installer is using the Remedy User client application. Notes: It is advisable that the CMDB portion of the installation be completed first. Before Beginning, ensure you have access to the ITSM-Config-Guide-700 document. Create a User If you have not already done so, create a user for the VoyenceControl system. Go to the Application Administration Console. 1. Select People->Create. 2. For the First Name enter: Network Configuration Manager 3. For the Last Name enter: User 4. For the Client Type enter: Vendor 5. Leave Company in the default setting. 6. For the Login ID use: voyence 7. For the Password use: voyence 8. For the License Type use: Fixed 9. Select Update Permission Groups. 10. From the Permission Group combo box, select the following permissions, adding them one by one: AR System->Administrator Foundation->ASE-Administrator Foundation->Approval Admin Problem->Problem Submitter Incident->Incident Submitter 11. Select Close to close the dialog box. 12. On the Main user form, select Add to add this user to the system. 13. Ensure the ITSM (CMDB) Application Administrator is configured correctly. Refer to page 29 in the ITSM-Config-Guide-700 document, and then follow the instructions in the Defining an Application Administrator section. 14. Log out, and log back in as this user to continue the configuration. Create a Data Set In the CMDB Reconciliation Engine, create the following data set: Data Set Name: NCM Network Devices Data Set ID: NetDevDS Accessibility: Writable Dataset Type: Regular Page 5
Create the Product Catalog Information for Network Devices 1. Using the instructions starting from page 194 in the ITSM-Config-Guide-700 document, under the CI type Computer System, create the Product Categorization Structure below. Note that this requires 10 entries, as each entry requires setting Tier 1, 2, 3 together. For example, there will be 10 entries under Computer System, each one with Categorization Tier 1 = Network Device and the Categorization Tier 3 = None. The Categorization Tier 2 for each entry is detailed in the following information, and matches the NCM device types in our system. The capitalization must match exactly as specified. 2. Set the option for Suite Definition to true. CI Type = Computer System Product Categorization Tier 1 = Network Device Product Categorization Tier 2 = Router Product Categorization Tier 2 = Switch Product Categorization Tier 2 = VPN Concentrator Product Categorization Tier 2 = ATM Switch Product Categorization Tier 2 = Firewall Product Categorization Tier 2 = Wireless Device Product Categorization Tier 2 = Layer 3 Switch Product Categorization Tier 2 = Content Cache Device Product Categorization Tier 2 = Load Balancer Product Categorization Tier 2 = VOIP Device Product Categorization Tier 3 = None Make the VoyenceControl Data Set a Trusted Data Set 1. In the ITSM-Config-Guide-700, starting on page 215, follow the instructions under the heading Trusted Data Sets for Product Catalog. 2. Make the NCM data set NCM Network Devices a trusted data set. Page 6
Add the VoyenceControl ID to the CMDB Follow these steps to add VoyenceControl to the CMDB. 1. Click the link to the CMDB console on the home page of the Remedy User application. 2. From the tab menu, select Class Manager. 3. Locate the BMC_ComputerSystem class in the Class Name column, and then select View. 4. Select the Attributes Tab, and click Add. 5. The Attribute Information dialog displays. Select the following from the Add tab options: Data Type = Character Attribute Name = NCMIntegrationId Namespace = BMC.CORE Field ID = (leave empty) Entry Mode = Optional Primary Key = No Hidden = No Attribute Type = Regular Description = Identifier from NCM System 6. Select the Permissions tab. Select the following from the Permissions tab options: Attribute View Permissions = Public Attribute Change Permissions = Public 7. Select the Allow Any User To Submit check box. 8. Select Save. 9. On the Class Manager screen, select Save. It will take a few minutes for the change to be committed. This status is reflected in the Status column of the Class Manager. Page 7
VOYENCECONTROL-SIDE INSTALLATION AND CONFIGURATION INSTRUCTIONS The following Integration Module and Configuration Integration Module instructions assume you have previously installed the VoyenceControl core application. Install the Integration Module 1. Obtain the BMC CMDB Integration Module file: VoyenceControl_x_x_x_yyy_BMC_CMDB20.bin. 2. Change the permissions on file VoyenceControl_x_x_x_yyy_BMC_CMDB20.bin to 755. 3. Add /opt/voyence/lib to the LD_LIBRARY_PATH variable in /etc/voyence.conf. 4. Run VoyenceControl_x_x_x_yyy_BMC_CMDB20.bin. 5. Follow the instructions in the Install Anywhere installation program. 6. After installation, you can either wait for the application server to deploy the module during run time, or you can reboot the application server to pick up the changes. Run time deployment takes approximately ten minutes. Configure the Integration Module 1. Open a browser, and go to the following URL (replace <hostname> with the IP Address or hostname) http://<hostname>:8881/jmx-console 2. Log in with the user name and password given during installation. 3. Under the jboss heading, select the link: service=bmc CMDB Integration Module under vc. 4. Enter the proper values for the ARServerHostname, username, and password. 5. Select Apply Changes, then restart the integration module by clicking the Restart button. 6. Return to the main page by clicking the Back to Agent View link. Page 8
USING INTEGRATION FOR BMC ATRIUM CMDB Once installed and configured, this integration module reacts to events in VoyenceControl related to devices being created and modified. The system automatically populates and updates the CMDB in relation to these events. You do not need to complete any steps to initiate this information exchange. It happens automatically. After the module is installed, you can browse the CMDB to see the network devices populated by VoyenceControl. Page 9
CONCLUSION This integration lays a foundation for populating the CMDB, and for other BMC products to utilize the Configuration Items populated by VoyenceControl. For example, once this integration is in place, other integration modules, such as EMCs Remedy Help Desk or Service Impact Manager integration can link events and trouble tickets directly to the CIs in the CMDB. It is really the first step in a comprehensive program of configuration and change control for network devices and IT assets as a whole. Page 10
WHERE TO GET HELP Where to get help EMC support, product, and licensing information can be obtained as follows. Product information For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at: http://powerlink.emc.com Technical support For technical support, go to EMC Customer Service on Powerlink. To open a service request through Powerlink, you must have a valid support agreement. Please contact your EMC sales representative for details about obtaining a valid support agreement or to answer any questions about your account. Sales and customer service contacts For the list of EMC sales locations, please access the EMC home page at: http://emc.com/contact Page 11
A INDEX Add the VoyenceControl ID to the CMDB, 7 B BMC Atrium CMDB v2.0.1, 4 C CMDB-side Installation and Configuration Instructions, 5 Conclusion, 10 Configure the Integration Module, 8 copyright, 2 Create a Data Set, 5 Create a User, 5 I Install the Integration Module, 8 Installing the Integration for BMC Atrium CMD, 5 Integration module for BMC Atrium CMDB, 4 Introduction, 4 P Port Requirements, 4 Product Catalog Information for Network Devices, 6 S Summary of the CMDB Integration, 4 where to get help, 11 System and Platform Requirements, 4 T Trusted Data Set, 6 U Using Integration for BMC Atrium CMDB, 9 V VoyenceControl 4.1.0, 4 VoyenceControl-Side Installation and Configuration Instructions, 8 Page 12