Automating the configuration and installation of appliance Storage Nodes

You can use the configure-sga.py script to configure and install StorageGRID Webscale appliance Storage Nodes.

Before you begin

The appliance has been installed in a rack, connected to your networks, and powered on.
Network links and IP addresses have been configured for the appliance using the StorageGRID Appliance Installer.
The primary Admin Node for the StorageGRID Webscale grid has been deployed, and you know its IP address.
All Grid Network subnets listed on the IP Configuration page of the StorageGRID Appliance Installer have been defined in the Grid Network Subnet List on the primary Admin Node.

See the installation and maintenance instructions for your appliance.

You know the location of the configure-sga.py file. The file is included in the installation archive, or you can access it by clicking Help > Appliance Installation Script from the StorageGRID Appliance Installer.

Steps

Log in to the Linux machine you are using to run the Python script.
For help with the script syntax and to see a list of the available parameters, enter the following:
```
configure-sga.py --help
```
The configure-sga.py script uses four subcommands: configure, install, monitor, and reboot. To get help for each subcommand, enter the following:
```
configure-sga.py subcommand --help
```

To confirm the current configuration of the appliance Storage Node, enter the following:

configure-sga.py configure SGA-INSTALL-IP

The results show current IP information for the appliance, including the IP address of the primary Admin Node and information about the Admin, Grid, and Client Networks.

Connecting to http://10.224.2.32:8080 (Checking version and connectivity)
2017/07/30 21:56:34: Performing GET on /api/versions... Received 200
2017/07/30 21:56:34: Performing GET on /api/v2/system-info... Received 200
2017/07/30 21:56:34: Performing GET on /api/v2/admin-connection... Received 200
2017/07/30 21:56:34: Performing GET on /api/v2/link-config... Received 200
2017/07/30 21:56:34: Performing GET on /api/v2/networks... Received 200
2017/07/30 21:56:35: Performing GET on /api/v2/system-config... Received 200

  StorageGRID Webscale Appliance
    Name:   MS-SGA1

  StorageGRID primary Admin Node
    IP:        172.16.1.170                                      
    State:     ready                                             
    Message:   Connection validated at 2017-07-31T01:55:52.982161

  Bond and VLAN configuration
    Port bond mode:         FIXED  
    Link speed:             10GBE  
                                   
        Admin Network:      ENABLED
            Bonding mode:   no-bond
            VLAN:           novlan 
                                   
        Grid Network:       ENABLED
            Bonding mode:   lacp   
            VLAN:           novlan 
                                   
        Client Network:     ENABLED
            Bonding mode:   lacp   
            VLAN:           novlan 

  Admin Network
    CIDR:      10.224.2.32/21 (Static)
    MAC:       00:80:E5:43:AE:BC      
    Gateway:   10.224.0.1             
    Subnets:   192.168.8.0/24         
               172.19.0.0/16          
               10.0.0.0/8             
               192.168.9.0/24         
               172.21.0.0/16          

  Grid Network
    CIDR:      172.16.2.32/21 (Static)
    MAC:       00:A0:98:A1:85:AE      
    Gateway:   172.16.0.1             
    Subnets:   172.18.0.0/21          
               172.17.0.0/21          
               192.168.0.0/21         

  Client Network
    CIDR:      47.47.2.32/21 (Static)
    MAC:       00:A0:98:A1:85:AD     
    Gateway:   47.47.0.1             

##############################################################
#####   If you are satisfied with this configuration,    #####
##### execute the script with the "install" sub-command. #####
##############################################################

If you need to change any of the values in the current configuration, use the configure subcommand to update them. For example, if you want to change the IP address for the primary Admin Node to 10.224.2.99, enter the following:
```
configure-sga.py configure --admin-ip 10.224.2.99 SGA-INSTALL-IP
```
When you are satisfied with the configuration, use the install and monitor subcommands to install the appliance:
```
configure-sga.py install --monitor SGA-INSTALL-IP
```
If you are experiencing difficulties trying to configure the appliance and want to try rebooting it, enter the following:
```
configure-sga.py reboot SGA-INSTALL-IP
```