ALTIRIS CONNECTOR PACK 6.0 FOR HP OPENVIEW PRODUCT GUIDE

Transcription

1 ALTIRIS CONNECTOR PACK 6.0 FOR HP OPENVIEW PRODUCT GUIDE

2 Notice Copyright Altiris Inc. All rights reserved. Product Version: 6.0 Document Date: March 9, 2005 Bootworks U.S. Patent No. 5,764,593. RapiDeploy U.S. Patent No. 6,144,992. Recovery Solution U.S. Patent No. 5,778,395, 5,907,672, , , , , , , , GB , B , Other patents pending. Due to the inherently complex nature of computer software, Altiris does not warrant that the Altiris software is error-free, will operate without interruption, is compatible with all equipment and software configurations, or will otherwise meet your needs. The content of this documentation is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Altiris. Altiris Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this documentation. For the latest documentation, visit our Web site at Altiris, the Altiris logo, BootWorks, Inventory Solution, LabExpert, PC Transplant, RapiDeploy, and RapidInstall are registered trademarks of Altiris, Inc. in the United States and in other countries. Carbon Copy is a registered trademark licensed to Altiris, Inc. in the United States and a trademark of Altiris, Inc. in other countries. Altiris express, Altiris Protect, Application Management Solution, Application Metering Solution, Asset Control Solution, Asset Management Suite, Client Management Suite, Compliance Toolkit, Connector Solution, Conflict Analysis Solution, Contract Management Solution, Deployment Server, Deployment Solution, Energy Saver Toolkit, Education Management Suite, Helpdesk Solution Software, Lab Management Suite, Migration Toolkit, Mobile Client for SMS, Monitor Solution, Notification Server, Patch Management Solution, Problem Management Suite, Recovery Solution, Server Management Suite, Site Monitor Solution, Software Delivery Solution, TCO Management Solution, UNIX Client for SMS, Web Administrator for SMS, Web Reports, and other product names are trademarks of Altiris, Inc. in the United States and other countries. Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries. HP and Compaq are registered trademarks of the Hewlett-Packard Corporation. Dell is a registered trademark of Dell Inc. Macintosh is a registered trademark of the Apple Computer Corporation. Palm OS is a registered trademark of Palm Computing, Inc. BlackBerry is a service mark and a trademark of Research In Motion Limited Corporation. RIM is a service mark and trademark of Research In Motion (RIM) All other brand names are trademarks or registered trademarks of their respective companies. Altiris Connector Pack for HP OpenView Product Guide 2

3 Contents Altiris Connector Product Guide Pack 6.0 for HP OpenView Notice Overview Two-way Integration with HP OpenView NNM and Operations Servers Using with Altiris Solutions Installation Installing the Connector for HP OpenView Prerequisites Upgrading Installing Uninstalling the Connector for HP OpenView Registration Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Desk Install the Altiris Connector Agent Configure the Data Export Run a Data Export Configure the Data Import Run a Data Import Verify the Data Import Integrate the UI Using with Solaris User Interface Configure Data Exports Download Agent Install Reports Troubleshooting Database Access Error Out of Memory Error Database Scalability Limitation Using the Connector for HP OpenView Operations Setting Up and Using the Connector for HP OpenView Operations Add your Operations Servers to the SNMP Destinations Collection Create a Connector Agent Installer for each Operations Server Install the Connector Agent Installer on your Operations Servers Access Altiris Items on the Operations Console Making a Trap a Critical Error in HP OpenView Operations Accessing Resource Manager in HP OpenView Operations Altiris Connector Pack for HP OpenView Product Guide 3

4 Contents How the SNMP Management Agent Interacts with the HP OpenView Operations Server How to set up and use Contextual Menu Integration Between HP OpenView Operations and Resource Manager User Interface Agent Configuration Using the Connector for HP OpenView Network Node Manager Setting Up and Using the Connector for HP OpenView NNM Add your NNM Servers to the SNMP Destinations Collection Create a Connector Agent Installer for each NNM Server Install the Connector Agent Installer on your NNM Servers Access Altiris Items on the NNM Console Altiris Integration with HP OpenView NNM Making a Trap a Critical Error in HP OpenView NNM Accessing Resource Manager in HP OpenView NNM How the NS SNMP Agent Interacts with the HP OpenView NNM Server User Interface Agent Configuration Appendix A OVSD Configuration Item (CI) Custom Fields OVSD Person Custom Fields Altiris Connector Pack for HP OpenView Product Guide 4

5 Getting Started This section will introduce you to the Altiris Connector for HP OpenView and an overview of its features, including installation. Quick Links Overview on page 6 Installation on page 13 Provides an introduction to the Connector for HP OpenView. Install the Connector for HP OpenView on your Notification Server. Altiris Connector Pack 6.0 for HP OpenView Product Guide 5

6 Overview The Altiris Connector Pack for HP OpenView provides seamless integration that extends and enhances HP OpenView solutions including Network Node Manager, Service Desk, and Operations. The complementary strengths of Altiris and HP solutions allows you to implement a more comprehensive management solution that will prevent downtime, resolve problems faster and keep computers running efficiently. The Altiris IT lifecycle management strategy extends HP OpenView management to provide inventory, asset, software and configuration management for desktops, notebooks, handhelds, and servers. As a strategic partner for HP OpenView, Altiris is a registered HP OpenView Solution Alliance Partner and has obtained certification for the Altiris Connector for HP OpenView. HP OpenView provides a proactive, service centric approach to monitoring the network, system, applications and storage. By anticipating hardware and software problems before they occur, HP OpenView optimizes system performance and availability. As an IT manager, you can leverage the complementary strengths of HP OpenView and Altiris solutions to implement a more comprehensive management solution that will provide alerts, detailed computer information, and access to problem resolution solutions that will keep your computers running optimally. Altiris' comprehensive Web-enabled solutions empower organizations to manage computers throughout the IT lifecycle. IT Infrastructure Library (ITIL) provides best practice processes that enable IT to realize their key objective of service management. Altiris solutions support many ITIL processes, but significantly support Configuration, Change, Release and Problem Management. Integration between Altiris and HP OpenView further enhances the quality of IT service that is delivered, reduces overall cost of ownership and helps align IT services with business needs. You can, through your central HP OpenView consoles, gain additional visibility and get a more complete picture of your enterprise IT resources, allowing for more efficient management. By integrating your Altiris solutions into the HP OpenView consoles, you extend your tracking of issues to client computers and applications. Alerts from installed Altiris solutions can be forwarded to the HP OpenView consoles for comprehensive system monitoring of your IT environment. Detailed inventory from Altiris is accessible from within HP OpenView, providing the information needed to properly troubleshoot problems. Access to Altiris solutions is integrated in the integrated HP OpenView consoles to provide management tools that will reduce the time needed to resolve issues such as image deployment, software repair and updates, identifying inventory changes, software license management, remote control and management reporting. By integrating HP OpenView with Altiris solutions, you can move easily between the two management systems and problem resolution capabilities. HP OpenView and Altiris integration help you achieve a higher return on investment (ROI) through an integrated approach to PC deployment and migration, inventory and asset management, and software, change, and SLA management. Providing you with solutions that address your business needs and keep your systems operating optimally is a key benefit of the integrated approach between Altiris and HP OpenView. Altiris offers server provisioning across heterogeneous server hardware and manages heterogeneous client systems. Enhanced capabilities exist for HP/Compaq clients or ProLiant servers that take advantage of co-developed technology from Altiris and HP. HP Client Manager Software is a free hardware management solution for HP clients that generates hardware-specific alerts such as memory changes, chassis intrusion, or hard disk errors that can be forwarded to HP OpenView. HP specific hardware information is combined with other Altiris software inventory to provide additional troubleshooting information that is accessible from within HP OpenView consoles. HP ProLiant Essentials Rapid Deployment Pack uses the same Altiris infrastructure to deploy all ProLiant servers. Altiris solutions complement and extend HP OpenView. Altiris Connector Pack for HP OpenView Product Guide 6

7 Overview Features and Benefits HP OpenView Network Node Manager (NNM) and Operations Event forwarding via SNMP traps - Meet service level agreements (SLAs) with additional monitoring capabilities. Right-click access to detailed Altiris inventory - Streamline IT problem resolution via contextual access to in-depth client and server inventory. Launch Altiris solutions from within the HP OpenView console - Speed IT service delivery through quick access to the Altiris suite of tools to image, update software and configuration, track, and fix computer problems. HP OpenView Service Desk (OVSD) Import Altiris hardware and software inventory into the Service Desk Configuration Management Database (CMDB) - Maximize IT asset management integrating inventory data with service, incident, change, and contract data. Automatically create parent/child relationships between hardware, software, and host systems - Provide comprehensive picture of the computer, including all installed hardware and software. Create new hardware and software records as components are added to the environment - Enable automated change management, software licensing, and full hardware component inventory. Standard and user-configurable inventory data and category mapping between Altiris and OVSD - Adapt to your specific setup by permitting level of inventory integration to be defined. Import uses ITIL business rules to establish parent/child relationships, record changes, and add new records to OVSD - Automate processes including set record status, check for duplicate records, enable software license tracking, and determine record type, category, and data defaults. Altiris Notification Policies are designed to notify IT administrators of certain conditions that have occurred on an IT resource, namely desktop computers, notebooks, and servers. Based on these notifications, Altiris provides you many tools to assess and repair the condition. Altiris Connector Pack for HP OpenView Product Guide 7

8 Overview The Connector for HP OpenView provides integration between Altiris solutions and HP OpenView modules, including HP OpenView Network Node Manager (OVNNM), HP OpenView Operations (OVO), and HP OpenView Service Desk (OVSD). Altiris can forward events to OVNNM and OVO and forward inventory to Service Desk. The Connector for HP OpenView includes three components: OVNNM Event Management - This component lets you forward events to an HP OpenView Network Node Manager server via SNMP traps, view Altiris inventory via right-clicking on a node, and launch the Altiris console from within HP OpenView. OVO Event Management - This component lets you forward events to an HP OpenView Operations server via SNMP traps and launch the Altiris console from within HP OpenView. OVSD Data Extraction - This component lets you extract Notification Server inventory data in XML format for import into HP OpenView Service Desk. See Also Two-way Integration with HP OpenView NNM and Operations Servers on page 9 Using with Altiris Solutions on page 10 Installing the Connector for HP OpenView on page 13 Using the Connector for HP OpenView Service Desk on page 17 Using the Connector for HP OpenView Operations on page 40 Using the Connector for HP OpenView Network Node Manager on page 47 Altiris Connector Pack for HP OpenView Product Guide 8

