Steps for install toolkit

This section lists the steps for the installation of the toolkit.

Note: Ensure that the steps in the Installation prerequisites section are completed before you proceed with the steps listed in this section.
  1. Install the following packages for the installation toolkit:
    • python-2.7
    • net-tools
    • elfutils-libelf-devel [Only on Red Hat® Enterprise Linux® 8.0 nodes with kernel version 4.15 or later]
  2. Install the JAVA openjdk-devel on all the nodes
    yum install java-1.8.0-openjdk-devel
  3. Export Java™ home in root profile
    # vi ~/.bashrc
    export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
    export PATH=$PATH:$JAVA_HOME/bin
    
  4. Obtain and run the IBM Storage Scale self-extracting installation package.
    Run the self-extracting installation package:
    # ./Spectrum_Scale_Advanced-5.1.0.0-x86_64-Linux-install

    After the IBM Storage Scale package is expanded, the hdfs_3.1.1-x folder will contain two packages required for the installation toolkit usage that will reside in the /usr/lpp/mmfs/5.1.0.0/hdfs_rpms/rhel7 directory.

    The HDFS Transparency and the IBM Storage Scale Big Data Analytics Integration Toolkit for HDFS Transparency (Toolkit for HDFS) are the two packages that are required for the installation toolkit usage based on the HDFS Transparency support matrix versioning and should reside in the hdfs_3.1.1-x directory.

    Installation Toolkit supports the deployment of the following versions of HDFS Transparency:
    1. From IBM Storage Scale 5.1.1.2 through 5.1.3.1:
      • HDFS Transparency 3.1.1-x
      • HDFS Transparency 3.3.x-x
    2. From IBM Storage Scale 5.1.3.2 (Technical preview release)/5.1.4:
      • HDFS Transparency 3.1.1-x
      • HDFS Transparency 3.2.2-x
      • HDFS Transparency 3.3.x-x

    By default, HDFS Transparency 3.1.1-x is deployed.

    If you want to deploy HDFS Transparency 3.2.2-x, set the following environment variable before running the installation toolkit command:
    # export SCALE_HDFS_TRANSPARENCY_VERSION_322_ENABLE=True
    If you want to deploy HDFS Transparency 3.3.x-x, you need to set the following environment variable before running the installation toolkit command:
    # export SCALE_HDFS_TRANSPARENCY_VERSION_33_ENABLE=True

    You can set the SCALE_HDFS_TRANSPARENCY_VERSION_<version>_ENABLE variable in ~/.bashrc. Here, <version> is 322 or 33 without any "." between the numbers.

    For more information on the IBM Storage Scale software package, see Extracting the IBM Storage Scale software on Linux nodes in IBM Storage Scale: Concepts, Planning, and Installation Guide and HDFS Transparency download section.

  5. Install the required packages for Ansible® toolkit deployment.

    From IBM Storage Scale 5.1.1, the IBM Storage Scale installation toolkit uses the Ansible deployment. For Red Hat 7 and 8, the installation toolkit installs the supported version of Ansible on the installer node when you run the ./spectrumscale setup -s InstallNodeIP command.

    To manually install the correct Ansible for your environment, see the Preparing to use the installation toolkit topic in the IBM Storage Scale: Concepts, Planning, and Installation Guide.

  6. After the setup is complete, see Installing followed by Using installation toolkit.