BMC Atrium CMDB Adapter Installation Guide for HP … Atrium CMDB adapter Installation Guide for HP ... versions of Hewlett Packard (HP) Universal Configuration ... CMDB adapter for

www.bmc.com

BMC Atrium CMDB adapterInstallation Guidefor HP UCMDB

February 2013

Contacting BMC Software

You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada

Address BMC SOFTWARE INC2101 CITYWEST BLVDHOUSTON TX 77042-2827 USA

Telephone 1 713 918 8800 or1 800 841 2031

Fax 1 713 918 8000

Outside United States and Canada

Telephone +1 713 918 8800 Fax +1 713 918 8000

© Copyright 2012-2013 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners.

Linux is the registered trademark of Linus Torvalds.

The information included in this documentation is the proprietary and confidential information of BMC Software, Inc., its affiliates, or licensors. Your use of this information is subject to the terms and conditions of the applicable End User License agreement for the product and to the proprietary and restricted rights notices included in the product documentation.

Restricted rights legendU.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC SOFTWARE INC, 2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA. Any contract notices should be sent to this address.

http://www.bmc.com

Customer support

You can obtain technical support by using the BMC Support Central website or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, see “Before contacting BMC.”

Support website

You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support. From this website, you can

■ read overviews about support services and programs that BMC offers■ find the most current information about BMC products■ search a database for issues similar to yours and possible solutions■ order or download product documentation■ download products and maintenance■ report an issue or ask a question■ subscribe to receive proactive e-mail alerts when new product notices are released■ find worldwide BMC support center locations and contact information, including e-mail addresses, fax numbers, and

telephone numbers

Support by telephone or e-mail

In the United States and Canada, if you need technical support and do not have access to the web, call 1 800 537 1813 or send an e-mail message to [email protected]. (In the subject line, enter SupID:<yourSupportContractID>, such as SupID:12345). Outside the United States and Canada, contact your local support center for assistance.

Before contacting BMC

Have the following information available so that Customer Support can begin working on your issue immediately:

■ product information

— product name— product version (release number)— license number and password (trial or permanent)

■ operating system and environment information

— machine type— operating system type, version, and service pack or other maintenance level such as PUT or PTF— system hardware configuration— serial numbers— related software (database, application, and communication) including type, version, and service pack or

maintenance level

■ sequence of events leading to the issue

■ commands and options that you used

■ messages received (and the time and date that you received them)

— product error messages— messages from the operating system, such as file system full— messages from related software

3

http://www.bmc.com/support

mailto:[email protected]

License key and password information

If you have questions about your license key or password, use one of the following methods to get assistance:

■ Send an e-mail message to [email protected].

■ Use the Customer Support website at http://www.bmc.com/support.

4 BMC Atrium CMDB adapter for HP UCMDB

mailto:[email protected]

http://www.bmc.com/support

ContentsChapter 1 Overview of HP UCMDB adapter installation 9

About the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Supported versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 2 Planning your installation 11

Downloading the installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Installation events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13User permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Turning off DEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 3 Installing the HP UCMDB adapter 17

Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Installing the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing the HP UCMDB adapter on a secondary server . . . . . . . . . . . . . . . . . . . 19Components installed during the HP UCMDB adapter installation . . . . . . . . . . . . . . 19

Chapter 4 Upgrading the HP UCMDB adapter 21

Before you upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Back up TQLs and the AI7604RepositoryBackup folder . . . . . . . . . . . . . . . . . . . . . 21

Upgrading the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 5 Uninstalling the HP UCMDB adapter 23

Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Uninstalling the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 6 HP UCMDB adapter Maintenance Tool 25

Using the HP UCMDB adapter Maintenance Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Using installation and uninstallation logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Zipping logs to send to BMC Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Location of the CMDB Extension Loader log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Index 29

Contents 5


TablesAdapter installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Components installed during the HP UCMDB adapter installation . . . . . . . . . . . . . . 19

Tables 7


C h a p t e r 1
1 Overview of HP UCMDB adapter installation
This section provides an overview of BMC Atrium CMDB adapter for HP UCMDB and gives information about the different supported versions of Hewlett Packard (HP) Universal Configuration Management Database (UCMDB).

The following topics are presented:

■ About the HP UCMDB adapter■ Supported versions■ Audience

About the HP UCMDB adapterThe HP UCMDB and the BMC Atrium CMDB are both configuration management databases (CMDB) used by enterprise IT organizations to document, store, and manage details of the configuration items (CI) in the IT infrastructure.

