Updating an advanced installation using xlcndi

If the XL C compiler has been installed to a non-default directory, you must use xlcndi to install PTFs.

About this task

Note: The xlcndi tool enforces that you install the PTF xlccmp.13.1.0.ndi fileset before using the tool to install the PTF to a non-default location.

To update a non-default installation, take the following steps:

Procedure

  1. Begin by installing the xlccmp.13.1.0.ndi fileset included in the PTF. This fileset must be installed first, so that the xlcndi script inside it can be used to correctly install the remaining filesets.

    To determine the version number of the xlccmp.13.1.0.ndi fileset currently installed on your system, run the command:

    lslpp -l xlccmp.13.1.0.ndi

    To install a new version of the xlccmp.13.1.0.ndi fileset, run the command:

    installp -aXgd ptf_images_location -e logfile xlccmp.13.1.0.ndi
  2. Create a text file listing the PTF filesets you want to install. This text file must contain the name of a single PTF file on each line. You can use the ls command to do this: ls source_path > ptf_names_file.

    For example:

    ls /compiler/update/*.bff > /home/user/update.list
    update.list contains all the updated fileset names, one for each line. For example:
    xlccmp.13.1.0.1.bff
  3. Use the perl command to run the xlcndi script:
    Read syntax diagramSkip visual syntax diagram
    >>-perl--/opt/IBM/xlc/13.1.0/bin/xlcndi-- -d--source_path-- -u--ptf_names_file-->
    
    >--+--------------+--+-----------------+--+-------+------------->
       '- -e--logfile-'  '- -b--target_dir-'  '- -rte-'   
    
    >--+-----------+-----------------------------------------------><
       '- -version-'   
    
    
    perl /opt/IBM/xlc/13.1.0/bin/xlcndi -d source_path -u ptf_names_file [-e logfile] 
    -b [target_dir]
    where:
    -d source_path
    Specifies the directory where the filesets are located. This path might also be a mounted CD-ROM drive.
    -u ptf_names_file
    Specifies the text file containing the names of PTF filesets you want to install.
    -e logfile
    Specifies the name and location of the installation log file. By default, the installation log file xlcndi.log will be stored in your working directory.
    -b target_dir
    Specifies the directory where the compiler you are updating is installed.
    -rte
    Specifies that only the runtime component is installed.
    -version
    Displays the version of the non-default installation tool.
    Note: The installation script creates a compressed TAR backup of the compiler files that exist before the PTF update. If a problem is encountered with the installation of the PTF update or with the PTF update itself, you can restore from this backup file target_dir.tar.Z to uninstall the PTF update.

    The following example uses the xlcndi Perl script to install all available PTF filesets in the /compiler/update/ source directory to the non-default location, /compiler/xlc/ and writes the installation log file to /tmp/xlc.ndi.inst.log.

    Example:

    perl /opt/IBM/xlc/13.1.0/bin/xlcndi -d /compiler/update/ -u /compiler/update/ptflist
    -b /compiler/xlc/ -e /tmp/xlc.ndi.inst.log