Setting configuration parameters before installation

After you define nodes in the cluster definition file, you can set certain configuration parameters in the cluster definition. Use the ./spectrumscale config gpfs command for this purpose.

  • To specify a cluster name in the cluster definition, use the -c argument.
    ./spectrumscale config gpfs -c gpfscluster01.my.domain.name.com
    

    In this example, gpfscluster01.my.domain.name.com is the cluster name.

    If no cluster name is specified, the GPFS admin node name is used as the cluster name. If the user-provided name contains periods, it is assumed to be a fully qualified domain name. If the cluster name is not a fully qualified domain name, the cluster name domain name is inherited from the admin node domain name.

  • To specify a profile in the cluster definition file to be set on cluster creation, use the -p argument.
    ./spectrumscale config gpfs -p randomio
    

    The valid values for -p option are default (for gpfsProtocolDefaults profile), randomio (for gpfsProtocolRandomIO profile), and ProfileName (for user-defined profile).

    • The system-defined profiles are based on workload type: sequential I/O (gpfsProtocolDefaults) or random I/O (gpfsProtocolRandomIO). These defined profiles can be used to provide initial default tunables or settings for a cluster. If more tunable changes are required, see mmchconfig command and mmcrcluster command.
    • You can specify a user-defined profile of attributes to be applied. The profile file specifies GPFS configuration parameters with values different than the documented defaults.
      A user-defined profile must have the following properties:
      • It must not begin with the string gpfs.
      • It must have the .profile suffix.
      • It must be located in the /var/mmfs/etc/ directory.
      For more information, see mmcrcluster command and mmchconfig command.

    If no profile is specified in the cluster definition, the gpfsProtocolDefaults profile is automatically set on cluster creation.

  • To specify the remote shell binary to be used by GPFS, use the -r argument.
    ./spectrumscale config gpfs -r /usr/bin/ssh
    

    If no remote shell is specified in the cluster definition, /usr/bin/ssh is used as the default.

  • To specify the remote file copy binary to be used by GPFS, use the -rc argument.
    ./spectrumscale config gpfs -rc /usr/bin/scp
    

    If no remote file copy binary is specified in the cluster definition, /usr/bin/scp is used as the default.

  • To specify an ephemeral port range to be set on all GPFS nodes, use the -e argument.
    ./spectrumscale config gpfs -e 61000-62000

    For information about the ephemeral port range, see IBM Storage Scale port usage.

    If no port range is specified in the cluster definition, 60000-61000 is used as default.

  • To view the current GPFS configuration settings, issue the following command.
    ./spectrumscale config gpfs --list
    
    [ INFO  ] No changes made. Current settings are as follows:
    [ INFO  ] GPFS cluster name is gpfscluster01
    [ INFO  ] GPFS profile is default
    [ INFO  ] Remote shell command is /usr/bin/ssh
    [ INFO  ] Remote file copy command is /usr/bin/scp
    [ INFO  ] GPFS Daemon communication port range is 61000-62000