IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IC53543

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    54W

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-08-20

  • Closed date

    2007-10-18

  • Last modified date

    2007-10-18

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

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

Publications Referenced
SC32013300    

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"54W","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
18 October 2007