Only perform this procedure when directed by SiteWorx.

The SiteWorx app (gw3engine files) is constantly updated. If an old version of a SiteWorx app is installed, then the gateway will be downgraded and may lose functionality. SiteWorx automaitcally updates gateways to the latest SiteWorx app and this procedure is not necessary in almost all scenarios.

Materials Required

1. Micro USB cable
   
2. Computer
   
3. DLGW3
   
4. two gw3engine files (one ending in .squashfs-xz and the other ending in .sig)
   
5. gw3cli
   
1. Email SiteWorxOps@siteworx.io to receive gw3cli. Please note if using a Mac or Windows computer.
   

Workflow

Mac

1. Power the gateway for 5 minutes. After 5 minutes, view the large gateway Health indicator:
   
1. If the Health indicator is blue, yellow, green or orange, STOP and do not perform the steps in this guide
   
2. If the Health indicator is red, blinking red or off and you have been advised to perform these steps by SiteWorx, proceed to step 2
   
2. Download and unzip gw3cli-macos-1.2.4. Drag the unzipped file into your Desktop
   
3. Download the two gw3engine files (one ending in .squashfs-xz and the other ending in .sig) and save them to your Desktop
   
4. Open Terminal and change directory to to your Desktop directory where the gw3cli tool is located
   
1. type cd ~/Desktop/
   
   
   
   
5. Enter command ./gw3cli this will show you the help menu with all commands and options
   
1. If you see the "gw3cli cannot be opened..":
   
1. Click Cancel
   
2. Navigate to System Settings > Privacy & Security, then click Allow Anyway
   
   
   
   
6. Connect the DLGW3 to your computer via Micro USB cable and wait a few minutes for the DLGW3 to complete booting
   
7. Enter command: ./gw3cli get-status
1. This will display the serial number and versions of all software
   
8. Update the DLGW3 application to version 0eb620b
   
1. Enter command: ./gw3cli update-app ./gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz ./gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz.dev.sig
   
2. The above command has the correct file paths for a file saved to the Desktop. If you are having difficulty entering the correct the file paths, you can drag and drop gw3cli, gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz and gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz.dev.sig into Terminal. This will automatically populate the file paths.
   
9. Update the DLGW3 OS to version 1.2.6
   
1. Enter command: ./gw3cli update-app ./dl-gateway-basic-gateway3-1.2.6.rootfs.squashfs-xz ./dl-gateway-basic-gateway3-1.2.6.rootfs.squashfs-xz.dev.sig
   
10. Enter command: ./gw3cli get-status
    
1. This will display the serial number and versions of all software. Check that the versions are different from when the command was entered in Step 6
   
11. Connect the gateway to the internet, wait 5 minutes and observe if the large Health indicator is blue, yellow, green or orange. These colors indicate the SiteWorx app started. A blinking blue Health indicator notes a connection to SiteWorx if the correct ports are open
    

Windows

1. Download and unzip gw3cli-win32-1.2.4.zip Drag the unzipped file into your Desktop
   
2. Download the two gw3engine files (one ending in .squashfs-xz and the other ending in .sig) and save them to your Desktop
   
3. Ensure the latest version of Commissioner is installed to ensure USB drivers are up to date (visit https://help.siteworx.io/portal/en/kb/articles/download-commissioner)
   
4. Click Start, and search for cmd to open CMD prompt
   
5. Enter command: cd Desktop
6. Enter command: gw3cli.exe
1. This will show you the help menu with all commands and options
   
2. Note: The exact syntax of the below commands will depend on where the file is saved and the configuration of your computer. If you are not comfortable with Command Prompt, the easiest thing to do is drag and drop the gw3cli.exe file into Command Prompt to start each command and then manually type the portion of the command after gw3cli.exe For example to do the gw3cli.exe command, drag gw3cli.exe into the Command Prompt and then press the Return/Enter key. To do the gw3cli.exe get-status command, drag gw3cli.exe into the Command Prompt and then type get-status and then press the Return/Enter key.
   
   
   
   
7. Connect the DLGW3 to your computer via Micro USB cable and wait a few minutes for the DLGW3 to complete booting
   
8. Enter command: ./gw3cli.exe get-status
1. This will display the serial number and versions of all software
   
2. If this command fails to read the serial number from the gateway, please email SiteWorxOps@siteworx.io with a screenshot of Command Prompt as an additional driver may need to be installed
   
9. Update the DLGW3 application to version 0eb620b
10. Enter command: ./gw3cli update-app ./gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz ./gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz.dev.sig
    
1. The exact syntax of the above command will depend on where the file is saved and the configuration of your computer. If you are not comfortable with Command Prompt, the easiest thing to do is drag and drop the gw3cli.exe file into Command Prompt to start each command and then manually type the portion of the command after gw3cli.exe For example to do the update-app command, drag gw3cli.exe into the Command Prompt, then type get-status, press the space bar, drag gw3engine-0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz into the Command Prompt, drag 0eb620b96c756371a59efbbf8b0cc86d3caa8dbe.squashfs-xz.dev.sig into the Command Prompt and then press the Return/Enter key.
11. Update the DLGW3 OS to version 1.2.6
1. Enter command: ./gw3cli update-app ./dl-gateway-basic-gateway3-1.2.6.rootfs.squashfs-xz ./dl-gateway-basic-gateway3-1.2.6.rootfs.squashfs-xz.dev.sig
12. Enter command: ./gw3cli get-status
1. This will display the serial number and versions of all software. Check that the versions are different from when the command was entered in Step 6
   
13. Connect the gateway to the internet, wait 5 minutes and observe if the large Health indicator is blue, yellow, green or orange. These colors indicate the SiteWorx app started. A blinking blue Health indicator notes a connection to SiteWorx if the correct ports are open.