Nondefault installation

To install IBM Open SDK for Rust on AIX 1.96 to a nondefault location on AIX® system, first use installp to install the rustsdk.1.96.0.ndi fileset, and then use the rustndi Perl script included in that fileset to install the compiler.

Procedure

  1. Run the installp command to install the rustsdk.1.96.0.ndi fileset as follows:
    installp -aYXgd install_images_location -e logfile rustsdk.1.96.0.ndi  rustsdk.1.96.0.license
    Read syntax diagramSkip visual syntax diagram - installp -aYg -p -X -dinstall_images_location -elogfile rustsdk.1.96.0.ndi rustsdk.1.96.0.license
    -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 rustndi.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:

    installp -aYgd /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images -e /tmp/install.log
     rustsdk.1.96.0.ndi \
        rustsdk.1.96.0.license
    Note: This command automatically installs and accepts the license agreement fileset, rustsdk.1.96.0.license, required to install rustsdk.1.96.0.ndi.
  2. Install any available updates to the rustsdk.1.96.0.ndi fileset. You can download the latest compiler updates from the support website: IBM Support

    To check the version number of the rustsdk.1.96.0.ndi fileset currently installed on your system, use the following command:

    lslpp -l rustsdk.1.96.0.ndi

    To install a new version of the rustsdk.1.96.0.ndi fileset, use the following command:

    installp -aYgd fix_pack_images_location -e logfile rustsdk.1.96.0.ndi
  3. Install rustsdk.1.96.0.ndi by entering the following command:
    Read syntax diagramSkip visual syntax diagram perl /opt/IBM/RustSDK/1.96/bin/rustndi -dsource_path -elogfile-btarget_dir-rte-version
    perl /opt/IBM/RustSDK/1.96/bin/rustndi -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 rustndi.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 rustndi 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.

    The following example uses the rustndi 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/rustsdk/, and writes the installation log file rustsdk.ndi.inst.log to /tmp.

    Example:

    perl /opt/IBM/RustSDK/1.96/bin/rustndi
     -d /LOCATION_OF_EXTRACTED_TARBALL/usr/sys/inst.images 
    -b /compiler/rustsdk/ -e /tmp/rustsdk.ndi.inst.log 

Results

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

IBM Open SDK for Rust on AIX 1.96 is installed into the chosen location.

The compiler invocation commands are installed to /target_dir/opt/IBM/RustSDK/1.96/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 SDK for Rust on AIX 1.96 is installed to the /compiler/rustsdk directory:

/compiler/rustsdk/opt/IBM/RustSDK/1.96/bin/rustc hello.rs -o hello