Upgrade to a New Version

Print Friendly, PDF & Email

◷ 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. Databases: This is a folder in which the actual Master’s database is located.
  2. FlexRule.Server.Master.exe.config: This is a file that has the configuration of the Master node.
  3. 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.
  4. 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. master.log: This is an Agent’s node log file. This file also is located inside the Agent’s installation unless you configured it otherwise.
  2. 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 all agents:

  1. Make a backup from the Agent nodes
  2. Install the new FlexRule Runtime anywhere outside of the FlexRule Server location
  3. Navigate to the Framework folder of the installed FlexRule Runtime
  4. Copy all of the assembly files (DLL files) except
    1. System.Net.Http.dll
    2. System.Net.Http.Formatting.dll
    3. System.Web.Mvc.dll
  5. Shutdown the Agent node before proceeding
  6. Paste the files into the Agent’s folder
  7. Run the Agent node

For example, the image below shows what assemblies are required to be copied to Age machines to upgrade the FlexRule Runtime on the Agent. The image below also shows what assemblies must be copied across (under the blue rectangles) and which ones should not be copied (outside the blue rectangles).

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 August 8, 2019

Was this article helpful?

Related Articles