Modifying Host Configuration Using a USB Drive

In addition to the Cloud Services Portal and Device UI, you can configure a physical host and connect it to BloxOne Cloud through a USB drive. You must first download the host configuration template from the Cloud Services Portal, make changes, save it on a USB drive, and then insert it into the physical appliance. Once the appliance detects the configuration file, it automatically starts the process and connects the host to BloxOne Cloud based on the configuration on the USB drive. This method is useful if your physical appliance is offline and you want to reconnect it to BloxOne Cloud.

To configure a host and connect it to BloxOne Cloud using a USB drive, complete the following:

1. From the Cloud Services Portal, click Administration -> Downloads.

2. Select Host Configuration Template, and click Host Configuration Template to download the template. 

   • Open the downloaded template and make appropriate changes to it. For example, if you want to change the name server IP address, add that to the template. The following is an example:
     {
  "network": {
    "name": "enp1s0",  
    "nameServers": ["52.119.40.100"],
    "ipv4": {
      "type": "static",
      "ip": "192.168.0.1",
      "netmask": "255.255.255.0",
      "gateway": "192.168.0.1",
      "mtu": "1500"
},
"ipv6": {
   "type": "",
   "ip": "",
   "cidr": "",
   "gateway": "",
   "mtu": ""
},
  "disablepmtud": ""
},
"httpProxy": "",
"timeSettings": {
   "mode": "ntp",
   "servers": [],
   "pools": []
},
"docker": {
   "bip": "172.17.0.1/22"
},
"k3s_network": {
   "cluster_cidr": "192.166.0.0/24",
   "service_cidr": "192.167.0.0/24"
  }
}
     
     

     Important

     You must set the time setting mode to "ntp" for the configuration to take effect. Leaving the time setting mode empty will cause the configuration to fail.
3. Use the following commands to save the modified template on a USB drive:
      diskutil list (list out to find the USB drive location)
   diskutil eraseDisk FAT32 BLOXONE MBRFormat /dev/disk2 (format the USB drive)
   diskutil unmountDisk /dev/disk2 (unmount the USB drive)
   diskutil mountDisk /dev/disk2 (mount the USB drive)
   cp onprem.conf /Volumes/BLOXONE (copy the modified onprem.conf file downloaded from step 2)
   diskutil unmountDisk /dev/disk2 (unmount the USB drive and eject it from the system)
   
   
4. Insert the USB drive into the physical appliance you want to configure and connect to BloxOne Cloud.
5. When the appliance detects the configuration file, it compares the existing configuration with that in the file on the USB drive, and starts the configuration process based on the new information.
6. The host will restart when the process is complete. 

7. The host is connected to BloxOne Cloud when it is up and running.
   

   Important

   Once the host is connected to BloxOne Cloud, remove the USB drive from the appliance to avoid losing further configuration changes you make to the host.