9 Overview Two-way Integration with HP OpenView NNM and Operations Servers Two-way Integration with HP OpenView NNM and Operations Servers The Connector for HP OpenView provides for a two-way integration with HP OpenView NNM and Operations servers: 1 You can configure Notification Server to forward all or selected Notification Policies to an HP OpenView server. A configuration page has been created that lets you set up the link to the HP OpenView server, configure which policies will be forwarded, and test a sample trap for communication validation. 2 On the HP OpenView side, there is a MIB that is imported into HP OpenView to translate all the Notification Server traps to standard SNMP alerts. You can individually configure these traps as to whether they are critical, major, minor, normal, or a warning and whether they change the color of the resource in the console. There is also an ARF (application registration file) installed that allows 3rd party integration. This allows Altiris to provide a menu option from the HP OpenView console, to launch the Altiris Resource Manager, which provides detail information about the device, and provides a user interface that allows you to remote control the device. By simply right-mouse clicking on a computer within HP OpenView, there will be a new option to launch the Resource Manager for that computer. Figure 1 below illustrates what can be set up with this integration. In our example, a computer has experienced a low disk space condition: 1 An Altiris enabled computer notifies the Notification Server that it is low on disk space. 2 The Notification Server has an enabled policy with an Automated Action to forward an SNMP trap to an HP OpenView server (when it gets a low disk space alert from an Altiris enabled computer). 3 HP OpenView receives the SNMP trap identifying the problem computer and records the trap in the Alarms browser. 4 The computer is displayed in HP OpenView. Right-clicking on the computer in HP OpenView provides an option to launch Resource Manager. Altiris Connector Pack for HP OpenView Product Guide 9

10 Overview Using with Altiris Solutions 5 Altiris reports and Resource Manager provides you with a complete diagnostics set of reports, including disk space usage reports. One report can also tell you how much disk space can be freed up if you empty the Internet cache, temp directory, etc. Another report shows you how many MP3, GIF, JPG, or other audio/video files are on the drive. You can remote control the computer from here (using Carbon Copy). Figure 1 Network PCs Altiris Notification Server HP OpenView Server 5. Notification Server Integrating Altiris with HP OpenView provides a complete pro-active systems management solution for both your infrastructure as well as all the devices it services. While HP OpenView can provide the active monitoring and notifying of all systems across the infrastructure, Notification Server provides all the integrated tools necessary to control, manage, and repair those conditions. Using with Altiris Solutions Quick Links Altiris HP Client Manager Software on page 11 Altiris Asset Control on page 11 Altiris Inventory Solution on page 12 Altiris Connector Pack for HP OpenView Product Guide 10

11 Overview Using with Altiris Solutions Altiris HP Client Manager Software Altiris solutions support heterogeneous clients. However, you can take advantage of hardware management for HP/Compaq clients by using the Altiris HP Client Manager software. Hardwarespecific alerts such as memory changes, chassis intrusion, or hard disk errors that are generated with HP Client Manager software can also be forwarded to the HP OpenView console. Additional hardware information is combined with other Altiris inventory data to provide the best management for HP clients. The HP Client Manager software is specifically designed for HP computers, and leverages HP s Intelligent Manageability technology. HP Client Manager offers the following capabilities to provide you with the ability to efficiently manage HP and Compaq desktops and notebook computers: Client information Client information allows you to perform a hardware inventory of HP and Compaq computers, memory, hard disks, monitors, batteries and more. This information is stored in a central database, so you can quickly find information about any computer associated with the network. You can generate numerous reports to help you analyze the network, resolve TCP/IP address problems, and do growth planning stategies. Health monitoring HP Client Manager allows you to monitor the health, or proper function, of computer components such as the hard drive, memory, processor, and battery. When a problem arises, an alert is automatically generated and user-specified actions take place to alert you of the problem. Diagnostics HP Client Manager gathers diagnostic information and helps track down and analyze problems for supported computers on the network. SoftPaq deployment SoftPaqs (software support files such as, BIOS and driver updates) can be deployed from a central location to those computers that need the them. HP Client Manager keeps track of which computers on the network have received SoftPaq updates and those that have not. For more information on HP Client Manager and other Altiris Solutions, see the Altiris Web site at Altiris Asset Control The Connector for HP OpenView lets you export data from Notification Server and import it into HP OpenView Service Desk. If you own Altiris Asset Control, you can import Asset Inventory into OVSD. Asset Control provides an integrated solution to managing your assets, invoices, purchase orders, and projects. This solution allows you to do the following: Track assets, invoices, purchase orders, projects, and catalog items You can track assets, such as phones, printers, monitors, copiers, and users. You can also track invoices, purchase orders, projects, and catalog items. All of this data can be associated with each other, so assets can be linked to applicable invoices, purchase orders, and projects. Associate depreciation schedules with assets You can associate depreciation schedules with assets, which makes it easy to know the current value of an asset. Import data from and export data to numerous source types and files Asset, invoice, purchase order, project, and catalog data can be imported from or exported to Microsoft SQL Server, Oracle, Microsoft Access, Microsoft Excel, ODBC sources, and text files. This saves substantial effort in entering data manually, especially if the data is already available. The procedures can be done one time or regularly on a schedule. Create inventory data histories Connector Pack for HP OpenView allows you to create a history of inventory data in the Notification Server database, which helps in identifying changes and determining trends. Altiris Connector Pack for HP OpenView Product Guide 11

12 Overview Using with Altiris Solutions Tight integration with other solution data Connector Pack for HP OpenView integrates tightly with other Altiris solutions, such as Contract Management and Inventory Solution. With Contract Management, you can associate Connector Pack for HP OpenView assets, invoices, purchase orders, and projects with contracts. With Inventory Solution, you can associate additional computer related data with the computer data collected by Inventory Solution. For more information on Asset Control and other Altiris Solutions, see the Altiris Web site at Altiris Inventory Solution The Connector for HP OpenView lets you export data from Notification Server and import it into HP OpenView Service Desk. If you own Altiris Inventory Solution, you can import computer inventory into OVSD. Inventory Solution gathers comprehensive software and hardware data from virtually any computer. Inventory Solution provides these features and benefits: Works with Non-Networked Windows workstations Works with computers with no IP connectivity. A floppy disk method has been designed for these non-networked Windows workstations. Works with Non-SMS clients Windows workstations that are not SMS clients can be inventoried into Notification Server and integrated into the SMS database. Provides full access to all the data from any browser Data can be accessed through Web Reports on Notification Server or through Web Administrator for Microsoft SMS using data that has been forwarded to the SMS database. Includes integrated Web Reports Inventory Solution comes with numerous built-in reports that help you analyze and make proactive management decisions based upon Inventory Solution data. This allows quick and easy access to inventory information without having to create custom SQL scripts. Custom reports may also be added and scheduled to run automatically. Posts data through files and HTTP Inventory Solution data can be sent to Notification Server through a file or through an HTTP post. Deploys through , URL, login scripts Inventory Solution can be deployed through e- mail, a URL, login scripts, or any other method you have in place to run a program on the target systems running a Windows 32-bit Operating System. For more information on Inventory Solution and other Altiris Solutions, see the Altiris Web site at Altiris Connector Pack for HP OpenView Product Guide 12

13 Installation This section tells you how to install the Connector for HP OpenView. Installing the Connector for HP OpenView on page 13 Uninstalling the Connector for HP OpenView on page 14 Registration on page 15 Installing the Connector for HP OpenView This section explains how to install the Connector for HP OpenView. See Prerequisites on page 13 before you install or upgrade. Quick Links Upgrading on page 13 Installing on page 14 Prerequisites Notification Server 6.0 or higher must be installed on the computer you are installing the Connector for HP OpenView on. For more information, see Altiris Notification Server Help. The Notification Server computer with this Connector installed must have access to an HP OpenView server. IMPORTANT: Only one Notification Server should be connected to any HP OpenView server. If more than one Notification Server tries to connect to an HP OpenView server, files will be overwritten on the HP OpenView computer. However, you can connect one Notification Server to as many HP OpenView servers as you want. Note: The Connector for HP OpenView supports HP OpenView Service Desk 4.5 SP11, HP OpenView Operations 7.0 for Windows, and HP OpenView Network Node Manager 6.2 for Windows. Note: If you are using any service pack prior to HP OpenView Service Desk SP11, you will need to replace the Web API file (web-api.jar) in the ConnectHPOVSDAgent\Lib folder after the Connector Agent installation on the Service Desk computer with the version that matches your service pack level. Altiris Connector Solution 6.1 must be installed on Notification Server. Upgrading If you are upgrading from the Connector 5.5 for HP OpenView, follow these steps for installation. To Upgrade the Connector for HP OpenView 1 Uninstall the Connector 5.5 for HP OpenView by following the instructions in the Connector 5.5 for HP OpenView documentation. 2 Install the Connector 6.0 for HP OpenView (see Installing on page 14) Altiris Connector Pack for HP OpenView Product Guide 13

14 Installation Uninstalling the Connector for HP OpenView Installing If you are installing this Connector without any previous version installed, follow these steps. To Install the Connector for HP OpenView 1 Open the Altiris Console. Click Start > Programs > Altiris > Altiris Console 2 Click the Configuration tab. 3 In the treeview pane, click Upgrade/Install Additional Solutions. 4 In the content pane, click the Available Solutions tab. 5 Click the Segments sub-tab. 6 Expand either the Connectors or the Partner Solutions list. 7 Click Altiris Connector Pack for HP OpenView. 8 Click Start. Uninstalling the Connector for HP OpenView To uninstall the Connector for HP OpenView 1 Open the Altiris Console. Click Start > Programs > Altiris > Altiris Console 2 Click the Configuration tab. 3 In the treeview pane, click Upgrade/Install Additional Solutions. 4 In the content pane, click the Currently Installed tab. 5 Remove the following components by clicking the Remove button next to them: Altiris Connector for HP OpenView Service Desk Altiris Connector for HP OpenView Operations Altiris Connector for HP OpenView Network Node Manager Altiris Connector Altiris Context Factory To uninstall the Altiris Connector Agent from the HP OpenView server 1 To remove the Connector Agent for HP OpenView Service Desk: a On the HP OpenView server, go to Add or Remove Programs in the Control Panel and remove Altiris Connector Agent for HP OpenView Service Desk. b Remove the shared folder that you created (Program Files\Altiris\ConnectHPOVSDAgent\Import by default) and any files that were imported from the Connector. c If you have customized the Service Desk user interface (either manually or by using one of the files in the ACES folder), manually remove those customizations. 2 To remove the Connector Agent for HP OpenView Operations: a b c d On the HP OpenView server, go to Add or Remove Programs in the Control Panel and remove Altiris Connector Agent for HP OpenView Operations. Manually undeploy the Altiris-Aggregate-Mib SNMP Interceptor from the management server node. Manually delete the Altiris-Aggregate-Mib SNMP Interceptor from the list of SNMP Interceptors. Manually delete the tools. Altiris Connector Pack for HP OpenView Product Guide 14

15 Installation Registration 3 To remove the Connector Agent for HP OpenView Network Node Manager: a b Registration On the HP OpenView server, go to Add or Remove Programs in the Control Panel and remove Altiris Connector Agent for HP OpenView Network Node Manager. Manually delete the Altiris Alert category. Even though this Connector Pack is downloaded as one product, Network Node Manager, Operations, and Service Desk are separate components and need to be licensed separately. Each Altiris product comes with a 7-day trial license that is installed by default. You can register and obtain a 30-day evaluation license through our Web site at or purchase a full product license. To view your current license, open the Altiris Console, click the Configuration tab, and select Licensing. For more information, see Licensing Altiris Software in the Altiris Getting Started Guide on the product CD or on our Web site at Altiris Connector Pack for HP OpenView Product Guide 15

