Posted on

License Properties

License Code

This string is unique for the system since the last time a License Key (see below) has been saved.

Copy Code

Use this button to copy the contents of the License Code to send to OAS Support to receive an updated  License Key for manual activation.

License Key

This is the unique string for the local system to save to the Licensing to enable features of the software. The License Key may be just a short term extension to the demonstration period or a full activation for the License.

Save Key

Use this button to save the License Key to the local or remote system. A verification will be performed on the License Key to insure that the License Key is proper for the License Code. Once the License Key is properly saved the License Code will change to prevent unauthorized duplication of licenses.

Update Maintenance Button

Use this button to update the expiration date for the software maintenance.  If you wish to update your maintenance expiration without an Internet connection use the Copy Code button and email the License Code to support at openautomationsoftware.com.

Electronic Activation Button

Use this button to activate a license with the Serial Number that was provided with the order when you have an Internet connection is available.

Manual Activation Button

Use this button to copy the License Code to a form to send to License Code to support at openautomationsoftware.com.  Include the Serial Number that was provided with the order.  Alternatively you can use the Manual License Key Generation Tool here.

Move – Kill License

Use this button to delete a License to show a Kill Code to be given to Open Automation Software to validate that a License has been removed from the local system. Use this button only to remove a valid License and to verify with OAS that the License has been removed.

Posted on

Update Software Version

You can update your version of Open Automation Software to the latest version provided your system is under a current maintenance plan.

Before updating your software save all configurations to files.

Am I eligible for an update?

To check if you can update to the latest version of OAS us the Configure OAS application and select Configure-License and select the OAS Engine to check.

Review the Maintenance Expiration date under the License Key field.

If it is current you can proceed with the update.  If the maintenance is expired click on the UPDATE MAINTENANCE button and check the Maintenance Expiration again.  If expired copy the License Code found under Configure-License and email to support@oasiot.com to receive an updated License Key.

Once the maintenance is up to date you can proceed with either Automated Update or Manual Update.

Automated Update

The automated update process has the advantage of remote system update without the need to login to the remote operating system.  The update process is available for local and remote Windows systems and remote Linux systems.

The downtime will be minimal as the OAS Engine will be left running during the download process.

OAS Configuration App Version

The OAS Configuration.exe file must be version 16.00.0087 or greater in order to access the OAS file server.  If your local OAS version is older than 16.00.0087 use the following special download.

  • Download https://filedownloads.openautomationsoftware.com/config-oas/V16.00.0087/config-oas.zip.
  • Right click on the zip file that you have downloaded and select Properties. Check the Unblock checkbox for security and click Apply.
  • Extract files to any new directory (not OAS installation directory) and run OAS Configuration.exe in Administrator mode.
  • Select-Configure-License and select the local or remote system to update.
  • Select the UPDATE VERSION button and follow the suggested prompts.

Requirements

  • OAS service version 15.00.0014 or greater support automated update.  To check your current version of the OAS Engine select Configure-System Status.
  • OAS Configuration application must be version 16.00.0087 or greater.  If older see special step above for OAS Configuration.
  • The system where the Configure OAS application is running must have an Internet connection.  If updating a remote OAS Engine the remote system does not need an Internet connection.
  • The Configure OAS application must be running in Administrative mode.
  • If the OAS Engine default security has Update OAS Version disabled login is required with a user that has the privilege for updating.

Save all configuration files, the OAS Engine will be stopped in the update process.

Right click on the Configure OAS shortcut and select to Run-As-Administrator.

Select-Configure-License and select the local or remote system to update.

Select the UPDATE VERSION button and follow the suggested prompts.

Note: If you receive the error message Could not access download server from Internet follow the steps above for OAS Configuration App Version.

Do not stop the OAS Engine or Configure application during the update process, the latest version files will be first downloaded before the OAS Engine is automatically stopped.  If updating the local system on Windows the Configure application and other OAS applications will closed automatically so they also can be updated.