The BMC Atrium CMDB adapter for HP UCMDB provides an integration plugin, using which you can retrieve data from the HP UCMDB, transform it into data that can be used by Atrium CMDB, and insert this data into the Atrium CMDB. After this is done the HP UCMDB discovered data is ready to be used by other BMC applications which share the Atrium CMDB data.

For a complete list of components added during the HP UCMDB adapter installation, see “Components installed during the HP UCMDB adapter installation” on page 19.

Chapter 1 Overview of HP UCMDB adapter installation 9

Supported versions

Supported versionsThe BMC Atrium CMDB adapter for HP UCMDB version 2.0.00 supports:

■ HP UCMDB version 8.x and 9.x ■ BMC Atrium CMDB 8.0.00■ BMC Atrium CMDB 8.1.00■ BMC Remedy AR System 8.0.00■ BMC Remedy AR System 8.1.00■ Atrium Integrator 8.0.00■ Atrium Integrator 8.1.00■ Microsoft Windows Server 2008 R2 Standard■ Microsoft Windows Server 2003 Standard Edition■ Red Hat Enterprise Linux Server release 5.5

AudienceThis documentation is intended for administrators of BMC Atrium CMDB.


C h a p t e r 2
2 Planning your installation
This section describes the system requirements and provides worksheets that you can use to gather the information needed to install BMC Atrium CMDB adapter for HP UCMDB.


■ Downloading the installer■ Installation events■ User permissions■ Installation worksheet■ Turning off DEP

Downloading the installerThe BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer is available for download from the BMC Electronic Product Distribution (EPD) website.

You can access this website at http://webapps.bmc.com/epd. To use the website, you need the user name and password that you obtained when you registered and subscribed to Customer Support. To subscribe, you must have a valid Support Contract ID. If you do not know your Support Contract ID, contact [email protected].

If you do not have a current license for the product, contact your BMC sales representative or your local BMC office or agent. If you cannot download the product, you can request a physical kit.


Downloading the installer

To download the product installation files

1. Create a directory in which to place the downloaded files.

2. Go to https://webapps.bmc.com/signon/content/logon.jsp.

3. Enter your user ID and password, and click Submit.

4. Click Download Product.

5. On the Export Compliance and Access Terms page, provide the required information, agree to the terms of the agreements, and click Continue.

6. If you are accessing this site for the first time, create an EPD profile; otherwise, skip to step 7:

A. Under Localized Languages, select the language for the product.

B. Under Install Platforms, select the platforms to download for the product.

C. Click Save Profile.

7. Verify that the correct profile is displayed for your download purpose, and select the Licensed Products tab.

8. Locate the product:

A. Locate the product name and expand its entries to show the available version numbers. For example, to download the BMC Atrium CMDB adapter for HP UCMDB installer, select BMC Atrium CMDB Adapters.

B. Expand the version number to show the available versions.

C. Select the check boxes next to the products and documents to download.

NOTE On Microsoft Windows computers, ensure that the directory is only one level into the directory structure. The EPD package creates a directory in the temporary directory when you extract the files, and the directory that contains the installation image should not be in a directory deeper than two levels into the directory structure.


Installation events

9. To download the selected items, click Download (FTP) or Download Manager:

■ Download (FTP) places the selected items in an FTP directory, and the credentials and FTP instructions are sent to you in an email message.

■ Download Manager enables you to download multiple files consecutively and to resume an interrupted download if the connection drops. This method requires a one-time installation of the AkamiNetSession Client program on the target computer and is usually the faster and more reliable way to transfer files. A checksum logic is used to verify file integrity automatically.

Installation eventsThis section provides information about how to plan for your installation and prepare your environment before installing the BMC Atrium CMDB adapter for HP UCMDB by using the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer.

1. Ensure that HP UCMDB is installed and is running on a computer and you have the URL, user name, and password to access it.

2. Ensure that the BMC Remedy Action Request System (BMC Remedy AR System) is installed on the same computer where you are installing the BMC Atrium CMDB adapter for HP UCMDB.

3. Ensure that both HP UCMDB and BMC Remedy AR System are running.

4. Ensure that BMC Atrium CMDB and Atrium Integrator are installed on the same computer where you are installing the BMC Atrium CMDB adapter for HP UCMDB.

5. When installing on a Microsoft Windows computer, ensure that you have turned off Data Execution Prevention (DEP) for the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer setup.exe file. The “Turning off DEP” on page 15 describes how to turn off DEP for the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer setup.exe file.

