NOTE: To view files in PDF format (*.pdf), Adobe Acrobat Reader must be installed on your system. To download Adobe® Acrobat® Reader, go to the web site:

http://www.adobe.com

Software and Hardware Requirements

These requirements are listed in the Installation and User's Guide for HP Operations Manager Dependency Mapping Automation. Before installing HP Operations Manager Dependency Mapping Automation, make sure that your system meets these minimum requirements.

Known Problems, Limitations, and Workarounds

Co-existence Considerations

Windows HTTPS Agent and UCMDB Running on the Same System (QXCR1000810075)

The Operations Manager HTTPS Agent for Windows is assigned free ports at random during start up. This may conflict with the ports required by a UCMDB or BAC installation located on the same Windows System.

Solution

Start up the UCMDB or BAC application before starting up the HTTPS Agent on the Windows System.

Installation and Deinstallation

HPOM DMA Not Supported on Windows 2008

HPOM DMA is currently not supported on Windows 2008 platforms. When installing HPOM DMA on a proxy system running a Windows operating system in conjunction with a remote HPOM for UNIX installation on a PA-RISC 64-bit system, a system running a Windows 2003 operating system must be selected.

HPOM DMA Product Installer and Temporary Directory Space

The HPOM DMA product installer requires free space in a temporary directory on the host system.

If the product installer cannot complete the installation due to insufficient space in the temp directory then use the following environment variables to point the temp directory to another directory with more space available and retry the installation:

On UNIX systems, the temporary directory is /tmp.

By default on UNIX systems, if the temporary directory does not exist or has insufficient space, the installer attempts to use $HOME as the temporary space. You can define the environment variable IATEMPDIR to specify an alternative temporary location.

Port 8081 Already Assigned but is Ignored by the Installer (QXCR1000800822)

After installation, the HPOM DMA console cannot be opened in a web browser. The Tomcat log file in <DataDir>/log/tomcat/ovtomcatb.out indicates that there is a port conflict on port 8081.

Solution

Complete one of the following options:

• There may be another program that is occupying this port. Change the others application's port and restart Tomcat by running the commands:

  1. ovc -stop ovtomcatB
  2. ovc -start

• Change the port of the HPOM DMA Tomcat:

  1. Enter the command:

     /opt/OV/nonOV/tomcat/b/bin/ovtomcatbctl -sethttpport <New Port Number>

  <InstallDir>\nonOV\tomcat\b\bin\OvTomcatBCtrl.vbs -sethttpport <New Port Number>
  2. Stop Tomcat: ovc -stop ovtomcatB
  3. Start Tomcat and all processes reliant on Tomcat: ovc -start

Hotfix for BAC 7.5 UI Launch from OM for UNIX

UI launches into BAC 7.5 do not work.

Solution

For UI launches into BAC 7.5 to work, apply the hotfix from the product media.

NOTE: If the hotfix is not included on your product media, request the following hotfix directly from the HP support organization:

hpdma-uilaunch Hotfix

To apply the hot fix, follow these steps:

1. Create the directory: hpdma-uilaunch.war
2. Extract the hpdma-uilaunch.zip file from the product media to the hpdma-uilaunch.war directory.
3. Move or copy the hpdma-uilaunch.war directory with all its contents to the <BAC-install-dir>\AppServer\webapps\ directory.

NOTE: The scripts should be deployed automatically. If UI Launch is not available, restart the BAC server process.

4. Open the following file for editing:

   hpdma-uilaunch.war\WEB-INF\ucmdbWebService.properties

5. Make sure that the default URL is the URL of the UCMDB web service interface on the local machine.

   The default URL takes the following form:

   url=http://localhost:8080/axis2/services/UcmdbService

6. Change the user name and password for the UCMDB web service.
7. Test the availability of the script by launching the following URL from a web browser:

   http://<BAC_or_UCMDB_hostname>:8080/hpdma-uilaunch

   The deployment is successful if this URL shows a page with the message UI Launch is available.