16 Using the Connector for HP OpenView This section provides information about using the Connector for HP OpenView. Quick Links Using the Connector for HP OpenView Service Desk on page 17 Using the Connector for HP OpenView Operations on page 40 Using the Connector for HP OpenView Network Node Manager on page 47 Provides a comprehensive guide for using the Service Desk component. Provides a comprehensive guide for using the Operations component. Provides a comprehensive guide for using the Network Node Manager component. Altiris Connector Pack 6.0 for HP OpenView Product Guide 16

17 Using the Connector for HP OpenView Service Desk Quick Links Setting Up and Using the Connector for HP OpenView Service Desk on page 17 User Interface on page 37 Troubleshooting on page 39 Setting Up and Using the Connector for HP OpenView Service Desk This section walks you through the steps you need to export data from Notification Server, download the Connector Agent, configure the Connector Agent for the data import, and perform a data import. This section assumes that you have successfully installed the Connector for HP OpenView on your Notification Server and have Service Desk set up. To successfully set up and use the Connector, follow these Quick Steps in order. Quick Steps Install the Altiris Connector Agent on page 17 Configure the Data Export on page 19 Run a Data Export on page 20 Configure the Data Import on page 21 Run a Data Import on page 34 Verify the Data Import on page 35 Integrate the UI on page 35 See Also Using with Solaris on page 37 Install the Altiris Connector Agent The Altiris Connector Agent installs files and folders on your Service Desk server that are needed for performing a data import. The Connector Agent installs to the Program Files\Altiris\ConnectHPOVSDAgent folder. We recommend that after the Connector is installed, you install the Connector Agent before doing anything else with the Connector. This lets you place the Import folder inside the ConnectHPOVSDAgent folder, which is recommended. The Import folder is where the data export component places the XML files that are exported from Notification Server. See Also Configure the Data Export on page 19 Altiris Connector Pack for HP OpenView Product Guide 17

18 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service The following files and folders are included in the Connector Agent installation ACES - This folder contains templates that you can use for contextual menu integration. Archive - The Connector Agent places all processed data XML files in this folder. Lib - This folder contains the Java application files that perform the data import. Configuration.dtd - This file describes the structure of the Configuration.xml file. This DTD can help you when you need to edit the Configuration.xml file. Configuration.xml - This file is where you set up your configuration for the Data Import. ConnectHPOVSDAgent.bat - This file is for running the Data Import in Windows. You can set up your Windows Task Scheduler to run the Data Import on a schedule. Alternatively, you can put the command line found in this batch file directly into the Windows Task Scheduler. Log.txt - This file contains all logging information generated during the Data Import. Initially, it is empty. During each Data Import, all generated logging information is entered in it. This file will continue to grow and may need to be purged periodically. If you want to save the information that is generated in this file, we recommend that you periodically rename this file. A new Log file will then be created the next time that a data import is run. To Install the Connector Agent onto a Service Desk server 1 From the Service Desk server, open an internet browser. 2 Access the Altiris Console and click the Configuration tab view. 3 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Service Desk > Download Agent Install. Altiris Connector Pack for HP OpenView Product Guide 18

19 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service 4 Install the Connector Agent to the Service Desk server by clicking the Open button in the File Download window that appears. This is installed in the Program Files\Altiris\ConnectHPOVSDAgent folder. Note: If the File Download window does not appear, you can click the click here link to install the Connector Agent. Note: If you have Software Delivery Solution installed, you can create a package that deploys the Connector Agent to one or more Service Desk servers. To push the Connector Agent down as a package, the Service Desk server must have the Altiris Agent installed on it. 5 Create an Import folder in the Program Files\Altiris\ConnectHPOVSDAgent\Import folder. This name and location is the default but can be changed to meet your needs. See Configure the Data Import on page 21 for more information. 6 Share the Import folder with the Notification Server administrator account. IMPORTANT: We recommend that you not share the Program Files\Altiris\ConnectHPOVSDAgent folder because the Configuration.xml file contains unencrypted user login information. Configure the Data Export This section walks you through the steps of creating a data export configuration. Data export configurations are used for exporting data to the Import folder (by default). You can create as many configurations as you want. For more information, see Configure Data Exports on page 37. After you have created a configuration, you can use it to export data from Notification Server to XML files and place them in a UNC path. See Also Run a Data Export on page 20 To create a data export configuration 1 Open the Altiris Console. a Click Start > Programs > Altiris > Altiris Console. 2 From the Configuration tab, in the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Service Desk > Configure Data Exports. 3 In the Name field, enter the name for the configuration. 4 In the Description field, enter a description for the configuration. 5 In the Folder Path for Export field, enter the path for the XML files to be exported to. We recommend that this path be on your Service Desk server. By default in the Configuration.xml file, this path is Program Files\Altiris\ConnectHPOVSDAgent\Import. This folder should be a shared folder to which Notification Server has access. Note: This folder needs to be accessible from the Service Desk server by sharing it. We recommend that this be an empty folder. 6 In the Collection To Export field, select the collection which contains the data you want to export. 7 Select Only Export Changes if you want to only export changes each time after the first full data export. Note: The first data export for any configuration will always be a full data export. Thereafter, a full data export will be performed only if the Only Export Changes checkbox is cleared. 8 In the Data Classes to Export section, select all of the data classes that you want to export. We recommend that you start with Basic Inventory. After you see what gets exported with Basic Inventory, then you can add more data classes as desired. Note: In tests run by Altiris, the data export/import process took approximately 7 seconds per computer when only basic inventory was selected. Your time may vary depending on your system configuration. Remember, the more data classes that you select, the slower the data export/import will be. Altiris Connector Pack for HP OpenView Product Guide 19

20 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service 9 In the Scheduling section, select Enable Schedule, then select the schedule that you this data export to run on. This lets you automate the data export to fit your needs. 10 Click the Apply button to save all changes and add this configuration to the configuration list. Run a Data Export This section walks you through the steps of running and verifying a data export. Note: The first time the Data Export runs, it will perform a full data export. If the Only Export Changes checkbox is selected, it will perform a delta export (only changes are updated). If you want to perform a full export at any time, clear the Only Export Changes checkbox, apply the changes and run the data export. You can automate the data export by creating different configurations on the Configure Data Exports page to fit your needs. Each configuration can be run on a schedule. See Also Configure the Data Export on page 19 Configure the Data Import on page 21 To Export Data from Notification Server 1 Open the Altiris Console. a Click Start > Programs > Altiris > Altiris Console. 2 From the Configuration tab, in the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Service Desk > Configure Data Exports. 3 In the content pane, select a configuration that is created. 4 In the toolbar, click the Run the Selected Configuration icon. Note: You can click the Test the Selected Configuration icon to make sure the data export works without performing a full data export. This tests all of the queries of which the data export is composed to ensure that they run appropriately; however, no export files are produced. There should be up to 10 data export XML files in the directory you specified. You can view one or more of these files to make sure that the data export worked correctly. Note: Even if you did not select any data classes, resource records will still be exported containing very minimal information, including the resource name. This information, however, can be quite useful. Once it is imported into Service Desk, you will be able to double-click on the resource name, open Resource Manager, and view all of the data on that resource that is in the Notification Database. If you have Carbon Copy installed, you can then access that resource directly from Resource Manager. To verify the data export Verify the data export by checking the Import folder. There should be one or more XML files in this folder. They are named Altiris followed by the date and time. The Data Export XML File Inventory data is exported in groups of whole classes based on the category or sub-category selected in the Data Classes to Export section. Here is an example of the formatting of a data export XML file: <nsdataexport> <columns> column data... </columns> <exportexecution> <rows> <row> row data... </row> <row n> Altiris Connector Pack for HP OpenView Product Guide 20

21 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service row data... </row n> </rows> </exportexecution> </nsdataexport> The exporting process assures the following: During a full data export, all data classes on the host computer will show up in a data export XML file. During a delta data export, only classes that have changed will show up in a data export XML file. Errors Errors that occur during the Data Export are entered in the Notification Server error logs. For more information on these log files, see Error Logging in Altiris Notification Server Help. Configure the Data Import To configure the data import, you need to change the Configuration.xml file. This file contains the default configuration for importing data. This section discusses the Configuration.xml file and how to configure it to run a data import. The Configuration.xml file contains four main element sections: EXECUTION, LOGGING, CONNECTION, and RULES. To perform a basic data import, you can leave the settings in the Configuration.xml file unchanged with one exception. In the CONNECTION section, you will most likely need to change the defaults to reflect the hostname, username, and password for logging onto your Service Desk application server. If you want to make changes to the Configuration.xml file, see the sections below for detailed information. Note: See the Configuration.dtd file for a better understanding of the structure of the Configuration.xml file. See Also Run a Data Import on page 34 EXECUTION Element The EXECUTION element lets you configure import paths and whether or not to continue if an error is found. There can be zero or one EXECUTION elements in the Configuration.xml file. The attributes listed in the following table are associated with the EXECUTION element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Attribute importfolderpath importarchivefolderpath importerrorfolderpath Description The path to the shared Import folder where the XML files get exported to. This is also the path that the Connector Agent uses to place data in Service Desk. The default is \Import. The path where the XML files are moved after they are imported. The default is \Archive. The path where XML files are moved if application was unable to parse everything in the file. If there are any errors during the parsing of the XML file, it is placed in this folder instead of the Archive folder. The default is \Error. Altiris Connector Pack for HP OpenView Product Guide 21

22 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute continueonerror If true, the data import tries to continue past errors (all errors are logged to the Log file). If false, the import stops when errors occur. The default is True. Note: These errors are errors related to importing the data into Service Desk. percentagefreememorythresholdforconfigure This sets the minimal percentage of memory you want to use for the configuration process. This is based on the memory that was available when the data import starts. This memory is the memory allocated to the Java Runtime environment when the data import runs. This can be any number between 0 and 100. The default is 0. For more information, see How the data import uses thresholds on page 22 percentagefreememorythresholdforsave Description How the data import uses thresholds The data import is divided into three processes: load, configuration, and save. The load process loads all of the data from the XML files into memory. This sets the minimal percentage of memory you want to use for the save process. This is based on the memory that was available when the data import starts. This memory is the memory allocated to the Java Runtime environment when the data import runs. This can be any number between 0 and 100. The default is 0. For more information, see How the data import uses thresholds on page 22 The configuration process checks the Service Desk database and configures in memory the data that was loaded by the load process. The save process saves the data into the Service Desk database that is configured in memory if it is different than what is in the Service Desk database. As the data import goes through the three processes, if the data import is able to do it all without descending below either the percentagefreememorythresholdforconfigure or the percentagefreememorythresholdforsave thresholds, then these thresholds are not applicable. In this case, the data import will run the load process, then the configuration process, and then the save process. If, while the load process is loading data, the amount of free memory falls below the percentagefreememorythresholdforconfigure threshold, then the load process temporarily stops, and the configuration process starts and processes that data. If, while the configuration process is configuring data, the amount of free memory falls below the percentagefreememorythresholdforsave threshold, then the configuration process temporarily stops, and the data is processed by the save process. After the data moves through the three processes, the load process loads more data and the processing continues according to the percentagefreememorythresholdforconfigure and percentagefreememorythresholdforsave thresholds. The data import uses these two thresholds to decide when it should start the next step of the import so that it does not run out of memory. We recommend that you not change these two thresholds from their original values in the Configuration.xml file (20 for percentagefreememorythresholdforconfigure and 10 for percentagefreememorythresholdforsave) unless you receive an Out of Memory error while Altiris Connector Pack for HP OpenView Product Guide 22

