Archive for the ‘Enterprise Software’ Category

Integrating SiteScope 11.30 Events with BSM 9.25

  1. Install SiteScope 11.30
  2. Extract "Software_HP_Operations_Agent_v11.14_Windows_ISO_TC097-15046" iso locally on sis server
  3. CD to that extracted dir (run as admin)
  4. Run "cscript oainstall.vbs -i -a" and click ok to any prompts, etc.
  5. Select Start > All Programs > HP SiteScope > Configuration Tool (run as admin)
  6. In the "Configure HP Operations Agent installed separately" option select "Configure HP Operations Agent" to complete the installation of the HP Operations agent.
  7. Restart SiteScope server.
  8. In SIS UI, select Preferences > Integration Preferences:

    • Click the "New Integration" button and select "HP Operations Manager Integration".
    • Configure the OM/BSM path (in distributed environment, point to gateway server)
    • Click "Connect" to connect the agent to the BSM server. This sends a connection request from the agent to the specified server.
    • Leave this window open
  9. Accept the agent connection request on the BSM Gateway/Web Processing server

    • In BSM 9.20 or later UI, go to Admin > Operations Manager > Certificate Request, locate and grant your certificate request.
  10. Install the log policies on the SiteScope server

    • After the certificate request has been granted on the BSM server, back in SIS UI, click "Install Policies" in the HP Operations Manager Integrations Main Settings panel of the HP Operations Manager Integration dialog box. This installs and signs the preconfigured log file policy file on the HP Operations agent.
    • Leave this window open
  11. Check connection status and send test message from the SiteScope server – optional

    • In the HP Operations Manager Integration dialog box, expand the HP Operations Manager Integrations Main Settings panel, and click "Analyze".
    • To check that the agent is connected to the BSM server, type a message in the Test message text box, and click "Send Test Message".
    • If the test is successful, the text message is displayed in the Operations Management Event Browser in BSM. This message is generated by a basic opcmsg policy command (i.e. opcmsg a=a msg_grp=test o=o msg_t=test).
  12. Enable SiteScope to send events to HPOM or Operations Management

    • In the HP Operations Manager Integration dialog box, expand the HP Operations Manager Integrations Main Settings panel, and in the Configuration Settings area select "Enable sending events".
    • Leave all other options at default
    • Save and close the window – done.
  13. Note: LWSSO will automatically be configured between BSM and SIS.
 
Reference: SIS_1130_OM_Integration_Guide.pdf (pages 21 – 32)

Virtual Machine Consolidation Needed – Data Protector Backups

In the last post on this subject I discussed an issue where backing up a virtual VEAgent/Backup/Proxy host itself leads to orphaned disks on the host (when using a HotAdd backup transport method), which inevitably leads to the host itself becoming unstable and crashing – thus causing any subsequent VM backups relying on he backup host to fail!

The workaround was simply to not run backups against your virtual VEAgent host, or to make your VEAgent host physical.  HP has since come back to me with an actual fix.

As of version 8.00, Data Protector uses VDDK 5.0U1, and our issue is related to the following Known VMware Issue:

http://www.vmware.com/support/developer/vddk/VDDK-510-ReleaseNotes.html
 
Hang in connect or cleanup due to intermittent race condition. 
Windows processes can sometimes hang when calling VixDiskLib_ConnectEx() or VixDiskLib_Cleanup() due to a race condition while loading or unloading libraries. There is no known workaround. A fix has been identified, and will be available in the VDDK 5.1 first update release
 
If this is the case then it will be fixed in a newer version of the VDDK, the reason why I suspect it might be related is because if the Vmware VixDiskLib_Cleanup() hangs then the disks will not be removed from the backup host.  During a HotAdd backup a redo log is created for HotAdded disks, so in this case HotAdd failed to properly clean up redo logs and left the VM disks in your backup host.

The Fix:

  1. From the Backup host: remove all the folders inside of: C:\Windows\TEMP\vmware-SYSTEM
  2. Then remove the orphaned disks on the host corresponding to other virtual machines in the backup host using vCenter (not host disk management).  After this, reboot the host.
  3. If you have a related case open with HP, you can optionally add the variable: vixDiskLib.transport.LogLevel="6" to "C:\ProgramData\OmniBack\Config\client\ vepa_vddk.config".  This variable will log more information about the vddk transport method used during the backup job and this is the only way to determine why the HotAdd doesn’t remove the disks from the backup host.  Once the issue is duplicated with vixDiskLib.transport.LogLevel="6", collect the session report when the disk was not removed so we can get the information needed to determine the reason of this condition. 
  4. On backup host, open cmd prompt and type following:
  • diskpart
  • san policy=onlineAll 
  • Note: As per Vmware documentation, setting the san policy thus is a best practice when using HotAdd transport method.

 

