Integrations & Setup
...
Installing Factry Historian fo...
Downloading and Installing Factry Historian server
this guide describes how to download and install the factry historian server binary on a host system it is part of a larger guide with installing factry historian for production use docid\ c1i5q5n3p8rmljj5lvhxe if you are looking to test / evaluate factry historian instead, follow this guide installing factry historian using docker docid\ myrfsdthxlh5xqk06ik m prerequisites access to the factry historian portal, which is granted when purchasing a license download factry historian installation executable login to the factry historian portal and download the factry historian installation executable for your cpu architecture navigate to https //portal factry cloud https //portal factry cloud login with your credentials once logged in, click downloads in the header menu in the downloads panel select a release channel ( stable ) select a product ( factry historian ) select a version select an os/platform ( linux/amd64 ) for an offline installation, click download to download the binary and manually copy it to the host system for installation on a system with internet access, click copy uri to copy the link and download it with e g wget we recommend to also download the metadata file to verify the signature place to executable (and metadata file) on a location where you have write access e g your home folder verify signature download factry's public key from our portal wget https //portal factry cloud/download/products pem then verify the binary against the provided signature, replacing vx x x with the correct version openssl dgst sha256 \\ verify products pem \\ signature <(sed n 's/ "signature" "\\( \\)" /\1/p' factry historian server vx x x meta \\ \| sed 's/\\\n/\n/g' \\ \| base64 d) \\ factry historian server vx x x if the output is verified ok , then proceed with the next steps if not, retry downloading the binary / signature file installing factry historian replace the factry historian server vx x x linux x64 filename with the filename of your executable perform the command(s) in the cli sudo chmod a+x factry historian server vx x x linux x64 sudo /factry historian server vx x x linux x64 install the factry historian installation prompts you for a few questions (leave empty and press enter to use the default value) the postgresql admin username and password (created when installing postgresql) the postgresql database name to create (use default factry historian is recommended) the postgresql host , port and ssl mode to connect to a valid jwt secret or leave empty to generate one verify if factry historian is running sudo systemctl status factry historian server defaults factry historian has the following defaults default systemd service file /etc/systemd/system/factry historian server service default environment file /etc/systemd/system/environments/factry historian server default user factry system user please keep the environment file is only readable by the file owner, as it contains usernames, passwords and secrets configuration the factry historian server can be configured using environment variables if left empty, the server will use 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 postgresql host 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 db ssl mode disable ssl mode to use, one of ‘disable’, ‘require’, ‘verify ca’, ‘verify full’ 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 time series database client buffer log level info the log level of the historian grpc max message size 64mb the maximum message size for grpc messages