📔Installation

The ObX installer streamlines the installation process of various server components within the ObX platform by enabling users to install them with a single click. However, prior to installation, certain hardware and software prerequisites must be met to ensure smooth deployment.

ObX Components

The ObX platform comprises five distinct components, serving as fundamental elements for constructing a comprehensive ObX platform tailored for efficiently executing data collection, historicization, and visualization across various processes. Among these components, four function as server-side components, while one operates as a client-side component.

Component Name
Component Type
Description

ObX Historian

Server

This is where all our datasources are stored, archived and maintained.

ObX WebUI

Server

Web based applications for dashboarding, reports and alerting.

ObX Collector

Server

Provides functionality for collection of data from various sources such as MQTT, modbus and opcua. It has data buffering features.

ObX Sound Alert

Server

Provides functionality of audible alarm when alarm condition is triggered in WebUI.

Excel Addin

Client

An excel addin to easily generated dynamic templated report in excel.

Server components must be installed on a PC or server computer to enable it to provide services or resources to other devices on a network. In contrast, client components do not require installation and typically access the services provided by servers over the network.

Hardware Pre-requisites

Although ObX is capable of functioning on low-end hardware configurations, the following specifications are advised for optimal performance in a production environment. However, for testing purposes, any available hardware specifications can be utilized with ObX.

For testing or production setup, you can also install ObX on a Virtual machine (VMware or VirtualBox)

For production environment

  • Processor: Intel Xeon, i5 or more

  • Memory (RAM): 8GB or more

  • Disk: 100 GB or more SSD/HDD

  • Operation System: Any Windows client or server OS

Software Pre-requisites

The ObX components rely on various communication ports to function correctly. It is essential that these ports remain unobstructed and accessible for the proper operation of the components. Depending on where you deploy the ObX components, ensure that the specified ports are available and unoccupied.

ObX Component
Port
Description

ObX Collector

1881

Port for access the UI of collector

ObX Historian

8086, 8088

Database ports for historian

ObX Historian

5050

API port

ObX WebUI

443, 4545, 80

Web UI ports

ObX-sound

1880

For sound alarm

Installation Type

The choice of installation method for the ObX Platform depends on how you plan to configure it. If you're a system integrator, you should already be aware of the installation type specified in your functional design specification (FDS).

It is advantageous to have a clear understanding of the setup you intend to deploy. Below, you'll find various installation types along with concise descriptions.

Standalone

All ObX's server components are installed on a single computer.

This configuration requires no additional setup after installation. However, due to the presence of the ObX collector alongside the ObX historian, data buffering in the ObX collector will be disabled. Please take this into consideration.

Standalone

Enhanced Standalone

In contrast to the standalone configuration where the ObX collector and ObX historian are co-located, this setup involves installing the ObX collector on a separate server. This arrangement enables data buffering in instances of network interruptions or downtime of the ObX historian, ensuring continuous data capture and storage capability.

Enhanced Standalone

The good thing about this setup is you can also put a firewall in between so you can add some layer of security between the two servers or networks.

And of course, it free-ups computing resources on different machines, rather than installing all components on a single computer.

Enhanced Standalone with Firewall

Dedicated

All server components of ObX are installed on a dedicated computer server.

Dedicated

It gives you the same benefit of Enhanced standalone, but with added layer of security by putting two (2) firewalls. With this setup, giving you more security and highly compliant to Purdue model ISA-95 philosophy.

Dedicated with two(2) Firewall

Step-by-Step

Once you have considered all hardware and software pre-requisites, and installation type you may now install the ObX's Server components.

Installing ObX Historian component
  1. Make sure no other applications are running on the computer.

  2. Right-click on the installer and Run as administrator.

  3. Click next until you see the selection of ObX components to install.

  4. Select the ObX historian component to install on your server.

  5. Accept and check the terms and conditions.

  6. Select the directory where to install the ObX component you have selected on step 2. If ask to create the folder just simply select Yes.

  7. Click Start to install the component and wait for it to finish.

Installing ObX Historian

Installing ObX WebUI Component
  1. Make sure no other applications are running on the computer.

  2. Right-click on the installer and Run as administrator.

  3. Click next until you see the selection of ObX components to install.

  4. Select the ObX WebUI component to install on your server.

  5. Accept and check the terms and condition.

  6. Select the directory where to install the ObX component you have selected on step 2. If ask to create the folder just simply select Yes.

  7. Click Start to install the component and wait for it to finish.