If there is a failure during the update process the cause of the error will appear under Configure-System Errors of the Configure OAS application.

Once the update is completed the OAS Engine will automatically be restarted.

Manual Update

To update OAS manually first download the latest version of OAS.

Windows

Save all configuration files, the OAS Engine will be stopped in the update process.

Use Add / Remove Programs to uninstall Open Automation Software.

Run the downloaded setup.exe file.

Start the OAS Services when prompted at the finish of installation.

Linux or Win-Core

Stop the OASEngine app. Extract the contents from oas-linux.zip or oas-win.zip and copy the contents over the existing deployment directory.  Leave the ConfigFile subdirectory and its contents.

Start the OASEngine app.

Posted on

Move Software License

Step 1

OASStart Configure OAS application from the program group Open Automation Software on the system where the license currently resides (old computer).

Note: Each OAS Serial Number license is associated with the computer it is activated on.  If your system crashes (hard drive failure or other reason) do not throw away the computer.  Call or email OAS at support@oasiot.com to recover your license if the Serial Number maintenance is current.

Step 2

Select Configure-License.

Configure License

Step 3

Select the Local OAS Service by selecting the Select button next to the Network Node drop down.

Network Node

Note: The Configure application can be used to connect to remote systems using the network node name or IP address of the remote node the OAS Service is running on. Simply enter the IP Address or network node name of the remote OAS Service you wish to connect to and click on the Select key.

Note: When selecting a service if you receive a warning dialog that the service cannot be retrieved make sure the OAS Service, OAS Data Service, and OAS Database Service are started as described in Start Service.

Service Error

Step 4

Verify that the Maintenance Expiration is current. If it is out of date please copy the License Code from the License Code field and email it to support@oasiot.com.
Do not proceed further unless the maintenance is current.

Record the License Code from the License Code field.

Step 5

Select the Move License button and record the Kill Code provided.

Step 6

OASStart Configure OAS application from the program group Open Automation Software on the new system where the license will be moved to (new computer).

Step 7

Select Configure-License.

Configure License

Step 8

Select the Local OAS Service by selecting the Select button next to the Network Node drop down.

Network Node

Note: The Configure application can be used to connect to remote systems using the network node name or IP address of the remote node the OAS Service is running on.  Simply enter the IP Address or network node name of the remote OAS Service you wish to connect to and click on the Select key.

Note: When selecting a service if you receive a warning dialog that the service cannot be retrieved make sure the OAS Service, OAS Data Service, and OAS Database Service are started as described in Start Service.

Service Error

Step 9

Record the License Code from the License Code field.

Step 10

E-mail the License Code and Kill Code of the old system, the License Code of the new system to support@oasiot.com along with the Serial Number that was provided with your order.

Step 11

When the License Key is received enter the Key into the License Key field on the new system and select the Save Key button.

Posted on

Activate License with License Code Manually

Step 1

OAS

Start Configure OAS application from the program group Open Automation Software.

Step 2

Select Configure-License.

Configure License

Step 3

Select the Local OAS Service by selecting the Select button next to the Network Node drop down.

Network Node

Note: The Configure application can be used to connect to remote systems using the network node name or IP address of the remote node the OAS Service is running on.  Simply enter the IP Address or network node name of the remote OAS Service you wish to connect to and click on the Select key.

Note: When selecting a service if you receive a warning dialog that the service cannot be retrieved make sure the OAS Service, OAS Data Service, and OAS Database Service are started as described in Start Service.

Service Error

Step 4

Use the Manual License Key Generation Tool to generate a License Key.

You can use this tool for the following tasks.
  • Generate a Demo License
  • Generate a Production License with a Serial Number
  • Update existing Product License Maintenance
  • Update existing Product License number of Tags available
  • Update existing Product License features

Step 5

When the License Key is generated enter the Key into the License Key field and select the Save Key button.

Step 6

Record the License Key for future reference in case the system hard drive has to be reloaded.

