OAS File Locations

Following is where you can find the locations of the Open Automation Software options, license, and other default files.

Config Files Folder

The Config Files Folder is a specific folder in the operating where the OAS options, license, custom objects files are located.

Linux operating system there is a ConfigFiles sub-directory located in the directory you have deployed the OAS Engine.

Note: If moving the OAS Engine folder in Linux make sure all files in the ConfigFiles sub-directory are moved with the OAS Engine.

Windows operating system this is C:\ProgramData\OpenAutomationSoftware\ConfigFiles\

Note: ProgramData is by default a hidden directory in Windows and you can use Windows Explorer to show hidden folders.

To view ProgramData follow these steps.

  • open File Explorer options from Control Panel
  • Then to View Tab.
  • Uncheck “Hide protected Operating system files” and click on “Show hidden files and folders”
  • Press Yes and then OK.

 

OAS.Options

The OAS.Options file contains all settings defined under Configure-Options of the Configure OAS application.

OAS.License

The OAS.License file will be updated with an activation with the OAS Serial Number to enable product features and the number of tags in the license.

OAS.GUID

The OAS.GUID file will be generated the first time the OAS Engine starts on a new operating system.  This contains a unique identifier for store and forward functionality after a system restart.

OAS.CustomObjects

The OAS.CustomObjects file is generated any time a custom object is programmatically assigned using the OASConfig or OPCSystems component.  This is also the file that will persist all user changes for the Web HMI Dashboard.


OAS Options

All options can be set using the Configure OAS application with Configure-Options or programmatically with the OASConfig .NET component,  OPCSystems .NET component, or REST API for OAS.  All options are persisted in the OAS.Options file in the ConfigFiles sub-directory.

Default Configuration Files

Use the Configure OAS application with Configure-Options-Default Files to specify the default configuration files to load when the operating system restarts.  The location of all configuration files will be in the ConfigFiles sub-directory. These settings are stored with the OAS.Options file.

System Logging

Use the Configure OAS application with Configure-Options-System Logging to specify the file path of the OAS System Errors, Communication Errors, and Transaction Logs. These settings are stored with the OAS.Options file.

Store and Forward Folder

Use the Configure OAS application with Configure-Options-Data Buffer to specify the folder to use for data logging and alarm logging store and forward feature. This setting is stored with the OAS.Options file.

Retain Values on System Restart

Use the Configure OAS application with Configure-Options-Retain Values to specify the file path to retain Values and Alarm Limit changes, Time On and Counts, Realtime Trending, and Realtime Alarms. These settings are stored with the OAS.Options file.

File Data Source

The ConfigFiles subdirectory is the location for files when Tags are set to a Data Source of File-Text, Binary, or XML.


OPC UA Trusted Certificates

If the OPC UA Server you are connecting to has security restriction using Certificates you can move the rejected certificates to the trusted certificates under following paths.

Linux operating system there will be a pki sub-directory created under the directory where the OAS Engine is located.

Windows operating system this is C:\ProgramData\OpenAutomationSoftware\pki\

C:\ProgramData\OpenAutomationSoftware\pki\rejected\certs
C:\ProgramData\OpenAutomationSoftware\pki\trusted\certs

The OAS OPC Server third-party OPC UA client certificates location is pki-server sub-directory.

Linux operating system there will be a pki-server sub-directory created under the directory where the OAS Engine is located.

Windows operating system this is C:\ProgramData\OpenAutomationSoftware\pki-server\

C:\ProgramData\OpenAutomationSoftware\pki-server\rejected\certs
C:\ProgramData\OpenAutomationSoftware\pki-server\trusted\certs