Some Console Pages Fail to Respond After Installing HPOM DMA (QXCR1000801075)

After HPOM DMA has been installed on either HP-UX or Sun Solaris, some pages do not respond when attempting to open them from the navigation pane on the left. The right content pane remains unchanged. The browser does not indicate that the page is being loaded.

The affected pages are:

• Sub pages of Enrichment Summary
• Script Summary
• Content
• Connection
• Synchronization Packages

The error appears only once after installation. After one of the following workarounds is performed, the error does not occur again.

There are two possible solutions:

Preferred Solution

To make sure that the Connection page loads correctly:

1. Open the HPOM DMA console and click either the Connection or Configuration link in the left navigation pane.

2. Stop and start the trace server daemon using the command appropriate for your operating system:

   • HP-UX
     
     /sbin/init.d/OVTrcSrv stop
/sbin/init.d/OVTrcSrv start

   • Solaris
     
     /etc/init.d/OVTrcSrv stop
/etc/init.d/OVTrcSrv start

   The the HPOM DMA console responds with an error page.

3. Click the Connection or Configuration link again.

The Connection and Configuration page loading should now be successful.

Alternative Solution

To make sure that the Connection page loads correctly:

1. Open the HPOM DMA console and click either the Connection or Configuration link in the left navigation pane.
2. Stop the ovtomcatB process and restart all ovc processes using the commands:
   
   /opt/OV/bin/ovc -stop ovtomcatB
/opt/OV/bin/ovc -start

3. Login to the HPOM DMA Web UI.
4. Click the Connection or Configuration link again.

The Connection page loading should now be successful.

Repair Mode on Windows Proxy Systems Does Not Work

The HPOM DMA Installer repair feature is not operational.

Solution

If you need to repair your HPOM DMA installation, follow these steps:

1. Make a backup of your system data and any extensions and customizations that you have made.
2. Uninstall HPOM DMA, using the installer application as described in the Installation and User’s Guide.

   NOTE: Do NOT execute the post Post-Uninstall Cleanup steps.

3. Reinstall HPOM DMA.
4. Restore any extensions and customizations.

Alternatively, restore the system form a previous backup.

Runtime

Multibyte Characters Cannot be Stored in the Database

BAC and UCMDB, versions 7.00 and 7.50 cannot store multibyte characters in the UCMDB database. Synchronization of localized data is not currently supported.

Solution

This is a limitation that is currently being addressed. Support of synchronization of localized data will be available in an update of BAC and UCMDB.

Integration with Other HP Software Solutions

HP Operations Manager Dependency Mapping Automation is supported with HP Operations Manager 8.29 for UNIX and higher versions of HP Operations Manager. HPOM DMA requires UCMDB or BAC version 7.00 or 7.50.

Support

You can visit the HP Software Support web site at:
http://www.hp.com/go/hpsoftwaresupport

This web site provides contact information and details about the products, services, and support that HP offers.

HP Software online software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by being able to do the following:

• Search for knowledge documents of interest
• Submit and track progress on support cases
• Submit enhancement requests online
• Download software patches
• Manage a support contract
• Look up HP support contacts
• Review information about available services
• Enter discussions with other software customers
• Research and register for software training

Legal Notices

©Copyright 2007-2009 Hewlett-Packard Development Company, L.P.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

The information contained herein is subject to change without notice.

For information about third-party license agreements, refer to the documents located in the directory on the product installation media:

<dvd-mountpoint>/license

These documents are also available after installation under <InstallDir>/license_agreements on the HPOM DMA host system.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by the Jaxen Project (http://jaxen.org/).

This product includes software developed by the JDOM Project (http://www.jdom.org/).

This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/).

Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.

Java™ and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.

SUN™, SOLARIS™, JINI™, FORTE™, and iPLANET™ are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

UNIX® is a registered trademark of The Open Group.