Posted on

Activate License with Serial Number via Internet

Step 1

OASStart Configure OAS application from the program group Open Automation Software.

Step 2

Select Configure-License.

Configure License

Step 3

Select the Local OAS Service by selecting the Select button next to the Network Node drop down.

Network Node

Note: The Configure application can be used to connect to remote systems using the network node name or IP address of the remote node the OAS Service is running on.  Simply enter the IP Address or network node name of the remote OAS Service you wish to connect to and click on the Select key.

Note: When selecting a service if you receive a warning dialog that the service cannot be retrieved make sure the OAS Service, OAS Data Service, and OAS Database Service are started as described in Start Service.

Service Error

Step 4

Select button labeled Electronic Activate License with Serial Number via Internet Connection.

License Buttons

Step 5

Enter Serial Number provided with order to activate the license.

Note: If a firewall is blocking your computer from the license server, or any other issue prevents you from activating your license electronically, try the Manual License Key Generation Tool here.

You can use this tool for the following tasks.
  • Generate a Demo License
  • Generate a Production License with a Serial Number
  • Update existing Product License Maintenance
  • Update existing Product License number of Tags available
  • Update existing Product License features
Posted on

License Activation

The Open Automation Software license can be activated via a Serial Number with an Internet connection or manually activated by providing the License Code to Open Automation Software to receive the License Key manually.

View Activate License with Serial Number via Internet when an Internet connection is available.

View Activate License with License Code Manually when an Internet connection is not available.

If a license needs to be moved from one computer to another follow the steps listed under Move Software License.

Posted on

Options

CONTENTS
Overview - Options
Modify Options
Options Properties
Options Programmatic Interface

Overview – Options

To open a new window for Options modification, select Configure-Options or Alt-C-O.

Select a Windows Service to modify, the node with the green arrow is the current Service being modified.  Refer to Selecting Service for more information on selecting an OAS Service.

Modify Options

After making the desired changes to the OAS Service select Apply Changes in the lower right corner to make activate the changes.

Options Properties

Load Default Tag Configuration On Service Start

To automatically load a Tag configuration when the OAS Service starts enable this option and browse for the desired Tag configuration. It is recommended to only browse for the default Tag configuration file on the local system as the path is relative to the OAS Service not the system with the Configure OAS application.

Load Default Data Logging Configuration On Service Start

To automatically load a Data Logging configuration when the OAS Service starts enable this option and browse for the desired Data Logging configuration.  It is recommended to only browse for the default Data Logging configuration file on the local system as the path is relative to the OAS Service not the system with the Configure OAS application.

Load Default Alarm Logging Configuration On Service Start

To automatically load an Alarm Logging configuration when the OAS Service starts enable this option and browse for the desired Alarm Logging configuration.  It is recommended to only browse for the default Alarm Logging configuration file on the local system as the path is relative to the OAS Service not the system with the Configure OAS application.

Load Default Report Configuration On Service Start

To automatically load a Report configuration when the OAS Service starts enable this option and browse for the desired Report configuration. It is recommended to only browse for the default Report configuration file on the local system as the path is relative to the OAS Service not the system with the Configure OAS application.

Load Default Recipe Configuration On Service Start

To automatically load a Recipe configuration when the OAS Service starts enable this option and browse for the desired Recipe configuration. It is recommended to only browse for the default Recipe configuration file on the local system as the path is relative to the OAS Service not the system with the Configure OAS application.

Log Errors

Log all failures to a specified text file. The file will have appended to the file name the year, month, day, and hour to easily sort error logs at the time they occurred.  Specify the file path to create the error logs relative to the OAS Service application. The default will be the Log directory in the installation directory of Open Automation Software.

No error file will be created if there are no errors.

Log Transactions

Log all transactions to a specified text file. The file will have appended to the file name the year, month, day, and hour to easily sort error logs at the time they occurred.  Specify the file path to create the transaction logs relative to the OAS Service application. The default will be the Log directory in the installation directory of Open Automation Software.

