Installation

Jump to Section

Before starting the installation, ensure all required dependencies are installed.

Extract Installation

Extract HighByte-Intelligence-Hub-x.x to a location where you have read/write/execute privileges in order run HighByte Intelligence Hub.

Setup Application Data Directory (Recommended)

By default, the application configuration and settings are stored side-by-side with the application code. This can make it more difficult to manage upgrades, so we recommend separating the two. To do this, create a directory for application state. This can be inside the runtime directory, or any other directory accessible to the application.

Assume we created a directory called appData in C:\HighByte-Intelligence-Hub-X.X\appData. Before launching the runtime, find the file runtime\intelligencehub-settings.json.template and rename it to intelligencehub-settings.json. Open this file in a text editor and edit the appData setting as shown. This will place all application data in the appData directory at startup.

json

"settings": {
    "directories" : {
        "appData" : "..\\appData",
        "storeForwardData" : null
    },
}

Note on Windows backslashes must be escaped using \\ syntax.

You can also set the storeForwardData setting as well, which controls where store and forward data is placed on disk. By default, this is stored side-by-side with the application code.

Start Runtime

To launch the runtime in a command shell, open a shell and navigate to the runtime directory. Start the runtime by executing the start-[OS] file associated with your OS (e.g., start-windows.bat, ./start-linux.sh, ./start-macos.sh).

The runtime will begin logging event messages to the console upon startup.

Stop Runtime

To stop the runtime safely, execute the corresponding stop-[OS] script. This will ensure the runtime completes any outstanding work (e.g., persisting configuration updates, storing data for future forwarding, etc.) before shutting down.

Run as Windows Service

When running on Windows it is recommended to run as a service. To install the Intelligence Hub as a service run the runtime\service\install-windows-service.bat script. Note, this feature requires Java to be in the system PATH environment variable. If you are unsure if this was set when you installed Java check out this link: https://www.java.com/en/download/help/path.html.

Once installed, the service can be found in Windows Services Manager under the name HighByte Intelligence Hub Runtime.

Executing the file runtime\service\uninstall-windows-service.bat will stop and uninstall the service.

Setup system.d service on Linux

NOTE: In order to install to the example directory and use systemctl you will need super user permission.

Copy the runtime and configuration directories from HighByte-Intelligence-Hub-x.x to the desired installation directory. This example will use /opt/highbyte.

Once complete, the directory listing should look like:

$ ls /opt/highbyte/
configuration  runtime

Make sure the start and stop scripts have execute permissions: sudo chmod +x /opt/highbyte/runtime/*-linux.sh

Create /etc/systemd/system/highbyte.service. This minimal example service file will automatically start the Intelligence Hub during system boot-up.

To install the service run: sudo systemctl enable highbyte.service

To start the service run: sudo systemctl start highbyte.service

To verify the service started successfully run: sudo systemctl status highbyte.service

Installing Java