6. When installing on a Linux computer, ensure that you have provided execution rights to the installer folder, all its subfolders, and files.

7. When installing on a Linux computer, ensure that you have set the environment variable for the installed location of Atrium Integrator. For example:

export BMC_AR_SYSTEM_HOME=/opt/bmc/ARSystem


User permissions

User permissionsWhen you run the installation program, you must be logged on to the destination computer as the administrator or as a user with administrator rights and permissions.

Installation worksheetBefore installing the BMC Atrium CMDB adapter for HP UCMDB, you must gather the parameter information that the installer requires for each product. This section has a worksheet that you can use to gather the information necessary to complete the installation process. To avoid installation errors, print out the worksheet, fill it with relevant information, and refer to it when you run the installation.

Table 1 Adapter installation worksheet

Panel name and setting Default value and notes Your value

Directory Selection

Destination Directory Default value:

■ (Windows) C:\Program Files (x86)\BMC Software\UCMDBAdapter

■ (Linux) /opt/bmc/UCMDBAdapter

Directory Selection

UCMDB API WAR Directory None

HP UCMDB Connection Validation Settings

HP UCMDB Service URL

HP UCMDB Server User

HP UCMDB Server Password

BMC Remedy AR System User Inputs

AR System Server Administrator Name

AR System Server Administrator Password

AR System Server TCP Port Default value: 0

Note: A value of 0 indicates use of the port mapper service. If a fixed port is being used, specify the port number.

AR System Server Name Alias


Turning off DEP

Turning off DEPBefore installing the BMC Atrium CMDB adapter for HP UCMDB on your Microsoft Windows computer, you must ensure that Data Execution Prevention (DEP) is turned off for the BMC Atrium CMDB Application Adapter 2.0.00 installer setup.exe file.

To turn DEP off for a program, you must be logged on as an administrator or a member of the Administrators group. If your computer is connected to a network, network policy settings can prevent you from completing this procedure.

To turn off DEP

1 To open System Properties, click Start > Control Panel, and then double-click System.

2 Click the Advanced tab and, under Performance, click Settings.

3 On the Data Execution Prevention tab, select Turn on DEP for all programs and services except those I select.

4 Click Add.

5 Navigate and locate the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer setup.exe file.

6 Double-click the setup.exe file.

7 Verify that InstallAnywhere Self-Extractor is added to the list.

8 Click OK.


Turning off DEP


C h a p t e r 3
3 Installing the HP UCMDB adapter
This section provides instructions for installing the BMC Atrium CMDB adapter for HP UCMDB.


■ Before you begin■ Installing the HP UCMDB adapter■ Components installed during the HP UCMDB adapter installation

Before you beginEnsure that you have fulfilled the prerequisites described in Chapter 2, “Planning your installation”.

Installing the HP UCMDB adapterThis section contains instructions for installing the BMC Atrium CMDB adapter for HP UCMDB software.

To install the HP UCMDB adapter

1 On the Welcome page, click Next.

2 Review the license agreement, select I agree to the terms of license agreement, and then click Next.

3 On the Directory Selection page, navigate to the directory in which you want to install the BMC Atrium CMDB adapter for HP UCMDB software.


Installing the HP UCMDB adapter

The default location is:

■ (Windows) C:\Program Files (x86)\BMC Software\uCMDAdapter

■ (Linux) /opt/bmc/UCMDBAdapter

4 Click Next.

5 Get the ucmdb-api.war file from the following location. This WAR file must be copied from the HP UCMDB installation location to the computer where the BMC Atrium CMDB adapter for HP UCMDB is being installed.

■ HP UCMDB 8.x: <UCMDB installation location>\UCMDBServer\j2f\AppServer\webapps\ucmdb-api.war

■ HP UCMDB 9.x: <UCMDB installation location>\UCMDBServer\deploy-api\ucmdb-api-8.0.war

6 On the UCMDB API WAR File Selection page, navigate to the directory in which the ucmdb-api.war file is located.

7 On the HP UCMDB Connection Inputs page, specify the HP UCMDB Service URL and user credentials.

8 Click Next.

9 On the BMC Remedy AR System User Inputs page, specify the AR System Server Administrator user credentials, AR System Server TCP Port, and AR System Server Name Alias.

The default AR System Server TCP Port is 0. A value of 0 indicates use of the port mapper service. If a fixed port is being used, specify the port number.

10 Click Next.

