4. Unpackaged Installation

Not all target operating systems are supported with native software packages. In this case, a non-package based installation via a tar-archive is supported. This type of installation will build all software for both, Cluster Node and Cluster Management Node, and install it to a path that you specify. From there, you have to perform the actual driver and service installation using scripts provided with the installation.

This type of installation installs the complete software into a directory on the local machine. Depending on whether this machine will be a Cluster Node or the Cluster Management Node, you have to install different drivers or services from there. To install using this method, please proceed as follows:

  1. Become superuser:

    $ su - 
  2. Create the tar archive from the SIA, and unpack it:

    # sh ./Dolphin_eXpressWare-<version>.sh --get-tarball
    #* Logfile is /tmp/DIS_install.log_260 on node1
    #+ Dolphin ICS - Software installation (version: 1.31 $ of: 2007/09/27 15:05:05 $)
    #* Generating tarball distribution of the source code
    #* NOTE: source tarball is /tmp/DIS.tar.gz
    # tar xzf DIS.tar.gz 
  3. Enter the created directory and configure the build system, specifying the target path <install_path> for the installation. We recommend that you use the standard path /opt/DIS, but you can use any other path. The installation procedure will create subdirectories (like bin, sbin, lib, lib64, doc, man, etc) relative to this path and install into them.

    # cd DIS
    # ./configure --prefix=/opt/DIS --with-adapter=MX
  4. Build the software stack using make. Check the output when the command returns to see if it the build operation was successful.

    # make
    # make supersockets
  5. If the build operations were successful, install the software:

    # make install
    # make supersockets-install


    You can speed up the installation on multiple Cluster Nodes if you copy over the installation directory to the other Cluster Nodes, provided they features the same Linux kernel version and CPU architecture. The best way is to create a tar archive:

    # cd /opt
    # tar czf DIS_binary.tar.gz DIS

    Transfer this file to /opt on all Cluster Nodes and unpack it there:

    # cd /opt
    # tar xzf DIS_binary.tar.gz
  6. Install the drivers and services depending on whether the local machine should be a Cluster Node or the Cluster Management Node. It is recommended to first install all Cluster Nodes, then the Cluster Management Node, than configure and test the cluster from the Cluster Management Node.

    For a Cluster Node, install the necessary drivers and services as follows:

    1. Change to the sbin directory in your installation path:

      # cd /opt/DIS/sbin
    2. Invoke the scripts for driver installation using the option -i. The option --start will start the service after a successful installation:

      # ./kosif_setup -i --start
      	      # ./px_setup -i --start
      	      # ./irm_setup -i --start
      	      # ./nodemgr_setup -i --start
      	      # ./sisci_setup -i --start
      	      # ./ssocks_setup -i


      Please make sure that SuperSockets are not started yet (do not provide option --start to the setup script).

      You can remove the driver from the system by calling the script with the option -e. Help is available via -h.

    Repeat this procedure for each Cluster Node.

    For the Cluster Management Node, install the necessary services and perform the cluster configuration and test as follows:

    1. Change to the sbin directory in your installation path:

      # cd /opt/DIS/sbin
    2. Configure the cluster via the GUI tool dis_netconfig:

      # ./dis_netconfig

      For more information on using dis_netconfig, please refer to Chapter 4, Initial Installation, Section 2.4, “Working with the Dolphin Network Configurator, dis_netconfig”.

    3. Invoke the script for service installation using the option -i:

      # ./networkmgr_setup -i --start

      You can remove the service from the system by calling the script with the option -e.

    4. Test the cluster via the Dolphin GUI dis_admin tool:

      # ./dis_admin

      For more information on using dis_admin to test your cluster installation, please refer to Appendix B, dis_admin Reference and Section 1, “Verifying Functionality and Performance”.

    5. Enable all services, including SuperSockets, on all Cluster Nodes.


      This command has to be executed on the Cluster Nodes, not only on the Cluster Management Node!