Understanding the spectrumscale installation toolkit options

Use the following information to understand how to work with the spectrumscale installation toolkit, and toolkit options.

When you use the spectrumscale installation toolkit to install GPFS™, the procedure comprises two stages:
  1. Using a series of spectrumscale commands to add node and NSD specifications and configuration properties to the cluster definition file.
  2. Using the spectrumscale install command to install GPFS on the nodes specified in the cluster definition file and to apply the configuration options to the cluster.
When you use the spectrumscale installation toolkit to deploy protocols, the procedure comprises two similar stages:
  1. Using a series of spectrumscale commands to specify environment details, to identify which protocols are to be enabled, and to define protocol-specific properties in the cluster definition file.
  2. Using the spectrumscale deploy command to deploy protocols as specified in the cluster definition file.
If you already have an existing GPFS cluster, with GPFS started and at least one file system for the CES shared file system, you can just define protocol nodes in the cluster definition and then deploy protocols.

See Using the spectrumscale installation toolkit to perform installation tasks: Explanations and examples for information on how to use the command options listed in Table 1 to perform the installation and deployment. After you review the examples, you can tailor them according to your own needs and then proceed to implement them.

Table 1. spectrumscale command options for installing GPFS and deploying protocols
spectrumscale command option Purpose
node add Adds node specifications to the cluster definition file.
node delete Removes node specifications from the cluster definition file
nsd add Adds NSD specifications to the cluster definition file.
nsd clear Clears all NSDs.
nsd delete Removes a single NSD.
nsd list Lists all NSDs currently in the configuration.
nsd modify Modifies an NSD.
nsd balance Balances the NSD preferred node between the primary and secondary nodes.
filesystem list Lists all file systems that currently have NSDs assigned to them.
filesystem modify Changes the block size and mount point of a file system.
auth file Configures file authentication on protocols in the cluster definition file.
auth object Specifies Object authentication on protocols in the cluster definition file.
config gpfs Adds GPFS-specific properties to the cluster definition file.
install Installs GPFS on the configured nodes, creates a cluster, and creates NSDs.
config protocols Provides details about the GPFS environment to be used during protocol deployment.
config perfmon

Configures performance monitoring settings

config object Defines object-specific properties to be applied during deployment.
deploy Creates file systems and deploys protocols on your configured nodes.
config ntp Configures NTP settings
upgrade Upgrades the various components of the installation.

The list of spectrumscale command options listed is not exhaustive. For all command options available with the spectrumscale command and for more information about these command options, see spectrumscale command.

Required cleanup if you are reinstalling with the spectrumscale installation toolkit

If you are reinstalling with the spectrumscale installation toolkit, you must perform some cleanup procedures first. See Cleanup procedures required if reinstalling with the spectrumscale installation toolkit.