23 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service performing a data import. If this happens, you can try adjusting these thresholds slightly higher; however setting them too high can decrease import speed substantially. Contact Altiris Support if you have any questions regarding changing these two thresholds. These two thresholds are configurable to help you improve the efficiency of your data import based on the amount of data you are importing. The data import process takes much longer than the data export. These two thresholds give you flexibility so that you can decrease the data import time depending on the data you are importing. For example, if you are importing data for Configuration Items already associated with a lot of data in Service Desk, you may need to increase the percentagefreememorythresholdforsave threshold. Another way you can decrease your data import time is to increase the Java Runtime environment memory if you can do so. For more information, see Out of Memory Error on page 39. LOGGING Element The LOGGING element lets you configure logging information for the data import. There can be zero or one LOGGING elements in the Configuration.xml file. The attributes listed in the following table are associated with the LOGGING element. They are both optional, but if not listed in the Configuration.xml file, their default is used. Attribute filepath verbose Description The location of the Log file. The default (if no filepath is listed) is to output log messages to the command line only. This lets you increase the amount of logging information that gets entered in the Log file. The default is false, which means only the minimum is entered in the Log file. We recommend that you only set this to true when you want to troubleshoot. If this is set to true, the Log file size can increase quickly, and import speed can decrease substantially. The default is False. CONNECTION Element The CONNECTION element lets you configure your settings for connecting to Service Desk. There can be zero or one CONNECTION elements in the Configuration.xml file. The attributes listed in the following table are associated with the CONNECTION element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Note: These settings will most likely need to be changed before you can run a data import. Attribute hostname username password Description The name of the Service Desk server. The default is localhost. The user name for logging onto the Service Desk application server. The default is system. The password for logging onto the Service Desk application server. The default is servicedesk. RULES Element The RULES element lets you configure the data import rules. There can be zero or one RULES elements in the Configuration.xml file. The RULES element can contain zero or one of these four elements: RESOURCETYPES, RESOURCES, DATACLASSES, and DATASUBCLASSES. These four elements correspond to the four different kinds of information you import into Service Desk: Resource Types, Resources, Data Classes, and Data Subclasses. Altiris Connector Pack for HP OpenView Product Guide 23

24 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Resource Types are asset categories, and examples include Computer, User, Monitor and Keyboard. Resources are individual assets, such as individual computers or individual users. Data Classes are properties associated with asset categories, including software and hardware for computers and contact information for users; for example, the Data Class MS Office Apps may be associated with the computer asset category. Data Subclasses are unique instances of Data Classes and are properties associated with individual assets; for example, the Data Subclass MS Word 97 may be associated with an individual computer. See the Configuration.xml file to get a better understanding of the element and attribute structure described in this section. RESOURCETYPES Element The RESOURCETYPES element lets you configure how and where your Resource Types appear in Service Desk. There can be zero or one RESOURCETYPES elements in the Configuration.xml file. The RESOURCETYPES element can contain zero or more RESOURCETYPE elements. The attributes listed in the following table are associated with the RESOURCETYPES element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Altiris Connector Pack for HP OpenView Product Guide 24

25 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute createconfigurationitem category searchcodesuffix statuswhencreated statuswhenchangeduser Description This controls whether or not you want to create a Configuration Item for each Resource Type. In Service Desk, by default, the data import creates a Configuration Item for each Resource Type. Resources that are imported are then assigned to the appropriate Resource Type as a child Configuration Item. For example, a Computer Configuration Item could have children called Computer1 and Computer2, which are specific computer names. If this is set to False, the data import will create Resource Configuration Items, but those Resources will not be associated with any parent Resource Type. The default is True. The category into which all Resource Types are imported into Service Desk. The default is Altiris Resource Type. The suffix you want to add to the end of the search code for each Configuration Item that is created for a Resource Type. This can be used to better describe the Configuration Item. This improves the probability of uniqueness for the search code. The default is -RESOURCETYPE. The name of the status that Resource Types are given when they are created. The default is Created. The name of the status that Resource Types are given when their associated users change. This affects only the User Resource Type. The default is User Changed. statuswhenchangedresource The name of the status that Resource Types are given when their associated Resources change. The default is Resource Changed. statuswhenupdated The name of the status that Resource Types are given when they are updated. The default is Updated. Note: The statuses (attributes that start with the word status ) listed above are listed in a hierarchy in order of importance with statuswhencreated being most important and statuswhenupdated being least important. For example, if the Resource Type is updated, but none of its Users or Resources change, then the status gets set to the statuswhenupdated status. However, if the Resource Type gets updated and one of its Users change, then the status gets set to the statuswhenchangeduser status. Under the RESOURCETYPES section, you can create as many RESOURCETYPE elements as you want. This gives you the freedom to customize individual Resource Types when you want them to be different from the configuration in the RESOURCETYPES section. There are three ways that you can classify where a resource appears in the Service Desk Windows console: lowest priority, middle priority, and highest priority. The lowest priority categorization is the defaultcategory attribute on the RESOURCES element. This is the category a resource will get if it is not categorized in any of the other two higher priority categorizations. The middle priority categorization is on the RESOURCETYPE element that corresponds to the Resource Type that is being categorized. For example, optionally there is a RESOURCETYPE element named Computer. If you want, you can add a resourcecategory attribute to the Computer RESOURCETYPE element giving it another category. In this case, all of your resources that are not computers would go in the default category, but then all of your resources of Resource Type Computer would go to the new category that you specify in the resourcecategory attribute in the Computer RESOURSETYPE element. The highest priority categorization is given by categorizing an individual resource directly by its name. You do this by creating a RESOURCE element by the Altiris Connector Pack for HP OpenView Product Guide 25

26 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service name of that individual resource and give it a category attribute. So, if you have an individual computer named Computer1, you can assign that computer its own category. This is the highest priority. If an individual resource, such as a specific computer, has its own category, this takes precedence and it is placed into the assigned category. If a resource type, such as Computer, has its own category, then all resources of that resource type that have not been assigned an individual resource category are assigned to that category. All resources that do not have categories assigned to them through a highest or middle priority category are assigned the category given to all resources. Note: The Search Code Suffix attributes have the same priority classifications as discussed above for categories. The highest priority is the searchcodesuffix attribute in the RESOURCE element. The middle priority is the resourcesearchcodesuffix attribute in the RESOURCETYPE element. The lowest priority is the defaultsearchcodesuffix attribute in the RESOURCES element. Note: The Status attributes (any attribute that has the name status in it) have the same priority classifications as discussed above for categories and Search Code Suffix. The highest priority are the Status attributes in the RESOURCE element. The middle priority are the Status attributes in the RESOURCETYPE element. The lowest priority are the Status attributes in the RESOURCES element. RESOURCETYPE Element The RESOURCETYPE element lets you configure how and where a specific Resource Type appears in Service Desk. There can be zero or more RESOURCETYPE elements under the RESOURCETYPES element in the Configuration.xml file. The attributes listed in the following table are associated with the RESOURCETYPE element. One is required. The others are optional. Altiris Connector Pack for HP OpenView Product Guide 26

27 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute name resourcecategory resourcesearchcodesuffix resourcestatuswhencreated resourcestatuswhenchangeddatafield resourcestatuswhenchangeduser resourcestatuswhenchangeddatasubclass Note: The statuses (attributes that start with resourcestatus ) listed above are listed in a hierarchy in order of importance with resourcestatuswhencreated being most important and resourcestatuswhenupdated being least important. RESOURCES Element Description The name of the Resource Type in the Notification Database. This attribute is required. The category into which all Resources of this Resource Type is imported into Service Desk. The suffix you want to add to the end of the search code for all Configuration Items that are created for Resources of this Resource Type. This can be used to better describe the Configuration Item. This improves the probability of uniqueness for the search code. The name of the status that Resources of this Resource Type are given when they are created. The name of the status that Resources of this Resource Type are given when their data fields change. The name of the status that Resources of this Resource Type are given when their associated users change. The name of the status that Resources of this Resource Type are given when their associated Data Subclasses change. resourcestatuswhenchangedresourcetype The name of the status that Resources of this Resource Type are given when their associated Resource Types change. resourcestatuswhenupdated The name of the status that Resources of this Resource Type are given when they are updated. The RESOURCES element lets you configure how and where your Resources appear in Service Desk. There can be zero or one RESOURCES elements in the Configuration.xml file. The RESOURCES element can contain zero or more RESOURCE elements. The attributes listed in the following table are associated with the RESOURCES element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Altiris Connector Pack for HP OpenView Product Guide 27

28 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute Description defaultcategory The category into which all Resources are imported into Service Desk. The category can be overridden by using RESOURCE elements. The default is Altiris Resource. defaultsearchcodesuffix The suffix you want to add to the end of the search code for the Configuration Item that is created for this Resource. This can be used to better describe the Configuration Item. This improves the probability of uniqueness for the search code. This is the default suffix that all types get unless they are overwritten by the resourcesearchcodesuffix attribute in the RESOURCETYPE element or the searchcodesuffix attribute of the RESOURCE element, in that order. For more information on prioritization, see the discussion on category prioritization in RESOURCETYPES Element on page 24. The default is -RESOURCE. defaultstatuswhencreated The name of the status that Resources are given when they are created. The default is Created. Note: The Status attributes in the RESOURCES element are the default Statuses that all types get unless they are overwritten by the comparable attribute in the RESOURCETYPE element or the comparable attribute of the RESOURCE element, in that order. For more information on prioritization, see the discussion on category prioritization in RESOURCETYPES Element on page 24. defaultstatuswhenchangeddatafield The name of the status that Resources are given when any of the Resource's data fields change. The default is Data Field Changed. defaultstatuswhenchangeduser The name of the status that Resources are given when their associated users change. This affects only a Resource of a User Resource Type. The default is User Changed. defaultstatuswhenchangeddatasubclass The name of the status that Resources are given when any of their Data Subclasses are changed during the import. The default is Data Subclass Changed. defaultstatuswhenchangedresourcetype The name of the status that Resources are given when they change Resource Type. The default is Resource Type changed. defaultstatuswhenupdated The name of the status that Resources are given when they are updated. The default is Updated. Note: The statuses (attributes that start with the defaultstatus ) listed above are listed in a hierarchy in order of importance, with defaultstatuswhencreated being most important and defaultstatuswhenupdated being least important. For example, if the Resource is updated, but none of its Resource Types, Data Subclasses, or Data Fields change, then the status gets set to the defaultstatuswhenupdated status. However, if the Resource gets updated and one of its Data Subclasses change, then the status gets set to the defaultstatuswhenchangeddatafield status. Under the RESOURCES section, you can create as many RESOURCE elements as you want. This gives you the freedom to customize individual Resources when you want them to be different from the configuration in the RESOURCES section. Altiris Connector Pack for HP OpenView Product Guide 28

