Installing IBM Spectrum Scale and creating a GPFS cluster
After you set up the installer node, and define nodes, NSDs, and file systems in the cluster definition file, and set certain configuration parameters, you can install IBM Spectrum Scale according to the topology defined in the cluster definition file.
- If call home is enabled in the cluster definition file,
specify the minimum call home configuration
parameters.
For more information, see Enabling and configuring call home using the installation toolkit../spectrumscale callhome config -n CustName -i CustID -e CustEmail -cn CustCountry
- Do environment checks before initiating the installation
procedure.
./spectrumscale install -pr
This step is not required because running ./spectrumscale install with no arguments also runs these checks before the installation.
- Start the IBM
Spectrum Scale installation and the
creation of the cluster.
./spectrumscale install
- Understanding what the installation toolkit does during the installation
-
- If the installation toolkit is being used to install IBM Spectrum Scale on all nodes, create a new GPFS cluster, and create NSDs, it automatically does the following outlined steps.
- If the installation toolkit is being used to add nodes to an existing GPFS cluster and create new NSDs, it automatically does the following steps.
- If all nodes in the cluster definition file are in a cluster, then the installation toolkit automatically does the following steps.
To add nodes to an existing GPFS cluster, at least one node in the cluster definition must belong to the cluster where the nodes not in a cluster are to be added. The GPFS cluster name in the cluster definition must also exactly match the cluster name outputted by mmlscluster.
When the ./spectrumscale install command is run, the installation toolkit does these steps:
- To install IBM Spectrum Scale on all nodes, create a new GPFS cluster, and create NSDs
-
- Run preinstall environment checks
- Install the IBM Spectrum Scale packages on all nodes
- Build the GPFS portability layer on all nodes
- Install and configure performance monitoring tools
- Create a GPFS cluster
- Configure licenses
- Set ephemeral port range
- Create NSDs (if any are defined in the cluster definition)
- Run post-install environment checks
- To add nodes to an existing GPFS cluster and create any new NSDs
-
- Run preinstall environment checks
- Install the IBM Spectrum Scale packages on nodes to be added to the cluster
- Install and configure performance monitoring tools on nodes to be added to the cluster
- Add nodes to the GPFS cluster
- Configure licenses
- Create NSDs (if any new NSDs are defined in the cluster definition)
- Run post-installation environment checks
Important: The installation toolkit does not alter anything on the existing nodes in the cluster. You can determine the existing nodes in the cluster by using the mmlscluster command.The installation toolkit might change the performance monitoring collector configuration if you are adding the new node as a GUI node or an NSD node, due to collector node prioritization. However, if you do not want to change the collector configuration then you can use the ./spectrumscale config perfmon -r off command to disable performance monitoring before initiating the installation procedure.
- If all nodes in the cluster definition are in a cluster
-
- Run preinstall environment checks
- Skip all steps until NSD creation
- Create NSDs (if any new NSDs are defined in the cluster definition)
- Run post-install environment checks
Although not part of GPFS, NTP configuration on every node is useful for cluster operation and future debugging. You can use the ./spectrumscale ntp options for configuring NTP on all nodes at installation time. For example:
/usr/lpp/mmfs/5.0.5.x/installer/spectrumscale config ntp -e on -s 198.51.100.2,198.51.100.4 [ WARN ] The NTP package must already be installed and full bidirectional access to the UDP port 123 must be allowed. [ WARN ] If NTP is already running on any of your nodes, NTP setup will be skipped. To stop NTP run 'service ntpd stop'. [ INFO ] Setting NTP to on [ INFO ] Setting Upstream NTP Servers to 198.51.100.2,198.51.100.4
For more information, see spectrumscale command.
- What to do next
- Upon completion of the installation, you have an active GPFS cluster. Within the cluster, NSDs might be created, performance monitoring is configured, and all product licenses are accepted. File systems are fully created in the next step that is deployment.