1. IBM Software Group © 2009 IBM Corporation IBM Tivoli Provisioning Manager 7.1.1 Inventory Extension

2. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Topics  Feature Objective (Problems Solved)  Feature Overview  Common Use Cases

3. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 TPM 7.1.1 Inventory Extension Objective  Define/Create/Run custom inventory scan  View custom inventory scan results via TPM reports

4. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Topics  Feature Objective (Problems Solved)  Feature Overview  Common Use Cases

5. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 TPM 7.1.1 Inventory Extension Overview  Enable users to create their own custom inventory tables  Register custom inventory tables in TPM  Configure to run pre/post custom scripts as part of the regular TPM inventory scan (support for both agent and agentless scan)  Generate/import custom inventory report definitions  View custom inventory reports from TPM web UI

6. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Topics  Feature Objective (Problems Solved)  Feature Overview  Common Use Cases

7. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 TPM 7.1.1 Inventory Extension Common Use Cases  Collect extended data from endpoints and make it available to users in the TPM UI 1.Define data to be collected from the endpoint 2.Prepare to collect the data (pre and post scripts or commands), deploy to endpoints 3.Create custom schema definition in the TPM db 4.Create (define) an inventory extension to TPM referencing the custom schema and endpoint resident scripts/commands 5.Run generated discovery scan 6.View data via generated custom report 7.Change the scan definition 8.Change the generated report 9.Modify the extension definition

8. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Custom Inventory Scans  TPM CIT (inventory) scans can be extended to collect additional data using MIF or XML files: 1.Inventory extensions registered to TPM using the command line. This will define the extension for later use in the discovery configuration. The reporting service will be updated to create a simple report showing the custom inventory and to allow new custom reports to be created against that data. 2.Custom report creation: The operator will be given the ability to create custom reports referencing the extended schema containing the custom inventory data. 3.List and delete inventory extensions is provided as a command line utility. The list command will show the name, pre and post scripts, and the custom table names. 4.Use the discovery configuration UI to select and run a custom inventory scan. 5.The configured discovery is scheduled and executed. The extended data is collected via SDI and stored in the defined extended schema.

9. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Step 1: Define Custom Schema  User defined custom table needs to be modified using the following: ALTER TABLE MY_CUSTOM_TABLE ADD COLUMN discovery_id BIGINT NOT NULL ALTER TABLE MY_CUSTOM_TABLE ADD COLUMN server_id BIGINT NOT NULL ALTER TABLE MY_CUSTOM_TABLE ADD FOREIGN KEY (discovery_id) REFERENCES DISCOVERY(discovery_id) on DELETE CASCADE; ALTER TABLE MY_CUSTOM_TABLE ADD FOREIGN KEY (server_id) REFERENCES SERVER(server_id) on DELETE CASCADE;  There are no restrictions on the column data types

10. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Step 2: Define Scripts and Collected MIF/XML File  MIF as supported by TCM will be converted by TPM to XML, or raw XML: <!ATTLIST custom-table name CDATA #REQUIRED > <!ATTLIST integer-column name CDATA #REQUIRED length (32 | 64) #REQUIRED value CDATA #IMPLIED > <!ATTLIST string-column name CDATA #REQUIRED length CDATA #REQUIRED value CDATA #IMPLIED >

11. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Step 3: Prepare Extension Definition (properties) File  Passed on the command line in the create extension operation. Defines the extension to the TPM system. # name of the extension extName = test # description of the extension extDescription = my test inventory extension # Table list of tables referenced during data collection (used to generate the custom report) TABLES = ipconfig,netstat  For each operating system that this extension will be used on: # files for the AIX platform – not supported in this example AIX = no # files for the Solaris platform SOLARIS = yes pre_solaris = /tmp/test_inv/pre.sh out_solaris = /tmp/test_inv/ipconfig.mif post_solaris = /tmp/test_inv/post.sh # files for the Windows platform WINDOWS = yes pre_windows = c:\\pre.bat out_windows = c:\\ipconfig.mif post_windows = c:\\post.bat …

12. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Step 4: Create Extension  Run the command: Windows: %TIO_HOME%\tools\InventoryExtension.cmd Unix: $TIO_HOME/tools/InventoryExtension.sh  With one of the following: "create -p properties_file", "list [-e extension_name]", "delete -n extension_name ", "help“  Create Registers an extension, validating by introspecting the referenced tables Creates a discovery configuration Creates a custom report definition via introspection of the custom tables

13. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Creating Inventory Extensions

14. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Import report to TPM  Import report into TPM (It is manual step now)  Copy.rptdesign & xml file from \tmp to *Maximo Admin Client workstation \reports\birt\reports\TPSERVERS  Command resides in *Maximo Admin Client workstation Go to \reports\birt\tools Run the following command importreports.cmd app TPSERVERS Note: Workaround CQ: 81097 & 81099 *Maximo Admin Client workstation is the windows server that you used to deploy TPM

15. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1

16. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Inventory Extension  Go to Discovery Configuration page  Run Inventory Scan as you run Inventory Scan  Search extension _Discovery

17. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Inventory Extension  You will see Inventory Extension check box checked for the discovery  You will see the list of Inventory Extensions Note: You can add more than 1 Inventory Extensions to one discovery manually

18. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Inventory Extension  You will see all the inventory Extension run in the list of discoveries that was run against a computer

19. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Report  Go to Report Administration page  Find the report – Same name as the one you imported with extension.rptdesign in Maximo Admin Client Workstation

20. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Report  Generate Request Page

21. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1 Run Report  Preview report  View Report from Reports Navigation: Go to Reports > Deployment > Provisioning Computers

22. IBM Software Group | Tivoli software © 2009 IBM Corporation Tivoli Provisioning Manager 7.1.1