29 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service RESOURCE Element The RESOURCE element lets you configure how and where a specific Resource appears in Service Desk. There can be zero or more RESOURCE elements under the RESOURCES element in the Configuration.xml file. The attributes listed in the following table are associated with the RESOURCE element. One is required. The others are optional. Attribute name category searchcodesuffix statuswhencreated statuswhenchangeddatafield statuswhenchangeduser statuswhenchangeddatasubclass Note: The statuses (attributes that start with the word status ) listed above are listed in a hierarchy in order of importance with statuswhencreated being most important and statuswhenupdated being least important. DATACLASSES Element Description The name of the Resource in the Notification Database. This attribute is required. The category into which this Resource is imported into Service Desk. The suffix you want to add to the end of the search code for all Configuration Items that are created for this Resource. This can be used to better describe the Configuration Item. This improves the probability of uniqueness for the search code. The name of the status that this Resource is given when it is created. The name of the status that this Resource is given when any of its data fields change. The name of the status that this Resource is given when its associated users change. The name of the status that this Resource is given when its associated Data Subclasses change. statuswhenchangedresourcetype The name of the status that this Resource is given when it changes to a different Resource Type. statuswhenupdated The name of the status that this Resource is given when it is updated. The DATACLASSES element lets you configure how and where your Data Classes appear in Service Desk. There can be zero or one DATACLASSES elements in the Configuration.xml file. The DATACLASSES element can contain zero or more DATACLASS elements. The attributes listed in the following table are associated with the DATACLASSES element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Attribute category searchcodesuffix statuswhencreated Description The category into which all Data Classes are imported into Service Desk. The category can be overridden by using DATACLASS elements. The default is Altiris Resource. The suffix you want to add to the end of the search code for the Configuration Item that is created for this Data Class. This can be used to better describe the Configuration Item. This improves the probability of uniqueness for the search code. The default is -DATACLASS. The name of the status that Data Classes are given when they are created. The default is Created. Altiris Connector Pack for HP OpenView Product Guide 29

30 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute Description statuswhenchangeddatasubclass The name of the status that Data Classes are given when any of their Data Subclasses are changed during the import. The default is Data Subclass Changed. statuswhenupdated The name of the status that Data Classes are given when they are updated. The default is Updated. Note: The statuses (attributes that start with the word status ) listed above are listed in a hierarchy in order of importance with statuswhencreated being most important and statuswhenupdated being least important. DATACLASS Element The DATACLASS element lets you configure how and where a specific Resource appears in Service Desk. There can be zero or more DATACLASS elements under the DATACLASSES element in the Configuration.xml file. The DATACLASS element can contain zero or more DATAFIELD elements. The attributes listed in the following table are associated with the DATACLASS element. One is required. The others are optional. Attribute name createconfigurationitem datasubclasscategory datasubclasssearchcodesuffix datasubclassstatuswhencreated datasubclassstatuswhenchangeduser datasubclassstatuswhenchangedresource Description The name of the Data Class in the Notification Database. This attribute is required. This controls whether or not you want to create a Configuration Item for each Data Class and its children and associate the appropriate Data Subclasses with it. In Service Desk, by default, the data import creates a Configuration Item for each Data Class. Data Subclasses that are imported are then assigned to the appropriate Data Class as a child Configuration Item. If this is set to False, the data import will not create the Data Class Configuration Item or any of its child Data Subclass Configuration Items. The default is True. For an example of why you would use this, see DATACLASS createconfigurationitem Example on page 31. The category into which all Data Subclasses of this Data Class are imported into Service Desk. The suffix you want to add to the end of the search code for all Configuration Items that are created for Data Subclasses of this Data Class. This can be used to better describe the Configuration Item. The name of the status that Data Subclasses of this Data Class are given when they are created. The name of the status that Data Subclasses of this Data Class are given when their associated users change. The name of the status that Data Subclasses of this Data Class are given when their associated Resource is changed. datasubclassstatuswhenchangeddataclass The name of the status that Data Subclasses of this Data Class are given when their associated Data Classes change. datasubclassstatuswhenupdated The name of the status that Data Subclasses of this Data Class are given when they are updated. Altiris Connector Pack for HP OpenView Product Guide 30

31 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Note: The statuses (attributes that start with datasubclassstatus ) listed above are listed in a hierarchy in order of importance with datasubclassstatuswhencreated being most important and datasubclassstatuswhenupdated being least important. DATACLASS createconfigurationitem Example An example for using createconfigurationitem is in the Configuration.xml file in the DATACLASSES section. <DATACLASS name= AeX AC TCPIP createconfigurationitem= false > <DATAFIELD name= IP Address resourcefield= IPAddress resourcefieldaccumulate= false /> </DATACLASS> In this example, createconfigurationitem is false. This means that there will not be a Data Class called AeX AC TCPIP created. Also, there will not be a child Data Subclass created for any of the computers that have an IP address. However, since there is a Data Field IP Address mapping, the IP Address will be placed directly into the Resource Configuration Item. So, instead of having a relationship between a computer and a Data Subclass for an IP Address, the IP Address is placed directly into the Resource Configuration Item in Service Desk. DATAFIELD Element The DATAFIELD element lets you associate fields with a Data Class that appears in Service Desk. There can be zero or more DATAFIELD elements under the DATACLASS element in the Configuration.xml file. The attributes listed in the following table are associated with the DATAFIELD element. Two are required. The other three are optional. Attribute name resourcefield resourcefieldaccumulate Description The name of the Data Field in the Notification Database. This attribute is required. The Resource Field name which is mapped to the name of the field in the Service Desk database. This should be one of the fields found in the Resource Field Name column of the table in OVSD Configuration Item (CI) Custom Fields on page 56. If this is set to true, all of the instances of a Data Class found in a Resource are accumulated and placed into the ResourceField in the Configuration Item. If these instances are numbers, they are mathematically added together and the total is placed in the field. If these instances are text, they are comma-separated and placed in the field. If this is set to false, the last instance is the one that gets mapped into the Configuration Item in Service Desk. To see an example for using this, see DATAFIELD resourcefieldaccumulate Example on page 32. Altiris Connector Pack for HP OpenView Product Guide 31

32 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute Description datasubclasssearchcodeexclude The field designated by the name attribute will be excluded when the data import creates the Data Subclass name in Service Desk. If set to true, the data field is excluded from the Data Subclass name. If false, the data field name is included in the search code. The search codes for Data Subclass names that you see in Service Desk are generated based on the fields in the Data Class for that particular Resource. This attribute lets you exclude fields when creating the search code for Data Subclass names. Each use of this attribute will exclude one field designated by the name attribute. A unique search code is generated for each unique instance of a Data Class. If this attribute is not used, all columns in the Data Class are used to generate the search code for the Data Subclass name. To see an example for using this, see DATAFIELD datasubclasssearchcodeexclude Example on page 33 You have two ways of controlling the search code for Data Subclass names: use this attribute to exclude fields from the generated name of a Data Subclass and place a suffix on the generated name of a Data Subclass. isusername This prompts the data import to either attempt to associate the particular resource that is currently being imported with a person in Service Desk or create a new person in Service Desk and associate that new person as a user of that Configuration Item. This gives you the ability to associate any Resource with a user of that Resource. This must be used in conjunction with the isuserdomain attribute. Use this when there is a user name and domain in two separate fields that should be associated together. When the data import sees that a particular record has both a user name and a domain, it attempts to associate the particular resource that is currently being imported with a person in Service Desk. It will then relates the person with the Configuration Item as a user of that Configuration Item. If that person does not exist in Service Desk, the data import creates a person and associates that new person as a user of that Configuration Item. See the Configuration.xml for examples on using this attribute. isuserdomain This prompts the data import to either attempt to associate the particular resource that is currently being imported with a person in Service Desk or create a new person in Service Desk and associate that new person as a user of that Configuration Item. This gives you the ability to associate any Resource with a user of that Resource. This must be used in conjunction with the isusername attribute. Every Data Class in Notification Server has a number of fields associated with it. You can direct any one of those fields into a specific field on any Configuration Item. When you use a Data Field, you are setting fields on a Configuration Item, not relating Configuration Items together. For more information, see Appendix A on page 56. DATAFIELD resourcefieldaccumulate Example An example for using resourcefieldaccumulate is in the Configuration.xml file in the DATACLASSES section. <DATACLASS name= AeX AC Roles createconfigurationitem= false > <DATAFIELD name= Role resourcefield= Name2 Altiris Connector Pack for HP OpenView Product Guide 32

33 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service resourcefieldaccumulate= true /> </DATACLASS> In this example resourcefieldaccumulate is true. This means that all instances of the AeX AC Roles Data Class will be combined and mapped into the Name2 resourcefield in the Configuration Item in Service Desk. If the AEX AC Roles Data Class has instances called Altiris Agent and Notification Server Client, then the Altiris Agent, Notification Server Client will be placed in the Name2 field in the Configuration Item. If resourcefieldaccumulate were set to false in this example, then Notification Server Client would be placed in the Name2 field in the Configuration Item. DATAFIELD datasubclasssearchcodeexclude Example An example for using datasubclasssearchcodeexclude is in the Configuration.xml file in the DATACLASSES section. <DATACLASS name= AeX AC NT Services createconfigurationitem= true datasubclasscategory= Altiris Data Subclass Software Operating System Service DataSubclassSearchCodeSuffix= -SERVICE > <DATAFIELD name= Path datasubclasssearchcodeexclude= true /> <DATAFIELD name= StartupType datasubclasssearchcodeexclude= true /> <DATAFIELD name= LogonAs datasubclasssearchcodeexclude= true /> </DATACLASS> The AeX AC NT Services Data Class shows multiple services running on a computer. Each of these services has multiple fields of data associated with it (Name, Description, Path, StartupType, LogonAs, and Version). When a Configuration Item for each of these services is created in Service Desk, the values for each of these fields are used to generate a unique search code for the Data Subclass name. In this example the Path, StartupType, and LogonAs fields are excluded from the search code of the the Data Subclass name. DATASUBCLASSES Element The DATASUBCLASSES element lets you configure how and where your Data Subclasses to appear in Service Desk. There can be zero or one DATASUBCLASSES elements in the Configuration.xml file. The attributes listed in the following table are associated with the DATASUBCLASSES element. They are all optional, but if not listed in the Configuration.xml file, their default is used. Attribute defaultcategory defaultsearchcodesuffix defaultstatuswhencreated defaultstatuswhenchangeduser defaultstatuswhenchangedresource Description The category into which all Data Subclasses are imported into Service Desk. The default is Altiris Data Subclass. The suffix you want to add to the end of the search code for all Configuration Items that are created for all Data Subclasses. The default is -DATASUBCLASS. The name of the status that Data Subclasses are given when they are created. The default is Created. The name of the status that Data Subclasses are given when their associated users change. The default is User Changed. The name of the status that Data Subclasses are given when their associated Resources change. The default is Resource Changed. Altiris Connector Pack for HP OpenView Product Guide 33

