Skip to main content

Linux

Pre-requisites#

Before proceeding with the installation of the Java Agent, ensure that your system meets the following requirements:

  1. Operating System:

    • Linux

  2. Hardware:

    • Minimum of 4 GB RAM
    • Minimum of 80 GB hard disk space

  3. Internet Connection:

    • An active internet connection is required for downloading and push the data to facilio cloud.

  4. Network Connection:

    • Ensure that the system is connected to the Building Management System (BMS) network for proper communication.

  5. System Time

    • Ensure that the system time is synchronized with the correct local time zone.

Pre-requisites For OPC Ua#

  • Download Self Singed Certificate : Link

Steps to establish the Connection:#

    A. Create an agent in the Facilio Platform.    B. Install And Run 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 - Agent, 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


  • Extract the downloaded zip file and move those files (facilio.crt, facilio-private.key, facilio.com) to Downloads/Some other folder.

B. Install and Run the Facilio Agent#

Follow the steps listed below to install the Java Agent:

  • Dowload the agent and bash script from here
  • Extract the downloaded zip file and move the agent-v0.1.19.jar to where all the other files were moved previously.
  • Open a terminal window.
  • Navigate to the directory where the facilio-agent.sh script is available.
  • Run the following commands to start the agent:
    • chmod +x facilio-agent.sh
    • run either of the commands sudo ./facilio-agent.sh or sudo ./facilio-agent.sh /path/to/certificate/files

  • Once the above command execution completed, Check agent status using agent-status in the new terminal window.

Agent Status Management Commands: Quick Reference#

a. Agent status:

agent-status

b. Start the agent:

agent-start

c. Restart the agent:

agent-restart

d. Stop the agent:

agent-stop

Firewall configuration (If Needed):#

Outgoing connection to

  • Endpoint : Endpoint can be found in facilio.config file, MQTT Port : 8883

if you configured the firewall and connection couldn't established, then check with following command:
  • Linux: telnet <aws endpoint> 8883
    • response should Connected to <aws endpoint>.

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. (Command to check: java -version)
  • Restart the agent using agent-restart command in the terminal.
  • For BACnetIp, the agent uses port 47808/47809/47810..etc.. 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
    • find the log file here - /root/facilio/logs/agentlog
On This Topic