BMC Atrium CMDB Adapter For HP UCMDB Installation Guide

BMC Atrium CMDB adapter
Installation Guide
for HP UCMDB
February 2013
www.bmc.com
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 INC Telephone 1 713 918 8800 or Fax 1 713 918 8000
2101 CITYWEST BLVD 1 800 841 2031
HOUSTON TX 77042-2827
USA
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 legend

U.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.
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 customer_support@bmc.com. (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
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 customer_support@bmc.com.
Use the Customer Support website at http://www.bmc.com/support.
4 BMC Atrium CMDB adapter for HP UCMDB

Contents
Chapter 1 Overview of HP UCMDB adapter installation 9
About the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Supported versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 2 Planning your installation 11

Downloading the installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installation events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
User permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Turning off DEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 3 Installing the HP UCMDB adapter 17

Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing the HP UCMDB adapter on a secondary server . . . . . . . . . . . . . . . . . . . 19
Components installed during the HP UCMDB adapter installation . . . . . . . . . . . . . . 19
Chapter 4 Upgrading the HP UCMDB adapter 21

Before you upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Back up TQLs and the AI7604RepositoryBackup folder . . . . . . . . . . . . . . . . . . . . . 21
Upgrading the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 5 Uninstalling the HP UCMDB adapter 23

Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Uninstalling the HP UCMDB adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 6 HP UCMDB adapter Maintenance Tool 25

Using the HP UCMDB adapter Maintenance Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Using installation and uninstallation logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Zipping logs to send to BMC Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Location of the CMDB Extension Loader log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Index 29
Contents 5
Tables
Adapter installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Components installed during the HP UCMDB adapter installation . . . . . . . . . . . . . . 19
Tables 7
Chapter
1
Overview of HP UCMDB adapter
1
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 adapter

The 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 versions
The 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
Audience
This documentation is intended for administrators of BMC Atrium CMDB.

Chapter
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

The 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
customer_care@bmc.com.
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.

To download the product installation files
1. Create a directory in which to place the downloaded files.
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.
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.

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 events
This 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 permissions
When 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 worksheet
Before 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 DEP

Before 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
6 Double-click the setup.exe file.
7 Verify that InstallAnywhere Self-Extractor is added to the list.
8 Click OK.

Turning off DEP

Chapter
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 begin

Ensure that you have fulfilled the prerequisites described in Chapter 2, Planning
your installation.

This 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.

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
Table 2 Components installed during the HP UCMDB adapter installation

Component Description
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 KTRs are updated with Atrium CMDB database connection details.
connection
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 Adapter is registered in the SHARE:Application_Properties form.
Properties
Index Index is created on the UCMDBIntegrationID and DatasetID attributes of the
BMC_BaseElement class.

Chapter
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 upgrade

The 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

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.

This 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
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.

Chapter
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

This 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

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.

Chapter
6
HP UCMDB adapter Maintenance
6
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.


When 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).
NOTE
Click the column header to sort columns. To reverse sort a column, press the
Shift key while clicking the column header.
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.

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.
NOTE
To unzip the UCMDBInstallerLogs.zip file, use a utility such as WinZip to extract
the files, or you might receive an error.
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

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
A
about HP UCMDB 9
about the HP UCMDB adapter 9
M
adapter installation worksheet 14 maintenance tool 25
audience 10
O
B overview of HP UCMDB 9
BMC Software, contacting 2 overview of HP UCMDB Adapter 9
browse to log 27
P
C parameter information 14
components installed in HP UCMDB server 19 planning the installation 11
configuration log 27 prerequisites 13
customer support 3 product support 3
D R
Data Execution Prevention settings 13, 15 required parameters 14
DEP 13, 15 required user permissions 14
H S
HP UCMDB adapter installation 17 secondary server, installing HP UCMDB adapter 19
HP UCMDB adapter installation overview 9 support, customer 3
HP UCMDB adapter Maintenance Tool 25 supported HP UCMDB versions 10
HP UCMDB adapter uninstallation 21, 23 supported versions 10
I T
Install instructions 17 target audience 10
installation log 27 technical support 3
installation overview 9 to install the HP UCMDB adapter 17
installation planning 11 to open the log file folder 27
installation prerequisites 13, 14 to run the maintenance tool 26
installation worksheet 14 to uninstall from a Linux computer 24
installed components in the HP UCMDB server 19 to uninstall from a Microsoft Windows computer 24
installing HP UCMDB adapter, secondary server 19 to upgrade the HP UCMDB adapter 22
installing instructions 17 turning off DEP 13, 15
installing the HP UCMDB adapter 17
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
U
uninstallation instructions 23
uninstallation log 27
uninstallation prerequisites 23
uninstalling 21, 23
upgrade instructions 22
upgrade prerequisites 21
user permissions 14
using the maintenance tool 25
V
viewing the configuration log 27
viewing the installation log 27
viewing the uninstallation log 27
Z
zipping all log files for support 28

Notes
*410430*
*410430*
*410430*
*410430*
*410430*

BMC Atrium CMDB Adapter For HP UCMDB Installation Guide

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

BMC Atrium CMDB Adapter For HP UCMDB Installation Guide

Încărcat de

Drepturi de autor:

Formate disponibile

BMC Atrium CMDB adapter

Copyright 2012-2013 BMC Software, Inc.

Restricted rights legend

Support by telephone or e-mail

Before contacting BMC

4 BMC Atrium CMDB adapter for HP UCMDB

Chapter 2 Planning your installation 11

Chapter 3 Installing the HP UCMDB adapter 17

Chapter 4 Upgrading the HP UCMDB adapter 21

Chapter 5 Uninstalling the HP UCMDB adapter 23

Chapter 6 HP UCMDB adapter Maintenance Tool 25

The following topics are presented:

About the HP UCMDB adapter

About the HP UCMDB adapter

Chapter 1 Overview of HP UCMDB adapter installation 9

HP UCMDB version 8.x and 9.x

10 BMC Atrium CMDB adapter for HP UCMDB

The following topics are presented:

Downloading the installer

Downloading the installer

Chapter 2 Planning your installation 11

To download the product installation files

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

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

4. Click Download Product.

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

C. Click Save Profile.

8. Locate the product:

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

12 BMC Atrium CMDB adapter for HP UCMDB

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

Chapter 2 Planning your installation 13

Table 1 Adapter installation worksheet

(Windows) C:\Program Files

Note: A value of 0 indicates

14 BMC Atrium CMDB adapter for HP UCMDB

Turning off DEP

To turn DEP off for a program, you must be logged on as an administrator or a

To turn off DEP

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

6 Double-click the setup.exe file.

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

Chapter 2 Planning your installation 15

16 BMC Atrium CMDB adapter for HP UCMDB

The following topics are presented:

Before you begin

Before you begin

Installing the HP UCMDB adapter

To install the HP UCMDB adapter

1 On the Welcome page, click Next.

Chapter 3 Installing the HP UCMDB adapter 17

The default location is:

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

HP UCMDB 8.x: <UCMDB installation

11 On the Installation Preview page, click Install.

13 Click Done to exit the installer.

18 BMC Atrium CMDB adapter for HP UCMDB

Installing the HP UCMDB adapter on a 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-

3 Copy the AtriumCustomWSPlugin_9 folder from the primary server.