ViPR 2.1 - Upgrade data fabric

Table of Contents

Overview

Use this step-by-step procedure to upgrade the data fabric.

The vipr.upgrade.all command supports the following upgrade types:

Upgrade takes approximately 25 minutes per node.

Before you begin the upgrade, complete the following prerequisites:

Back to Top

Deploy the installer host OVA

Procedure

  1. Download the ViPR data fabric OVA file, ecs-fabric-installer-version-build.ova to a temporary directory.
  2. Start the vSphere client.
  3. Log in to the vCenter Server where you are deploying the installer host.
  4. Select File > Deploy OVF Template.
  5. Browse to and select the ViPR installer host OVA file that you copied to the temporary directory.
  6. Accept the End User License Agreement.
  7. Specify a name for the installer host.
  8. Select the host or cluster on which to run the installer host.
  9. If resource pools are configured (not required for the installer host), select one.
  10. If more than one datastore is attached to the ESX Server, select the datastore for the installer host.
  11. Select Thin Provision.
  12. On the Network Mapping page, map the source network to a destination network as appropriate.
  13. Power on the VM.
  14. Log in to the VM using root/ChangeMe as the credentials.
  15. Navigate to /opt/emc/ECS-fabric-installer.
Back to Top

Put the data fabric node IP addresses in a script

As a convenience, create a script that defines the IP addresses for the set of nodes in the data fabric, for the Controller VIP, and the ZooKeeper ensemble variables.

Procedure

  1. On the installer host, navigate to the /opt/emc/ecs-fabric-installer directory.
  2. Create a script that contains a set of environment variables that represents the IP addresses that you need to supply during the data fabric operation and save the script in /opt/emc/ecs-fabric-installer
    #!/bin/bash
    echo set node IP addresses
    N1=<Node1 IP>
    N2=<Node2 IP>
    N3=<Node3 IP>
    N4=<Node4 IP>
    export N1 N2 N3 N4
    echo $N1
    echo $N2
    echo $N3
    echo $N4
    
    echo set nodes that require comma-separated and space-separated lists and the ZooKeeper ensemble
    NC="$N1,$N2,$N3,$N4"
    NS="$N1 $N2 $N3 $N4"
    NZK="$N1 $N2 $N3"
    export NC NS NZK
    echo $NC
    echo $NS
    echo $NZK
    
    echo set Controller VIP
    CVIP=<Controller VIP>
    export CVIP
    echo $CVIP
  3. Change the access permissions on the script you created by executing chmod.
    # chmod 755 <script_name.sh>
  4. Execute the environment variable script.
    # source <script_name.sh>
  5. Verify the environment variable script set the values correctly.
    # echo $NC 
    # echo $NS
  6. If you have not already done so, set up SSH password-less login between the installer node and the target nodes by using SSH keygen. Accept the defaults, and do not set a password.
    1. Create the authentication SSH key.
      # ssh-keygen
    2. Copy the generated key file from the installer node to each of the target nodes by running the following command:
      # ssh-copy-id <target-node-IP- address>
Back to Top

Upgrade the data fabric automatically

Use this procedure to upgrade all nodes in the data fabric by executing one command.

Procedure

  1. Log in to the installer host VM and navigate to the ecs-fabric-installer directory.
    # cd /opt/emc/ecs-fabric/installer/

  2. Run the fab vipr.upgrade.all passing in the IP addresses for all of the nodes in the data fabric on the -H parameter, for example:
    # fab vipr.upgrade.all -H $NC --set "CONTROLLER_VIP=$CVIP,registration_key=ChangeMe,REGISTRY="$N1",ZK_SERVER_LIST="$NZK",IS_BLOCK=false" 
    
    fab vipr.upgrade.all reports progress to stdout as it completes each step of the upgrade. It reports Upgrade complete when the upgrade of all nodes in the data fabric is successful.
Back to Top

Upgrade the data fabric manually

Use this procedure to upgrade the data fabric one node at a time. This option is recommended when you want to remove nodes from a load balancer or connection list during the time when they are upgraded.

Procedure

  1. Log in to the installer host VM and navigate to the ecs-fabric-installer directory.
    # cd /opt/emc/ecs-fabric/installer/
  2. Remove the first node to be upgraded from the connection list or load balancer.
  3. Upgrade the first node, by executing fab vipr.upgrade.all passing in -R manual and the public IP address of the node to upgrade on the -H parameter, for example:
    # fab vipr.upgrade.all -R manual -H $NC --set "CONTROLLER_VIP=$CVIP,registration_key=ChangeMe,REGISTRY="$N1",ZK_SERVER_LIST="$NZK",IS_BLOCK=false"
  4. When the upgrade completes, manually add the node's IP address back to the connection list or load balancer.
  5. Remove the next node to be upgraded from the connection list or load balancer.
  6. Upgrade the next node by executing the same command passing in both the -R manual and the -H parameter with the public IP address of the next node to upgrade. For the second and subsequent nodes, you must also pass in IS_FIRST_UPGRADE=false. For example:
    # fab vipr.upgrade.all -R manual -H $NC --set "CONTROLLER_VIP=$CVIP,registration_key=ChangeMe,REGISTRY="$N1",ZK_SERVER_LIST="$NZK",IS_BLOCK=false,IS_FIRST_UPGRADE=false"
  7. When the upgrade completes, manually add the node's IP address back to the connection list or load balancer.
  8. Repeat the process with the next node to be upgraded until each node has been upgraded.
Back to Top

Fabric upgrade command reference

Use this as a reference when supplying options to the data fabric upgrade command.

The syntax is:

# fab vipr.upgrade.all options
The valid options are:

The valid key-value pairs to pass on the --set option:

Back to Top