Using UCMDB Integration Studio to Setup Integration with Service Manager

Transcription

1 Using UCMDB Integration Studio to Setup Integration with Service Manager Exercise 2.2 To: From: Subject: C. Michael, C. Michael DanBury, CMDB Manager Jennifer Falcon, System Administrator Universal CMDB Integration Studio Practice using the UCMDB Integration Studio to set up data push from the UCMDB into Service Manager. Thanks, Jennifer Tasks to Complete This Exercise Delete existing SM Integration Point Create and map integration TQL Create a new Integration Point for Service Manager Create and run Data Push jobs to replicate data in Service Manager Define integration from SM to UCMDB View CIs pushed from UCMDB into Service Manager Replicate new attributes from UCMDB to SM Change an attribute on a CI in UCMDB View the updated attribute from the Actual State tab in Service Manager Deleting existing SM Integration Point In this section, delete the existing Service Manager Integration Point. 1. From the desktop, double-click on the Internet Explorer short-cut icon. 2. Click the UCMDB link on the ITSM Demo Environment page that opens (If this launch page does not load, enter the following URL: 3. Log into the UCMDB using User Login: admin and User Password: hpswdemo$09! HP Restricted 2.2 1

2 CCRM 9.x: Essentials 4. Click Login. 5. Click the Data Flow Management tab. 6. Click Integration Studio to load the Integration Studio page. 7. From the Integration Studio, view the list of Integration Points. 8. Select sm. Note: On the right hand side, there are two types of integration types with Service Manager: Federation and Data Push. 9. Select the Federation tab and review the integration setup. 10. Select the Data Push tab and review the integration setup HP Restricted

3 Using UCMDB Integration Studio Note: Two jobs are defined. One to push the configuration items to Service Manager and another to push the relationships among the configuration items to Service Manager. 11. Double-click cmdb2sm job to review the job configuration details. Note: The queries listed define the information that is pushed to Service Manager. Those listed are provided out-of-the-box for UCMDB and SM integration. As part of this exercise, you will learn how to customize the data pushed to SM. 12. Click OK. 13. Click the Delete Integration button in the Integration Point pane. 14. Click OK to confirm that you want to delete this Integration. Creating and mapping integration TQL 15. Click Modeling in the bottom part of the left navigation bar. 16. Click Modeling Studio. 17. If not already selected, select the Resources tab. 18. From the Resource Type field, select Queries. HP Restricted 2.2 3

4 CCRM 9.x: Essentials 19. Expand Integration > SM Sync. 20. Select and right-click the hostdata TQL definition, and select Save As HP Restricted

5 Using UCMDB Integration Studio 21. The Save Query window appears. 22. In the Query Name field, enter DataPushNodes. 23. Click OK. The DataPushNodes map displays. 24. Select and right-click Root in the TQL map, and then select Query Node Properties. 25. From the Attribute tab, click Delete to delete all the attribute conditions. Note: Conditions can be created here to limit what CIs are pushed to Service Manager. Note: Do not delete the conditions defined on the other tabs, Cardinality, Qualifier and Identity. 26. Click Query Result Count and make sure you have 19 Root nodes. HP Restricted 2.2 5

6 CCRM 9.x: Essentials 27. Click OK. 28. Click OK. You will see an asterisk on the tab called DataPushNodes. You need to save the changes you have made. 29. From the main toolbar, click Save. Now, map the new TQL definition. 30. Click Data Flow Management in the bottom part of the left navigation bar. 31. Click Adapter Management. 32. Expand ServiceManagerAdapter7-1 > Configuration Files HP Restricted

7 Using UCMDB Integration Studio 33. Click ServiceManagerAdapter7-1/smSyncConfFile.xml. 34. Type the following XML under the <mapping> node: <tql name="datapushnodes" xslfile="host_data.xslt"> <request type="create" name="createucmdbcomputerrequest"/> <request type="update" name="updateucmdbcomputerrequest"/> <request type="delete" name="deleteucmdbcomputerrequest"/> </tql> HP Restricted 2.2 7

8 CCRM 9.x: Essentials Note: this added configuration tells the integration to use the new DataPushNodes TQL, but it is still using the host_data.xslt for the data translation details. We will look at this later in the course when we add fields to replicate from UCMDB to SM. 35. Click OK to save your changes. Using UCMDB Integration Studio to Create Integration Point to Service Manager In this section, create a new integration point to Service Manager. Afterwards, push data into Service Manager. 36. From the Navigator, click Data Flow Management. 37. Click Integration Studio to load the Integration Studio page. 38. From the Integration Studio, view the list of Integration Points. 39. Click New HP Restricted

9 Using UCMDB Integration Studio The Create New Integration Point window opens. 40. From the Integration Properties section, enter the following: a. Enter sm in the Integration Name field. b. Optionally, in the Description field, enter Service Manager integration. c. In the Adapter field, select Service Manager 7.1x, since it is the closest release to SM d. Make sure the Is Integration Activated field is selected. 41. From the Connection Properties section, enter the following: a. From the Credentials field, select Generic Protocol and the credentials listed there. The user name (smucmdbint) and password has already been entered for us; do not modify. b. In the Hostname/IP field, enter the fully qualified hostname of the Service Manager server. In this case, enter smrc.advantageinc.hpswdemo.com. HP Restricted 2.2 9

10 CCRM 9.x: Essentials 42. Click Test connection. 43. Click OK upon successful connection HP Restricted

11 Using UCMDB Integration Studio Creating and running Data Push jobs to replicate data in Service Manager Next, define the jobs to push the data from UCMDB to SM. Note: On the right side, Population, Federation, and Data Push tabs appear. 44. Select the Data Push tab on the right hand side. 45. Click the plus sign to add a new UCMDB job. The Create New Job Definition window opens. 46. In the Name field, enter cmdb2sm. 47. From the Select the Job Type field, select Changes. 48. From the Query Name section, add appropriate TQL queries by doing the following: a. Click the plus sign to add a query definition. b. Select the DataPushNodes TQL query from the list. c. Click OK. HP Restricted

12 CCRM 9.x: Essentials 49. Repeat the process as described in the previous step to add the following TQL queries to the list (these are found under Integration > SM Sync. Note: you may select multiple items to add at one time): a. applicationdata b. businessservicedata c. hostdata d. networkdata e. printerdata 50. From the right hand side of the list, check Allow Deletion for all queries. 51. Click OK to save the job definition. Define another job for the relationship data. 52. Click Add to define another job definition HP Restricted

13 Using UCMDB Integration Studio The Create new Job Definition window opens. 53. In the Name field, enter cmdb2smrels. 54. In the Select Job Type field, select RMI. Note: If the UCMDB contains relationship data, put the *relations* TQLs into the RMI job type and all others into the Changes job type. 55. From the Query Name list, click Add (plus sign) to add a TQL query definition. 56. From the Available Queries window, expand Integration > SM Sync. 57. Multiple select the following query definitions: a. applicationrelationsdata b. businessservicerelationsdata c. hostrelationsdata 58. Click OK to save the job definition. 59. From the main toolbar, click Save. Now, run the jobs to push data from UCMDB to SM. 60. Select the first job definition cmdb2sm. 61. Click Run Full Job for data push. 62. To check the status, click the Statistics button. If the Start Time from the latest replication job is not listed, click the Refresh button. HP Restricted

14 CCRM 9.x: Essentials 63. Click OK to close the Replication Job Statistics window. The replication job is complete. 64. Select the other job definition cmdb2smrels, and then click Run Full Job. 65. To check the status, click the Statistics button. 66. Click OK to close the Replication Job Statistics window. 67. Logout of the UCMDB interface. Defining integration from Service Manager to UCMDB Note: these steps are already done in the virtual environment, but you can step through them to ensure you are familiar with them. 68. From the student lab environment, click the CCRM-SMRCv5d tab at the top of the Internet Explorer window to go to the Service Manager server system. 69. Open a web browser, and then click the Service Manager link. 70. From the SM Login page, in the Login Name field, enter falcon. 71. In the password field, enter: hpswdemo$09! 72. Click Log in HP Restricted

15 Using UCMDB Integration Studio 73. From the left pane, expand System Administration Base System Configuration Miscellaneous and click System Information Record. 74. Click the Active Integrations tab. 75. Check HP Universal CMDB. 76. Fill the following information: a. UCMDB webservice URL: ces/ucmdbsmservice b. User Id: admin c. Password: hpswdemo$09! 77. Click Save. Note: When the System Information Record is changed, log out and log back in to see the change applied. Viewing CIs in Service Manager 78. From the left pane, expand Configuration Management Resources. 79. Click Search CIs. 80. From the CI Identifier field, enter oba, and then click Search. Note: If you would like, you can verify that all these hosts were replicated from UCMDB by modifying the column display. Click the More icon on the toolbar and select Modify Columns. Click in the first blank line of fields and type U (case sensitive). The field should fill with UCMDB Id. Click the Proceed button, and now you will see the UCMDB Id displayed in the list. HP Restricted

16 CCRM 9.x: Essentials 81. Select obadb Click the Managed State tab. Note: In many environments, these attributes would have originally been pushed (replicated) from the UCMDB or some other source HP Restricted

17 Using UCMDB Integration Studio 83. Click the Actual State tab. Note: These are attributes that do not reside in Service Manager but are available either from the UCMDB (or other tools via the UCMDB federation). HP Restricted

18 CCRM 9.x: Essentials Replicating new attributes from UCMDB to SM 84. Select the CCRM-UCMDB v5d tab from the top of the Internet Explorer window to go to the UCMDB server system. 85. Login as user admin and with the password hpswdmeo$09! 86. Navigate to Modeling > Modeling Studio. 87. From the Root directory, open DataPushNodes query definition. 88. From the query map, select and right-click the Root node. 89. Select Query Node Properties. 90. Click the Advanced Layout Settings button to get the Layout Settings dialog box. 91. Check the Vendor and OsVendor attributes. 92. Click OK. 93. Click OK to close the Query Node Properties dialog. 94. Click the Save button to save the TQL HP Restricted

19 Using UCMDB Integration Studio Add Vendor and OsVendor Attributes to Service Manager and UCMDB Integration 95. Toggle to Service Manager server system by clicking the CCRM-SMRC v5d tab at the top of the Internet Explorer window. 96. Navigate to Tailoring > Web Services, and then click WSDL Configuration. 97. Type ucmdb (lowercase) in the Service Name field, and then click Search. 98. Select ucmdbcomputer web service. 99. Select the Fields tab In the Field column, scroll to the bottom and add vendor field In the Caption column, enter Vendor as the caption In the Field column, scroll to the bottom and add os.manufacturer field In the Caption column, enter OsVendor as the caption Click Save Close the External Access Definition tab Toggle to UCMDB server system by clicking CCRM-UCMDB v5d tab Click Data Flow Management in the bottom part of the left navigation bar Click Adapter Management Expand Service Manager Adapter 7-1 > Configuration Files Open the host_data.xslt file Add the following text under <file.device> section: <xsl:for-each HP Restricted

20 CCRM 9.x: Essentials <Vendor><xsl:value-of select="."/></vendor> </xsl:for-each> 112. Add the following text under <file.computer> section: <xsl:for-each <OsVendor><xsl:value-of select="."/></osvendor> </xsl:for-each> Note: The select statement refers to the attribute name as defined in UCMDB. To determine the field name in UCMDB, go to Modeling > CI Type Manager. Note: The second line refers to the name provided in Service Manager in the WSDL Configuration file. The parameter is the value in the Caption field of the WSDL configuration file Click OK to save the file. Note: the XSLT files map data between the UCMDB CI Type and the SM web service. This file defines which (UCMDB) attribute goes into which (SM) file as defined in the WSDL Configuration Navigate to Data Flow Management Click Integration Studio Select the Service Manager Integration, sm Select the Data Push tab Click the ucmdb2sm job Click the Run Diff Job button Click Yes to run the synchronization job HP Restricted

21 Using UCMDB Integration Studio 121. Click Refresh every 30 seconds or so, until the status changes to Succeeded View the details of the job to ensure that items have been updated. Changing an attribute on a CI 123. Navigate to Modeling Modeling Studio Open the DataPushNodes Integration query (if it is not still open from earlier) From the right pane, select and right-click the Root node, and then select Show Element Instances Right-click obadb2, and select Properties In the Vendor field, enter HP In the OsVendor field, enter Microsoft Click Apply Click OK Click OK to close the dialog. HP Restricted

22 CCRM 9.x: Essentials 132. Navigate to Data Flow Management Click Integration Studio Select the Service Manager Integration, sm Select the Data Push tab Click the ucmdb2sm job Click the Run Full Job button Click Yes to run the synchronization job Click Refresh every 30 seconds or so, until the status changes to Succeeded View the details of the job to ensure that items have been updated. Adding Attribute to the Actual State View in SM You will now add a new attribute to display under the Actual State tab that contains data from the UCMDB Toggle to UCMDB and navigate to Modeling > Modeling Studio Expand Integration > SM Query and double-click the hostextendeddata TQL Right-click the Root node and select Query Node Properties Click Advanced Layout Settings to get the Layout Settings dialog box Check the Vendor attribute, and then click OK Click OK to close the Query Node Properties dialog Click Save to save the TQL In the right pane, right-click Root and select Show Element Instances Find and right-click obadb Select Properties Change the Vendor field value to Hewlett-Packard Click OK Click OK Toggle back to Service Manager and search again for obadb Navigate to Actual State and verify it now includes an attribute for Vendor and reflects the changed value from HP to Hewlett-Packard HP Restricted

23 Using UCMDB Integration Studio 156. In Service Manager, click the Vendor tab and notice the value for Vendor Name still appears as HP because the updated vendor name currently only resides in the UCMDB and was not replicated to Service Manager. HP Restricted