IZ56489: ITMCMD CONFIG -S FAILS WITH OVER 50 SOAP USERS

APAR status

• Closed as program error.

Error description

• Environment:
  ITM 6.21 unix/linux
  
  Problem Description:
       The problem is caused by an internal limit in the
       configuration code set to a maximum of 50 users.
       This problem occurs for both the CLI and the GUI
       configuration of the TEMS.
  
  
       Detailed Recreation Procedure:
       (1) Add over 50 users to the soap access list
       (2) itmcmd config -S -t TEMS
       (3) You will see the following messages displayed
  
   $itmcmd config -S -t $TEMS
   Configuring TEMS...
  
   Hub or Remote [1=*LOCAL, 2=*REMOTE] (Default is: 1):
   TEMS Host Name (Default is: tems3):
  
    Network Protocol 1 [ip, sna, ip.pipe or ip.spipe]
    (Default is: ip.pipe)
  
        Now choose the next protocol number from one of these:
        - ip
        - sna
        - ip.spipe
        - 0 for none
   Network Protocol 2 (Default is: 0):
   IP.PIPE Port Number (Default is: 1918):
   Enter name of KDC_PARTITION (Default is: null):
   Enter path and name of KDC_PARTITIONFILE (Default is:
   /ITM6/tables/hub_tems3/partition.txt):
  
   Configuration Auditing? [1=YES, 2=NO] (Default is: 1):
   Hot Standby TEMS Host Name or type 0 for "none" (Default is:
  0):
   Enter Optional Primary Network Name or type 0 for "none"
  :(Default is:
   0):
   Security: Validate User ? [1=YES, 2=NO] (Default is: 1):
   LDAP Security: Validate User with LDAP ? [1=YES, 2=NO](Default
  is: 1):
   Enter required LDAP user filter ?(Default is:
   (&(sAMAccountName=%v)(objectclass=user)):
   LDAP base ?(Default is: dc=testland,dc=com):
   LDAP bind ID ? [ 1=anonymous bind, or enter a value ](Default
  is:
   admin@corp.testland.com):
   LDAP bind password ?(Default is: ********):
   LDAP host name ?(Default is: ldap1.corp.testland.com):
   LDAP Port Number(Default is: 3268):
   LDAP SSL communications: Use SSL ? [1=YES, 2=NO](Default is:
  2):
  
   Tivoli Event Integration Facility? [1=YES, 2=NO] (Default is:
  1):
   EIF Server?(Default is: tec1):
   EIF Port? (Default is: 5539):
   Disable Workflow Policy/Tivoli Emitter Agent Event Forwarding?
  [1=YES,
   2=NO] (Default is: 2):
  
    ... Writing to database file for ms.
   Exception in thread "main"
  java.lang.ArrayIndexOutOfBoundsException:
   Array index out of range: 51
           at
  ITMinstall.editXmlSH.parseXmlFileSH(editXmlSH.java:121)
           at
   ITMinstall.CandleConfigCMS.moveXHubsFile(CandleConfigCMS.java:5
  08)
           at
   ITMinstall.CandleConfigCMS.preConfigureCMS(CandleConfigCMS.java
  :344)
           at
  ITMinstall.CandleConfigCMS.main(CandleConfigCMS.java:1035)
  

Local fix

• 1. To support more than 50 users:
  Edit the kshxhubs.xml file and add the desired users
  Do not re-configure the TEMS.
  Recycle  and bounce the TEMS
  
  2. To reconfigure the TEMS:
  Rename kshxhubs.xml to kshxhubs.xml.save.
  Re-configure the TEMS.
  Rename kshxhubs.xml.save to kshxhubs.xml.
  Start the TEMS.
  

Problem summary

• The problem occurs when a customer defines more than 50 soap
  users, either by manual editing of
  $CANDLEHOME/tables/TEMS/HTML/kshxhubs.xml or by using the GUI
  (itmcmd manage). The CLI command (itmcmd config -S -t
  <TEMS_NAME>) does not allow adding more that 50 users to any
  access type.
  

Problem conclusion

• The limit on the maximum number of soap user that can be defined
  has been removed. The customer is now allowed to define as many
  users as desired (within reason).
  
  
  The fix for this APAR is included in the following maintenance
  vehicle:
      | fix pack | 6.2.1-TIV-ITM-FP0002
      | fix pack | 6.2.2-TIV-ITM-FP0002
  

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

  OMEG DIST INSTA

• Fixed component ID

  5608A41CI

Applicable component levels

• R621 PSY

     UP