Integrations & Setup
...
Collectors
Installing a collector
the installation of the collector is done by running the install command on the collector binary the install process will copy the binary to the correct directory and create a service on the host system (=server running the collector) requirements permissions in factry historian to manage collectors see docid\ k2nnyecuxqqsiuclmpfkh configured factry historian docid\ jwpo8qzsond29mhglerea settings administration rights on the host system where the collector will run tcp connection from host system to the factry historian server on port 8001 (uses {{grpc}} which includes tls encryption) the connection from the the host system to factry historian is outbound only for security purposes! host sytem {{os}} linux (32 bit, 64 bit or arm architecture) windows ≥ 10 (32 bit or 64 bit architecture) depending on the type of collector, a specific os build architecture may not be available refer to the download section in the https //portal factry cloud for a list of build architectures available for each collector creating a collector in factry historian in factry historian, visit the collectors page and click the + create collector button enter a unique name optionally enter a description optionally choose a default database click submit a success message should appear signifying the collector has been created if something went wrong, an error message will appear generate a token select the collector you have just created press the generate token button after pressing the button a modal will open with the generated collector token click copy to clipboard you will pass this token as a flag with the install command for your information the collector token contains 4 pieces of important information for the collector historian server url historian server rest port historian server grpc port collector uuid collectors are linked to a corresponding collector user in the user overview you can invalidate the generated token creating a new token will also invalidate the old token after 24 hours getting the binary navigate to 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 (collector type) select a version select the os/platform of the host system click download to download the binary manually copy it to the host system (location does not matter) start the binary with the collector token now that the collector binary is on the host system and a collector token is generated, the collector can be installed open a terminal with administrator rights (powershell or cmd) and navigate to the folder where the collector binary is located e g c \users\myuser\documents\factry cd "c \users\myuser\documents\factry" the following command will register the collector as a system service and start the collector using the information in the token, the collector will establish a connection with the factry historian server replace the filename with your collector binary filename replace the token after t with your token (use the surrounding " ) example on windows \factry opcua collector v1 1 4 windows x64 install t "eyjhbgcioijiuzi1niisinr5cci6ikpxvcj9 eyjhdwqioijodhrwoi8vbg9jywxob3n0ojgwmdailcjlehaioji0mzcymdi0mdcsimdycgmtcg9ydci6ijgwmdeilcjpyxqioje2ndg4mdi0mdcsimlzcyi6imzhy3ryes5pbyisinjlc3qtcg9ydci6ijgwmdailcj1dwlkijoinjgxzmzinjqtyje4ny0xmwvjlwjlnwytmdi0mmfjmtgwmdazin0 rqlzfoi7i 793 srie8bgcqam5fxq7lhhkucvcwxnu8" example on linux chmod +x factry opcua collector v1 1 4 linux x64 sudo /factry opcua collector v1 1 4 linux x64 install t "eyjhbgcioijiuzi1niisinr5cci6ikpxvcj9 eyjhdwqioijodhrwoi8vbg9jywxob3n0ojgwmdailcjlehaioji0mzcymdi0mdcsimdycgmtcg9ydci6ijgwmdeilcjpyxqioje2ndg4mdi0mdcsimlzcyi6imzhy3ryes5pbyisinjlc3qtcg9ydci6ijgwmdailcj1dwlkijoinjgxzmzinjqtyje4ny0xmwvjlwjlnwytmdi0mmfjmtgwmdazin0 rqlzfoi7i 793 srie8bgcqam5fxq7lhhkucvcwxnu8" install help usage opc ua collector v1 1 4 install \[flags] flags e, env stringtostring environmental value overrides e g batch size=200 (default \[]) h, help help for install i, installdir string the directory where the collector will be installed (default "/opt/factry") t, token string collector token u, user string the user used to run the service (default "factry system user") w, workdir string the working directory for the collector (default "/var/opt/factry") expected outcome when the collector is successfully installed and connected to factry historian, in the factry historian webpage > collectors , the collector shows an initial state initial state see the docid\ iv4 sd56tdxcqkrkcj4kv section below if this is not the case configure the collector see docid 3fys7rs2fli2rdgv2zv7g to configure your collector, depending on the collector type troubleshooting the collector does not show an initial state in factry historian plausible causes the base url in the factry historian docid\ jwpo8qzsond29mhglerea settings is not the url using which the collector can connect to factry historian this heavily depends on your networking architecture change it, re generate the token for the collector and redo the installation command with the new token the base url of factry historian is correct, but it can not be reached from the host system of the collector verify any network rules set to make this connection possible with your it department can't spot your error? contact factry support

