Skip to content

Run Wing Commander on a machine other than the Master Node

BigOokie edited this page Sep 23, 2018 · 1 revision

Overview

A standard Wing Commander deployment will see Wing Commander installed onto the Master Node of the Skyminer. For most, this is the simplest, easiest and recommended way forward.

This guide has been put together to assist those that may have more advanced deployment requirements, and specifically require the ability to run Wing Commander on a machine other than the Skyminer Master Node, and even outside of the Skyminer itself. As mentioned, this is an advanced configuration, and will require you to deploy all required prerequisites to the target machine - these will be listed here, but the instructions for installing each will not (homework for the reader).

Prerequisites

The following are required before starting:

  1. A machine running Linux, or MacOS (Windows is not supported at this time). This machine must also have:
    • Go v1.10 installed and operational
    • Git and associated command line tools
    • Any other prerequisites listed in the Wing Commander documentation
  2. Port 8000 open on the Skyminer firewall and direct it to your Manager Node IP (port 8000).
    • Note, this should be open for internal access on your LAN only. Please do not open this to the WAN (Internet).
    • Port 8000 is the default port used when starting the Manager. You can change this - and if you did, please reflect that here.

Test Access

At this stage, there is no point continuing if the new machine cannot communicate with your Skyminer Manager Node. Ensure your Skyminer Manager is running then run the following command:

curl http://{IP_OF_SKYMINER_ROUTER}:8000/conn/getServerInfo

Replace {IP_OF_SKYYMINER_ROUTER} with your Skyminer Routers IP. This is the IP address you access your Skyminer from your LAN.

If you don't get a response, or you get a timeout or error response, something is not setup correctly. Continue to the following sections if you get a valid response.

Install Wing Commander

Install Wing Commander on the new target machine. Use the existing documentation to do this. Configure Wing Commander in the same way as you would for a regular installation - the only difference is that you MUST specify a different PORT for your Manager Node in the config.toml file. In most default installations, the following section of the config.toml file may be commented out or absent as its assumed by default to be 127.0.0.1:8000 - which works for most. You will need to edit and replace it as per the below

[skymanager]
address="{IP_OF_SKYYMINER_ROUTER}:8000"

Start Wing Commander

Start Wing Commander as per the documentation. Firstly ensure that you get the Welcome message in Telegram. Next select the start button and confirm that you get Nodes reported by the Bot.

If you encounter issues, check the steps above and confirm everything is as expected.