IZ86997: NETWORK INTERFACE WITH MULTIPLE ADDRESSES BREAKS CINFO -R RESULTS IN KCAWD TERMINATING AGENT DUE TO HOSTNAME RESOLUTION

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • On AIX, defining a network interface with more than one
    IP address can cause "cinfo -r" to report the status of
    running processes incorrectly.
    
    This can result in the KCAWD watchdog process terminating
    ITM agents.  In the KCAWD process's RAS1 log, there will
    be indications of problems with the agent process:
    
    kcawd.cpp,246,"checkAvailability")
     Availability script timeout/failed but agent kuxagent is still
    up.
    kcawd.cpp,247,"checkAvailability")
     Restarting unhealthy agent kuxagent.
    
    RECREATE INSTRUCTIONS:
    
    On an AIX system,
    System prep steps:
    1) Install the OS agent from ITM 6.22 FP3
    2) Change to the new installation directory (CANDLEHOME)
    3) Determine the local IP address and local host name
       # bin/ITMhostName -i
       9.48.152.121
       # bin/ITMhostName -l
       l338
    4) Determine the network host name
       # host 9.48.152.121
       l338.tivlab.austin.ibm.com is 9.48.152.121,  Aliases:   l338
       # bin/ITMhostName -n
       l338
    5) Edit /etc/hosts so that the local host name and the
       network host name are not the same.  For example:
       9.48.152.121    MiXeD.tivlab.austin.ibm.com MiXeD
    6) Verify that the network host name is changed:
       # host 9.48.152.121
       MiXeD.tivlab.austin.ibm.com is 9.48.152.121,  Aliases:
    MiXeD
       # bin/ITMhostName -n
       MiXeD
    
    Recreate steps:
    1) Determine a valid but unused IP address for the local
       network, for example 9.48.144.248.
    2) View the settings for one of the network interfaces,
       like eno.
     Notice that there is only one 'inet' entry:
     # ifconfig en0
     en0:
    flags=1e080863,480<UP,BROADCAST,NOTRAILERS,RUNNING,SIMPLEX,
     MULTICAST,GROUPRT,64BIT,CHECKSUM_OFFLOAD(ACTIVE),CHAIN>
         inet 9.48.152.121 netmask 0xffffff00 broadcast 9.48.152.255
          tcp_sendspace 262144 tcp_recvspace 262144 rfc1323 1
    3) Start the OS agent:
       # bin/itmcmd agent start ux
    4) Run the following commands:
       # bin/ITMhostName -l
       l338
       # bin/ITMhostName -ia
       9.48.152.121
       # bin/ITMhostName -na
       MiXeD
       # bin/cinfo -r
       *********** Tue Oct 19 11:48:29 CDT 2010 ******************
       User: root Groups: system bin sys security cron audit lp
    itmgroup
       Host name : MiXeD        Installer Lvl:06.21.04.00
       CandleHome: /data/aschwart/IZ81161/tepin621mdv/inst
       ***********************************************************
       Host   Prod  PID      Owner  Start     ID    ..Status
       MiXeD  ux    2326606  root   11:46:33  None  ...running
    
    4) Add an IP address to an interface
       # ifconfig en0 9.48.144.248 netmask 255.255.255.0 alias
    5) View the settings for the updated network interface, like
    eno.
     Notice that there are now two 'inet' entries:
     # ifconfig en0
     en0:
    flags=1e080863,480<UP,BROADCAST,NOTRAILERS,RUNNING,SIMPLEX,
     MULTICAST,GROUPRT,64BIT,CHECKSUM_OFFLOAD(ACTIVE),CHAIN>
         inet 9.48.152.121 netmask 0xffffff00 broadcast 9.48.152.255
         inet 9.48.144.248 netmask 0xffffff00 broadcast 9.48.144.255
          tcp_sendspace 262144 tcp_recvspace 262144 rfc1323 13)
    
    6) Run the following commands from a 621 FP3 or 622 FP3
       installation:
       # bin/ITMhostName -l
       l338
       # bin/ITMhostName -ia
       9.48.152.121 9.48.144.248
       # bin/ITMhostName -na
       l338
       # bin/cinfo -r
       *********** Tue Oct 19 11:46:49 CDT 2010 ******************
       User: root Groups: system bin sys security cron audit lp
    itmgroup
       Host name : l338         Installer Lvl:06.21.04.00
       CandleHome: /data/aschwart/IZ81161/tepin621mdv/inst
       ***********************************************************
       Host   Prod  PID      Owner  Start  ID    ..Status
       MiXeD  ux    2326606                None
    7) Notice that the local host name (l338) is returned
       instead of the network host name (MiXeD) from the
       ITMhostName -na command.
    8) Notice that the local host name is displayed for "Host name
    :"
       in the "cinfo -r" header and the OS agent does not have
       a status of running.
    

Local fix

  • cd $CANDLEHOME/bin
    cp -p ITMhostName ITMhostName.keep
    cp -p ITMhostName ITMhostName.new
    sed 's/$networkIP 2>/$inet 2>/' < ITMhostName.keep >
    ITMhostName.new
    cp ITMhostName.new ITMhostName
    
    
    *note* The "sed" command includes "ITMhostName.new" as part
    of a single line.
    

Problem summary

  • A network interface with multiple addresses causes "cinfo -r" to
    return incorrect results.
    
    On AIX, if there are multiple IP addresses for an aliased
    interface, "cinfo -r" will report incorrect results.
    

Problem conclusion

  • Fixed code to handle multiple IP addresses for aliased
    interfaces.
    
    
    The fix for this APAR is contained in the following maintenance
    packages:
    
      | fix pack | 6.2.2-TIV-ITM-FP0004
    

Temporary fix

Comments

APAR Information

  • APAR number

    IZ86997

  • Reported component name

    OMEG DIST INSTA

  • Reported component ID

    5608A41CI

  • Reported release

    622

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-10-19

  • Closed date

    2010-12-08

  • Last modified date

    2011-04-06

  • 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

  • R622 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Components
ITM Distributed Installer V6

Software version:

622

Reference #:

IZ86997

Modified date:

2011-04-06

Translate my page

Machine Translation

Content navigation