IT12941: LAN-FREE BACKUP FAILS WITH ANS0338E (RC47) AND ANR2250E

7.1.5.000-TIV-TSMSRV-AIX
7.1.5.000-TIV-TSMSRV-HP-UX
7.1.5.000-TIV-TSMSRV-Linuxppc64
7.1.5.000-TIV-TSMSRV-Linuxs390x
7.1.5.000-TIV-TSMSRV-Linuxx86_64
7.1.5.000-TIV-TSMSRV-SolarisSPARC
7.1.5.000-TIV-TSMSRV-WIN
IBM Spectrum Protect Server V7.1 Fix Pack 5 (7.1.5.000) Downloads

APAR status

• Closed as program error.

Error description

• The IBM Tivoli Storage Manager Server is using the Server-ID of
  the StorageAgent instead of the Node-ID of the node that is
  connected to the StorageAgent for LAN-free backup or archive
  processing for checking whether the node is decommissioned or
  not.
  If the Server-ID of the StorageAgent is the same as the
  Node-ID of a decommissioned node, the node that is actually
  connecting to the Server will fail with:
  
  ANS0338E (RC47)   An invalid operation was attempted on a node
  
  The IBM Tivoli Storage Manager Server reports this error with
  message:
  
  ANR2250E SESSION 132: Operation is not allowed because node
           NODENAME is decommissioned.
  
  Note that in this case the node specified in the ANR2250E is not
  actually decommissioned.
  
  
  Customer/L2 Diagnostics:
  To verify whether the system is affected by this problem login
  to DB2 as (Tivoli Storage Manager) instance owner and query the
  IBM Spectrum Protect Servers database using this commands:
  
  >select NODENAME, NODEID from TSMDB1.Nodes
  Here find the Node-ID from any decommissioned node.
  
  >select server_name, server_id from tsmdb1.server_connect_info
  Here find the Server-ID from the StorageAgent that is running on
  the affected system.
  
  Run the "Query NOde Format=Detailed" command to find which nodes
  are 'Decommissioned'.
  
  
  Data Protection Versions Affected:
  IBM Spectrum Protect Server at version 7.1.3 and above
  
  
  Initial Impact: Medium
  
  
  Additional Keywords:
  TSM STA LAN-free SQL API
  

Local fix

• Disable lan-free communications for the decommissioned node and
  then stop and restart the storage agent.
  An alternative to disabling lan-free communications for the
  decommissioned node is to make process and/or script changes to
  prevent the decommissioned node from establishing a connection
  through the storage agent.
  If for some reason this node does need to connect through the
  storage agent then the storage agent would need to be stopped
  and restarted again before using other nodes with this same
  storage agent.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All Tivoli Storage Manager server users of client-side       *
  * deduplication.                                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 7.1.5. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Affected platforms: AIX, HP-UX, Solaris, Linux, and Windows.
  

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

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels