Installation

Download the latest version of the historian here

Debian

sudo apt install ./factry-historian-server_vx.x.x_linux-x64.deb

Redhat / Centos

Install postgresql-server

sudo yum install postgresql-server postgresql-contrib
sudo yum localinstall ./factry-historian-server_vx.x.x_linux-x64.rpm

Run post-install script

sudo /opt/factry/scripts/setup_postgres.sh

Default service file location/name:

/lib/systemd/system/factry-historian-server.service

Default environment file location/name:

/etc/systemd/system/environments/factry-historian-server

Default system user:

factry-historian

Configuration

The historian server can be configured using environment variables. If left empty the historian server will used the listed default values.

All variables starting with ‘DB_’ refer to the main postgresql configuration database.

Name Default value Description
DB_HOST 127.0.0.1 Host to connect to for the database
DB_NAME factry_historian Name of the database to connect to
DB_USER_NAME factry User to connect to the database with
DB_PASSWORD Password for the user
DB_PORT 5432 Port number to connect to at the server host
PORT 8000 Port number for the REST API
GRPC_PORT 8001 Port number for GRPC collector communication
JWT_SECRET JWT token used to sign the collector API token. Which is used to authenticate in the REST/GRPC communication. The JWT is also used to encrypt certain settings
BUFFER_PATH /var/opt/factry/buffer Path for the timeseries database client buffer
LOG_LEVEL info The log level of the historian
GRPC_MAX_MESSAGE_SIZE 64MB The maximum message size for GRPC messages.