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

See the installation and maintenance instructions for your appliance.

Steps

  1. Log in to the Linux machine you are using to run the Python script.
  2. 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
  3. 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. #####
    ##############################################################
  4. 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
  5. 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
  6. 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