34 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Attribute defaultstatuswhenchangeddataclass The name of the status that Data Subclasses are given when their associated Data Classes change. The default is Data Class Changed. defaultstatuswhenupdated The name of the status that Data Subclasses are given when they are updated. The default is Updated. Note: The statuses (attributes that start with defaultstatus ) listed above are listed in a hierarchy in order of importance with defaultstatuswhencreated being most important and defaultstatuswhenupdated being least important. There are two ways to categorize a Data Subclass: its defaultcategory and its category. The lowest priority for specifying the category, statuses, and Search Code Suffix for Data Subclasses is the DATASUBCLASSES element. The highest priority for getting the category, statuses, and Search Code Suffix for Data Subclasses is the DATACLASS element. You are not allowed to categorize a Data Subclass by its name as you are with Resources because the names of Data Subclasses are very complex. The default category for a Data Subclass is set by the defaultcategory attribute under the DATASUBCLASSES element. If you want to categorize that Data Subclass according to whatever Data Class it belongs to, then you will have to make a specific entry for that Data Class (as a Data Class element under the DATACLASSES section) and then any Data Subclasses of that category will go to the specified path in that Data Class element. Run a Data Import After you have performed a data export and configured the Configuration.xml file, it is easy to run a data import. In the Program Files\Altiris\ConnectHPOVSDAgentfolder folder, run the ConnectHPOVSDAgent.bat file. This batch file imports the data found in the Import folder into Service Desk. After the files have been imported, they are placed in the Archive folder. IMPORTANT: Service Desk needs to be running in order to perform a data import. Notes The ConnectHPOVSDAgent.bat file calls the Java runtime environment which launches an executable Jar file, sets the memory that you want to have allocated to that application, and then calls the Jar executable. The Jar executable is what actually performs the data import. By default, the Connector Agent allocates 256 MB of Java runtime memory. This memory is used to store the data before it gets placed in Service Desk. You can change this default higher or lower depending on how much memory you have available. The performance of the data import increases when the Java runtime memory is increased. The speed of the data import depends on how many computers you are importing, how many data classes you exported, and whether or not you are performing a delta (update-only) data import. Service Desk uses numerous rules for importing data and may take some time importing data. The data import process takes quite a bit longer than the data export process. The first time you perform a data import, it will take longer than subsequent delta data imports. This Connector never deletes information from Service Desk. It only imports data from Notification Server and creates appropriate relationships of that data in Service Desk. As new data is imported, these relationships can be changed or even broken. For example, if a computer is no longer associated with a hard drive, that relationship is broken, but the hard drive is not deleted from Service Desk. See Also Verify the Data Import on page 35 Description Altiris Connector Pack for HP OpenView Product Guide 34

35 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service To automate the process of importing data into Service Desk You can automate the data import by setting up the Windows Task Scheduler on the Service Desk server. The following steps walk you through this process. 1 On the Service Desk server, open the Control Panel. 2 Select Schedule Tasks. 3 Double-click Add Scheduled Task to run the Scheduled Task Wizard. 4 Select the ConnectHPOVSDAgent.bat file as the program to run (found in Program Files\Altiris\ConnectHPOVSDAgent). 5 Select the schedule that meets your needs. Verify the Data Import When you import inventory data into Service Desk, you will be able to double-click on the resource name, open Resource Manager, and view all of the data on that resource that is in the Notification Database. If you have Carbon Copy installed, you can then access that resource directly from Resource Manager. See Also Integrate the UI on page 35 To view the Initial Import Results 1 Open Service Desk. 2 In the left pane, click CMDB. 3 Select Configuration Items. 4 In the tree view, under CI Category, there should be an Altiris category. Class CIs appear in the Altiris category. Host names appear in the computer sub-category. Inventory CIs appear in the Hardware, Operating System, and Software sub-categories. Integrate the UI This connector provides templates for automatically setting up contextual menu integration. These templates can be found in the ACES folder that is found in the ConnectHPOVSDAgent folder. There are two Aces templates and one shortcut template in this folder. The shortcut template sets up some links to the Altiris Console, the Altiris Reports, and the Connector Configuration window. These appear in the shortcut bar under Altiris in Service Desk. The Actions Aces template is for the contextual menu integration. The Views Aces template lets you have customized views of your Configuration Items (for example, this lets you display only those Configuration Items that have changed, or have been updated, or that have had a field change). To use these templates, you need to either edit the Notification Server name in the URL found in the template and import it, or import the template and change the Notification Server name in Service Desk. To import the template into Service Desk, navigate to Tools > System > File > Aces > Aces Import Wizard. Altiris Connector Pack for HP OpenView Product Guide 35

36 Using the Connector for HP OpenView Service Desk Setting Up and Using the Connector for HP OpenView Service Manually set up contextual menu integration between OVSD and Resource Manager The following describes how to manually set up menu integration between OVSD and Resource Manager. This process can be used if you don t use the templates that are provided in the ACES folder. 1 Open the HP OpenView Service Desk console. The Tools drop-down menu appears at the top of the console. 2 Click on the Tools drop-down menu. System appears in the drop-down menu. 3 Select System. The Business Logic node appears in the left pane of the Administrator Console window. 4 Expand the Business Logic node. The Actions node appears as a child node of the Business Logic node. 5 Expand the Actions node. The Smart Actions node appears as a child node of the Actions node. 6 Expand the Smart Actions node. The Configuration Item node appears as a child node of the Smart Actions node. 7 Select the Configuration Item node. The Smart action pane appears in right-pane of the Administrator Console window. 8 Right-click in the Smart action pane. New Smart Action appears in the popup menu. 9 Select New Smart Action. The New - Smart Action dialog appears. 10 Type Altiris Resource Manager in the Text field. 11 Click the Application button. 12 Select the Internet Explorer application. 13 Enter the URL. The URL should be 14 Click the Field button. Source ID appears in the popup menu. 15 Select Source ID. [Source ID] appears after URL in the Parameters field. 16 Click the OK button. Altiris Resource Manager appears in the Smart action pane of the Administrator Console window. Using Contextual Menu Integration between OVSD and Resource Manager 1 Open the HP OpenView Service Desk console. CMDB appears in the left pane of the console. 2 Click on CMDB. The Configuration Item icon appears under CMDB. 3 Click on the Configuration Item icon. The Category tree sub-pane appears in the left sub-pane of the Configuration Item pane in the right pane of the console. Altiris Connector Pack for HP OpenView Product Guide 36

37 Using the Connector for HP OpenView Service Desk User Interface User Interface 4 Navigate in the Category tree to the node containing the hostnames. The hostnames appear in the right sub-pane of the Configuration Item pane. 5 Double-click on a hostname. The Actions drop-down menu appears at the top of the...- Configuration Item window. 6 Click on the Actions drop-down menu. Altiris Resource Manager appears in the drop-down menu. 7 Select Altiris Resource Manager. Altiris Resource Manager appears containing contextual data (if the hostname was previously imported from Notification Server). Using with Solaris This release of the Connector for HP OpenView Service Desk supports Service Desk servers running on Unix Solaris. Here are some notes of interest if you are running Service Desk on Solaris. Solaris does not natively support Microsoft Windows shares. Yet, we recommend that you create a shared directory on your Service Desk server into which the data export places the XML files. To share the Import directory, you need to install a third-party component, such as Samba, to create a shared directory that Windows can see via UNC paths. Then, you can point the data export to that shared directory. Note: There are other ways to get the XML files to your Solaris Service Desk server besides using a shared directory. Do what works best for you if you do not want to install a third-party component. If you want the data import to run on a schedule, you must set up a UNIX cron job to launch the data import application from time to time. This section describes the elements that are added to the Altiris Console when this Connector gets installed. Quick Links Configure Data Exports on page 37 Download Agent Install on page 38 Reports on page 38 Configure Data Exports This page lets you set up one or more data export configurations. After a configuration has been set up, you can select it from the Select a Configuration drop-down list and run it. For best performance, we recommend that you create multiple data exports that run on different schedules. For example, you can create a full data export that exports all of the needed data periodically according to your needs (such as weekly or monthly). Then, create a delta data export that updates your data more often and in less time (such as daily). The connector gives you the flexibility you need to export the data you want, how you want, and where you want into Service Desk. Altiris Connector Pack for HP OpenView Product Guide 37

38 Using the Connector for HP OpenView Service Desk User Interface To access this page 1 In the Altiris Console, select the Configuration tab. 2 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Service Desk > Configure Data Exports. Page Items Item Select a Configuration Name Description Folder Path for Export Collection To Export Only Export Changes Data Classes To Export Enable Schedule Apply Cancel Description A drop-down list containing the names of configurations you have created. Select the configuration you want and click an icon in the toolbar to test, run, or delete that configuration. The configuration name. This is the name that will appear in the Select a Configuration drop-down list. The configuration description. Enter any description you want. The full path of a local or network folder where the exported XML files will be placed. This can be any UNC path. The collection to export. Data from the collection you select will be exported as XML files. Select this if you want to perform delta exports after the first export. The first export will always export the full data. If this is not selected, each export will be a full export. The data classes to export. Select one or more data classes from this list to export. We recommend that you start with Basic Inventory. After you see what gets exported with Basic Inventory, then you can add more data classes as desired. Note: You can select all data classes in a folder by selecting it or expand the folder to select individual data classes inside the folder. Configure when and how often the data export described by this configuration will run. Click to save your changes and add this configuration to the configuration list. Click to cancel your changes. Download Agent Install This page installs the Connector Agent executable to the Service Desk server. When you click on Download Agent Install, a File Download window should appear. Click Open to install the Connector Agent to the Service Desk server. Note: If the File Download window does not appear automatically, click the click here link in the content pane. Reports The Data Export component provides several reports that let you view import and export data. To view these reports 1 Open the Altiris Console. 2 Click the Reports tab view. 3 In the treeview pane, navigate to Reports > Connector > Import/Export Results. Altiris Connector Pack for HP OpenView Product Guide 38