Transaction logs should only be used for troubleshooting to find the source of a problem along with technical support for an OAS service center. Because the information logged is extensive it is not recommended to leave this enable for long periods as the text files will consume a large amount of disk space.

Auto Runtime On Service Start

To automatically have the OAS Service start in Runtime mode when the service starts enable this option.

OPC Server Watchdog Rate

The number of Seconds the OAS Service will expect data from each OPC Server.  If the OPC Server does not have a data change within this period the OAS Service will disconnect from the OPC Server and reconnect to try and re-establish the connection.  Set this value to 0 to disable the OPC Server Watchdog feature.

Use TimeStamp from OPC Servers

Enable this property to have all trend, alarm, and data logging timestamps to come from the OPC Servers instead of the local CPU clock.  The default of the property is True.

Options Programmatic Interface

Use the OPC Systems component in your Visual Studio application to programmatically modify options. Refer to the FormConfigureOptions Form in the WinForm Example Code example for an example and how to modify options.

Refer to the Programmatic Access Options|topic=Programmatic Access Options section in the Programmatic Interface – .NET Programmatic Configuration topic for all of the method syntax.

Posted on

OAS Configuration Manager – Menu

Menu 1

  • File-Exit: Exits application.
  • Configure – Tag: Opens a new window for Tag configuration.
  • Configure – Drivers: Opens a new window for Driver Interface configuration.
  • Configure – Data Logging: Opens a new window for modifying data logging.
  • Configure – Alarm Logging: Opens a new window for modifying alarm logging.
  • Configure – Alarm Notification: Opens a new window for modifying alarm notification.
  • Configure – Reports: Opens a new window for modifying report executions.
  • Configure – Recipes: Opens a new window for modifying recipe executions.
  • Configure – Excel: Launches Excel formula wizard.
  • Configure – UDP Broadcast: Opens a new window for modifying one way network transmission.
  • Configure – UDP Receive: Opens a new window for modifying one way network receiving client.
  • Configure – Security: Opens a new window for modifying security configuration.
  • Configure – Users: Opens a new window for modifying security users.
  • Configure – Options: Opens a new window for modifying startup and execution options of a Service.
  • Configure – License: Opens a new window for modifying the license of the local system.
  • Window: Select an existing window already opened.
  • Language: Select desired language for configure application.
  • Help – Open Automation Software: View this help file.
  • Help – Training Videos: View on-line training videos.
  • Help – Training Guide: View Quick Start Example section in this help file.
  • Help – Versions: View current installed versions and check on-line what recent changes have been made to Open Automation Software product features.

 

Posted on

Runtime Control

The Service must be in Runtime mode in order to process values for trending, alarming, data logging, recipe execution, report generation, data transfer, and communications.  You can Start and Stop Runtime from any of the Service configuration windows.

To Start Runtime select the Start Runtime Button in any Service modification window of the OAS Configuration application or from the OAS Service Control application.

Start Runtime

To Stop Runtime select the Stop Runtime Button in any Service modification window of the OAS Configuration application or from the OAS Service Control application.

Stop Runtime

You can make add, delete or make modifications to all configurations while the Service is in Runtime mode. Tag configurations files can only be loaded when not in Runtime, but Tag configuration files can be saved during Runtime.  All other modifications can be done while in Runtime if desired.

Make certain to save the modifications if you desire the changes to be retentive for the next time the Service is started.

Save Button

Posted on

Selecting Live Data Cloud Service

If one or more Live Data Cloud services are subscribed to the service you are connecting to the Live Data Cloud list will populate with all of the remote Live Data Cloud services that are available to connect to. Use the Select button to the right of the Live Data Cloud list to connect to the Live Data Cloud service for remote configuration.

See Live Data Cloud for more information on how to setup Remote SCADA Hosting to host a remote data source through a standard Internet connection.