Set Up the OSI Agent

review the following information for setting up and configuring the osi agent driver before you begin install an osi server and osi agent on a windows system follow up with your account executive to download the osi agent and required files make sure the osi client dll is on the same system running the osi agent open port 443 and 4777 between windows and belden horizon data operations otherwise, the osi agent won't work configure windows authentication so that the osi pi server can work docid\ okxgbkzkfqb773 m6k7kj in belden horizon data operations step 1 install osi agent install the zip file with the osi agent and all required files on a windows system step 2 run and configure the dh historian agent to run and configure the dh historian agent run the dh historian agent exe file a windows service starts and connects to the osi agent so that it can collect data from the osi agent review the introductory screen and click next the appearance configuration settings displays configure the appearance settings click save , and then next the server settings section displays in the pi server section, click the load pi servers button you will be able to view all pi servers properly set up with dcom rules on the correct network open the drop down list for server to view accessible servers and select the appropriate server select an authentication method pi user this is local user to define the dcom rules for this user, open the pi system management tool and navigate to security > pi users and groups enter the correct username and password windows the pi server needs to be properly configured to use windows authentication once the pi server is configured, click test connection verify the status is success or fail in the operation mode section, select how data will be collected both modes allow the first value on startup to get published to nats events based the recommended selection whenever the value changes on the pi server, you will receive a nats message polling define the polling interval in seconds the timestamp for the message is when the data was published to the dh historian agent, not when belden horizon data operations collects the data in the logs section, select how to view logs the logs will records failures with details events log to view logs, start the osi agent log file folder define a local folder to store log files click save , and then next the site settings section displays configure the site settings host enter the ip address for the belden horizon data operations instance port enter 4777 user enter the username to connect to the server in devicehub password enter the password to connect to the server in devicehub api token copy and paste the belden horizon data operations api token if you haven't yet done so, docid\ okxgbkzkfqb773 m6k7kj the token is used to create the device and tags device name enter the name for the device that will be created in belden horizon data operations devicehub device id this field is optional the id is automatically generated click test connection to ensure the settings are configured correctly click create device if a device is successfully created, a created a new device message will display the osi agent driver device will be created in the belden horizon data operations devicehub pane click save , and then next the tags section displays search for tags you want to add you can search by using regular expression the character displays all tags on the server the server tags column displays tags on the osi agent the agent tags column displays tags that will be sent to belden horizon data operationse and mapped to the osi agent driver device in devicehub after selecting tags to be sent to belden horizon data operations, click update tags the tags will be added to the osi driver in belden horizon data operations you can view them in devicehub > tags if needed, click save this saves the settings in the devicehubagentmain ui execonfig file, which is a password encrypted text file the next time you start the historian agent, the saved settings from the configuration file will load in the folder that installed the dh historian agent, navigate to the pi agent sub folder double click the devicehubagentsvc exe file this will enable the connection to the server follow the command to install the service once installed and the task management is properly set up to run the service when logged off, data will still be sent to the driver when users are logged out log in to belden horizon data operations and navigate to devicehub > devices you should see a connected status for the osi agent device osi agent driver settings in belden horizon data operations if you review or edit the settings of the osi agent device, refer to the following parameters parameter value type osi driver osi agent network port the port configured in the dh historian agent the default value is 4777 interface you have the option of selecting the interface for accepting client connections the default value is 0 0 0 0, which means using all network interfaces for accepting connections from clients user the username configured in the dh historian agent password the password configured in the dh historian agent tag parameters in belden horizon data operations if you docid\ csrurtoacnmmamyn uc5o in belden horizon data operations, select the r register name, and then refer to the following supported data types and tag parameters uint32 uint64 float64 string byte\[] float32\[] bool byte float64\[] string\[] uint16 int64 uint16\[] sbyte int16 int16\[] int32\[] int64\[] uint64\[] float32 bool\[] uint32\[] int32 sbyte\[] tag parameters name select r value type select a value type tag name enter a name for the tag description (optional) enter a description for the tag tag formula enter a formula for the tag to process the generated data two variables are permitted value (current tag value) and timestamp (current tag unix time in milliseconds) the following math functions are available sin cos sqrt tan power log exp only publish on change of value select the checkbox to customize nats messages to be published only when the value parameter changes from a previous value to a new one change of value only applies to boolean, numeric (such as int or float), and simple string data types it does not apply to complex types, such as json or array poll once topics will not be affected by change of value settings these topics will still only see a single message meta data metadata summarizes basic information about data this feature allows you to define key value pair data for the device output payload later on it can then be used to find, use, and reuse particular instances of data