IBM Support

Cannot save edits to agent autostart file on ITM 6.X on UNIX and Linux

Question & Answer


Question

Customers have to manually update the kcirunas.cfg file to persist reboot application and run ID information. There is also no interface for the automation of these actions.

Cause

Function of UpdateAutoRun.sh requires customers to modify kcirunas.cfg

Answer

A new script has been written to perform the edit on the XML formatted kcirunas.cfg file. This new script reduces the complexity of update instructions and update actions. The script also provides a mechanism for scripting, or automating, the activity. This will also reduce the introduction of errors by performing kcirunas.cfg related edits.
There are two versions of the kciedit script which coincide with the functionality of UpdateAutoRun.sh

  1. For ITM 6.1.0 FP5 up to ITM 6.2.2 FP1;
    • IZ04587.kciedit.tar, contains the original kciedit script.
    • IZ04587.txt, contained the kciedit usage instructions.
  2. For ITM 6.2.2 FP2 and above or for use with provisional 6.2.2-TIV-ITM-FP0001-IZ52380;
    • IZ52380.kciedit.tar, contains the kciedit script which support function added.
    • IZ52380.txt, contained the kciedit usage instructions.


Installation

The kciedit script can be made available in either of two ways:
  1. Applied to the CANDLEHOME directory after installation has been completed
    • For the commands in this section, the following variables with explanation will be used. You must assign the variables as described to be able to use the commands as written:
      CANDLEHOME The full path to the original CD or expanded tar file directory.
      PATCHDIR The full path to the directory containing the patch tar file.
    • Apply the fix to the CANDLEHOME directory.
      • For the original script:
        cd $CANDLEHOME
        tar xf $PATCHDIR/IZ04587.kciedit.tar
      • For the new script:
        cd $CANDLEHOME
        tar xf $PATCHDIR/IZ52380.kciedit.tar
    • Read the kciedit usage instructions.
      • For the original script:
        cat $PATCHDIR/IZ04587.txt
      • For the new script:
        cat $PATCHDIR/IZ52380.txt
  2. Applied to the Installation media (CD image) before attempting to run the installer script install.sh.
    • The media files must reside in a writable directory. If they do not, you must create a new writable directory and copy the CD image contents to the new directory. You must have enough space on the file system where you create the new directory.
    • For the commands in this section, the following variables with explanation will be used. You must assign the variables as described to be able to use the commands as written:
      CDIMAGE The full path to the original CD or expanded tar file directory.
      NEWIMAGE The full path to the modified CD image directory.
      PATCHDIR The full path to the directory containing the patch tar file.
      NEWTAR The full path to the tar file created from $NEWIMAGE.
      $NEWTAR must not be within the $NEWIMAGE directory.
    • If $CDIMAGE is a writable directory:
      • Reuse the directory to apply the fix:
        NEWIMAGE=$CDIMAGE
    • If $CDIMAGE is not a writable directory:
      • Determine the required space:
        cd $CDIMAGE
        du -sk .
      • Determine the available space:
        df
      • Create a writable directory on a file system with enough space:
        mkdir $NEWIMAGE
        chmod 755 $NEWIMAGE
      • Verify that the new directory is on a file system with enough space:
        df $NEWIMAGE
      • Copy the original media contents to the new directory:
        cd $NEWIMAGE
        cp -pR $CDIMAGE/* .
    • Apply the fix to the writable media directory.
      • For the original script:
        cd $PATCHDIR
        tar xf IZ04587.kciedit.tar
        tar rf $NEWIMAGE/unix/cienv.tar bin/*
        cp bin/* $NEWIMAGE
      • For the new script:
        cd $PATCHDIR
        tar xf IZ52380.kciedit.tar
        tar rf $NEWIMAGE/unix/cienv.tar bin/*
        cp bin/* $NEWIMAGE
      • Optional: If you wish to modify the kcirunas.cfg that is distributed on the CD image, read the kciedit usage instructions. The instructions to run would look similar to these
        • For the original script:
          cat $PATCHDIR/IZ04587.txt
          cd $NEWIMAGE
          ./kciedit -m ....
        • For the new script:
          cat $PATCHDIR/IZ52380.txt
          cd $NEWIMAGE
          ./kciedit -m ....
    • Create the new tar file for archival and other installs:
      cd $NEWIMAGE
      tar cf $NEWTAR *
    • Perform the product installation from the updated media directory:
      cd $NEWIMAGE
      ./install.sh
    • Read the kciedit usage instructions.
      • For the original script:
        cat $PATCHDIR/IZ04587.txt
      • For the new script:
        cat $PATCHDIR/IZ52380.txt

Patch files for the above instructions:

IZ04587.kciedit.tar ->IZ04587.kciedit.tar IZ04587.kciedit.tar
IZ04587.txt ->IZ04587.txt IZ04587.txt
IZ52380.kciedit.tar ->IZ52380.kciedit.tar IZ52380.kciedit.tar
IZ52380.txt ->IZ52380.txt IZ52380.txt
IZ52380.kdyedit.tar ->IZ52380.kdyedit.tar IZ52380.kdyedit.tar

[{"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ITM Distributed Installer V6","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"6.3.0;6.3;6.2.3;6.2.2;6.2.1;6.2;6.1","Edition":"All Editions","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21271332