Skip to main content

Joining nodes to the cluster using the CLI

When the newly installed controller modules are ready, you can add each one to the cluster by using the cluster setup command.

About this task

  • You must perform this procedure on both nodes.

  • You must join each node one at a time, not concurrently.

  1. Start the Cluster Setup wizard by using the cluster setup command at the CLI prompt.

    Example

    Welcome to the cluster setup wizard.

    You can enter the following commands at any time:
    "help" or "?" - if you want to have a question clarified,
    "back" - if you want to change previously answered questions, and
    "exit" or "quit" - if you want to quit the cluster setup wizard.
    Any changes you made before quitting will be saved.

    You can return to cluster setup at any time by typing "cluster setup".
    To accept a default or omit a question, do not enter a value.

    This system will send event messages and periodic reports to Lenovo Technical
    Support. To disable this feature, enter
    Auto Support modify -support disable
    within 24 hours.

    Enabling Auto Support can significantly speed problem determination and
    resolution should a problem occur on your system.

    Type yes to confirm and continue {yes}:

  2. Enter the network information for the node management port.

    Example

    Enter the node management interface port [e0M]: e0M
    Enter the node management interface IP address: <ip>
    Enter the node management interface netmask: <subnet_mask>
    Enter the node management interface default gateway: <default_gateway>
    A node management interface on port e0M with IP address <ip> has been created.

    Use your web browser to complete cluster setup by accessing
    https://<ip>

    Otherwise, press Enter to complete cluster setup using the command line
    interface:
  3. When prompted to create a new cluster or join and existing one, enter join.

    Example

    Do you want to create a new cluster or join an existing cluster? {join}:
    join
  4. When prompted with the existing cluster interface configuration, press Enter to accept it or enter yes.

    Example

    Existing cluster interface configuration found:

    Port MTU IP Netmask
    e0a 9000 169.254.5.171 255.255.0.0
    e0b 9000 169.254.148.183 255.255.0.0

    Do you want to use this configuration? {yes, no} [yes]:
  5. Follow the prompts to join the existing cluster.

    Example

    Step 1 of 3: Join an Existing Cluster
    You can type "back", "exit", or "help" at any question.

    Enter the name of the cluster you would like to join [cluster1]: cluster1

    Joining cluster cluster1

    Starting cluster support services..

    This node has joined the cluster cluster1.

    Step 2 of 3: Configure Storage Failover (SFO)
    You can type "back", "exit", or "help" at any question.

    SFO will be enabled when the partner joins the cluster.

    Step 3 of 3: Set Up the Node

    Cluster setup is now complete.


    The node is automatically renamed to match the name of the cluster.
  6. On the cluster, verify that the node is part of the cluster by using the cluster show command.

    Example

    cluster1::> cluster show
    Node Health Eligibility
    --------------------- ------- ------------
    cluster1-1 true true
    cluster1-2 true true
    cluster1-3 true true
    3 entries were displayed.
  7. Repeat steps 1 through 6 for the second newly installed controller module.

    The Cluster Setup wizard differs on the second node in the following ways:
    • It defaults to joining the existing cluster because its partner is already part of a cluster.

    • It automatically enables storage failover on both nodes.

  8. Verify that storage failover is enabled and possible by using the storage failover show command.

    Example

    The following output shows that storage failover is enabled and possible on all nodes of the cluster, including the newly added nodes:
    cluster1::> storage failover show
    Takeover
    Node Partner Possible State
    -------------- -------------- -------- -------------------------------------
    cluster1-1 cluster1-2 true Connected to cluster1-2
    cluster1-2 cluster1-1 true Connected to cluster1-1
    cluster1-3 cluster1-4 true Connected to cluster1-3
    cluster1-4 cluster1-3 true Connected to cluster1-4
    4 entries were displayed.