Getting Started – Web HMI Dashboard

Step 1

To use the Web HMI Dashboard you must first register the Web HMI libraries. This is done with the OAS Service Control Manager with the Web HMI Registration (highlighted below).

Define the exclusive Node Name and Port Number  that is to be supported. The Node Name should be the registered domain name, IP address, or network node name that all clients will connect to from their browsers. It can also be left as localhost.

The Port number is set to 58725 by default, but can be changed to any available port on the server.  You may also select Use SSL if you choose to require an SSL connection for all Web HMI communications, including the Web HMI Dashboard.  If you choose to use SSL, you must select which SSL Certificate to use with the service. SSL requires that a server certificate be present and installed on the server where the OAS Services are installed.

Once you have configured the Web HMI Registration fields using your desired settings, click Register to set the server registration. If your services are running, you will be asked if you would like the services to be stopped, as it is required for the registration to be completed.

Step 2

Open a browser to the Web HMI Dashboard at the following address:


For example, if you are on the same machine as the OAS Service installation, you are not using SSL, and you are using the default port, the URL will be:


Step 3

Once presented with the Web HMI Dashboard login screen, enter in an OAS server credential, or leave blank to use the default server credential and click “Sign In“.

Upon successfully logging in, you will be presented with your personalized Web HMI Dashboard. If the application is in Demo Mode, you will be provided with some demo dashboards and you will see live data flowing into each module.  All modifications to your dashboard will be saved within your login and remembered for your next session.

Additional Configuration Settings

By default, the Web HMI Dashboard will run in Demo Mode which will do the following:

  • All logins no matter the credentials, will be allowed to log into the application and be provided individual dashboard settings
  • New logins will be pre-populated with demo dashboards

To alter any application configurations, locate the Web HMI Dashboard directory located in the installation directory for Open Automation Software. This is typically in C:\Program Files (x86)\Open Automation Software\OPC Systems.NET.  The Dashboard directory is labeled “www“.

Within this directory, look in the “js” directory and locate the file app_config.js. This is a JSON file containing application settings.

oas_url : optional hard-coded URL of the OAS server location. Omit this setting and the application will assume the server:port used to connect to the app
show_login_url : <true | false> determines if the OAS url can be supplied by the user in the login screen to point the application to a specific OAS service
session_timeout : <integer> number of minutes of inactivity before the user session is ended and the login screen is displayed
demo_mode : <true | false> enables or disables demo mode
demo_dashboards : a JSON representation of the demo dashboards pre-populated for new users in demo_mode