11 On the Installation Preview page, click Install.

12 On the Installation Summary page, click View Log to review any messages.

13 Click Done to exit the installer.


Installing the HP UCMDB adapter on a secondary server

Installing the HP UCMDB adapter on a secondary server

To execute jobs and transformations from a secondary server, you must install the HP UCMDB adapter on the secondary server.

To install the HP UCMDB adapter on a secondary server

1 Navigate to primary server where the HP UCMDB adapter is installed.

2 Go to the following location:

■ (Microsoft Windows) C:\Program Files\BMC Software\ARSystem\diserver\data-integration\plugins\steps\

■ (Linux) /opt/bmc/ ARsystem/ diserver/dataintegration/plugins/steps

3 Copy the AtriumCustomWSPlugin_9 folder from the primary server.

4 Navigate to the AR System server installation folder on the secondary server.

■ (Microsoft Windows) C:\Program Files\BMC Software\ARSystem\diserver\data-integration\plugins\steps\

■ (Linux) /opt/bmc/ ARsystem/ diserver/dataintegration/plugins/steps

5 Paste the AtriumCustomWSPlugin_9 folder in the steps folder.

Components installed during the HP UCMDB adapter installation

When you install the BMC Atrium CMDB adapter for HP UCMDB software, the following components are installed during the HP UCMDB adapter installation.

Table 2 Components installed during the HP UCMDB adapter installation

Component Description

TQLs TQLs are imported into the HP UCMDB. For a complete list, see the BMC Atrium CMDB adapter User Guide for HP UCMDB.

Dataset HPUCMDB.IMPORT dataset is created in the BMC Atrium CMDB.

UCMDBIntegrationID UCMDBIntegrationID attribute is added to the BMC_BaseElement class.

ArtiumCustomWSPlugIn AtriumCustomWSPlugIn_8 and AtriumCustomWSPlugIn_9 folders are copied to Atrium Integrator installation directory.

Error logs folder UCMDBAdapterOutput folder for Error logs is created (on the drive where the Adapter is installed in MS Windows).


Components installed during the HP UCMDB adapter installation

Atrium Integrator jobs Atrium Integrator jobs are imported into the Atrium Integrator repository in the UCMDB folder.

KTRs KTRs are imported into the Atrium Integrator repository in the UCMDB folder.

HP UCMDB connection KTRs are updated with the proper HP UCMDB connection details.

CMDB database connection

KTRs are updated with Atrium CMDB database connection details.

Normalization Engine jobs NE jobs are created in the BMC Atrium Core CMDB.

Reconcilation Engine jobs RE jobs are created in the BMC Atrium Core CMDB.

Launch in Context Launch in Context configurations are imported in the BMC Remedy AR System server.

Licenses Adapter is registered in Licenses.

Share Application Properties

Adapter is registered in the SHARE:Application_Properties form.

Index Index is created on the UCMDBIntegrationID and DatasetID attributes of the BMC_BaseElement class.

Table 2 Components installed during the HP UCMDB adapter installation

Component Description


C h a p t e r 4
4 Upgrading the HP UCMDB adapter
This section provides instructions for upgrading the BMC Atrium CMDB adapter for HP UCMDB.


■ Before you upgrade■ Upgrading the HP UCMDB adapter

Before you upgradeThe following versions must be installed:

■ BMC Atrium CMDB adapter for HP UCMDB version 1.0.00 must be installed and working with BMC Atrium CMDB 7.6.04.

■ BMC Atrium CMDB 7.6.04, BMC Remedy AR System 7.6.04, and Atrium Integrator 7.6.04 must be upgraded to BMC Atrium CMDB 8.0.00 or 8.1.00, BMC Remedy AR System 8.0.00 or 8.1.00, and Atrium Integrator 8.0.00 or 8.1.00.

Back up TQLs and the AI7604RepositoryBackup folder

Before upgrading, BMC recommends that you back up the following:

■ TQLs in the HP UCMDB■ The AI7604RepositoryBackup folder located at C:\Program Files\BMC Software\ARSystem

The AI7604RepositoryBackup folder stores your old jobs and transformations.

Chapter 4 Upgrading the HP UCMDB adapter 21

Upgrading the HP UCMDB adapter

To back up TQLs in HP UCMDB 8.x

1 Log on to HP UCMDB 8.x.

2 Navigate to Settings > Package Manager.

3 Right-click BMC_Atrium_8_TQL and click Export Package.

4 Navigate to the folder where you want to export the backup.