Virtual Machine Consolidation Needed – Data Protector workaround

I've come across an issue several times when I try to backup a VEagent backup host itself (aka proxy host).  After some back and forth troubleshooting with HP Software Support, we finally determined that this is a known VMware limitation.  If the proxy host itself is a virtual machine, and the transport method to back it up is HotAdd (only option in Data Protector), then a backup job will result in an extra virtual disk being left over on the proxy host.  This will eventually, if not immediately, leave the host corrupted.  And once the proxy host is corrupted, any future VM backups that rely on it will not run.  Not good!

The only work-around is to NOT backup the proxy host itself using Data Protector, or to make the proxy host a physical machine.  More details on this issue can be found on the VMware support site.

In the event that this scenario has already played out in your environment, you currently have a VEagent client in Data Protector that is inaccessible and unusable, and all other VE backup jobs dont run as a result.  To fix, we do the following.

  1. Create a new VM to serve as a new VEagent backup host.  And add it as a VEagent client in DP GUI.
  2. Normally, you can right click a client in DP to delete it, but if the old VEagent host is unreachable, this will not work.  To remove this old client, delete the related line in the cell_info file on the DP cell manager.  This is found in: "C:\ProgramData\OmniBack\Config\Server\cell" (server 2008).  This will remove the old host from the DP GUI going forward.
  3. Lastly, you're existing VE backup jobs are still going to be referencing the old proxy host.  The old proxy hostname is hardcoded in the various VE barlist files for each of your VE backup jobs.  Open each of these files and swap out the old hostname with your new hostname.  These VE barlist files can be found on the cell manger in: "C:\ProgramData\OmniBack\Config\Server\BarLists\VEAgent" (server 2008).

You're now setup to move forward using a new VEagent backup host.

UPDATE:
There is now a better fix to this issue.  Please see this post:

 

Gathering Data Protector Logs for HP

What follows is the recommended information and logs one should gather when opening a Data Protector case with HP.  Note: the following only applies to a Data Protector 7.01 Windows Environment.

  1. Server Specs 
  2. Data Protector Patch Level
  3. Full Session Report
  4. Extended logs

1) Server Specs

No matter the issue you are having, invariably the server specs for the Cell Manager need to be provided.  This may also apply to your Installation Servers, Backup Host, or any other affected hosts by the issue you are having.  Generally the OS/Build is acceptable, such as: Windows 2008 R2 Enterprise x64.

2) Data Protector Patch Level

As with providing server specs, the patch level of all related systems will usually be requested as well.  Run this command from every host that has the DP inet agent installed:

omnicheck -patches

Copy/Paste the output into the support case for each system related to the issue.

3) Full Session Report

More than likely you will want to include the full session report from the backup job that had issues.  This session report will contain a detailed output of the backup job containing all of the related messages you would see in the DP GUI.  You can find the Session ID by browsing the Reporting context in DP GUI, and selecting your job.  The right pane will look something like this:

[138:742] Backup session "2013/07/22-3" of the backup specification "VEAgent VM-Desktops",backup group "VMWARE" has errors: 19.

In this example, 2013/07/22-3 is the Session ID. Copy/Paste that value into the following cmd, which you will execute on the Cell Manager:

omnidb -session <sessionid> -report > C:\session.txt

Upload the session.txt file to HP Support case.

4) Extended logs

In many cases, the default session report will not provide enough debug information to find what is actually the problem.  What will be needed is some extended logging.  However, to gather this additional debug info, you will have to first enable the debugging, re-produce the issue, and then disable the debugging.  The debug process will typically create dozens of log files, depending on the issue, which you can then zip up and upload to the HP Support case.  

There are two primary debug use cases:

  1. Troubleshooting Data Protector GUI
  2. Troubleshooting DP Backup Jobs that are failing/etc.

Troubleshooting DP GUI

Exit the GUI, and restart it from the MS-DOS prompt in debug mode:

cd \Program Files\Omniback\bin
manager.exe –debug 1-500 yourname.txt

Reproduce the error in the DP GUI and then exit the GUI to stop the debugging.  Depending on the nature of the issue, this will create a debug.txt file on every host related to the issue.  On each host, in the following location, look for long file names starting with OB2DBG and ending with yourname.txt:

(Windows 2003) Program Files\Omniback\tmp        
(Windows 2008) Program Data\Omniback\tmp

Gather all these debug files from each host, zip them up (per host), and upload to HP Support Case.

Troubleshooting Failing Backup Jobs

Depending on the nature of your failing backup job you might deviate from these steps, but this will generally apply to all failing backup jobs:

On the Cell Manager open the CMD prompt and execute the following:

