Upgrade to a New Version

◷ Reading Time: 4 minutes

When it comes to the FlexRule Server upgrade process, the installer does not offer an automated upgrade. That’s simply because in FlexRule Server we want you to be in control.

When to Upgrade

There are different scenarios in which you might want to consider upgrading the whole FlexRule Server to a new version or just upgrading the FlexRule Runtime part of it.

New FlexRule Runtime

FlexRule Server Master’s and Agent’s nodes use FlexRule Runtime for different purposes:

  1. Master: Uses FlexRule Runtime for internal use and for execution of logic
  2. Agent: Uses FlexRule Runtime for execution of logic

When a new version of FlexRule Runtime is released and the installed FlexRule Server is not using the latest version, you can consider upgrading the FlexRule Server Agent’s node to ensure it uses the latest version of FlexRule Runtime.

New FlexRule Server

When a new FlexRule Server is released, it will always have the latest version of FlexRule Runtime at that time. So you can simply upgrade to the latest version of FlexRule Server. This requires you to upgrade both Master and Agent nodes together. You can start with Agent nodes one-by-one and then upgrade the Master.

Folder Structures

Let’s learn more about the folder structure and files in FlexRule Server. When FlexRule Server is used, you have the option of:

  1. Installing Master only
  2. Installing Master and Agents

During installation, you specify the folder for the Master and Agents. Everything by default is inside those folders.


In the Master folder, there are many files and folders but not all of them are important for you. Below is the list of items that are your assets:

  1. FlexRule.Server.Master.dll.config: This is a file that has the configuration of the Master node.
  2. master.log: This is a Master’s node log file. This file is also located inside the Master’s installation unless you configured it otherwise.
  3. FlexRule.Server.License.lic: This is your license for FlexRule Server

The rest are FlexRule Server standard files and folders.


In the Agent’s folder you can find:

  1. FlexRule.Server.ExecAgent.dll.config: This is a file that has the configuration of the Agent node.
  2. agent.log: This is an Agent’s node log file. This file also is located inside the Agent’s installation unless you configured it otherwise.
  3. FlexRule.Server.License.lic: This is your license for FlexRule Server


You need to have a backup for your Master and Agent’s folders before upgrading, or at least make a backup from the files mentioned above.

Ensure you have a backup before upgrading.

Copy and Paste

New FlexRule Runtime

You need to follow the instructions below for Master and all Agents:

  1. Make a backup from the Master and Agent nodes.
  2. Stop the running Master/ Agents.
  3. Download the latest Runtime from NuGet.
  4. Unzip the downloaded .nupkg file (You can use a tool such as 7-zip).

  5. Navigate to the unzipped folder –> lib –> netstandard2.0
  6. Copy all the assembly files (DLL files) 

  7. Paste the copied DLL files in both Master and Agent folders.
    The default locations are,

    For Master:
    1. C:\Program Files (x86)\Pliant Framework\FlexRule Server\4.2.30\Master
    2. C:\Program Files (x86)\Pliant Framework\FlexRule Server\4.2.30\Master\tools

      For Agent:
    1. C:\Program Files (x86)\Pliant Framework\FlexRule Server\4.2.30\ExecAgent
    2. C:\Program Files (x86)\Pliant Framework\FlexRule Server\4.2.30\ExecAgent\tools
  8. Restart the Master and Agent(s) servers.

Grab the latest FlexRule Runtime from NuGet.

New FlexRule Server

You need to proceed as shown below:

  1. Make a backup from the Master and Agent’s nodes
  2. Install the new FlexRule Server
  3. Copy your important files and folders from the old version to the new version
    1. Database file
    2. Master and Agent configuration file
Updated on October 5, 2021

Was this article helpful?

Related Articles