Wyn Enterprise Administration Guide

Wyn Enterprise: Node Management

As an administrator, you can easily manage the worker modules through the Node Management interface in the Admin Portal. It allows you to install, start, stop, uninstall, and configure a worker module for a specific machine in your distributed environment.

Typically, a monitor represents a single node in the Wyn Enterprise system. The monitor that installs with the server module is the primary node. The sub-node connected to the primary node is the secondary node. Primary node manages the secondary node to install, start, stop, uninstall, or configure a worker module. There can be number of secondary nodes connected to the primary node, with one or more worker(s) deployed on each secondary node. Refer to the following diagram for a better understanding.

Distributed Environment

Key Points -

  • It is always recommended to install the Server module first and add an inbound rule for port 51981 to the firewall. This is because the worker modules need to access the Server module from external machines.
  • Make sure that the CotWorker module installed on the secondary node has the access to the database service configured by the system.
  • In the Linux operating system, you can not deploy secondary nodes on the same machine as that of the primary node.

This article provides step by step instructions to configure the global settings for the primary node, add a secondary node, install the secondary node, and finally manage the worker modules on the machine where the secondary node is installed through the Node Management interface.

Configure Global Settings

This section describes the steps to configure the global settings for the primary node on the Node Management interface. These settings are required to add a secondary node.

  1. On the Admin Portal, navigate to the System Management > Node Management.

  2. In the Global Settings tab, set the Primary Node Host as the IP address of your system and modify the Identity Server URL such that it looks like this - http://<IP ADDRESS>:51981.
    Global Settings tab in Node Management

  3. Click the Save button. A Save Settings dialog box will appear.

  4. Click the Yes button to save the changes. Save Settings Dialog

Add Secondary Node

This section describes how to create a secondary node on the Node Management interface.

Note: You cannot add a secondary node if the Primary Node Host or Identity Server URL uses localhost or '127.0.0.1'.

  1. To create a secondary node, go to the Nodes tab and click the Add Node button.
    Add Secondary Node

  2. Enter the configuration details for the secondary node such as the secondary node name, the IP address of the machine where the secondary node will be deployed, and the port number.
    Configuring Secondary Node

  3. Click the Save button. The newly added secondary node is displayed in the Nodes list as shown.
    Nodes List displaying all the available nodes

  4. Select the secondary node (in this case, Secondary Node 1) from the list. Note that the current status of the node is Offline. Therefore, now we need to install the node on the machine where the secondary node is located.
    Checking the current status of the secondary node

Install the Secondary Node

This section describes the steps to install the secondary node from the Node Management interface. Scroll down to the bottom of the page and expand the How to install? section and follow the given instructions step by step.
Expanding the section that describes the installation steps for the secondary node

  1. Download and install .NET Core Runtime on the secondary node machine. Make sure you install the Hosting Bundle for Windows.
    Windows Server Hosting Installation Dialog

    It will take few minutes to install.

  2. Click and download the binary .zip file. Unzip the file and copy it on the secondary node machine.
    Copying the Monitor file onto the secondary node machine

  3. Execute the shell script as an administrator.

    • For Windows, run the command - .\install.bat
    • For Linux, run the command - sudo sh ./install.sh Excecute the shell script as an administrator

    After executing the installation steps, observe that the status of the node changes to Online. Now, you can install and manage the worker modules through the Node Management interface.

Note: Secondary nodes are automatically upgraded (if connected to primary node) when you upgrade the primary node.

Manage the Worker Modules

This section describes how you can manage the worker modules on the secondary node through the install, start, stop, and delete options.

Note: You cannot uninstall the workers of the primary node.

  1. Click the Install button next to the worker module you want to install.
    Install the worker module on the secondary node machine
  2. Once the installation is successful, click the Start button.
    Start the service

    You can now view the additional worker on the Admin Portal.
    Copying the Monitor file onto the secondary node machine

    You can also remove the installed worker module and stop the worker service on the secondary node using the Delete and Stop buttons, respectively.

    • Click the Delete button to uninstall the worker on the secondary node.

      Uninstall the worker module on the secondary node machine

    • Click the Stop button to stop the worker service on the secondary node.

      Uninstall the worker module on the secondary node machine

      You can also re-start the stopped worker service using the Start button.

    Tip: If the status of the secondary node appears as Offline, restart the Wyn Services on the machine where the secondary node is installed.

Uninstall the Secondary Node

This section describes the steps to uninstall or remove the secondary node through the Nodes Management interface.

  1. Select the secondary node from the Nodes list that you want to remove. In this case, select 'Secondary Node 1' from the list.
    Uninstall or remove the secondary node using the Nodes Management interface

  2. Click the Delete button next to the selected node.
    Uninstall or remove the secondary node using the Nodes Management interface

  3. In the Delete Node dialog box that appears, click the Yes button to confirm. Note that you cannot rollback the delete operation.
    Uninstall or remove the secondary node using the Nodes Management interface

Note: After implementing the above steps, execute the shell script as an administrator to remove the monitor service from the secondary node machine.
    • For Windows, run the command - .\uninstall.bat
    • For Linux, run the command - sudo sh ./uninstall.sh