Server:Install on Azure

From FlexRule Wiki
Jump to: navigation, search


Before start installing FlexRule Server on Azure, you need to prepare a VM and its connectivity.


  • Windows: 2008 R2 Sp1 or later
  • CPU: 2 Cores or more
  • RAM: 7 GB or more
  • HDD: 14 GB SSD or more

In our test environment, we chose the below server:


IP Addresses

Each VM on Azure has two IP addresses: Public and Private. During the VM installation, you need to know the VM's Public and Private IP addresses. These IPs have been listed in VM's Overview page:

FRS Azure IPs.png

These IPs will be used later to set up the FlexRule Server master/agent configurator application.

Setup DNS

In this step, you are going to create a DNS name Label for VM that allows you to use the name to access VM rather than its IP.

After Installing FlexRule Server Master and Agent, you will be able to browse the FlexRule Workbench. FlexRule Workbench is available by browsing the VM's DNS name from your browsers (i.e., Chrome, IE, etc.). Your selected VM by default doesn't have the DNS name label and it needs to be configured manually. This option is available under Server Settings/Configurations/DNS Name Label:

FRS Azure DNS.png

Inbound security Rules

You should configure new Inbound security Rules for VM that enables communication to your VM from the outside (internet). By default, all ports (except RDP) are blocked. To be able to browse FlexRule Workbench later on, we need to open 2 ports:

  • FlexRule Server Master is using TCP:9000
  • FlexRule Workbench is using TCP:9010 port

In order to add these ports in Inbound Security rules, you need to do the following:

  1. From left panel, choose your Settings/Network Interfaces
  2. Click on Network Security Group, then the VM machine and then Inbound Security Rules
  3. Click on Add (the Add button is the 3 horizontal lines with a down arrow).

Firewall Policy

In this step, you need to configure Inbound and Outbound ports on your firewall policy in order to be able to browse FlexRule Workbench over the Internet. To do that, you need to have the following Ports opened in your Windows Firewall:

  1. TCP:9000 (FlexRule Server Master)
  2. TCP:9010 (FlexRule Server Workbench).


FlexRule Server Master

When you use the Microsoft Azure VM, the IP addresses you would use on FlexRule Server Configurator need to be picked from your VMs configuration. The IP or Name address for FlexRule Server Master and Workbench would be your VM's Private IP address. In our test environment is a private VM IP address.

FlexRule Server Agent

You can find step-by-step instructions on how you can install the FlexRule Server-Agent at FlexRule Server Configurator.

When you use the Microsoft Azure VM, default values for configurator will be different. Similar to the FlexRule Server Master configuration, you need to use your VM's private IP address, and the port would be 9005 for the Agent. FlexRule Server Agent and FlexRule Server Master need to communicate to each other. Therefore, during the Agent set up this requires the address of the Master. In this step, your Master's Full Address would be:

http://your Private VM's IP address:9000
Info2.png By default the FlexRule Server Master public port is 9000

In our test environment this is what we have used:

FlexRule Workbench

After you install the FlexRule Server Master and Agent successfully, it is time to configure your Workbench. Workbench has a configuration file under:

[Local Disk]/Program Files (x86)/Pliant Framework/FlexRule Server/<version>/Master/Workbench/FlexRule/Config.jsx
  1. Open the file by using any text editor (e.g., Notepad).
  2. change the masterAddress to
Bulbgraph.pngTo be able to browse the Workbench URL over the Internet, you will need to change the Master Address to the DNS Lable that you have chosen during the DNS setup of VM. In our test environment, our Server DNS Label was flexruleserver

The change below allows Workbench communicate to Master's public API:

  1. // Generated by configurator
  2. var FlexRuleMasterServer = {
  3.     masterAddress: '',
  4.     clientId: 'App1',
  5. };

Browse FlexRule Workbench

After installing and configuring the FlexRule Server (Master, Agent and Workbench), now it's time to run them. You can follow this instruction, which explains step-by-step how you can run these. In our scenario, we simply ran them as command line Windows Console application.

If you install and configure everything correctly, now you should be able to browse the FlexRule Workbench from your local machine over the Internet.

  1. Open a browser like Chrome and use the VM's DNS Label name to browse the FlexRule Workbench at
  2. Enter your Admin User and Password (you have chosen this Username and Password during the FlexRule Server Master configuration).
  3. Then you will be able to see the FlexRule Workbench Home page.

FRS Azure WorkbenchHome.png