IC53543: TSM STORAGE AGENT FAILS TO START AS A SERVICE WITH 1168 ERROR

APAR status

• Closed as documentation error.

Error description

• Installing TSM storage agent as a service manually using
  "install.exe" can result in the storage agent service
  failing on startup with RC 1168.
  
  Event Type:       Error
  Event Source:    ADSMServer
  Event Category: None
  Event ID:           1
  Date:                7/12/2007
  Time:                3:25:39 PM
  User:                N/A
  Computer:         TESTBOX
  Description:
  Fatal error trying to start the TSM server as a service.
  Location: No compatible instance found for Storage Agent
   service:
  TSM Storage Agent. RC: 1168
  
  This is due to the name of the service installed not
  matching TSM required naming convention for the service.
  
  The storage agent service name has to be of the format:
   TSM StorageAgent1
   TSM StorageAgent2
   TSM StorageAgent3
   TSM StorageAgent4
  
  TSM manuals do not document this requirement for the service
  name.
  
  "install.exe" output gives an invalid example of installing
  the service name of "TSM Storage Agent"
  
  Initial Impact: low
  Additional Keywords:
  dsmsta.exe dstasvc.exe 1203221
  HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ADSM\CurrentVersion\StorageAgent
  HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TSM
  StorageAgent1
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM Tivoli Storage Manager for SAN for       *
  *                 Windows Storage Agent, Version 5.4           *
  ****************************************************************
  * PROBLEM DESCRIPTION: Installing TSM storage agent as a       *
  *                      service manually using "install.exe"    *
  *                      can result in the storage agent         *
  *                      service failing on startup with RC      *
  *                      1168. This is caused by the storage     *
  *                      agent service name not being in the     *
  *                      "TSM StorageAgentX" format,             *
  *                      where X=1, 2, 3, or 4.                  *
  *                                                              *
  *                      The Tivoli Storage Manager for SAN      *
  *                      for Windows Storage Agent User's Guide  *
  *                                                              *
  *                      does not document this requirement.     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The required naming convention for the TSM storage agent
  service needs to be documented in Chapter 4.
  Installing and Configuring External Library Environments,
  section "Install and Configure the Storage Agent" of the IBM
  Tivoli Storage Manager for SAN for Windows Storage Agent
  User's Guide.
  

Problem conclusion

• The next publication of the IBM Tivoli Storage Manager for
  SAN for Windows Storage Agent User's Guide, Chapter 4.
  Installing and Configuring External Library Environments,
  section "Install and Configure the Storage Agent" will be
  updated with the following information:
  
  You have just completed manual installation of the storage
  agent. If you want the storage agent to run as a Windows
  service, use the install.exe utility located in the console
  subdirectory of the product installation. Issue the following
  command:
  
  install "TSM StorageAgentx" "C:\Program Files\Tivoli\TSM\
  storageagent\dstasvc.exe" LocalSystem
  
  where x is a value from 1 to 4. The Tivoli Storage Manager
  storage agent service must follow the "TSM StorageAgentx"
  naming convention.
  
  If you need to change the Tivoli Storage Manager storage
  agent service name, remove and then reinstall the service
  using a Tivoli Storage Manager storage agent service name
  with the correct format. Use the remove.exe and install.exe
  utilities located in the console subdirectory, for example:
  
  remove "TSM Storage Agent"
  install "TSM StorageAgent1" "C:\Program Files\Tivoli\TSM\
  storageagent\dstasvc.exe" LocalSystem
  
  For information about the install.exe and remove.exe
  utilities, type INSTALL or REMOVE from a command prompt
  while in the storageagent directory.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels