Updating an advanced installation using vacppndi

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

About this task
Note: The vacppndi tool enforces that you install the PTF vacpp.ndi fileset before using the tool to install the PTF to a non-default location.

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

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

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

    lslpp -l vacpp.ndi

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

    installp -aYgd ptf_images_location -e logfile vacpp.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/ > /home/user/update.list
    update.list contains all the updated fileset names, one for each line. For example:
    vac.C.11.01.0000.0001.bff
  3. Use the perl command to run the vacppndi script:
    Read syntax diagramSkip visual syntax diagram
    >>-perl--/usr/vacpp/bin/vacppndi-- -d--source_path-- -u--ptf_names_file-->
    
    >--+--------------+--+-----------------+--+-------+------------->
       '- -e--logfile-'  '- -b--target_dir-'  '- -rte-'   
    
    >--+-----------+-----------------------------------------------><
       '- -version-'   
    
    
    perl /usr/vacpp/bin/vacppndi -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 vacppndi.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 vacppndi 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 vacppndi Perl script to install all available PTF filesets in the /compiler/update/ source directory to the non-default location, /compiler/xlcpp/ and writes the installation log file to /tmp/xlcpp.ndi.inst.log.

    Example:

    perl /usr/vacpp/bin/vacppndi -d /compiler/update/ -u /compiler/update/ptflist
    -b /compiler/xlcpp/ -e /tmp/xlcpp.ndi.inst.log