Академический Документы
Профессиональный Документы
Культура Документы
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
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
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.
Index 29
Contents 5
6 BMC Atrium CMDB adapter for HP UCMDB
Tables
Adapter installation worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Components installed during the HP UCMDB adapter installation . . . . . . . . . . . . . . 19
Tables 7
8 BMC Atrium CMDB adapter for HP UCMDB
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 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.
Supported versions
The BMC Atrium CMDB adapter for HP UCMDB version 2.0.00 supports:
Audience
This documentation is intended for administrators of BMC Atrium CMDB.
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.
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.
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.
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:
B. Under Install Platforms, select the platforms to download for the product.
7. Verify that the correct profile is displayed for your download purpose, and select
the Licensed Products tab.
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.
C. Select the check boxes next to the products and documents to download.
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
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.
1 To open System Properties, click Start > Control Panel, and then double-click System.
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.
8 Click OK.
3
3 Installing the HP UCMDB adapter
This section provides instructions for installing the BMC Atrium CMDB adapter for
HP UCMDB.
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.
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.
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.
12 On the Installation Summary page, click View Log to review any messages.
4
4 Upgrading the HP UCMDB adapter
This section provides instructions for upgrading the BMC Atrium CMDB adapter for
HP UCMDB.
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.
5 Select the whole package or select the required TQLs and Jobs.
6 Click Save.
5 Select the whole package or select the required TQLs and Jobs.
6 Click Save.
1 Navigate and locate the BMC Atrium CMDB adapter for HP UCMDB 2.0.00
installer 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.
5
5 Uninstalling the HP UCMDB adapter
This section provides instructions for uninstalling the BMC Atrium CMDB adapter for
HP UCMDB.
export BMC_AR_SYSTEM_HOME=/opt/bmc/ARSystem
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.
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.
4 On the Select the Features page, select BMC Atrium CMDB adapter for HP UCMDB
2.0.00.
5 Click Next.
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.
1 Navigate to the installation folder for BMC Atrium CMDB adapter for HP UCMDB.
/opt/bmc/UCMDBAdapter/UninstallBMCUCMDBInstaller/
2 Run uninstall.sh.
NOTE
When uninstalling the adapter from Linux, you need to delete the
/opt/bmc/UCMDBAdapter/ folder.
6
HP UCMDB adapter Maintenance
6
Tool
This section provides instructions for using the BMC Atrium CMDB adapter for HP
UCMDB 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.
1 From the installation directory of the product, open the ucmdbinstaller folder.
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
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.
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 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.
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.
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