PI22776: ERROR MESSAGE INVALID OPTION WHEN STARTING THE AGENT SERVICE TWICE

IBM UrbanCode Deploy Fix Pack 2 (6.1.0.2) for 6.1
IBM UrbanCode Deploy Interim Fix 1 for 6.1.0.2
IBM UrbanCode Deploy Fix Pack 3 (6.1.0.3) for 6.1
IBM UrbanCode Deploy Fix Pack 4 (6.1.0.4) for 6.1

APAR status

• Closed as program error.

Error description

• 1. Install an UCD 6.1.0.1 agent
  2. Make sure the user starting the agent service has got file
  system permissions:
  chown -R ucdagent /opt/ibm-ucd/agent/
  chgrp -R ucdagent /opt/ibm-ucd/agent/
  3. Make sure Agent starts after reboot
  [root@db1 agent]# cd /opt/ibm-ucd/agent/bin/init/
  [root@db1 init]# cp agent /etc/rc.d/init.d/ibm-ucdagent
  [root@db1 init]# vi /etc/rc.d/init.d/ibm-ucdagent
  Enter username and group for the agent service:
  AGENT_USER=ucdagent [check correct username]
  AGENT_GROUP=ucdagent [check correct groupname]
  Make sure the script point sto the right location:
  SCRIPT="$AGENT_HOME/bin/agent"
  4. [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent
  /etc/rc.d/rc5.d/S98ibm-ucdagent
  [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent
  /etc/rc.d/rc4.d/S98ibm-ucdagent
  [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent
  /etc/rc.d/rc3.d/S98ibm-ucdagent
  [root@db1 init]# chkconfig ibm-ucdagent --list
  ibm-ucdagent    0:off   1:off   2:off   3:on    4:on    5:on
  6:off
  [root@db1 init]# service ibm-ucdagent start
  Starting ibm-ucdagent:
  5. Start the agent a second time
  [root@db1 init]# service ibm-ucdagent start
  Starting ibm-ucdagent: process already running
  /etc/init.d/ibm-ucdagent: line 83: return: -1: invalid option
  return: usage: return [n]
  

Local fix

• Fix the script return value in script /etc/init.d/ibm-ucdagent
  line 83 from return -1 to return 1
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Any                                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * 1. Install an UCD 6.1.0.1 agent                              *
  * 2. Make sure the user starting the agent service has got     *
  * file                                                         *
  * system permissions:                                          *
  * chown -R ucdagent /opt/ibm-ucd/agent/                        *
  * chgrp -R ucdagent /opt/ibm-ucd/agent/                        *
  * 3. Make sure Agent starts after reboot                       *
  * [root@db1 agent]# cd /opt/ibm-ucd/agent/bin/init/            *
  * [root@db1 init]# cp agent /etc/rc.d/init.d/ibm-ucdagent      *
  * [root@db1 init]# vi /etc/rc.d/init.d/ibm-ucdagent            *
  * Enter username and group for the agent service:              *
  * AGENT_USER=ucdagent [check correct username]                 *
  * AGENT_GROUP=ucdagent [check correct groupname]               *
  * Make sure the script point sto the right location:           *
  * SCRIPT="$AGENT_HOME/bin/agent"                               *
  * 4. [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent      *
  * /etc/rc.d/rc5.d/S98ibm-ucdagent                              *
  * [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent         *
  * /etc/rc.d/rc4.d/S98ibm-ucdagent                              *
  * [root@db1 init]# ln -s /etc/rc.d/init.d/ibm-ucdagent         *
  * /etc/rc.d/rc3.d/S98ibm-ucdagent                              *
  * [root@db1 init]# chkconfig ibm-ucdagent --list               *
  * ibm-ucdagent    0:off   1:off   2:off   3:on    4:on    5:on *
  * 6:off                                                        *
  * [root@db1 init]# service ibm-ucdagent start                  *
  * Starting ibm-ucdagent:                                       *
  * 5. Start the agent a second time                             *
  * [root@db1 init]# service ibm-ucdagent start                  *
  * Starting ibm-ucdagent: process already running               *
  * /etc/init.d/ibm-ucdagent: line 83: return: -1: invalid       *
  * option                                                       *
  * return: usage: return [n]                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Fixed in IBM UrbanCode Deploy 6.1.0.2
  

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

  UC DEPLOY

• Fixed component ID

  5725M5400

Applicable component levels

• R600 PSN

     UP

• R600 PSY

     UP

• R601 PSN

     UP

• R601 PSY

     UP

• R610 PSN

     UP

• R610 PSY

     UP