IBM Support

IT11655: "RC.TSMSTGAGNT" SCRIPT FAILS TO START WITH "DSMSTA: NOT FOUND" AFTER UPGRADE OF THE STORAGE AGENT TO V7.1

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Using the original rc.tsmstgagnt script to start the Storage
    Agent may fail after an upgrade of the Storage Agent from V6.x
    to V7.1.
    
    Example:
    root@server:/opt/tivoli/tsm/StorageAgent/bin# ./rc.tsmstgagnt
    nn/dd/yy hh:mm:ss Starting Tivoli Storage Manager storage agent
    ./rc.tsmstgagnt[18]: dsmsta:  not found.
    
    These are the last two lines from the rc.tsmstgagnt script:
    cd /opt/tivoli/tsm/StorageAgent/bin
    dsmsta    quiet
    
    This assumes that the "dsmsta" can be found in the search path
    for executables as defined by the PATH environment variable, but
    in V7.1 - compared to V6.x - of the Storage Agent, there is a
    symbolic link of "dsmsta" missing in /usr/bin (which is usually
    in PATH) and the "dsmsta" can only be found in it's own
    installation path  /opt/tivoli/tsm/StorageAgent/bin (which is
    usually not in PATH) causing rc.tsmstgagnt script to fail.
    
    
    Tivoli Storage Manager Versions Affected:
    Tivoli Storage Manager Storage Agent versions 7.1.x on UNIX
    
    
    Initial Impact:
    Low
    
    
    Additional Keywords:
    TSM STA symbolic link
    

Local fix

  • There are several possibilities to work around this issue:
    1.) Create the symbolic link from /usr/bin/dsmsta to
    /opt/tivoli/tsm/StorageAgent/bin/dsmsta
    2.) Change the rc.tsmstgagnt to have "./dsmsta"  or
    "/opt/tivoli/tsm/StorageAgent/bin/dsmsta" as the very last line
    in the script
    3.) Change the PATH to include the Storage Agent installation
    path /opt/tivoli/tsm/StorageAgent/bin
    4.) Change the PATH to include the current directory i.e. :.:
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All Tivoli Storage Manager storage agent users.              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See APAR description.                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * This problem is currently projected to be fixed in level     *
    * 7.1.4.                                                       *
    * Note that this is subject to change at the discretion of     *
    * IBM.                                                         *
    ****************************************************************
    

Problem conclusion

  • This problem is fixed.
    
    Affected platform: AIX.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT11655

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    71A

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-10-12

  • Closed date

    2015-10-25

  • Last modified date

    2015-10-25

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

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

Fix information

  • Fixed component name

    TSM SERVER

  • Fixed component ID

    5698ISMSV

Applicable component levels

  • R71A PSY

       UP

  • R71H PSY

       UP

  • R71L PSY

       UP

  • R71S PSY

       UP

  • R71W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 7.1.3

Reference #: IT11655

Modified date: 25 October 2015