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. The primary node manages the secondary node to install, start, stop, uninstall, or configure a worker module. There can be several secondary nodes connected to the primary node, with one or more worker(s) deployed on each secondary node.
Key Points -
It is 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.
Ensure that the CotWorker module installed on the secondary node has access to the database service configured by the system.
In the Linux operating system, you cannot 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 then 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.
On the Admin Portal, navigate to System Management > Node Management.
In the Global Settings tab, define the Log Level for the primary node. You can choose from the following log levels -
Verbose – Trace information that includes method entry, exit, and return values.
Debug – Informational events useful for debugging an application.
Information – General information that highlights the progress of the application.
Warning – Potential harmful situations that might have an adverse performance implication.
Error – Error events that can prevent normal program execution but might still allow the application to run.
Fatal – Severe error events that might force an application to terminate.
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>:51980.
Click the Save button. A Save Settings dialog box will appear.
Click the Yes button to save the changes.
Add Secondary Node
This section describes creating 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'.
To create a secondary node, go to the Nodes tab and click the Add Node button.
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.
Click the Save button. The newly added secondary node is displayed in the Nodes list as shown.
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.
Install 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.
Download and install ASP.NET Core Runtime on the secondary node machine. Make sure you install the Hosting Bundle for Windows.
It will take few minutes to install.
Note: From release 6.0 onwards, make sure to download the ASP.NET Core Runtime 6.0 instead of 3.1.
Click and download the binary .zip file. Unzip the file and copy it to the secondary node machine.
Execute the shell script as an administrator.
For Windows, run the command - .\install.bat
For Linux, run the command - sudo sh ./install.sh
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 the primary node) when you upgrade the primary node.
Manage Worker and Service Modules
You can manage the workers and service modules of the primary and secondary nodes of Wyn Enterprise from the Service Information tab. You can also assign functional roles to the workers using the dropdown in the Worker Functional Roles column. Functional roles in Wyn Enterprise determine the type of tasks that can be assigned to the workers. Wyn Enterprise offers three functional roles - Report Worker, Cot Worker, and Dashboard Worker. With the default configurations, all workers can perform all types of tasks. However, with functional roles, you get an option to configure specific roles for the workers.
Note: Worker and Service modules of the primary node cannot be uninstalled.
Various operations you can perform from the Service Information tab for the Primary node and Secondary node are explained below.
Primary Node
You can enable, disable, start, or stop the workers and services of the primary node using the corresponding buttons from the Service Information tab.
You can also assign functional roles to the Cot and Report Workers by choosing a role from the dropdown in the Worker Functional Roles column. Click Save to apply changes. The available roles for both workers are listed below,
Cot Worker: Refresh model cache and Refresh dataset cache.
Report Worker: Preview, Scheduled Task, Export, and Others (includes download, bursting, and thumbnail generation).
Secondary Node
You can install the workers and service modules on the secondary node using the Install button.
You can enable, disable, start, or stop the workers and services of the secondary node using the corresponding buttons from the Service Information tab.
You can also assign functional roles to the Cot and Report Workers by choosing a role from the dropdown in the Worker Functional Roles column. Click Save to apply changes or Save & Restart to apply changes and restart the worker.
Tip: If the status of the secondary node appears as Offline, restart the Wyn Services on the machine where the secondary node is installed.
The following table shows the workers and services available in Wyn Enterprise,
Service Name | Type | Description |
---|---|---|
AnalysisDB Service | Service | AnalysisDB Service includes the analysis database. |
COT Worker | Worker | COT Worker is a standard Wyn worker used to execute the calculation to generate column-oriented datasets. |
Dashboard Worker | Worker | Dashboard worker is a standard Wyn worker used to execute the dashboard rendering tasks. |
Java Data Source Service | Service | Java Data Source Service is a lite Java service used to fetch the schema and execute SQL commands. |
MemoryDB Service | Service | MemoryDB Service is an in-memory database service used to store temporary data for real-time datasets and execute analytical queries. |
Report Worker | Worker | Report worker is a standard Wyn worker used to execute the report rendering tasks. |
Scheduler Service | Service | Scheduler service is the main service used that communicates with the workers to monitor the worker status and assign various tasks to the workers. The scheduler service also communicates with the server to return the status and results of the worker tasks. |
Server | - | The Wyn server website that manages documents and scheduled tasks. |
Note: Scheduler Service and Server cannot be stopped. If stopped, you will encounter accessibility issues in the Wyn Enterprise application.
Uninstall Secondary Node
This section describes the steps to uninstall or remove the secondary node through the Nodes Management interface.
Select the secondary node from the Nodes list that you want to remove. In this case, select 'Secondary Node 1' from the list.
Click the Delete button next to the selected node.
In the Delete Node dialog box that appears, click the Yes button to confirm. Note that you cannot roll back the delete operation.
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