Manually installing IBM Spectrum Scale for object storage on Red Hat Enterprise Linux 7.x nodes

IBM Spectrum Scale™ for object storage is typically installed using the installation toolkit. If you do not want to use the installation toolkit, use the following steps to manually install IBM Spectrum Scale for object storage.

For information about prerequisites, see Software requirements and Installation prerequisites.

Before you begin manually installing IBM Spectrum Scale for object storage, complete the following prerequisite tasks.

  1. Create protocol nodes for object service. For more information, see Configuring CES protocol service IP addresses.
  2. Add at least one CES IP address.

Manually install the object protocol and then enable object services as follows.

  1. On all protocol nodes, install the spectrum-scale-object package and its associated dependencies by issuing the following command.
    yum -y install spectrum-scale-object
    The package is created in the /usr/lpp/mmfs/4.2.3.0/object_rpms/rhel7 directory by expanding the Spectrum_Scale_Protocols installation image. For more information about extracting an installation image, see Extracting the IBM Spectrum Scale software on Linux nodes.
    Note: The path /usr/lpp/mmfs/4.2.3.0/object_rpms/rhel7, depends upon the release version.

    You might need to create the yum repository before using this command. To create the yum repository, create an entry similar to the following in the /etc/yum.repos.d directory:

    [spectrum_scale]
                        name=spectrum_scale
                        baseurl=file:///usr/lpp/mmfs/4.2.3.0/object_rpms/rhel7
                        enabled=1
                        gpgcheck=0
    Note: The path file:///usr/lpp/mmfs/4.2.3.0/object_rpms/rhel7, in the above example depends upon the release version.
  2. From one of the protocol nodes, install the object protocol by using the mmobj swift base command. Start of change
    mmobj swift base -g /ibm/fs1 -o object_fileset --cluster-hostname protocol-cluster.example.net \
    --local-keystone --admin-password Passw0rd --admin-user keystone
    End of change A sample output is as follows.
    mmobj swift base: Validating execution environment.
    mmobj swift base: Performing SELinux configuration.
    mmobj swift base: Creating fileset /dev/fs1 object_fileset.
    mmobj swift base: Configuring Keystone server in /gpfs/fs1/object/keystone.
    mmobj swift base: Creating postgres database.
    mmobj swift base: Validating Keystone environment.
    mmobj swift base: Validating Swift values in Keystone.
    mmobj swift base: Configuring Swift services.
    mmobj swift base: Uploading configuration changes to the CCR.
    mmobj swift base: Configuration complete.

After the initial install is complete, the object protocol needs to be enabled across all the protocol nodes.

  1. Complete the configuration and start object services on all protocol nodes by using the mmces service enable command.
    # mmces service enable OBJ
  2. Start of changeList the protocols enabled in the IBM Spectrum Scale cluster by using the mmces service list command. List a verbose output of object services running on the local node using the -v flag.
    # mmces service list -v
        
    A sample output is as follows.
    Enabled services: OBJ SMB NFS
        OBJ is running
        OBJ:openstack-swift-object                   is running
        OBJ:openstack-swift-account                  is running
        OBJ:openstack-swift-container                is running
        OBJ:openstack-swift-proxy                    is running
        OBJ:memcached                                is running
        OBJ:openstack-swift-object-replicator        is running
        OBJ:openstack-swift-account-reaper           is running
        OBJ:openstack-swift-account-replicator       is running
        OBJ:openstack-swift-container-replicator     is running
        OBJ:openstack-swift-object-sof               is running
        OBJ:httpd (keystone)                         is running
        SMB is running
        NFS is running
    End of change