We use cookies to remember your language choice. By using our websites you accept this in accordance with the Cookie section in our Privacy Statement.
Accept
We use cookies to remember your language choice. By using our websites you accept this in accordance with the Cookie section in our Privacy Statement.
Accept

3. Preconfiguration

3.1 Necessary files

To install the solution, you need to open the folder created at #2.1 and put the following files there:

  • provisioning.b64: a file containing the license information. Get one from our support team. If there is no such file, the backend won’t start.
  • tls_chain.pem + tls_privkey.pem: a TLS certificate for HTTPS. If there are no such files, the server will work over HTTP instead of HTTPS.
    Note that the chain file should contain the whole certificate chain. E.g., if you use Let’s Encrypt for certificate generation, you should rename its privkey.pem into tls_privkey.pem and its fullchain.pem to tls_chain.pem.

On the screenshot, the shared folder is named rxgw-extra.

Registry - File Station.png

3.2 Container configuration

3.2.1 Create a container

  1. Open Docker app,
  2. Choose Image pane to the left,
  3. Select rxgateway-onpremise:latest image and click Launch.
  4. Enter container name, e.g., rxgw,
Image - Container Settings.png

3.2.2 Mount the folder containing extra files

  1. Click the Advanced Settings button.
  2. In the Advanced Settings, choose the Volume tab and add the rxgw-extra folder there:
  3. Click the Add Folder button,
  4. Find and choose the rxgw-extra folder,
  5. Click Select,
  6. In the Mount path field, enter /extra,
  7. Click Apply.
Synology - advanced container settings

3.2.3 Open necessary ports

  1. Choose the Port Settings tab,
  2. Map all container ports listed there to the same local ports, as shown on the screenshot.
Advanced Container Settings - Port Settings.png

3.2.4 Set the environment variables

  1. Choose the Environment tab,
  2. Set the following parameters:
    1. RXGW_ADDRESS: the URL of your future Remotix server,
    2. RXGW_PORT: the unified port to access Remotix server (8443 by default),
    3. RXGW_BASE_URL: the full URL of your Remotix server, including HTTP/HTTPS and port,
    4. RXGW_HUB_NAME: name of your Remotix server to be shown in Remotix Hub,
    5. RXGW_MAINT_USER: username to access Remotix server's maintenance page,
    6. RXGW_MAINT_PASS: password to access Remotix server's maintenance page,
Advanced Container Settings - Environment.png

3.2.5 Finish container creation

  1. Click the Apply button,
  2. On the General Settings page of the wizard, click Next,
  3. On the Summary page of the wizard, review the final configuration and make sure that everything is correct,
  4. Make sure that the “Run this container after the wizard is finished” option is on,
  5. Click Apply.
Synology - create container

Now you should have the container up and running.

To check its status:

  1. Open Docker app,
  2. Choose Container pane to the left,
  3. Select your Remotix container (“rxgw” here),
  4. Click the Details button,
  5. Open Log tab.

If you see the Configs are ready, starting services... line in the log and the last line of the log says [APP] Entering sleep loop, the Remotix solution has been launched successfully.

rxgw - Log.png

You can also open the maintenance page and check what it says, too. The URL is your RXGW_BASE_URL/maint. For settings shown on the screens above, it is https://rxc0.nulana.com:8443/maint.

The status of all four modules (DB, Back, Front, and Tunnel) should be “Running.” If it is not, please check #5 Troubleshooting.

On-premise maintenance page status

3.3 Adding admin user

To finish the setup and make your local copy of the Remotix Hub usable, you need to add the first administrator to the Hub:

  1. Open the maintenance page (RXGW_BASE_URL/maint/),
  2. Scroll down to the “Admin users” section,
  3. Click Add new admin user,
  4. Enter the username and password for the new user,
  5. Click Add.
Maintenance - add user

Congratulations! Now your instance of Remotix server is good to go. The next step is to set client and agent apps to use it.