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 Support to recover your license if the Serial Number maintenance is current.

Select Configure-License.

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.

Network Node

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.
Do not proceed further unless the maintenance is current.

Record the License Code from the License Code field.

License Code

Select the Move License button.

Move License Button

Record the Kill Code provided.

Step 2

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

Select Configure-License.

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.

Network Node

Record the License Code from the License Code field.

License Code

Step 3

E-mail the License Code and Kill Code of the old system, the License Code of the new system to Support along with the Serial Number that was provided with your order.  Do not restart your system while a new License Key is generated and returned.

Step 4

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

License Key

Verify the status of the license is correct for the maintenance expiration, number of tags, networking, enabled products, and enabled drivers.

If the license is incorrect email the License Code (not License Key) to Support along with the Serial Number provided with your order.

Activate License

Step 1

OAS

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

Select Configure-License.

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.

Network Node

Copy the License Code listed there to use in Step 2 with the License Key Generation Tool.

License Code

Step 2

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

Alternatively, email activation code, and your serial number if you have one, to support@oasiot.com to receive an activation key.

Step 3

When the License Key is generated return to the Configure application and paste the Key into the License Key field and select the Save Key button.

License Key

Verify the status of the license is correct for the maintenance expiration, number of tags, networking, enabled products, and enabled drivers.

If the license is incorrect email the License Code (not License Key) to Support along with the Serial Number provided with your order.

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

License Activation

The Open Automation Software license can be activated with the Serial Number provided with your order and the License Code found under Configure-License of the Configure OAS application with the Manual License Key Generation Tool.

View Activate License for guided steps of obtaining the License Code, generating the License Key, and saving the License Key.

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

Options – Overview

The Options screen can be opened by selecting Options in the Configure menu.

By default the selected Network Node is localhost. You can configure any running OAS Instance using the Configure OAS application by providing the hostname or IP address of the instance and then clicking on the Select button.

Refer to Selecting Service for more information on selecting an OAS instance.

👉 See Options – Reference for a full listing of OAS configuration options.

Modify Options

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

CSV Export and Import

Options can be modified using a Comma Separated Variables file.

Use the Configure OAS application to export options to a CSV file under Configure-Options.

CSV Import and Export

You can modify this file with Microsoft Excel to make changes, save the file, and then close in Excel before performing a CSV Import.

Options Programmatic Interface

OAS instances can be configured programmatically using APIs such as the Dotnet OASConfig assembly using Visual Studio or using the REST API Server Configuration operations.

👉 For more details, see OASConfig documentation 🔗

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.

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

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.

Selecting Service

When accessing any of the configurations you will select the desired network node to modify.  Enter the IP Address, Network Node Name, or Registered Domain Name in the Network Node field and click the Select.  This allows you to modify configurations on remote systems.

Network Node with Live Data Cloud

Use the pull down to select previously selected services.  Use the EDIT button to add additional network nodes to the pull-down list.

If other Live Data Cloud nodes are hosted through selected network node the Live Data Cloud list will populate in the Live Data Cloud pull-down.

If the OAS Engine is not running on the system or the TCP Port is blocked you will see a warning dialog to start the service.

Network Error

If successfully connected to the OAS Engine the status of the service will appear at the top along with configuration buttons to load, save, and modify a configuration.

Runtime Status

FAQs – Windows Services

When do I need to use the OPC Data Fix?
Only when the OPC Server(s) you are connecting to do not run as a Windows Service and cannot be accessed from the SYSTEM account due to DCOM security.
What account are the OAS Services run under?
By default the SYSTEM account, but you can change the Service LogOn using the Service Control Manager.