39 Using the Connector for HP OpenView Service Desk Troubleshooting Troubleshooting Quick Links Database Access Error on page 39 Out of Memory Error on page 39 Database Scalability Limitation on page 39 Database Access Error During import, you may receive the following error (this error is logged both in the Parse.log file and on the console): java.lang.runtimeexception: You are not allowed to view this kernel code hierarchical or this may have been deleted by another user. This is a database access error. The solution is to adjust your database security settings to give administrative rights to the identity that is running the import process. Out of Memory Error During import, you may receive the following error (this error is logged both in the Parse.log file and on the console): Exception in thread main java.lang.outofmemoryerror <<no stack trace available>> This error happens when the computer runs out of RAM while trying to import data. The following are solutions to solve this error, in order of preference. 1 Increase the numbers in these parameters which are found in the ConnectHPOVSDAgent.bat file: -xms256m and -xmx256m. The 256 in these parameters represents the amount of memory (in MB) allocated to the java runtime environment. Increase these to 512 or higher (for example, -xms512m and -xmx512m). 2 Increase the amount of RAM on your computer. Database Scalability Limitation The data integration component of Connector Solution sets a limit of 50,000 rows on report results being exported. This means that if you are using the Connector for large databases, you may be unable to export everything desired. Altiris Connector Pack for HP OpenView Product Guide 39

40 Using the Connector for HP OpenView Operations This connector lets you configure Notification Server to forward Automated Actions and menu items to an HP OpenView Operations server. The SNMP Management component of Connector Solution lets you define the HP OpenView Operations server that will receive Automated Actions and choose which Automated Actions will be forwarded (for more information, see the Altiris Connector Solution Product Guide). Examples of the kinds of Automated Actions that can be forwarded include: change in computer name or low disk space (provided by Inventory Solution), memory module alerts, PC card thermal alerts, and DHCP services error and warnings and DNS error and warnings (provided by Server Monitor Solution). On the HP OpenView Operations server, MIBs imported into Operations translate all the Automated Actions to standard SNMP alerts. These Automated Actions can be individually configured as to whether they are critical, major, minor, normal, or a warning. Altiris-specific menu items can also be added to the HP OpenView Console that lets you launch directly into any installed Altiris console. Quick Links Setting Up and Using the Connector for HP OpenView Operations on page 40 User Interface on page 44 Setting Up and Using the Connector for HP OpenView Operations This section walks you through the steps you need to set up integration between Notification Server and your Operations servers. To successfully set up and use this Connector, follow these Quick Steps in order. Quick Steps Add your Operations Servers to the SNMP Destinations Collection on page 40 Create a Connector Agent Installer for each Operations Server on page 41 Install the Connector Agent Installer on your Operations Servers on page 41 Access Altiris Items on the Operations Console on page 42 Add your Operations Servers to the SNMP Destinations Collection In order to send Automated Actions to your Operations servers, you need to add your Operations computers to the HP OpenView Operations collection in the SNMP Destination Collections folder. The SNMP Destination Collections folder gets installed by Connector Solution as part of the Event Integration component. When the Connector for HP OpenView gets installed, an HP OpenView Operations collection gets created in the SNMP Destination Collections folder. Because this collection is empty, you need to add your Operations computers to this collection before you can send Automated Actions. Automated Actions become SNMP alerts in Operations. Altiris Connector Pack for HP OpenView Product Guide 40

41 Using the Connector for HP OpenView Operations Setting Up and Using the Connector for HP OpenView Operations Note: The SNMP Destination Collections folder is found in the Configuration tab view by navigating in the treeview pane to Configuration > Server Settings > Notification Server Settings > SNMP Management. Add your computers to this collection as explained in the Altiris Connector Solution Product Guide. After you have added computers to this collection, you can enable and edit the Automated Actions for the collection. Follow the instructions found in Enabling and Editing Automated Actions for SNMP Destination Collections in the Altiris Connector Solution Product Guide. Note: All discovered Computers can be added to an SNMP destination collection. See the Notification Server Help for information on discovering computers. Note: This connector creates the necessary MIBs for you (see Configuration on page 45), so you do not need to create the MIBs as explained in the Altiris Connector Solution Product Guide. Quick Link Create a Connector Agent Installer for each Operations Server on page 41 Create a Connector Agent Installer for each Operations Server The Configuration page lets you create a Connector Agent Installer for each of your Operations servers. After this Installer is created, you can install it on the appropriate Operations server. This Installer installs the necessary files can components to configure your Notification Server with your Operations servers. To create a Connector Agent Installer, do the following for each HP OpenView computer you have 1 Open the Altiris Console and click on the Configuration tab. 2 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Operations > Configuration. 3 In the content pane, select an Operations server from the Select an OpenView Operations Computer drop-down list. 4 Select the menu items you want to add to the selected computer. 5 Click Apply. When you click Apply, a Connector Agent Installer, a Connector Agent package, and a Connector Agent collection are all created. Quick Links Configuration on page 45 Install the Connector Agent Installer on your Operations Servers on page 41 Install the Connector Agent Installer on your Operations Servers Download and install the Connector Agent Installer to the appropriate Operations server by either clicking the Download the Configuration Package icon on the OpenView Configuration page or delivering it as a Software Delivery Package if you have Software Delivery Solution. Each Connector Agent Installer is unique to the Operations server for which it was created. Note: You can download the Connector Agent Installer directly by accessing the Altiris Console from the Operations server and clicking the Download the Configuration Package icon. Altiris Connector Pack for HP OpenView Product Guide 41

42 Using the Connector for HP OpenView Operations Setting Up and Using the Connector for HP OpenView Operations Access Altiris Items on the Operations Console This section tells you how to access Altiris items on the Operations console. Common connector tasks are also provided. MIBs can be accessed from Operations by opening up Policy Management > Policy Groups > Altiris. Quick Links Making a Trap a Critical Error in HP OpenView Operations on page 42 Accessing Resource Manager in HP OpenView Operations on page 42 How the SNMP Management Agent Interacts with the HP OpenView Operations Server on page 43 How to set up and use Contextual Menu Integration Between HP OpenView Operations and Resource Manager on page 43 Making a Trap a Critical Error in HP OpenView Operations All Altiris traps are set to the severity they are in Notification Server (or the closest match). To change the severity of a trap to another severity (such as critical), you must first modify the Altiris event associated with that trap. To change the severity of a trap 1 In the HP OpenView Operations main window, in the HP OpenView tree, navigate to Operations Manager > Policy management > Policy groups > Altiris. 2 In the right pane, double-click on an Altiris MIB. 3 Double-click on the event (trap) that you want to change the severity for. 4 Click the Actions tab. 5 Click the Message... button. Note: You can also click the Automatic commands button and enter a command to run as an action for the event. 6 In the Outgoing Message window, click the Message attributes tab. 7 Click the Severity drop-down menu and select Critical. 8 Click OK. 9 You may now close the Altiris MIB window or continue to modify rules as described in steps 3 through 8. Accessing Resource Manager in HP OpenView Operations The Connector for HP OpenView lets you use Resource Manager while using HP OpenView Operations. Resource Manager lets you see everything about an Altiris enabled computer. Note: You will not be able to view Resource Manager on your HP OpenView Operations server unless you have installed the Connector Agent Installer. You can access Resource Manager from HP OpenView Operations in one of two ways: Select a pertinent node (Altiris enabled computer) and then select Resource Manager from the drop-down menu. Open the Resource Manager tool, then select the pertinent node. Altiris Connector Pack for HP OpenView Product Guide 42

43 Using the Connector for HP OpenView Operations Setting Up and Using the Connector for HP OpenView Operations To access Resource Manager via the node (Altiris-enabled computer) Do one of the following: 1 Select a node object in the right pane. a In the HP OpenView Operations main window, in the HP OpenView tree, navigate to Operations Manager > Nodes. b Right-click on Nodes and select View > Map. You need to be in the Map view to launch Resource Manager. c In the right pane, select a node. d Right-click on Nodes and select Launch Tool. e Select Altiris Resource Manager. f Click Launch. 2 Select a node object from the tree. a In the HP OpenView Operations main window, in the HP OpenView tree, navigate to Operations Manager > Nodes. b Under Nodes, right-click on the desired Altiris enabled computer, then select All Tasks > Launch Tool. c d Select Altiris Resource Manager. Click Launch. To access Resource Manager via the tools 1 In the HP OpenView Operations main window, in the HP OpenView tree, navigate to Operations Manager > Tools > Altiris. 2 In the right pane, double-click on Altiris Resource Manager. 3 Select the desired node, then click Launch. How the SNMP Management Agent Interacts with the HP OpenView Operations Server The SNMP Management agent sends the SNMP trap to the HP OpenView Operations server. The SNMP Manager on the HP OpenView server does the following: 1 Looks in the Altiris MIB. 2 Records the trap information in the Message browser. How to set up and use Contextual Menu Integration Between HP OpenView Operations and Resource Manager Setting up Contextual Menu Integration between HP OpenView Operations and Resource Manager 1 Open the HP OpenView Operations console. The Tools node of the HP OpenView tree appears in the left pane of the console. 2 Right-click on the Tools node. Configure appears in the popup menu. 3 Select Configure and Nodes... The Nodes root node appears in the right pane of the Configure Managed Nodes dialog. 4 Right-click on the Nodes root node. Properties appears in the popup menu. 5 Select Properties. Altiris Connector Pack for HP OpenView Product Guide 43

44 Using the Connector for HP OpenView Operations User Interface User Interface The Tools tab appears in the Folder Properties dialog. 6 Select the Tools tab. The Add... button appears next to Tools Associated with this node group:. 7 The on the Add... button. The Altiris node appears as a child node of the Tools root node in the Associate Tools with Node Group dialog. 8 Expand Altiris. Altiris Resource Manager appears as a child node of the Altiris node. 9 Select Altiris Resource Manager. The OK button appears at the bottom of the Associate Tools with Node Group dialog. 10 Click the OK button. The OK button appears at the bottom of the Folder Properties dialog. 11 Click the OK button. The OK button appears at the bottom of the Configure Managed Nodes button. 12 Click the OK button. Using Contextual Menu Integration between HP OpenView Operations and Resource Manager 1 Open the HP OpenView Operations console. The Nodes node of the HP OpenView tree appears in the left pane of the console. 2 Expand the Nodes node. The hostname nodes appear as children nodes of the Nodes node. 3 Right-click on a hostname node. All Tasks appears in the popup menu. 4 Select All Tasks and Launch Tool. The Altiris Resource Manager tool appears in the Select the Tool to Execute dialog. 5 Select the Altiris Resource Manager tool. The Launch... button appears at the bottom of the Select the Tool to Execute dialog. 6 Click the Launch... button. Altiris Resource Manager appears containing contextual data (if the hostname was previously inventoried by Notification Server). This section describes the elements that are added to the Altiris Console when this Connector gets installed. Quick Links Agent on page 44 Configuration on page 45 Agent The Agent folder contains collections, packages, and tasks that are created for each Operations computer that you configure on the HP OpenView Operations Configuration page. Generally, each collection in the Agent folder contains only one computer. Altiris Connector Pack for HP OpenView Product Guide 44