Installing ObX WebUI
Installing ObX Collector Component
  1. Make sure no other applications are running on the computer.

  2. Right-click on the installer and Run as administrator.

  3. Click next until you see the selection of ObX components to install.

  4. Select the ObX Collector component to install on your server.

  5. Accept and check the terms and condition.

  6. Select the directory where to install the ObX component you have selected on step 2. If ask to create the folder just simply select Yes.

  7. Click Start to install the component and wait for it to finish.

Installing ObX Collector

Post installation check

Ensure that all post-installation checks are conducted to verify the absence of any issues following the installation of ObX components.

Check ObX Services

There are multiple services that should be running automatically when we installed the ObX components. Depends on what ObX components did you install, below are the services that we need to check per component installed.

Service Name
Description
Component

obx-db1

Historian service

ObX Historian

obx-node1

Backend service

ObX Historian

obx-ui9

Frontend service

ObX WebUI

obx-rp

Web server

ObX WebUI

obx-collector3

ObX Collector service

ObX Collector

obx-sound

ObX Sound Alarm service

ObX Sound

Using ObX Admin Tool

The ObX administration tool offers various sets of engineering utilities for the convenient management of the ObX platform. It is automatically deployed alongside the ObX historian component during installation.

  1. Go to Desktop and run the ObX Admin Tool by double-clicking it.

  2. On the left side tab, expand the Services and make sure all services related to ObX is up and running.

Using ObX Admin Tool
Using Window Services Tool

If the ObX admin Tool is inaccessible on your server (for instance, if you install the ObX collector or WebUI on a different machine), it will only be present where the ObX historian is installed. Consequently, in such scenarios, you can utilize the native Windows built-in tool instead.

  1. On your keyboard, press CTRL+R, this opens up the run services.

  2. type in the window services.msc and press enter.

  3. This will open the windows service tool, and look for services related to ObX.

  4. Make sure all the services are up and with status running.

Using built-in Window Service Tool

Setting Domain for WebUI Components

The domain configuration within the WebUI components serves as the central access point for all WebUI clients to reach the Dashboards. It is crucial to configure this aspect meticulously to ensure that all associated links, such as those embedded in email alerts, public dashboards, shared dashboards, etc., are accurately aligned with the specifications set for the domain.

All links sent by the WebUI components will be based on the following: https://{your_domain_config}

By default, the domain is set to localhost, this is okay when in test mode, but in production mode, you have to set this to IP or the domain (if it is in Cloud deployment) of the computer hosting the WebUI component.

  1. Open File Explorer and Go to -> WebUI component installation path. Make sure you know where you install the WebUI component. default installation path is C:\ObX\WebUI

  2. Go to folder -> ui9 -> conf , and open the custom.ini file using your preferred text editor.

  3. In the custom.ini file, look for configuration related to domain, it is located under the [server] section.

Server section -> domain
  1. Change the localhost value of domain to either of the following:

    IP address - The ip address of the computer hosting the computer. e.g. (192.168.1.23), make sure that the ip you will input here is the ip accessible to all WebUI clients.

    Domain - If the WebUI component is deployed on cloud where most likely you have specific domain associated to it. e.g. (obxdomain.com)

  2. Click Save once finished and Restart the obx-ui9 component services in the ObX Admin Tool to take effect the changes.

Sample domain configuration using IP Address
Sample domain configuration using domain.

Edit Historian Instance config file

The default configuration of the Historian instance in the config file restricts access to the local machine only, as it assumes that the initial installation is intended for standalone use. However, when the ObX WebUI and ObX Historian are deployed on separate machines, additional configuration is necessary to ensure seamless communication between the ObX Excel add-in and the ObX historian.

  1. Go to the computer where ObX WebUI installed.

  2. From the computer, goto -> installation path folder of the ObX WebUI (default: C:\ObX\WebUI)

  3. From the Folder, Go to -> rp -> conf, and open the nginx.conf file using your preferred text editor.

  4. From the file, look for the config related to upstream db.

 upstream db {
    server 127.0.0.1:8086;
}
  1. From the file, edit the 127.0.0.1:8086 to -> {{IP_address of computer hosting the ObX historian component}}:8086

  2. Then just save the file.

  3. Restart the obx-rp services in the ObX Admin tool to take effect.

Example configuration where ObX historian IP is 172.17.1.16

Last updated