Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Download the correct version of the Uplink Gateway package from here.

...

  1. Disable Windows automatic proxy service detection

...

Linux Installation

...

How to Stop Gateway

  1. Execute the stop script.
    Linux

    Code Block
    ./stop.sh

    Windows

    Code Block
    .\stop.bat

How to Update Gateway

Local Update

  1. Ensure that the old version of Gateway is running.

  2. Navigate to the extracted folder of the new version of the Gateway.

  3. Execute the script update.sh by providing the old Gateway directory and new Gateway directory.
    Linux

    Code Block
    ./update.sh -orig <path_to_old_version_directory> -dest <path_to_new_version_directory>

    Windows

    Code Block
    .\update.bat -orig <path_to_old_version_directory> -dest <path_to_new_version_directory>

Remote Update

Note that this requires an SSH Server to be installed on the Gateway’s Host system.

  1. Get service information of the gateway’s connection.
    Curl

    Code Block
    curl --location 'https://<UPLINK SERVICE URL>/api/device/<CAMERA_ID FROM GATEWAY ACCESS TOKEN>' --header 'Authorization: Bearer <UPLINK SERVICE PASSWORD>'

    Response

    Code Block
    {"camid": "3045", "proxy_id": "b4d185e7efdfa0f4ce01", "forwards": [{"name": "camera-gateway-http", "protocol": "http", "host": "127.0.0.1", "port": 80, "proxy_port_number": 33984, "proxy_host": "b4d185e7efdfa0f4ce01.proxy.cloud-vms.com", "proxy_url": "http://b4d185e7efdfa0f4ce01.proxy.cloud-vms.com:33984", "proxy_port": 33984}, {"name": "camera-gateway-ssh", "protocol": "tcp", "host": "172.31.2.21", "port": 22, "proxy_port_number": 33985, "proxy_host": "b4d185e7efdfa0f4ce01.proxy.cloud-vms.com", "proxy_port": 33985}]}
  2. Connect to device via the SSH info.

    Code Block
    ssh -i <PATH TO .PEM> <USERNAME>@a4f9efe5b9e887b79001.proxy.cloud-vms.com -p 34917

    Connection method may vary depending on how your SSH Client is configured on the host machine.

  3. Upload or download the Gateway version you want to update to onto the Gateway device.

  4. Navigate to the directory containing the new version of the Gateway.

  5. Execute the update script as a background process. Note that the connection will be broken as the Gateway restarts.
    Linux

    Code Block
    nohup sudo ./update.sh -orig <path_to_old_version_directory> -dest <path_to_new_version_directory> &

    Windows

    Code Block
    Start-Process .\update.bat -orig <path_to_old_version_directory> -dest <path_to_new_version_directory> -NoNewWindow


    If done successfully the Gateway should be accessible from it’s original IP.

API Examples

Request authorization token from Gateway

...

Valid response: 204 No Content

Restart Gateway

...

service connection

Code Block
curl -H 'Authorization: Token 8656763e69dd6ead1d167b865f8caf08bf907227' -X POST http://<DEVICE_IP>:8000/api/restart/

...

From the editing form you can then update the IP and click Update.

...

Remote Connection to Gateway Device

The Uplink Gateway not only creates a connection to the user interface, it also creates a connection to the hosting device on port 22 which can be used to connect to the device using SSH.

  1. Get service information of the gateway’s connection.
    Curl

    Code Block
    curl --location 'https://<UPLINK SERVICE URL>/api/device/<CAMERA_ID FROM GATEWAY ACCESS TOKEN>' --header 'Authorization: Bearer <UPLINK SERVICE PASSWORD>'

    Response

    Code Block
    {"camid": "3045", "proxy_id": "b4d185e7efdfa0f4ce01", "forwards": [{"name": "camera-gateway-http", "protocol": "http", "host": "127.0.0.1", "port": 80, "proxy_port_number": 33984, "proxy_host": "b4d185e7efdfa0f4ce01.proxy.cloud-vms.com", "proxy_url": "http://b4d185e7efdfa0f4ce01.proxy.cloud-vms.com:33984", "proxy_port": 33984}, {"name": "camera-gateway-ssh", "protocol": "tcp", "host": "172.31.2.21", "port": 22, "proxy_port_number": 33985, "proxy_host": "b4d185e7efdfa0f4ce01.proxy.cloud-vms.com", "service_port": 33985}]}
  2. Connect to device via the SSH info.

    Code Block
    ssh -i <PATH TO .PEM> <USERNAME>@a4f9efe5b9e887b79001.service.cloud-vms.com -p 34917

    Connection method may vary depending on how your SSH Client is configured on the host machine.