Server:Install on Azure

From FlexRule Wiki
Jump to: navigation, search

Prerequisites

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

Hardware

  • 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 did choose the below server:

Connectivity

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 setup 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 would be available by browsing the VM's DNS name from your bowers (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 configuring new Inbound security Rules for VM that enables communication to your VM from 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

For adding these ports in Inbound Security rules, you need to:

  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 to be able to browse FlexRule Workbench over 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).

Installation

FlexRule Server Master

You can find the step by step instruction of how you can install FlexRule Server Master in:

When you use the Microsoft Azure VM, the IP addresses you would use on FlexRule Server Configurator needs 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 10.0.1.4 is a private VM IP address.

FlexRule Server Agent

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

When you use the Microsoft Azure VM, default values for configurator will be different. Similar to 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 setup it 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 been used http://10.0.1.4:9000.

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 i.e. Notepad.
  2. change the masterAddress to http://flexruleserver.australiaeast.cloudapp.azure.com:9010
Bulbgraph.pngTo be able to browse the Workbench URL later on over the internet, you 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: 'http://flexruleserver.australiaeast.cloudapp.azure.com:9010',
  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 them. 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 http://flexruleserver.australiaeast.cloudapp.azure.com:9010.
  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