omnisv stop / omnisv start -debug 1-500 yourname.txt

On any other related system(s) with a DP INET agent installed, go to Windows services, stop the Data Protector INET service.  In the start up parameters for the service add the following and then click start:

-debug 1-500 yourname.txt

Reproduce the backup job failure, and exit the DP GUI.  This will create dozens of logs on the Cell Manager and every related system debugging was enabled on.  Before you collect the logs however, be sure to disable the debugging by removing the service startup parameters you added to each system and restart them normally.  Also, don't forget to restart DP Cell Manager without the debug:

omnisv stop / omnisv start

On each host, in the following location, look for long file names starting with OB2DBG and ending with yourname.txt:

(Windows 2003) Program Files\Omniback\tmp        
(Windows 2008) Program Data\Omniback\tmp

Gather all these debug files from each host, zip them up (per host), and upload to HP Support Case.

Finally, you will also want to grab a copy of the cell_info file from the Cell Manager and upload it as well:

(Windows 2003) Program Files\Omniback\Config\Server\cell    
(Windows 2008) ProgramData\Omniback\Config\Server\cell 

RTSM to CMS Sync – Step by Step Guide

This activity is one of the most commonly sought-after and often confusing HP Integrations.  Finding the correct documentation is usually the biggest hurdle to overcome.  For example, the documentation provided for this activity that ships with UCMDB/BSM is incomplete and/or blatantly incorrect.  The Software Solutions Now guides are far more comprehensive, however, the best outline can be found ironically in the Release Control Detect to Correct Value Stream interactive guide.
 
What follows are the steps from that guide:

UCMDB – BSM Integration Configuration

Overview
This configuration synchronizes the configuration item (CI) records between HP Universal CMDB (UCMDB) and Run-Time Service Model (RTSM). Apart from the convenience synchronizing the configuration between UCMDB and RTSM provides, we make sure that the CIs across all three systems (UCMDB, HP Service Manager (SM), and HP Business Service Management (BSM)) are identical and have the same GlobalID generated by UCMDB.

Create UCMDB to BSM Integration Point in BSM

Deploy Package CSM_to_RTSM_Sync.zip on BSM
  1. Copy the file CMS_to_RTSM_Sync.zip located on the BSM-DPS machine file system under HPBSM\odb\conf\factory_packages to the file system on the UCMDB machine.
  2. Open the UCMDB user interface.
  3. Select the Administration tab.
  4. Select Package Manager.
  5. Select Deploy Packages to server (from local disk).
  6. Click Add button and selec the file CMS_to_RTSM_Sync.zip through the file system browser.
  7. Select Deploy

