Nondefault installation

To install IBM® Open XL C/C++ for AIX® to a nondefault location on AIX system, first use installp to install the openxlCcmp.17.1.1.ndi fileset, and then use the xlCndi Perl script included in that fileset to install the compiler.

Procedure

Run the installp command to install the openxlCcmp.17.1.1.ndi fileset as follows:
```
installp -aYXgd install_images_location -e logfile openxlCcmp.17.1.1.ndi openxlCcmp.17.1.1.license
```
Note: If you are installing the evaluation version, run the installp command as follows instead:
```
installp -aYXgd install_images_location -e logfile openxlCcmp.17.1.1.ndi openxlCcmp.17.1.1.evaluation
```
-aYg

Specifies that all the latest installable filesets available in the install_images_location directory are applied and that the required software license agreement is accepted.

-d install_images_location

Specifies the directory where the filesets are located. This path might also be extracted tarball media.

-e logfile

Specifies the name and location of the installation log file. By default, the installation log file xlCndi.log is stored in your working directory.

-p

Performs a preview of the installation process by running the preinstallation checks. See Previewing the license agreements.

-X

Attempts to expand the file system at the default location if there is not enough space to complete the installation.
Example for installing the full compiler version:
```
installp -aYgd /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images -e /tmp/install.log
 openxlCcmp.17.1.1.ndi openxlCcmp.17.1.1.license
```
Note: This command automatically installs and accepts the license agreement fileset, openxlCcmp.17.1.1.license, required to install openxlCcmp.17.1.1.ndi.
Example for installing the evaluation version:
```
installp -aYgd /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images -e /tmp/install.log
 openxlCcmp.17.1.1.ndi openxlCcmp.17.1.1.evaluation
```
Install any available updates to the openxlCcmp.17.1.1.ndi fileset. You can download the latest compiler updates from the support website: https://www.ibm.com/mysupport/s/topic/0TO0z0000006v6TGAQ/xl-cc?productId=01t0z000007g72LAAQ
To check the version number of the openxlCcmp.17.1.1.ndi fileset currently installed on your system, use the following command:
```
lslpp -l openxlCcmp.17.1.1.ndi
```
To install a new version of the openxlCcmp.17.1.1.ndi fileset, use the following command:
```
installp -aYgd fix_pack_images_location -e logfile openxlCcmp.17.1.1.ndi
```
Install IBM Open XL C/C++ for AIX by entering the following command:
```
perl /opt/IBM/openxlC/17.1.1/bin/xlCndi -d source_path [-e logfile] [-b target_dir] [-rte][-version]
```
where:

-d source_path

Specifies the directory where the filesets are located. This path can also be extracted tarball media.

-e logfile

Specifies the name and location of the installation log file. By default, the installation log file xlCndi.log is stored in your working directory.

-b target_dir

Specifies the target location where the filesets are copied and expanded. By default, the files are copied to the xlCndi directory in your working directory. If the directory exists already, you will receive an error message and the installation will stop.

-rte

Specifies that only the runtime components should be installed.

-version

Displays the version of the nondefault installation tool.

Note: The -eval option is deprecated and has no effect. The xlCndi Perl script automatically determines the type of installation that is happening.

The following example uses the xlCndi Perl script to install all available compiler filesets in the /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images source directory to the nondefault location, /compiler/xlcpp/, and writes the installation log file xlcpp.ndi.inst.log to /tmp.

Example:
```
perl /opt/IBM/openxlC/17.1.1/bin/xlCndi
 -d /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images 
-b /compiler/xlcpp/ -e /tmp/xlcpp.ndi.inst.log 
```

Results

The xlCndi Perl script returns 0 if the installation is successful, or 1 if the installation fails.

IBM Open XL C/C++ for AIX is installed into the chosen location.

The compiler invocation commands are installed to /target_dir/opt/IBM/openxlC/17.1.1/bin/, where target_dir is the location of the compiler as set by the -b flag during the nondefault installation.

The following example uses the command to run the compiler, if IBM Open XL C/C++ is installed to the /compiler/openxlcpp directory:

/compiler/openxlcpp/opt/IBM/openxlC/17.1.1/bin/ibm-clang++_r hello.cpp -o hello_cpp