5 Select the whole package or select the required TQLs and Jobs.

6 Click Save.

To back up TQLs in HP UCMDB 9.x

1 Log on to HP UCMDB 9.x.

2 Navigate to Settings > Package Manager.

3 Right-click BMC_Atrium_9_TQL and click Export Package.

4 Navigate to the folder where you want to export the backup.

5 Select the whole package or select the required TQLs and Jobs.

6 Click Save.

Upgrading the HP UCMDB adapterThis section provides instructions for upgrading the BMC Atrium CMDB adapter for HP UCMDB software.

To upgrade the HP UCMDB adapter

1 Navigate and locate the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer setup.exe file.

2 Double-click the setup.exe file.

3 Perform the steps listed in “Installing the HP UCMDB adapter” on page 17.

4 After the installation is completed, apply your customizations to the TQLs and KTRs.


C h a p t e r 5
5 Uninstalling the HP UCMDB adapter
This section provides instructions for uninstalling the BMC Atrium CMDB adapter for HP UCMDB.


■ Before you begin■ Uninstalling the HP UCMDB adapter

Before you begin■ Ensure that all transformations and jobs are closed in Atrium Integrator (Spoon).■ When uninstalling on a Linux computer, ensure that you have set the environment

variable for the installed location of Atrium Integrator. For example:

export BMC_AR_SYSTEM_HOME=/opt/bmc/ARSystem

Uninstalling the HP UCMDB adapterThis section provides instructions for uninstalling the BMC Atrium CMDB adapter for HP UCMDB software.

NOTE Uninstalling the BMC Atrium CMDB adapter for HP UCMDB will remove all installed components except any data that was copied to Atrium CMDB as the part of integration.

Chapter 5 Uninstalling the HP UCMDB adapter 23

Uninstalling the HP UCMDB adapter

To uninstall from a Microsoft Windows computer

1 To open the Programs and Features page, click Start > Control Panel > Programs, and then double-click Programs and Features.

2 Select the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 installer from the list, and then click Uninstall.

3 On the Welcome page, click Next.

4 On the Select the Features page, select BMC Atrium CMDB adapter for HP UCMDB 2.0.00.

5 Click Next.

6 On the Uninstallation Preview page, click Uninstall.

7 On the Uninstallation Summary page, click View Log to review any messages.

8 Click Next.

9 On the installation completion page, you are required to select Yes, restart my system.

10 Click Done to exit the installer and restart your computer.

To uninstall from a Linux computer

1 Navigate to the installation folder for BMC Atrium CMDB adapter for HP UCMDB.

The default location for the uninstall.sh file is as follows:

■ /opt/bmc/UCMDBAdapter/UninstallBMCUCMDBInstaller/

2 Run uninstall.sh.

3 Click Done to exit the installer and restart your computer.

NOTE When uninstalling the adapter from Linux, you need to delete the /opt/bmc/UCMDBAdapter/ folder.


C h a p t e r 6
6 HP UCMDB adapter Maintenance Tool
This section provides instructions for using the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool.


■ Using the HP UCMDB adapter Maintenance Tool■ Using installation and uninstallation logs■ Zipping logs to send to BMC Customer Support■ Location of the CMDB Extension Loader log files

Using the HP UCMDB adapter Maintenance Tool

The Common Install Framework is a common installation program used by many BMC Software products. Products using the Common Install Framework install the Maintenance Tool.

The Maintenance Tool provides a common tool to access diagnostics and utilities. You can use the Maintenance Tool to review logs or configuration parameters. The Maintenance Tool also provides the Log Zipper utility that collects and archives log files and operating system information that BMC Customer Support can use to help you troubleshoot problems.

This section contains instructions for using the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool.


Using the HP UCMDB adapter Maintenance Tool

To run the HP UCMDB adapter Maintenance Tool

1 From the installation directory of the product, open the ucmdbinstaller folder.

The default installation directory is as follows:

■ (Windows) C:\Program Files (x86)\BMC Software\UCMDBAdapter ■ (Linux) /opt/bmc/UCMDBAdapter

2 Execute the following file to open the BMC Atrium CMDB adapter for HP UCMDB 2.0.00 Maintenance Tool:

■ (Windows) UCMDBInstallerMaintenanceTool.cmd ■ (Linux) UCMDBInstallerMaintenanceTool.sh

The following tabs are displayed:

■ Logs■ Configuration■ Health Check■ Encrypt