Enable the CMDB 9.x Integration Point

  1. Open the BSM admin user interface and select the RTSM Administration.
  2. Select the Data Flow Management tab.
  3. Select Integration Studio.
  4. Create a new Integration Point according to the following table:

     

     

    Name
    Recommended
    Value
    Description
    Integration
    Name
    <user defined> The name you give to the integration point.
    Adapter UCMDB 9.x Select the adapter type from the drop-down list.
    Is Integration
    Activated
    selected Select this check box to create an active integration point.
    Hostname/IP <user defined> The name of the UCMDB server.
    Port <user defined> The port through which you access UCMDB.
    Credentials <user defined>

    If UCMDB credentials appear in the Credentials column, select them.

    If no UCMDB credentials appear, select Generic Protocol and click the Add new connection details for
    selected protocol type button.
     
    Enter the following information:
    • Description. Enter UCMDB.
    • User Name. Enter the UCMDB user name. The default value is admin.
    • User Password. Enter and confirm a password.
    Probe Name <user defined> Select the probe you configured previously from the dropdown list.
     
  5. Click the Add icon on the right side of the window and add Job definitions as follows:

     

     

    • Name the Job definition.
    • Select the Allow Delete check box.
    • Click the Add icon in the Job definition window.
    • From the pop up window, browse to root – CMS sync, select the ActiveDirectory_sync job and click OK.
    • Select the Scheduler definition check box.
    • In the Repeat window, select Cron.
    • For the Cron expression, enter the following string: * 0/10 * * * ? *
    • Adjust other settings as needed.
    • When finished, click OK and save the integration.
    • Repeat steps a to i and configure the following jobs:

       

       

      • FailoverCluster_Sync
      • IIS_Sync
      • SOA_Sync
      • BusinessAndFacilities_Sync
      • ExchangeServer_Sync
      • Virtualization_Sync
      • Siebel_Sync
      • Credentials_Sync
      • Basicinfrastructure_Sync
      • J2EE_Sync
      • SAP_Sync
  6. Browse to UCMDB on port 8080 (for example, http://yourUCMDBhost.domain:8080), and select the JMX Console
  7. Log on to the JMX console.
  8. From the UCMDB section, select UCMDB:service=Multiple CMDB Instances Services.
  9. Invoke:

     

     

    • setAsNonGlobalIdGenerator for customer ID 1 and verify it succeeded.
    • getGlobalIdGeneratorScopes for customer ID 1 and verify it succeeded.
  10. Browse to your BSM administration UI.
  11. Select Data Flow Management tab.
  12. Select Integration Studio from the options.
  13. Select the Integration Point that you have configured.
  14. In the Job definition section, click Synchronize All to run the synchronization.
The integration point should be active and the jobs are displayed properly.

Configure BSM 9.x Integration Point

Deploy Package CMS_to_RTSM_Sync.zip on BSM
  1. Copy the file CMS_to_RTSM_Sync.zip located on the BSM-DPS machine file system under HPBSM\odb\conf\factory_packages to the file system on the BSM machine.
  2. Open the BSM user interface.
  3. Navigate to Admin > RTSM Administration > Administration > Package Manager.
  4. Select Deploy Packages to server (from local disk).
  5. Click the Add button and select the file CMS_to_RTSM_Sync.zip through the file system browser.
  6. Click Deploy.

Enable the CMDB 9.x Integration Point

  1. Open the UCMDB user interface.
  2. Select the Data Flow Management tab.
  3. Select Integration Studio.
  4. Create a new Integration Point according to the following table:

     

     

    Name
    Recommended
    Value
    Description
    Integration
    Name
    <user defined> The name you give to the integration point.
    Adapter BSM Adapter Select the adapter type from the drop-down list.
    Is Integration
    Activated
    selected Select this check box to create an active integration point.
    Hostname/IP <user defined> The name of the BSM server.
    Port <user defined> The port through which you access UCMDB.
    Credentials <user defined>
    If UCMDB credentials appear in the Credentials column, select them.
     
    If no UCMDB credentials appear, select Generic Protocol and click the Add new connection details for selected protocol type button.
     
    Enter the following information:
    • Description. Enter UCMDB.
    • User Name. Enter the UCMDB user name. The default value is admin.
    • User Password. Enter and confirm a password.
    Push Back IDs Enabled
    Specifies whether to push back the global IDs after CIs are populated in the server.
     
    Note: Relevant for UCMDB 9.x adapters.
    Probe Name <user defined> Select the probe you configured previously from the dropdown list.
  5. Click the Add button on the right side of the window and add Job definitions as follows:

     

     

    • Name the Job Definition.
    • Select the Allow Delete check box.
    • Click the Add button in the Job definition window.
    • From the pop up window, browse to root – CMS sync, select the ActiveDirectory_sync job and click OK.
    • Select the Scheduler definition check box.
    • In the Repeat window, select Cron.
    • For the Cron expression, enter the followning string: * 0/10 * * * ? *
    • Adjust other settings as needed.
    • When finished, click OK and save the integration.
    • Repeat steps to a to i and configure the following jobs:

       

       

      • FailoverCluster_Sync
      • IIS_Sync
      • SOA_Sync
      • BusinessAndFacilities_Sync
      • ExchangeServer_Sync
      • Virtualization_Sync
      • Siebel_Sync
      • Credentials_Sync
      • Basicinfrastructure_Sync
      • J2EE_Sync
      • SAP_Sync
  6. Browse to BSM on port 21212 (for example, http://yourDPShost.domain:21212), and select the JMX Console.
  7. Log on to the JMX console.
  8. From the UCMDB section, select UCMDB:service=Multiple CMDB Instances Services.
  9. Invoke:

     

     

    • setAsNonGlobalIdGenerator for customer ID 1 and verify it succeeded.
    • getGlobalIdGeneratorScopes for customer ID 1 and verify it succeeded.
  10. Browse to your UCMDB administration user interface.
  11. Click the Data Flow Management tab.
  12. Select Integration Studio from the options.
  13. Select the integration point that you have configured.
  14. In the Job definition section, click Synchronize All to run the synchronization.

‚ÄčThe integration point should be active and the jobs appear properly.

Verify UCMDB – BSM Configuration

  1. Browse to your UCMDB server user interface.
  2. In the CI Type manager screen, locate the Node element.
  3. Right-click a Node object and select Show CIT Instances. The CIT Instances window is displayed.
  4. Right click on one of the CIs and select Properties.
  5. Locate the Global ID and write down its value.
  6. Browse to your BSM server user interface.
  7. Repeat steps 2-4 and identify the value of Global ID.
  8. Compare the IDs from steps 5 and 7 and verify that they are the same.

Afterwards, there are a number of LWSSO/Security settings that will should be configured as well.  Please refer to the guide to complete those steps

Return top