45 Using the Connector for HP OpenView Operations User Interface To access this folder 1 In the Altiris Console, select the Configuration tab. 2 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Operations > Agent. Configuration This page lets you build a unique configuration package (Connector Agent Installer) to install on each HP OpenView Operations server you have. The Connector Agent Installer contains Altiris MIBs and menu items that let you integrate Notification Server with your HP OpenView Operations servers. To add computers to the Select an OpenView Operations Computer drop-down list, click the Add or Remove a Computer button and add one or more computers to the HP OpenView Operations collection. Click the Apply button to save your changes, then navigate back to the Configuration page. The HP OpenView Operations collection can be viewed by navigating to Configuration > Server Settings > Notification Server Settings > SNMP Management > SNMP Destination Collections. To configure an HP OpenView computer, select a computer from the Select an OpenView Operations Computer drop-down list. Then, select the menu items you want for that computer from the Select the Menu Items to Display OpenView Operations list. Each HP OpenView Operations computer has its own configuration. All actions performed on this page apply to the selected HP OpenView Operations computer on the Select an OpenView Operations Computer drop-down list. Click Add or Remove a Computer to add a computer to the list or remove a computer from the list. From the Agent package, you can set up a schedule to install the Connector Agent Installer. Then, when you update the configuration and click Apply, the Connector Agent Installer gets installed according to the schedule. To access this page 1 In the Altiris Console, select the Configuration tab. 2 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Operations > Configuration. Page Items Item Select an OpenView Operations Computer Add or Remove a Computer Select the Menu Items to Display in OpenView Operations Description Displays available HP OpenView Operations servers. Select the computer that you want to configure and send the Connector Agent Installer to. This lets you add a computer to or remove a computer from the Select an OpenView Operations Computer list. Select the menu items that you want to have available on this Operations server. Altiris Connector Pack for HP OpenView Product Guide 45

46 Using the Connector for HP OpenView Operations User Interface Page Items Item Apply Cancel Description Click to save your changes. When you click Apply, the following happens: a Connector Agent Installer is created that contains Altiris MIBs and the selected menu items a Connector Agent collection for this Operations server is created and placed in the Agent Packages Collections folder a Connector Agent package for this Operations server is created and placed in the Agent Packages folder Click to cancel your changes. Configuration Toolbar The configuration toolbar appears at the top of the contents pane. The clickable icons let you perform actions on the configuration of the selected HP OpenView computer. The clickable icons on the configuration toolbar are: Add or Remove a Computer - Lets you add a computer to or remove a computer from the Select an OpenView Computer list. Go to the Software Delivery Package - Takes you to the Software Delivery Package for this Operations server. Download the Configuration Package - Opens a download page, which lets you download and install the Connector Agent Installer to the appropriate Operations server. Configure SNMP Destination - Takes you to the SNMP Destinations Configuration page. This page lets you enable and edit the Automated Actions for the collection. This information is used for creating the Altiris MIBs that get placed in the Connector Agent Installer. Right click menu - Displays the right click menu for the folder. Altiris Connector Pack for HP OpenView Product Guide 46

47 Using the Connector for HP OpenView Network Node Manager This connector lets you configure Notification Server to forward Automated Actions and menu items to an HP OpenView Network Node Manager (NNM) server. The SNMP Management component of Connector Solution lets you define the HP OpenView NNM server that will receive Automated Actions and choose which Automated Actions will be forwarded (for more information, see the Altiris Connector Solution Product Guide). Examples of the kinds of Automated Actions that can be forwarded include: change in computer name or low disk space (provided by Inventory Solution), memory module alerts, PC card thermal alerts, and DHCP services error and warnings and DNS error and warnings (provided by Server Monitor Solution). On the HP OpenView NNM server, MIBs imported into NNM translate all the Automated Actions to standard SNMP alerts. These Automated Actions can be individually configured as to whether they are critical, major, minor, normal, or a warning. Altiris also uses an Application Registration File (ARF) to add a context sensitive menu option to the HP OpenView console for Altiris Resource Manager. With a right-click on your mouse, you can launch the Altiris Resource Manager which provides detailed information about the device and a user interface that allows you to remote control the device. Altiris-specific menu items can also be added to the HP OpenView Console that lets you launch directly into any installed Altiris console. Quick Links Setting Up and Using the Connector for HP OpenView NNM on page 47 User Interface on page 52 Setting Up and Using the Connector for HP OpenView NNM This section walks you through the steps you need to set up integration between Notification Server and your NNM servers. To successfully set up and use this Connector, follow these Quick Steps in order. Quick Steps Add your NNM Servers to the SNMP Destinations Collection on page 47 Create a Connector Agent Installer for each NNM Server on page 48 Install the Connector Agent Installer on your NNM Servers on page 48 Access Altiris Items on the NNM Console on page 49 Add your NNM Servers to the SNMP Destinations Collection In order to send Automated Actions to your NNM servers, you need to add your NNM computers to the HP OpenView Network Node Manager collection in the SNMP Destination Collections folder. The SNMP Destination Collections folder gets installed by Connector Solution as part of the Event Integration component. Altiris Connector Pack for HP OpenView Product Guide 47

48 Using the Connector for HP OpenView Network Node ManagerSetting Up and Using the Connector for HP OpenView When the Connector for HP OpenView gets installed, an HP OpenView Network Node Manager collection gets created in the SNMP Destination Collections folder. Because this collection is empty, you need to add your NNM computers to this collection before you can send Automated Actions. Automated Actions become SNMP alerts in NNM. Note: The SNMP Destination Collections folder is found in the Configuration tab view by navigating in the treeview pane to Configuration > Server Settings > Notification Server Settings > SNMP Management. Add your computers to this collection as explained in the Altiris Connector Solution Product Guide. After you have added computers to this collection, you can enable and edit the Automated Actions for the collection. Follow the instructions found in Enabling and Editing Automated Actions for SNMP Destination Collections in the Altiris Connector Solution Product Guide. Note: All discovered Computers can be added to an SNMP destination collection. See the Notification Server Help for information on discovering computers. Note: This connector creates the necessary MIBs for you (see Configuration on page 52), so you do not need to create the MIBs as explained in the Altiris Connector Solution Product Guide. Quick Link Create a Connector Agent Installer for each NNM Server on page 48 Create a Connector Agent Installer for each NNM Server The Configuration page lets you create a Connector Agent Installer for each of your NNM servers. After this Installer is created, you can install it on the appropriate NNM server. This Installer installs the necessary files can components to configure your Notification Server with your NNM servers. To create a Connector Agent Installer, do the following for each HP OpenView computer you have 1 Open the Altiris Console and click on the Configuration tab. 2 In the treeview pane, navigate to Configuration > Solutions Settings > Connectors > HP OpenView Network Node Manager > Configuration. 3 In the content pane, select an NNM server from the Select an OpenView Network Node Manager Computer drop-down list. 4 Select the menu items you want to add to the selected computer. 5 Click Apply. When you click Apply, a Connector Agent Installer, a Connector Agent package, and a Connector Agent collection are all created. Quick Links Configuration on page 52 Install the Connector Agent Installer on your NNM Servers on page 48 Install the Connector Agent Installer on your NNM Servers Download and install the Connector Agent Installer to the appropriate NNM server by either clicking the Download the Configuration Package icon on the OpenView Configuration page or delivering it as a Software Delivery Package if you have Software Delivery Solution. Each Connector Agent Installer is unique to the NNM server for which it was created. Note: You can download the Connector Agent Installer directly by accessing the Altiris Console from the NNM server and clicking the Download the Configuration Package icon. Altiris Connector Pack for HP OpenView Product Guide 48

49 Using the Connector for HP OpenView Network Node ManagerSetting Up and Using the Connector for HP OpenView Access Altiris Items on the NNM Console This section tells you how to access Altiris items on the NNM console. Common connector tasks are also provided. After the Connector Agent Installer is installed on the NNM computer, Altiris tools can be accessed by clicking Tools > Altiris from the NNM console. MIBs can be accessed from NNM by opening up Policy Management > Policy Groups > Altiris. Quick Links Altiris Integration with HP OpenView NNM on page 49 Making a Trap a Critical Error in HP OpenView NNM on page 49 Accessing Resource Manager in HP OpenView NNM on page 51 How the NS SNMP Agent Interacts with the HP OpenView NNM Server on page 52 Altiris Integration with HP OpenView NNM The following describes the additions to the HP OpenView NNM browser after the install package has been installed to the HP OpenView server. Altiris Buttons Two new Altiris standard buttons appear on the NNM browser. 1 The Altiris button lets you access the Altiris Console. 2 The Altiris Resource Manager button lets you access Resource Manager when a node is selected. Altiris Alarms Browser When the HP OpenView NNM browser opens, an Alarm Categories window is displayed. There is an Altiris option that, when selected, displays the Altiris Alarms Browser. Making a Trap a Critical Error in HP OpenView NNM All Altiris traps are set to warning severity (HP OpenView default). To change the severity of a trap to any other severity, such as critical, you must first modify the Altiris event associated with that trap. Altiris Connector Pack for HP OpenView Product Guide 49

50 Using the Connector for HP OpenView Network Node ManagerSetting Up and Using the Connector for HP OpenView To do so, follow these steps: 1 In the HP OpenView NNM main window, click on the Options drop-down menu and select Event Configuration. The Event Configuration window will open. 2 Select the altiris enterprise in the top pane of the window, and then double-click on the pertinent event in the bottom pane of the window. The Modify Events window will open. 3 Click on the Event Message tab to reveal the Event Message configuration options. Altiris Connector Pack for HP OpenView Product Guide 50

51 Using the Connector for HP OpenView Network Node ManagerSetting Up and Using the Connector for HP OpenView 4 Set the Severity drop-down menu option to Critical, and click the OK button. The Modify Events window will close, and you will return to the Event Configuration window. 5 Click on the File drop-down menu and select Save. The event will now produce a critical error notification when it receives the associated trap from Notification Server. 6 You may now close the Event Configuration window or continue to modify events as described in Step 2 through Step 5. Accessing Resource Manager in HP OpenView NNM The Connector for HP OpenView lets you use Resource Manager while using HP OpenView. Resource Manager lets you view all inventory data collected from an Altiris enabled computer. It also lets you launch Carbon Copy, if it has been installed, to remote control to the Altiris enabled computer. Note: You will not be able to view Resource Manager on your HP OpenView NNM server unless you have installed the Connector Agent Installer. To access Resource Manager from HP OpenView NNM, you must select a pertinent node (Altirisenabled computer) and then select Resource Manager from the drop-down menu. Note: If Resource Manager notifies you that Summary data is not ready for the node you selected, then you must use Notification Server to inventory the node before you can use Resource Manager to navigate its resources. For instructions on how to use Notification Server to inventory a node (using the Altiris Agent), please refer to the Altiris Notification Server Help. To access Resource Manager from HP OpenView NNM 1 In the HP OpenView main window, select the node for which you would like to launch Resource Manager. Please note that the node must display a host name that has been inventoried by Notification Server. 2 Open Resource Manager by doing one of the following: Altiris Connector Pack for HP OpenView Product Guide 51