Updating an advanced installation using vacndi

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

About this task

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

To update a non-default installation, do the following:

Procedure

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

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

    lslpp -l vac.ndi

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

    installp -aYgd ptf_images_location -e logfile vac.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:
    vac.C.12.01.0000.0001.bff
  3. Use the perl command to run the vacndi script:
    Read syntax diagramSkip visual syntax diagram
    >>-perl--/usr/vac/bin/vacndi-- -d--source_path-- -u--ptf_names_file-->
    
    >--+--------------+--+-----------------+--+-------+------------->
       '- -e--logfile-'  '- -b--target_dir-'  '- -rte-'   
    
    >--+-----------+-----------------------------------------------><
       '- -version-'   
    
    
    perl /usr/vac/bin/vacndi -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 vacndi.log will be stored in your working directory.
    -b target_dir
    Specifies the location where the filesets should be copied and expanded. By default, the files are copied to the vacndi directory in your working directory. If the directory exists already, an error message is produced and the installation stops.
    -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 vacndi 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 /usr/vac/bin/vacndi -d /compiler/update/ -u /compiler/update/ptflist
    -b /compiler/xlc/ -e /tmp/xlc.ndi.inst.log