NOTE BMC Atrium CMDB adapter for HP UCMDB uses the Logs tab. The other tabs are for other applications such as BMC Remedy Atrium. For more information, see the documentation for those products.


Using installation and uninstallation logs

Using installation and uninstallation logsWhen you run the BMC Atrium CMDB adapter for HP UCMDB installer or uninstaller, a log file is created in the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool.

To view logs

1 Open the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool.

2 Click the Logs tab. On the Logs tab, you can perform the following actions:

■ To view the installation log, click Install Log. This action is required when you want to see the messages generated during installation or search the install logs to identify issues. Search for rows highlighted in red (errors) or yellow (warnings).

■ To view the uninstallation log, click Uninstall Log. This action is required when you want to see the messages generated during uninstallation or search the uninstall logs to identify issues. Search for rows highlighted in red (errors) or yellow (warnings).

■ To view the configuration log, click Configuration Log. ■ To open the folder that contains the log files, click Browse to Log.

Zipping logs to send to BMC Customer Support

Installation issues and application issues can occur during installation or application use. You can use the Log Zipper, part of the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool, to zip all the log files that are necessary to debug issues. This action is required when you want to send the logs to Support for error investigation.

NOTE Click the column header to sort columns. To reverse sort a column, press the Shift key while clicking the column header.


Location of the CMDB Extension Loader log files

To zip logs

1 Open the BMC Atrium CMDB adapter for HP UCMDB Maintenance Tool.

2 Click the Logs tab. On the Logs tab, you can perform the following actions:

■ To zip all log files for Support, click Zip Logs. This action is required when you want to send the log files to Support for error investigation.

■ To zip all registered product logs on the computer, click Zip All Logs. This action is required when you want to send the logs to Support for error investigation.

3 Send the UCMDBInstallerLogs.zip output file from the temp directory to BMC Customer Support.

4 Navigate to <UCMDB installation location>\UCMDBAdapter\Logs\ExtLoaderLogs, zip all the log files in the folder, and send this zip file to the BMC Customer Support.

For more information, see “Location of the CMDB Extension Loader log files”.

Location of the CMDB Extension Loader log files

The CMDB Extension Loader is bundled with the BMC Atrium CMDB adapter for HP UCMDB. The location of the CMDB Extension Loader log files is:

<UCMDB installation location>\UCMDBAdapter\Logs\ExtLoaderLogs

NOTE To unzip the UCMDBInstallerLogs.zip file, use a utility such as WinZip to extract the files, or you might receive an error.


A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Index

Aabout HP UCMDB 9about the HP UCMDB adapter 9adapter installation worksheet 14audience 10

BBMC Software, contacting 2browse to log 27

Ccomponents installed in HP UCMDB server 19configuration log 27customer support 3

DData Execution Prevention settings 13, 15DEP 13, 15

HHP UCMDB adapter installation 17HP UCMDB adapter installation overview 9HP UCMDB adapter Maintenance Tool 25HP UCMDB adapter uninstallation 21, 23

IInstall instructions 17installation log 27installation overview 9installation planning 11installation prerequisites 13, 14installation worksheet 14installed components in the HP UCMDB server 19installing HP UCMDB adapter, secondary server 19installing instructions 17installing the HP UCMDB adapter 17

Mmaintenance tool 25

Ooverview of HP UCMDB 9overview of HP UCMDB Adapter 9

Pparameter information 14planning the installation 11prerequisites 13product support 3

Rrequired parameters 14required user permissions 14

Ssecondary server, installing HP UCMDB adapter 19support, customer 3supported HP UCMDB versions 10supported versions 10

Ttarget audience 10technical support 3to install the HP UCMDB adapter 17to open the log file folder 27to run the maintenance tool 26to uninstall from a Linux computer 24to uninstall from a Microsoft Windows computer 24to upgrade the HP UCMDB adapter 22turning off DEP 13, 15

Index 29

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Uuninstallation instructions 23uninstallation log 27uninstallation prerequisites 23uninstalling 21, 23upgrade instructions 22upgrade prerequisites 21user permissions 14using the maintenance tool 25

Vviewing the configuration log 27viewing the installation log 27viewing the uninstallation log 27

Zzipping all log files for support 28


Notes

*410430**410430**410430**410430*

*410430*

Documents

BMC Atrium CMDB Adapter Installation Guide for HP … Atrium CMDB adapter Installation Guide for HP ... versions of Hewlett Packard (HP) Universal Configuration ... CMDB adapter for