Wyn Enterprise: Upgrade Wyn Enterprise from 5.0 to 5.1 Edition

This article explains the steps to upgrade Wyn Enterprise from 5.0 to 5.1 edition in a distributed environment. To upgrade Wyn Enterprise to a new version if there are no remote workers installed, see this article.

The below sections provide information on how to upgrade Wyn Enterprise 5.0 edition with remote workers installed.

• Case 1: With Local Workers
• Case 2: Without Local Workers
• Case 3: Separate Deployments for Server and Portal

Case 1: With Local Workers

In this case, workers are installed on both the primary and secondary nodes. On the primary node, you can directly upgrade to the new version.

To upgrade the secondary node, it is recommended to reinstall the secondary node as explained in below steps.

1. Uninstall Wyn Enterprise on the secondary node. For information on how to install or uninstall a secondary node, please see this article.

2. Reinstall the Cot Worker, Dashboard Worker, and Reporting Worker in the secondary node. For more information on the installation steps, please see this article.

Case 2: Without Local Workers

In this case, workers are not installed on the primary node, but on the secondary node. Depending on your OS, follow the below steps.

For Linux

After upgrading the primary node to the latest version, there are no workers installed. Next, you need to follow these steps to add the workers and their configuration details in the conf file.

1. Copy the /opt/Wyn/CotWorker, /opt/Wyn/DashboardWorker, and /opt/Wyn/ReportingWorker folders from the secondary node to the /opt/Wyn folder on the primary node.

2. Add missing workers' configurations to the primary node's conf file.

   

3. Restart Wyn Enterprise on the primary node using the following command.

   sudo systemctl restart wyn
   

4. To upgrade the secondary node, please follow the steps mentioned in the Case 1: With Local Workers section.

For Windows

After upgrading the primary node to the latest version, the workers are installed. Next, you need to follow these steps to add the missing configurations for the workers.

1. Update the primary node's conf file to add missing workers' configurations.

   

2. Restart Wyn Enterprise on the primary node using the following command.

   sudo systemctl restart wyn
   

3. To upgrade the secondary node, please follow the steps mentioned in the Case 1: With Local Workers section.

Case 3: Separate Deployments for Server and Portal

In the latest release, Portal and Server modules have been merged into the Server module. So, from this release onward, there is only a Server module but no Portal module.

In order to upgrade Wyn Enterprise from 5.0 to 5.1 edition, please follow the below steps.

1. Upgrade the primary node where the Server module is located.

2. Migrate the portal configuration in Wyn.conf file on the secondary node to the server configuration in Wyn.conf file on the primary node.

   Note that the migration is only required if the following portal configurations exist in the Wyn.conf file on the secondary node.

Note: In case the Wyn.conf file contains BuiltInHttps configuration settings and is enabled, then you need to perform additional migration as mentioned below.
1. Modify the domain name on DNS to point to the primary node IP address instead of the secondary node IP address.
2. Upload the new HTTPS certificate (pfx format) on the System Configurations page of the Admin Portal.

3. Restart Wyn Enterprise on the primary node by running the below command.

   sudo systemctl restart wyn
   

   The secondary node where the Portal module is located gets deprecated.