Convert a DLGW3 from LightRules to SiteWorx

Convert a DLGW3 from LightRules to SiteWorx

Alert
This guide only applies to DLGW3-LR gateways. All DLGW3-LR's have serial numbers beginning in 0202XXXX and have model number "DLGW3-LR" on the front serial number label. DLGW2 units are not compatible.
Warning
DLGW2 gateways are not compatible with SiteWorx and cannot be converted.

Before you Start

Check Gateway Mode

Confirm the DLGW3-LR is in LightRules mode by powering the DLGW3-LR and viewing the Mode status indicator.
  1. LightRules mode
    1. Blinking yellow (OS 1.1.0+)
    2. Solid yellow (OS 1.0.0)
  2. SiteWorx mode
    1. Solid green
Info
If you are uncertain on the color or pattern of the Mode status indicator, the mode can be also checked using gw3cli (see Workflow section for details).

Gather Necessary Items

  1. Micro USB cable
  2. Computer
  3. DLGW3-LR
  4. gw3cli
    1. Email SiteWorxOps@siteworx.io to receive gw3cli. Indicate whether you're using a Mac or Windows computer.

Workflow

Mac
  1. Download and unzip gw3cli-macos-1.2.4. Drag the unzipped file into your Desktop.
  2. Open Terminal and change directory to to your Desktop directory where the gw3cli tool is located.
    1. To do so, type in cd ~/Desktop/



  3. Enter command ./gw3cli this will show you the help menu with all commands and options



    1. If you see the "gw3cli cannot be opened.." message, the click Cancel



    2. Navigate to System Settings > Privacy & Security, then click Allow Anyway



  4. Connect the DLGW3-LR to your computer via Micro USB cable and wait a few minutes for the DLGW3-LR to complete booting.
  5. Enter command: ./gw3cli get-status
    1. This will display the serial number and versions of all software.
  6. Enter command: ./gw3cli get-config
    1. This will display the configuration of the DLGW3-LR.



  7. Look for mode in the setup section
    1. "gateway2.emulator" indicates the DLGW3-LR is in LightRules mode
    2. "gateway3.engine" indicates the DLGW3-LR is in SiteWorx mode
      1. Only proceed if mode is "gateway2.emulator"
  8. To switch from LightRules mode to SiteWorx mode, enter command: ./gw3cli set-config '{"setup":{"mode":"gateway3.engine"}}'
  9. Enter command: ./gw3cli restart-app
  10. After gateway reboots, verify the changes were completed by checking that mode is now "gateway3.engine"



  11. Email SiteWorxOps@siteworx.io the serial numbers of the DLGW3-LRs that were converted from LightRules mode to SiteWorx mode. The DLGW3-LRs will need to be registered to SiteWorx by SiteWorx Operations before the DLGW3-LRs will connect to SiteWorx.
Windows
  1. Download and unzip gw3cli-win32-1.2.4.zip Drag the unzipped file into your Desktop.
  2. Ensure the latest version of Commissioner is installed to ensure USB drivers are up to date:
    1. https://commissioner.lightrules.net/Content/English/Home.htm
  3. Click Start, and search for cmd to open CMD prompt.
  4. Enter command: cd Desktop
  5. Enter command: ./gw3cli.exe
    1. This will show you the help menu with all commands and options.



      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.

  6. Connect the DLGW3-LR to your computer via Micro USB cable and wait a few minutes for the DLGW3-LR to complete booting.
  7. 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.
  8. Enter command: ./gw3cli.exe get-config
    1. This will display the configuration of the DLGW3-LR.
    2. Look for mode in the setup section:
      1. "gateway2.emulator" indicates the DLGW3-LR is in LightRules mode
      2. "gateway3.engine" indicates the DLGW3-LR is in SiteWorx mode
        1. Only proceed if mode is "gateway2.emulator"
  9. To switch from LightRules mode to SiteWorx mode, enter command: gw3cli.exe set-config {\"setup\":{\"mode\":\"gateway3.engine\"}}
  10. Enter command: ./gw3cli restart-app
  11. After gateway reboots, verify the changes were completed by checking that mode is now "gateway3.engine"
  12. Email SiteWorxOps@siteworx.io the serial numbers of the DLGW3-LRs that were converted from LightRules mode to SiteWorx mode. The DLGW3-LRs will need to be registered to SiteWorx by SiteWorx Operations before the DLGW3-LRs will connect to SiteWorx.
 

    • Related Articles

    • SiteWorx Gateway Connection - IT Information

      Firewall Ports Gateways must be able to connect to reliable high-speed internet, with outbound firewall access to the following standard ports. Inbound access can remain blocked. 443 (HTTPS - TCP): Secure HTTP, used for SiteWorx core services 8444 ...

    • How to Statically Address a Gateway 3 (DLGW3)

      This guide only applies to gateways of model DLGW3-LR or DLGW3. These products will have serial numbers beginning in 0202XXXX. Before you Start Gather Necessary Items Micro USB cable Computer, with Commissioner 3.4.1 or later DLGW3 or DLGW3-LR “Live” ...

    • Add a Gateway

      Click Lighting Gateway Select Manually add gateway information to the map and then click Next Enter all lighting gateway information, associate the lighting gateway with the desired network, and then select the lighting gateway type (refer to the ...

    • Gateway Connection Troubleshooting

      Live Gateway Connectivity Status Admin users can view the live gateway connectivity status in the Admin Console, which is accessed by clicking the square icon in the top-right and selecting Admin from the dropdown menu. Click Network along the left ...

    • How to determine the MAC address of a SiteWorx Gateway (DLGW3)

      The MAC address of a DLGW3 is based on the serial number. There are three serial number ranges and each serial number range has a different MAC address range. MAC Address Ranges by Serial Number 02020100 to 02020FFF use 7C70BC202000 to 7C70BC202EFF ...