Skip to main content

Facilio Standalone Agent Installation

Pre-requisites#

  • A system with operating system Windows 8 or above, Linux ( Ubuntu ) and Mac ( 10 and above ).
  • A minimum of 4 GB RAM and 80 GB hard disk space.
  • Oracle JDK 8 or Open JDK should be available or installed in the system.
  • Internet Connection
  • System should be connected to BMS Network.

Steps to establish the Connection:#

    A. Create an agent in the Facilio Platform.    B. Install the Facilio Agent in the system.    C. Start the Facilio Agent.

A. Create an Agent in the facilio platform#

Step 1 - Navigate To Iot Page#

  • Login to the account using the credentials given to you.
  • Homepage > Go to settings >> Click on Portals >>> Click on Work Centers >>>> Click on Agent.

HomePage

Settings

Iot


Step 2 - Add Agent#

Below is the Agent portal overview which can show up the number agents that are active, controllers that are associated with the network, points to capture the readings,etc.. To create an agent, follow the below steps.

  • Click on Add Agent.

Add agent


  • Select the Agent Type as Facilio, Type in Agent Name.
  • Also select the Site name where the agent has to be implemented. Then click on Save.

Add agent


Step 3 - Certificate & Config files#

  • Go to Agents and you will see the list of agents that you have added.
  • Select the Agent that you have added and Download the Certificate, Config file and extract files from the downloaded zip folder.

agent

Download Certificate


  • Create a Folder facilio in user home directory (C:\Users\CurrentUserName\facilio)

Config files


  • Move the Extracted files (1.facilio.config 2.facilio.crt 3.facilio.private.key) to facilio Folder, Created in previous step.

Config files


B. Install the Facilio Agent#

Follow the steps listed below to install the Java Agent:

  • Download and install JDK 8 (Java Development Kit) from this link.

  • Download the Facilio agent installer from this link.

  • Double click to open the installer (FacilioAgentInstaller.exe). Accept the agreement and click on Next.


Installer
  • Choose the installation location and click on Next.

Installer
  • Uncheck the option "Create a desktop shortcut" and click on Next.
  • Click Install in the next screen.

Installer
  • Options ‘Run uninstallService.bat’ and ‘Run installService.bat’ should be checked.
  • Next, click on Finish.

Installer
  • Close all the consoles opened during installation.

C. Starting the Agent#

Now that the Java Agent is installed in the system, you will need to start the agent to make it online.

  • Open Task Manager and click on the Services tab.

Config files


  • Search for Facilio Agent and then right-click on it and then click on Start. Facilio Agent will take few minutes to come online.

Config files


  • Once it's online, Go to the Agent Portal, now the Facilio Agent will be online. The Agent is ready to communicate with the networks.

Config files

Firewall configuration (If Needed):#

Outgoing connection to

  • Endpoint : Endpoint can be found in facilio.config file, MQTT Port : 8883
  • Endpoint : app.facilio.com, HTTPS Port : 443,80

if you configured the firewall and connection couldn't established, then check with following command:
  • Windows (PowerShell): Test-NetConnection -ComputerName <aws endpoint> -Port 8883
    • In respone TcpTestSucceeded should be true, if not check with firewall configurations.
  • Linux: telnet <aws endpoint> 8883

Troubleshooting Tips#

Tips

If the agent is not running, here are a few troubleshooting tips that you can try –

  • Check whether the Java version, it should be JDK 8.
  • If the service is installed but the Facilio agent is not starting you can open Task Manager, go to Services tab and stop the service. Next, go to the Processes tab and stop any Facilio process that is running. Lastly, go to the Details tab and stop any java.exe that is running. Finally, you can restart the service.
  • If the agent is up and running but is not pushing any data to the cloud, please check whether the certificate and the config files (facilio.config, facilio.crt and facilio-private.key) are placed in the right location.
  • If Controllers / Points are not discovering, try to discover them in the BDT tool. Make sure facilio agent is not running.
  • For BACnetIp, the agent uses port 47808. So the port must not be occupied by any other processes in the system.
  • If the none of the above is working, please mail the below-mentioned log files to this email id – support@facilio.com
    • C:\Users\<(current-user)>\facilio\logs\agentlog
    • C:\Program Files (x86)\Facilio\Logs\servicelog