Installing a collector

the installation of the collector is done by running the install command on the binary the install process will copy the binary to the correct directory and create a service prerequisities permissions in factry historian to manage collectors see privileges docid\ k2nnyecuxqqsiuclmpfkh configured factry historian general settings settings administration rights on the host system where the collector will run 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 factry portal 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 example of a generated collector token click copy to clipboard you will pass this token as a flag with the install command 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 an os/platform 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 you have the collector binary on the host system and a collector token, you an install the collector run the install command from within the directory where the binary is located, using an administrator terminal this 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 it will register in an initial state initial state further configuration is done in the factry historian interface "factry collector binary path" install token "token" 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") configure the collector see collectors, protocols and data formats docid 3fys7rs2fli2rdgv2zv7g to configure your collector, depending on the collector type start the collector once configured, you need to start the collector in factry historian before data can start coming in visit the collectors page and select your collector press the start button the collector should now be running and ready to receive measurements next steps creating a measurement docid\ u5 07ylms2jix9kz m lb importing measurements in bulk docid\ g5wek8z fipxau2ymzirz