Last revision: 4/7/2020
This document contains important information about AVEVA™ System Platform 2020, formerly Wonderware. This version of System Platform includes a number of security enhancements and new features for the component products of System Platform.
Important: Support for 32-bit operating systems and 32-bit SQL Server versions is discontinued in this release of System Platform. System Platform 2020 is only compatible with 64-bit operating systems and SQL Server versions. If you have a 32-bit version of SQL Server, you must uninstall it before installing System Platform. System Platform will check that an installed SQL version is compatible prior to installation, and will display an error message if the installed SQL Server version is not compatible for any reason (not only for 32-bit versions). For information about moving from 32-bit to 64-bit SQL Server, refer to Issue 1249251 under Install/Uninstall and Galaxy Migration Issues. For general information about SQL Server requirements, see SQL Server Notes.
Program Name |
Version |
AVEVA Application Server 2020 |
20.0.000 |
AVEVA Communication Drivers Pack 2020 |
7.0.0 |
AVEVA Enterprise License Manager |
3.6.00000 |
AVEVA Enterprise License Server |
3.6.00000 |
AVEVA Enterprise Licensing Platform |
3.6.00000 |
AVEVA Historian 2020 |
20.0.000 |
AVEVA Historian Client 2020 |
20.0.000 |
AVEVA InTouch HMI 2020 |
20.0.000 |
AVEVA InTouch Access Anywhere Server 2020 |
20.0.000 |
AVEVA InTouch Access Anywhere Secure Gateway 2020 |
20.0.000 |
InSight Publisher |
4.2.000 |
Platform Common Services 4.4.1 |
4.4.20035.1 |
System Monitor Agent Install Manager 2020 |
1.2.0 |
System Monitor Manager 2020 |
1.2.0 |
Changelog: System Platform 2020
Change Description |
Add support for FLEX (subscription) licensing |
Improve design-time performance for Object Wizards and Symbol Wizards |
Improve propagation performance for changes made to Area objects |
64-bit operating system required for all System Platform components |
64-bit SQL Server required for Application Server, Historian, InTouch HMI, and InTouch OMI |
Improve Galaxy Repository startup speed (aaGR process) |
OI Core, OI Gateway, and OI Sim components are combined into the AVEVA Communication Drivers Pack |
Allow import and use of WinForm controls in InTouch OMI ViewApps |
Add InTouch OMI and InTouch HMI support for AVEVA Connect (cloud portal) |
Add responsive option to InTouch OMI Layout Editor |
Add methods for retrieving lists of named credentials in InTouch OMI apps |
Add support for binding graphic custom properties in an InTouch OMI layout |
Add HideContent method for InTouch OMI graphic and layout scripting |
Add support for InTouch OMI Layout scripting |
Add event scripting for InTouch OMI apps |
Improvements to ContentPresenter app (InTouch OMI) |
Add support for out-of-sequence data via multiple channels to AVEVA Telemetry Server |
Allow OPC-UA clients to see Galaxy run-time data |
Allow externally detected alarms to link to another attribute via a Boolean attribute (Historian improvement) |
Add support for Historian LIKE/NOT LIKE functions in Application Server |
Provide clear messages to allow customers to easily troubleshoot deployment issues |
Security enhancements |
Miscellaneous bug fixes |
Incorporate InTouch HMI and Application Server hot fixes |
Supported System Platform Versions for Product Upgrade
You can upgrade directly to System Platform 2020 from the following versions:
Note that all existing products must be upgraded to the same version.
Supported System Platform Versions for Migration
You can migrate user-created content (for example, .cab files, .aaPKG files, Historian databases, etc.,) to System Platform 2020, as long as the content was created in one of the following product versions:
Server-based Licensing
System Platform 2020 continues to utilize the server-based licensing subsystem introduced in System Platform 2017. This new licensing subsystem provides centralized license management, and replaces the file-based licensing system that was used in prior releases. Licenses must be activated before use.
If you are upgrading from Windows Server 2014 R2 SP1 (with or without patches), you must first install and configure a license server node, and activate the licenses to ensure continuous plant operation. The license server is typically installed on the Galaxy Repository node, but you can use a dedicated license server. See the "License Installation and Activation" section of the System Platform Installation Guide (SP_Install_Guide.pdf), located at the root of the DVD.
Start Menu and Shortcut Changes
Some Start menu folders and some of the System Platform shortcuts they contain have been renamed. Commonly used applications, such as the Change Network Account utility, Configurator, and System Platform Management Console, are now located under the AVEVA Start menu folder. These were under the Wonderware Utilities folder in prior releases.
Old Name |
System Platform 2020 Name |
Type |
Wonderware Utilities |
AVEVA |
Folder |
Wonderware Documentation |
AVEVA Documentation |
Folder |
Wonderware Historian |
AVEVA Historian |
Folder |
Wonderware InTouch |
AVEVA InTouch |
Folder |
Wonderware System Platform |
AVEVA System Platform |
Folder |
Sentinel System Monitor |
AVEVA System Monitor |
Folder |
ArchestrA Service Bus Portal |
Common Services Portal |
Shortcut |
AVEVA Enterprise License Manager |
Enterprise License Manager |
Shortcut |
Sentinel Application |
System Monitor Application |
Shortcut |
Readme Files for Other Products in this Release
To access individual product Readme files, insert the System Platform installation DVD and navigate to the applicable folder under the InstallFiles directory. Review the known and resolved issues contained in each Readme file for the component products updated for this release:
Product |
Location on Installation DVD |
Application Server 2020 |
|
InTouch HMI 2020 |
|
Historian Server 2020 |
|
Historian Client 2020 |
|
InTouch Access Anywhere 2020 |
Affected Systems
This information is applicable to a small subset of highly secured environments, in which operating systems and supporting networks have been configured to enable TLS 1.2 and where TLS 1.0 and 1.1 have been purposefully disabled. In these rare instances, some additional configuration is required to ensure that System Platform will work as expected.
System Platform 2020 includes various measures to strengthen security, including the ability to leverage TLS (transport layer security) 1.2, provided that TLS 1.2 it has been enabled and configured in the host operating system.
In some cases, you may have to enable TLS 1.2 support by applying Microsoft updates and by making several manual edits to the system registry. The tasks of applying all Microsoft updates and editing the system registry must be completed before you install System Platform 2020. These instructions also apply to any other software products that support TLS 1.2. Follow the instructions listed below.
If you are required to enable TLS 1.2 and disable TLS 1.0 and TLS 1.1:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions"=dword:00000001
"SchUseStrongCrypto"=dword:00000001
For important information about this product release, go to the AVEVA Global Customer Support (GCS) website. Information on the GCS website includes product requirements, compatibility, as well as downloads from previous releases. After you log in, you can filter search results by product name and the release/version.
Two important new features, the requirement for 64-bit operating systems and SQL Server versions (where needed) and the Flex licensing option, apply across all System Platform 2020 products.
Additional new product-specific features are outlined below.
64-bit Operating System and SQL Server Now Required
With the release of System Platform 2020, a 64-bit operating system and SQL Server version are now required for all System Platform core products: Application Server, InTouch OMI, InTouch HMI, and the Historian. Running in a 64-bit environment provides a common environment for all products, and ensure that you get the best performance from your System Platform installation. For information about moving from 32-bit to 64-bit SQL Server, refer to Issue 1249251 under Install/Uninstall and Galaxy Migration Issues.
Flex Licensing Option
You can now choose between a perpetual license model and the new Flex-licensing subscription option for Application Server. Flex licensing lets you easily acquire and assign licenses to platforms, much more easily and affordably than what was possible with legacy perpetual licensing. Flex licenses are based on AppEngine assignments, rather than having to calculate I/O counts and other system parameters to determine final licensing costs. Other benefits include better cash flow management and a simplified business process.
Performance Improvements
A number of enhancements to improve performance have been implemented for this release of System Platform.
Credential Management for InTouch OMI ViewApps
InTouch OMI ViewApps can use security credentials created in Application Server to gain access to third-party data where Windows OS credentials are not recognized, and/or to provide a method to automatically load a particular data set for specified users. Credential Management is described under "Security" in both the Application Server User Guide and the System Platform 2020 Help.
Support for Additional .NET Controls InTouch OMI ViewApps
InTouch OMI now lets you import, configure, and use .NET WinForm controls in a ViewApp (.NET WPF controls were already supported). See "Importing ArchestrA Apps" in the System Platform 2020 Help for more information.
Responsive Layouts for InTouch OMI ViewApps
The Layout Editor has a new option for creating responsive layouts. This allows the ViewApp to dynamically move and resize content in response to the screen size on which it is being viewed. See "About Responsive Layouts" in the System Platform 2020 Help for more information.
Script Support for InTouch OMI Layouts
Using the same foundation as scripting for Industrial Graphics (formerly ArchestrA Graphics), layout scripting lets you customize run time behaviors for layout content as well as the layout container by adding scripts. As part of layout support, graphic custom properties can be overridden within the layout. A new namespace, "MyContent," is available for addressing content within a single ViewApp, in addition to the MyViewApp global namespace. See "Layout Scripts" in the System Platform 2020 Help for more information.
Event Scripting for InTouch OMI Layouts
You can add event-based scripts to InTouch OMI layouts when the layout include apps that expose public properties, for example "MouseDown." See "Add an Event Handler Script" in the System Platform 2020 Help for more information.
HideContent() Scripting Function and API Call
The HideContent() scripting function and API call can be used in conjunction with ShowContent(), which was introduced in System Platform 2017 Update 2. ShowContent() lets you place symbols or layouts into specific panes within an InTouch OMI layout, either through scripting or programmatically, and now HideContent() provides the additional functionality for more complete control of the content you wish to make available to users at run time. See the Application Server Scripting Guide for more information.
InTouch OMI App Enhancements
The MapApp and Content Presenter App have been enhanced with new features and improved functionality. These apps are described in the System Platform 2020 Help.
Browse Application Server Run-Time Data with OPC UA Clients
AVEVA Application Server now includes OPC UA server functionality. This lets you browse the namespace in a deployed galaxy, and connect to, subscribe to, and retrieve galaxy data, without the need for a gateway or other protocol translation mechanism. See "Configuring and Using the OPC UA Server" in the Application Server User Guide for more information.
AVEVA Connect for Sharing Graphics
AVEVA Connect is a cloud-based resource that lets you easily create and share graphics between locations, galaxies, and applications. See "AVEVA Connect" in the Application Server User Guide for more information.
AVEVA Telemetry Server Enhancements
The Telemetry Server now supports handling data that arrives out-of-sequence via multiple channels. See "Telemetry Server Data References" in the Application Server User Guide for more information.
Visualize Externally-Detected Alarms
Alarm conditions that have been detected within a PLC can now be visualized in, for example, the Historical Trend App or the Alarm App. To accomplish this, the ability to configure a Boolean attribute within the Object Editor as an alarm input for a State Alarm has been added. This allows the trend tools to properly visualize alarms that have been detected externally. See "Using the State Alarm Feature" in the Application Server User Guide for more information.
InTouch HMI 2020 includes a number of new features, hot fixes, and provides support for the latest versions of Microsoft products. Refer to the GCS Technology Matrix for the list of supported Microsoft products. The following section summarizes the major features introduced in this release.
64-bit Operating System and SQL Server Now Required
With the release of System Platform 2020, a 64-bit operating system and SQL Server version are now required for all System Platform core products: Application Server, InTouch OMI, InTouch HMI, and the Historian. Running in a 64-bit environment provides a common environment for all products, and ensure that you get the best performance from your System Platform installation.
Flex Licensing Option
You can now choose between a perpetual license model and new subscription option for InTouch HMI. Subscription (Flex) licensing lets you easily acquire licenses, much more easily and affordably than what was possible with legacy perpetual licensing. For more information, see the Application Management and Extension Guide.
New and Improved InTouch HMI Application Manager
The new InTouch HMI Application Manager presents with a modern user interface with simplified workflow tasks and easier access to features.
Integration with AVEVA Connect
You can upload, download and manage Industrial Graphics in AVEVA Connect via the Graphic Toolbox.
HTML5 Widget
In this release we have introduced the framework of using HTML5 widgets within InTouch HMI. The Carousel widget from the graphic toolbox will allow you to configure and view a HTML5 widget in WindowViewer and Web Client.
Standalone Applications with Support for Industrial Graphics
The new standalone application now supports Industrial Graphics.
Other Major InTouch HMI Features
Web Client
There are many improvements to the Web Client:
Web Client now available as a Mobile App
The Web Client interface is now available as a Mobile App. For more information see the Viewing Application Graphics in a Web Browser guide.
Using the Historical Trend Control from the Drawing toolbar you can configure the IndustrialSQL Server History Provider (Historian Server), to visualize historical trend data. This functionality requires the storage of database credentials in local files. To prevent unauthorized access to Historian and other SQL databases, we recommend using the ArchestrA Trend Client, with a Windows Integrated or Windows Account authentication mode.
Multi-Tier Replication Support
The Historian supports multi-tier replication. Data originating at tier 1 can be replicated to tier 2, then again to tier 3, and so on. Replication from tier 1 to tier two can be simple or summary replication. Replication beyond tier 2 is simple replication.
Support for AVEVA Flex Licensing
Enhanced Excel add-in
Support for tag selection using search, tag metadata in headings, wide/narrow output formatting, flexible column selection, and native formats for numbers/dates.
AVEVA Historian Client Web (previously known as Historian Insight) supports white labeling for OEMs
Trend automatically sets scale precision
Added auto precision option (enabled by default) to tag trend options. When enabled, the number of decimal places is set automatically based on the value range.
Trend XY plot "start/end" marker changes
Added options to show end markers only, show start markers only, not show any markers or time labels, and to change start/end marker sizes.
Dashboards can be accessed by URL, so they can be shared
Support for AVEVA Flex Licensing
Web Help - Browser-based User Assistance
Web help components have been delivered in this release. Web help opens in the default browser on your local computer. Help displayed in a browser allows more dynamic and searchable user assistance including standard web browser navigation and tutorial videos.
Typically, help content is installed on your local machine as part of the documentation library, and displays in your browser without requiring an Internet connection. To open the help, use one of the following methods (depending on the editor/UI you are using):
C:\Program Files (x86)\ArchestrA\Framework\Docs\1033\NGX\index.htm
Browser Requirements and Recommendations
Internet Explorer is recommended. You can also view web help Firefox. If you use Firefox, you may need to install and use an IE rendering extension (for example, IE Tab) to ensure that video content is shown.
Browser Permissions for Displaying Web Help
Each browser and Windows operating system combination has its own security permissions. Using Internet Explorer (version 8, 10, or 11) as an example, you may see a dialog requesting you to "Allow blocked content" each time you invoke the web help. This dialog is triggered by the presence in the help system of JavaScript components that control internal navigation and topic display elements such as pop-up or in-place-expanding display blocks that contain text and graphical images. The text and image content is itself non-active.
You can accept each occurrence of this dialog, or you can set the following option in Internet Explorer, depending on your IT security requirements: In Internet Options, click the Advanced tab, then navigate to the Security section. Enable the "Allow active content to run in files on My Computer." Permissions and security settings will vary depending on your specific browser.
Playback of Tutorial Videos
The web help may contain a number of brief tutorial videos. To play these videos, you must have Microsoft Media Player installed on your local machine. In Windows Server operating systems, you must enable the "Desktop Experience" feature using Server Manager.
Internet Explorer (or IE-rendering in other browsers) may be required for viewing video content. If using a browser other than Internet Explorer without IE rendering enabled, videos may not be visible.
InTouch OMI SDK Web Help
When you install the Application Server IDE, the InTouch OMI SDK is automatically installed, and a link to the InTouch OMI SDK Web Help is added to the Windows start menu. The browser requirements and recommendations that apply to System Platform Web Help also apply to the SDK help.
C:\Program Files (x86)\ArchestrA\Framework\Docs\1033\OMISDKHelp\index.html
Start > AVEVA Documentation > InTouch OMI SDK Help
When you install the Application Server IDE, the InTouch OMI SDK is automatically installed, and a link to the InTouch OMI SDK Web Help is added to the Windows start menu. The browser requirements and recommendations that apply to System Platform Web Help also apply to the SDK help.
C:\Program Files (x86)\ArchestrA\Framework\Docs\1033\OMISDKHelp\index.html
Start > AVEVA Documentation > InTouch OMI SDK Help
The following table provides guidelines for hardware configurations suitable for System Platform 2020 software based on the size of the application. These guidelines are subject to the limitations of your Windows operating system, and if applicable, to the SQL Server edition (Express, Standard, or Enterprise). See the AVEVA GCS Technology Matrix for supported versions of Windows operating systems and SQL Server.
Application |
Level |
CPU Cores |
RAM |
HD Space |
Screen Resolution |
Network Speed |
Server Nodes: for Historian Server, Galaxy Repository (GR node), Application Server IDE, AppEngine host |
||||||
Small Application |
Minimum |
2 |
2 GB |
100 GB |
1024 x 768 |
100 Mbps |
Recommended |
4 |
4 GB |
200 GB |
1920 x 1080 |
1000 Mbps |
|
Medium Application |
Minimum |
4 |
8 GB |
200 GB |
1024 x 768 |
1000 Mbps |
Recommended |
8 |
12 GB |
500 GB |
1920 x 1080 |
1000 Mbps |
|
Large Application |
Minimum |
8 |
16 GB |
500 GB |
1024 x 768 |
1000 Mbps |
Recommended |
16 |
24 GB |
1000 GB |
1920 x 1080 |
Dual 1000 Mbps |
|
Thin Client Node |
||||||
RDP clients, ITAA, mobile devices |
Minimum |
1 |
512 MB |
N/A |
800 x 600 |
100 Mbps |
Recommended |
2 |
2 GB |
N/A |
1280 x 1024 |
100 Mbps |
|
Client Node |
||||||
WindowViewer, ViewApp, Historian Client, Remote IDE |
Minimum |
2 |
1 GB |
100 GB |
1024 x 768 |
100 Mbps |
Recommended |
4 |
4 GB |
200 GB |
1920 x 1080 |
1000 Mbps |
|
Thin Client-Server Node |
||||||
RDS, ITAA Server |
Basic RDS - Minimum |
4 |
8 GB |
200 GB |
1024 x 768 |
1000 Mbps |
Basic RDS - Recommended |
8 |
12 GB |
500 GB |
1920 x 1080 |
1000 Mbps |
|
Large RDS - Minimum |
8 |
16 GB |
500 GB |
1024 x 768 |
1000 Mbps |
|
Large RDS - Recommended |
16 |
24 GB |
1000 GB |
1920 x 1080 |
Dual 1000 Mbps |
|
All-In-One Node |
||||||
All products on a single node |
Minimum |
4 |
8 GB |
200 GB |
1280 x 1024 |
100 Mbps |
Recommended |
6 |
12 GB |
500 GB |
1920 x 1080 |
1000 Mbps |
|
Server node type applies to Historian Server, Galaxy Repository node, and nodes hosting AppEngines. |
Supported and Recommended Node Hardware Types
Product |
Server Node |
Thin Client- Server Node |
Client Node |
Thin Client |
All-In-One |
Application Server |
|||||
Galaxy Repository |
Preferred |
Supported |
Supported |
No |
Supported |
Application Engine |
Preferred |
Supported |
Supported |
No |
Supported |
IDE |
Preferred |
Supported |
Supported |
RDP |
Supported |
ViewApp Runtime |
Supported |
Supported |
Preferred |
ITAA/RDP |
Supported |
InTouch Standalone |
|||||
WindowMaker (No Modern Apps) |
Supported |
Supported |
Preferred |
RDP |
Supported |
WindowMaker (with Modern Apps) |
Preferred |
Supported |
Supported |
RDP |
Supported |
WindowViewer / InTouch ViewApp (runtime only) |
Supported |
Supported |
Preferred |
ITAA/RDP |
Supported |
InTouch for System Platform |
|||||
WindowMaker (with Managed Apps) |
Preferred |
Supported |
Supported |
RDP |
Supported |
WindowViewer / InTouch ViewApp (runtime only) |
Supported |
Supported |
Preferred |
ITAA/RDP |
Supported |
InTouch Access Anywhere |
|||||
InTouch Access Anywhere Server |
Supported |
Preferred |
No |
No |
Supported |
InTouch Access Anywhere Client (HTML5 Browser) |
Browser |
Browser |
Browser |
Browser |
Browser |
InTouch Access Anywhere Secure Gateway |
Supported |
No |
No |
No |
No |
Historian |
|||||
Historian Server |
Preferred |
Supported |
Supported |
No |
Supported |
Historian InSight Client |
Browser |
Browser |
Browser |
Browser |
Browser |
Historian Client (Active Factory) |
Supported |
Supported |
Preferred |
RDP |
Supported |
Support Components |
|||||
OI Gateway |
Preferred |
Supported |
Supported |
No |
Supported |
AVEVA Enterprise Licensing - Server |
Preferred |
Supported |
Supported |
No |
Supported |
AVEVA Enterprise Licensing - Manager |
Preferred |
Supported |
Supported |
No |
Supported |
AVEVA Enterprise Licensing - Manager Client |
Browser |
Browser |
Browser |
Browser |
Browser |
Windows operating systems and SQL Server versions may impose hardware requirements that exceed the minimum requirements for System Platform 2020. Refer to the following Microsoft Web sites for Windows and SQL Server hardware requirements.
Windows requirements
Note: System Platform 2020 is not supported on any 32-bit Windows operating system. Windows 10, Version 1809 (64-bit), is the earliest version of Windows 10 that supports System Platform 2020. For the complete list of supported Windows operating systems and SQL Server versions, see the AVEVA GCS Technology Matrix.
SQL Server requirements
For system sizing examples, see the System Platform Installation Guide.
The latest product information for each System Platform product is listed in the AVEVA Global Customer Support GCS Technology Matrix. Each link includes:
Minimum Required Operating System Version
The following table shows the minimum operating system for each product. See the GCS Technology Matrix for a list of all supported operating systems.
Product |
Minimum Required Operating System Version |
|
Client OS (x86 and x64) |
Server OS (x64 only) |
|
Application Server |
Windows 8.1 Windows 10 |
Windows Server 2012 Windows Server 2012 R2 SAC versions of later Windows Server operating systems are not supported |
InTouch |
||
Historian |
Important: Regardless of which operating system you are using, we recommend that you download and install the latest Microsoft updates to enhance security and ensure product compatibility.
Note: Only Windows Server versions licensed under Microsoft's long term servicing channel (LTSC) are supported. Versions of Windows Server licensed under the Semi-Annual Channel (SAC) do not include Desktop Experience, and therefore, are not supported. For example SAC versions 1709, 1903, and 2003 are not supported.
64-bit only
System Platform Product / Component |
Windows 8.1 |
SAC Windows 10 |
LTSC Windows 10 |
LTSC Windows Server |
Application Server 2020
|
Supported |
1803 |
2016 |
2012 |
InTouch HMI 2020
|
Supported |
1803 |
2016 |
2012 |
InTouch for System Platform 2020
|
Supported |
1803 |
2016 |
2012 |
Historian Server 2020 |
Supported |
1803 |
2016 |
2012 |
InTouch Access Anywhere Server 2020
|
Supported |
1803 |
2016 |
2012 |
Other System Platform 2020 components / products
|
Supported |
1803 |
2016 |
2012 |
SAC: Semi Annual Channel (subscription)
LTSC: Long Term Servicing Channel
LTSC is the newer name for LTSB (Long Term Servicing Branch)
Windows Server Notes:
The following web clients are included with System Platform 2020:
The client programs listed above can be used with most common web browsers. Compatible browsers include:
Upgrading SQL Server with AVEVA products installed is supported. See the AVEVA Global Customer Support GCS Technology Matrix for the complete list of supported SQL Server versions.
Only 64-bit versions of SQL Server are supported in this System Platform release. See Supported SQL Server Versions at Time of Release for more information.
If an error message about an unsupported SQL Server version is displayed while installing or upgrading to System Platform 2020, check the following:
64-bit only
System Platform Product / Component |
SQL Server Express SSMSE |
SQL Server |
Application Server 2020
|
2012 SP4 v11.0.7001.0 or higher
2014 SP3 v12.0.6024.0 or higher
2016 SP2 v13.0.5026.0 or higher
2017 Core v14.0.1000.169 or higher
2019 Core v15.0.2000.5 or higher |
2012 Standard/Enterprise SP4 v11.0.7001.0 or higher
2014 Standard/Enterprise SP3 v12.0.6024.0 or higher
2016 Standard/Enterprise SP2 v13.0.5026.0 or higher
2017 Standard/Enterprise v14.0.1000.169 or higher
2019 Standard/Enterprise v15.0.2000.5 or higher
|
InTouch HMI 2020
|
||
InTouch for System Platform 2020
|
||
Historian Server 2020 |
||
System Monitor Manager |
Default database is SQL Server Express 2017 Core
For information about which version of SQL Server you are running, see How to determine the version, edition, and update level of SQL Server and its components
The following virtualization software and cloud-based virtual environments are supported for System Platform 2020:
In order to establish communication with other components and services on the network, System Platform and ArchestrA Service Bus (ASB) services require certain network ports to be opened in the Windows Firewall. Typically, these ports are automatically opened for the Windows Firewall during installation. However, if the Windows Firewall service is disabled or not running at the time of installation, or if an alternative firewall is in use, you will need to manually open the appropriate network ports in the firewall. For more information about port configuration, see "Configuring ArchestrA Service TCP Ports" in the Application Server User Guide (filename: IDE.pdf).
Due to the Data Execution Prevention (DEP) feature in Windows operating systems, any ActiveX control built with ATL version 7.1 or earlier will fail to host, or will behave unpredictably in InTouch, either in WindowMaker or WindowViewer.
The ActiveX controls and error message, along with solutions to resolve the behavior, are described in detail in TechNote 522, "Some ActiveX Controls NOT Supported in InTouch 2012 R2 (Version 10.6)". You can download this TechNote from the AVEVA Global Customer Support (GCS) website.
The process to configure remote alarm retrieval queries has changed for interactive applications such as InTouch HMI when running on currently-supported Windows and Windows Server operating systems.
When InTouch WindowViewer is started and generates alarms from an interactive Windows or Windows Server desktop session, an AlarmViewer control (running within InTouch HMI) on a remote node must be specially configured to query the alarms. The source alarms will not appear unless the AlarmViewer control's alarm query is configured.
This type of query only works for InTouch HMI as an alarm provider running in a Terminal Services session, not for InTouch HMI running in a console session.
To configure the AlarmViewer's alarm query
\\nodename:ip_address\intouch!$system
where nodename is the name of the node that is providing the InTouch alarm and ip_address is the IP address that you determined in step 1.
Windows Server no longer supports the /console switch as a means of starting the remote desktop (RDP) client, also known as Session 0 or Terminal Server Console session. Session 0 is no longer an interactive session, and is reserved only for Windows services. Windows Server treats all remote connections as remote RDP sessions regardless of /console, /admin, or any other switches used to make the connection.
This impacts InTouch HMI functionality such as Alarm Manager that depends on the Terminal Server Console session. The impact to Application Server is minimal as most Application Server processes run as services. One impact to Application Server is to carry forward the restriction introduced with the Windows Vista operating system which permits only one alarm provider. While both Application Server and InTouch HMI can be configured as alarm providers, only one alarm provider can be configured at any one time.
Refer to the InTouch HMI Readme for further information about InTouch HMI applications running in the Terminal Server Console.
If you are running WindowViewer within a Terminal Server session and want to access alarms from WindowViewer in a client session, you must use the syntax \\terminalservernode:<IP address>\InTouch!$System to access the alarms, with a colon (:) after the node name. The IP address is that of the client computer connected to the session.
NetDDE is not supported for InTouchView applications.
By design, an InTouchView application does not serve data to any other source, including InTouch HMI itself. When WindowViewer starts, it verifies if the application is an InTouchView application. When WindowViewer detects an InTouchView application, it does not register to become a DDE server. ArchestrA Symbols make use of the client layer when accessing InTouch tags, and appear as a third-party client trying to access WindowViewer as a data server. As a result, ArchestrA Symbols cannot communicate with InTouch tags when used with an InTouchView license.
In ArchestrA Symbols, InTouch:<tagname> is still a valid method of referring to an InTouch tag on a local node.
System Platform 2020 with InTouch HMI 2020 supports User Account Control-enabled operations on run-time nodes.
This section describes specific behaviors and restrictions when using the supported versions of Windows and Windows Server operating systems with Application Server.
Application Server supports User Account Control-enabled operations. Starting the IDE requires elevated privileges.
Scenarios involving remote node communication fail if the Historian node is using the Windows 7, Windows 8, Windows Server 2008 R2, or Windows Server 2012 operating system.
For example:
Workaround:
cmd /c reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f
This sets LocalAccountTokenFilterPolicy registry entry value to 1. In doing so, an elevated token for the user is generated.
User Account Control can be enabled when the Historian Client application is running as non-administrator.
IMPORTANT: System Platform 2020 leverages the Microsoft .NET Framework 4.7.2 (or higher) version. Multiple versions of the .NET Framework can coexist, if other applications on the same machine have dependencies on other .NET versions.
All user-supplied .NET code that runs in the context of InTouch HMI and Application Server requires .NET Framework 4.7.2 or higher. Although the .NET Framework 4.7.2 is highly compatible with applications that are built with earlier .NET Framework versions, you may have to update your scripts.
In ArchestrA scripting, some .Net codes could fail if not using proper text encoding, and could cause a script to exit without completion. The UTF8Encoder is the default BinaryStream decoder in .Net 4.5 and later. To enable an ArchestrA script to decode ASCII XML data, for example, insert the following snippet:
BinaryReader streamReader = new BinaryReader(ms, new ASCIIEncoding());
To learn more about changes introduced in different versions of the .NET Framework, refer to the following Microsoft resources:
SQL Server is required for Application Server, InTouch, and Historian Server. We recommend that you install and configure the supported SQL Server version before you begin the System Platform installation program. If you select SQL Server Express during System Platform installation, it will be installed automatically (applicable to small installations only).
The System Platform installer will install all prerequisites except the SQL Server requirement for installing the Historian Server. If you select the Historian Server for installation, and if the supported version of SQL Server is not already installed, you must exit the installation program, install the supported SQL Server version, then resume the installation.
Other considerations are:
Important! A 32-bit version of SQL Server cannot be upgraded to a 64-bit version through SQL Server Setup. However, you can back up or detach a database from a 32-bit instance of SQL Server, and then restore or attach the database to a 64-bit instance. For more information, see Supported Version and Edition Upgrades for SQL Server 2017.
If you accidentally delete the aaAdministrators group from the SQL Server security logins, you must run the aaConfig SQL Utility to restore it. Refer to the Application Server User's Guide, "About ArchestrA User Accounts", for further information and procedures about restoring the aaAdministrators group.
For Historian Client:
For detailed installation instructions in English, see the AVEVA System Platform Installation Guide (SP_Install_Guide.pdf) or AVEVA System Platform Installation Help (SP_Install_Guide.chm). The installation guide supersedes the separate installation guides for the individual products. The Installation Guide pdf file is located in the root directory of the System Platform installation DVD. The Installation Help chm file is located in the InstallFiles directory of the installation DVD.
The information provided in this Readme file and the InTouch Readme file supersedes the InTouch HMI Installation Help (Install-InTouch.chm) for the French, German, Japanese, and Simplified Chinese languages.
The ArchestrA user account is a user name and password combination that enables inter-node communication between all computers in an ArchestrA environment. You must specify the same user account on every node when you install the System Platform components for the first time on computers that communicate with each other.
WARNING! The ArchestrA user account is a Windows operating system account located on the local computer or on a domain. Do not delete this account with operating system account management tools. If you do, ArchestrA-enabled software may stop functioning properly.
After you install a System Platform component, you can use the ArchestrA Change Network Account utility to change or re-create the ArchestrA user account. The Start menu contains a shortcut to the utility. It is under the AVEVA Utilities folder.
You must have Administrator privileges to use the Change Network Account utility. For more information, see the Change Network Account utility help
Note: If you re-create the user account using the Change Network Account utility, the Microsoft Windows security component on the computer can take several minutes to update this information on the ArchestrA Galaxy node. Until that occurs, the ArchestrA component may not function properly. Restarting the Galaxy node updates this information immediately.
We highly recommend the following System Monitor installation and configuration sequence. For more information and details, please see “Configuring the System Monitor Agent" and "Configuring the System Monitor Manager” in the System Platform Installation Guide.
If you connect a machine to the System Management Server and then later replace the machine due to hardware failure, or restore the VM to a state prior to that connection without first disconnecting the machine from the System Management Server, you will not be able to reconnect that same machine to the System Management Server.
Cause:
To protect the security of the system, the System Management Server uniquely identifies each machine that connects to it. If an intruder attempts to pretend to be that machine (spoofing) and re-registers with that machine’s name, the System Management Server will detect the mismatched identity and reject the suspected intruder’s registration.
Solution:
After attempting to reconnect the machine, the logger will contain the warning:
“ArchestrA.CertificateManager: Please un-register the device <device name> from management server. Use the (Remove-AsbDevice) script to remove the device registration”
The PowerShell command will remove the machine’s connection information from the System Management Server. We recommend that you contact your support team, or AVEVA Global Customer Support (GCS), for assistance with executing this command.
IMPORTANT! You can only upgrade to System Platform 2020 if the prior version was installed on a 64-bit operating system.
You can upgrade directly to System Platform 2020 from System Platform 2014 R2 SP1 or later, provided the prior version was installed on a 64-bit operating system.
Upgrading is defined as installing a newer version of the software when a previous version of the software exists. An upgrade is possible when the system requirements (operating system, SQL Server, .NET Framework) are met. The upgrade process will properly remove or uninstall the previous software version and install the new version. For versions older than the current and previous licensed versions, only the latest service pack or patch versions are tested. For distributed systems, some products must be upgraded in a particular order. For more information, see upgrade information for each product in the System Platform Installation Guide.
The earliest versions of Windows that support System Platform 2020 are:
See the GCS Technology Matrix for complete information about operating system that you can use with System Platform 2020 products.
IMPORTANT! Back up any relevant application configuration files or databases before you start an upgrade or migration.
Once installed, a link to the AVEVA Enterprise License Manager can be found in the \AVEVA folder on the Start menu.
It can also be accessed by pointing your browser to the following URL:
http://<nodename>/AELicenseManager
where <Nodename> is localhost or the name of the node where the AVEVA Enterprise License Manager is installed.
The AVEVA Enterprise License Server can be installed separately from the AVEVA Enterprise License Manager.
In System Platform 2020, running both InTouch HMI and InTouch OMI in a session on an RDS Server will attempt to acquire two (2) Supervisory Client Server (unlimited) licenses instead of one (1).
If you have purchased a Supervisory Client Server license (unlimited RDP sessions on a single server) and then run both InTouch HMI and InTouch OMI simultaneously, there can be issues acquiring the server license due to differences in how the license is handled between the two. The order of startup will impact the results.
This behavior is seen in only a limited number of instances, only when you have purchased a Subscription license. If you do see this behavior, change the order of InTouch HMI and InTouch OMI startup.
If this behavior continues, contact AVEVA Software Global Customer Support (GCS), describe the behavior, and request a temporary license, typically valid for 60-days.
License Reservation
Reserving a license for a specific device ensures a license will be available for that specific device whenever it is needed, regardless of the number of devices connected to the system. Keep in mind, each license can only be reserved to a single device, so if the device names are unknown ahead of time, it's better to not use reservations and instead allow the licenses to be acquired on a first-come, first-serve basis.
User-based License Reservation
In the AVEVA Enterprise License Manager license reservation page it is possible to mark a license to be reserved to a specific user. While the reservation page allows this particular configuration, it's important to know that neither InTouch OMI nor InTouch HMI ViewApps support user-based license reservations. The end-result will be the inability for the software to acquire the license reserved. Therefore, only use device-based reservations for Supervisory Client licenses.
Device-based License Reservation
When reserving a Supervisory Client license for a specific device, the Device Name needs to be the name of the computer running the InTouch HMI/OMI ViewApp. In the case where the ViewApp is running inside of a Remote Desktop Session, on an RDS (aka: Terminal Server), then the Device Name needs to follow this naming pattern:
<RDSHostName>-<RDPClientName>-<index>
where RDSHostName is the name of the Remote Desktop Server (aka: RDS or Terminal Server), and RDPClientName is the name of the PC running the RDP client software, and "index" is 1, unless there will be multiple RDP sessions from a single client machine, in which case the index should be incremented (starting at 1) for each reservation for that specific RDP client, up to the total number of RDP sessions from that specific RDP client.
Reservation Examples
Situation: A computer with a hostname of "ControlRoomA" runs InTouch OMI
Device Name: "ControlRoomA"
Situation: A computer with a hostname of "ControlRoomB" running a single Remote Desktop Client (RDP), connecting to the Remote Desktop Server (aka: Terminal Server) with a hostname of "PrimaryRDS"
Device Name: "PrimaryRDS-ControlRoomB-1"
Situation: Two computers with hostnames "SupervisorPC1" and "LineMgrA", respectively, each running a single Remote Desktop Client (RDP) connecting to the Remote Desktop Server (aka: Terminal Server) with a hostname of "PrimaryRDS"
Device Names:
Situation: A computer with a hostname of "ExecutiveDesktop" running four (4) Remote Desktop Clients (RDPs), connecting to the Remote Desktop Server (aka: Terminal Server) with a hostname of "PrimaryRDS"
Device Names:
Virtual Environments: License Servers are supported in virtual environments. However, under certain circumstances, such as transferring a license from one virtual environment to another, the License Server may interpret the transfer as an improper move and therefore go into grace period.
High Availability: License Servers in a High Availability virtual environment are supported in specific topologies. Basic redundancy topologies are described in the AVEVA Enterprise Licensing online help.
Disaster Recovery: License Servers in a Disaster Recovery virtual environment will go into a grace period during DR activities. This is because DR activities are similar to an improper move of licenses and will trigger a grace period.
To avoid a grace period trigger in a DR virtual environment, we recommend that you run the License Server outside the virtualized DR environment and use a redundant License Server configuration through the functionality built into the License Server software. Another option is to purchase Disaster Recovery licenses at a discounted rate and establish a backup License Server with these additional licenses.
In all environments, we recommend you install and run the AVEVA System Monitor to monitor licensing functionality and view alerts on issues such as a License Server going into grace period or licenses expiring.
Hyper-V Virtual Environment
High Availability (HA) in a Hyper-V virtual environment does not activate licensing grace period during a failover as monitored environmental variables do not change.
Disaster Recovery (DR) in a Hyper-V virtual environment activates a licensing grace period as monitored environmental variables do change.
VMWare Virtual Environment
High Availability (HA) in a VMWare virtual environment does not activate licensing grace period during a failover as monitored environmental variables do not change.
Disaster Recovery (DR) in a VMWare virtual environment activates a licensing grace period as monitored environmental variables do change.
Antivirus Software should be implemented as part of a defense-in-depth strategy to secure your Industrial Control Systems. TechNote TN2865, available from the AVEVA Global Customer Support (GCS) web site, lists important information about antivirus software. Enter your GCS credentials to access the Tech Note.
https://softwaresupportsp.aveva.com/#/okmimarticle/docid/tn2865
See the product-specific Readme files for resolved issues.
The following important known issues are listed by their assigned CR or reference number in ascending order. Additional known issues are documented in the product-specific Readme files.
1278013 |
In certain multi-galaxy environments (MGC) running different versions of System Platform and using OS User Security, Verified Writes from InTouch to an attribute on another Galaxy node do not succeed. This occurs where one node is running System Platform 2014 R2 SP1, and a Verified Write is attempted from an InTouch window to an attribute on another node that is running System Platform 2020. Both nodes have InTouch and the GR installed. The following error message is logged: "Write attempt failed for the following reason: 'Security error: 8018'." However, Verified Writes from Object Viewer are successful. Workaround: When performing a Verified Write from an InTouch window, enter the user name in the format ".\<UserName". Do not use the format "<LocalMachineName>\<UserName>". |
1263702 |
When upgrading from a node with Platform Common Services (PCS) 4.3.3 installed, such as the case when upgrading from System Platform 2107 Update 3 SP1 or installing on a node with RMP 2017 Update 2, errors are logged while deploying the OPCUA service. However, the service is deployed successfully. The errors are similar to the following: Application certificate does not have an application URI: CN=AZURE2019 Failed! UnifiedAutomation.UaBase.StatusException: Application certificate does not have an application URI: CN=AZURE2019 Workaround:
|
1161407 |
With only run-time components of System Platform Update 3 or Update 3 SP1 already installed, the following error is encountered when installing InBatch 2014 R3SP1, Batch Management 2017, or RMP 2018 SP1: "Error 1603 A newer version of Archestra Service Bus Framework 4.2.2 is already installed." Workaround:
|
Alternate workaround: If you choose to install System Platform 2017 Update3 or 2017 Update3 SP1 first, then:
|
|
1111134 1121155 |
In some circumstances, when using the Configurator to configure the System Management Server, you may be prompted to enter your user credentials. This may happen if the logged-in user does not belong to the aaAdministrators or Administrators OS group. If you are a member of either of these groups, enter your user name as DomainName\UserName. The logged-in user should be a direct member of the aaAdministrators or Administrator group. Using the credentials for a user that belongs to nested groups is not supported. That is, you cannot use credentials that belong to a group that is part of aaAdministrators or Administrators. If you are not a member of aaAdministrators or Administrators on the local machine, you can obtain configuration privileges for another OS group by editing the file appsettings.json, and adding the name of the OS group to the file. The full path for this file is: To add an OS group to the file, add the new OS group after "aaAdministrators." "AppSettings": { "AllowGroups:: [ "aaAdministrators", "insert new group name here" ] |
1116282 |
In a very small set of multi-galaxy (MGC) environments, communications between some System Platform subscribers and a system service they subscribe to may not be secure. In these circumstances, communications still occur, but may not be secure. If all the following elements exist in an MGC topology, communications may occur over an insecure channel:
Workaround: To ensure that communications are always secure, update the config files as follows.
|
L00141660 |
In a system with two GR nodes, attempting to connect from the IDE on one node to a Galaxy on the second GR node does not succeed, and the IDE shuts down. Workaround: Pair the GR nodes before trying to connect to the Galaxy on the other node. See "Working with Multiple Galaxies > Setting Up a Multi-Galaxy Environment" in the Application Server User Guide for information about configuring multi-Galaxy pairing. |
L00139918 |
Uninstalling Wonderware InBatch versions 10.2 or 11.0 installed on a System Platform 2014R2 SP1 system results in a failure to connect to ArchestrA Service Bus (ASB) services. If you uninstall either of these InBatch versions then cannot connect to ASB services, run a repair on System Platform 2014R2 SP1 using Windows' Add/Remove Programs utility. |
L00133534 |
Undeploying a galaxy with Object Viewer active will cause Object Viewer to shut down with an informational message that requires acknowledgement (click OK) to complete the shutdown. In a multi-galaxy configuration, with Object Viewer open, undeploying a paired Galaxy, then redeploying the galaxy without properly shutting down Object Viewer, can cause ASB services to fail to reconnect to the redeployed galaxy. To avoid this condition, click OK to shut down Object Viewer before redeploying the galaxy. |
L00123474 |
Writing from InTouch to a remote galaxy using indirect tags can fail for some of the remote references. Object Viewers on two different nodes may show different values for the same reference. You can avoid this issue by deactivating Advanced Communication Management in the IDE. Additionally, if you use the same indirect tag with scripting more than one time, you can modify your scripts to set the indirect tag's name property to an empty string after the loop completes. For example, in the following script snippet, you would add the line highlighted with bold text:
IF bRunScript THEN
|
L00123462 |
In a multi-galaxy environment, you can pair galaxies by IP address rather than using a node name (computer machine name). Unpairing galaxies identified by IP address fails when NetBIOS and DNS solutions are unavailable. Where your galaxies are identified by IP address, you must create a temporary host file to map the IP addresses as hostnames for purposes of unpairing.
|
1249251 |
Upgrading to System Platform 2020 from a prior version does not succeed if the prior version used a 32-bit version of SQL Server. Support for 32-bit SQL Server has been discontinued for the System Platform 2020 release. Workarounds: Two methods for upgrading System Platform and migrating galaxies are listed below. Use the first method if you will use SQL Server Express, included with System Platform. Use the second method if you will be installing a 64-bit full version of SQL Server in place of a 32-bit version. Method 1 (install SQL Server Express as part of System Platform installation):
Method 2 (install full version of SQL Server):
|
1233570 |
The aaGR service generates errors and warnings when migrating a Galaxy from System Platform 2014 R2SP1 to System Platform 2020. This issue is most noticeable on nodes with eight or more cores, although it can also occur on nodes with six or fewer cores. |
1224058 |
When a galaxy with an ITMEViewApp object is migrated to System Platform 2020, an "ArchestrAObjectSupport" error message is logged. Note: This issue has been corrected in AVEVA™ Edge 2020. Workaround: You can avoid this issue by contacting AVEVA Customer Support for a patch compatible with your System Platform release. Before migrating your galaxy to System Platform 2020, import the ITMEViewApp Object patch. If you have already migrated your galaxy to SP 2020 and are seeing an error message, import the ITMEViewApp Object included in the AVEVA™ Edge 2020 release. |
1135229 1157116 |
If InBatch 2014 R3 or InBatch 2014 R3 SP1 is installed on the same node as System Platform 2017 or 2017 Update 1, upgrading to System Platform Update 3 SP1 may result in a compatibility issue that stops the IDE from working. Workaround: Upgrade InBatch to version 2017 or later before upgrading to System Platform 2017 Update 3 SP1. InBatch 2017 and later versions are compatible with System Platform 2017 Update 3 SP1. |
1120630 |
A Modify operation on InBatch 2017 fails when InBatch 2017 or earlier is installed before System Platform 2017 Update 3. Workaround: Install System Platform 2017 Update 3 first, then install InBatch. |
931629 |
If a System Platform component is removed through the Control Panel ("Install/Uninstall Programs" applet), rather than by running the System Platform installation program (Setup.exe), errors messages will be logged, exception messages such as "FileNotFound" will be displayed, and Application Server deployment will no longer be successful. Workaround: Use the "Modify" workflow, as described in the System Platform Installation Guide.
|
804308 |
While installing System Platform 2017 on a remote node using an RDP session, you may lose your RDP connection if the Windows Firewall Service is stopped and Startup Type=Manual. If you are unable to reconnect, try the following:
|
796068 |
On a Galaxy Repository, uninstalling Application Server results in restoring the ArchestrA User credentials to the registry. |
1295525 |
You may not be able to see a WYSYWYG preview of a ViewApp if all of the following are true:
|
1292338 |
Checkboxes and other WCC elements, when linked to an invalid User Defined Object attribute, do not retain settings. For example, a checkbox configured as True will immediately revert to False. Workaround: This works as designed, and no workaround is needed. Linking to an invalid reference should not show any value. |
1290949 |
Changes to an Object Wizard containing a symbol during run time or while in preview mode do not hide the symbols associated with the Wizard. |
1290461 |
When quickly associating multiple apps to a ViewApp, an app that displays a message, such as a licensing dialog while rendering its WYSIWYG preview) may cause the ViewApp and the IDE to become non-responsive. Workaround: Shut down the IDE process and restart the IDE. |
1290401 |
A ViewApp becomes non-responsive when the user attempts to login to the running ViewApp from the Login dialog box. |
1289649 |
Certain characters cannot be entered when the Layout Script Editor is set to the International US keyboard. Instead of the typed character, the keyboard produces a space. Workaround: When there is need to type one of the international accented dead keys (such as " ' ~ ^ : ), use an external text editor such as Notepad, and copy and paste the text into the script editor. Note that the Layout Script Editor supports all international characters. |
1281954 |
A Layout Editor window that extends beyond a monitor screen onto another monitor screen still spans multiple screens, even after selecting the Maximize button. The Layout Editor window should resize to the full screen size of a monitor after selecting the Maximize button. |
1257142 |
During run time, the top of a slide-in pane (pane 2) in a ViewApp appears to be misaligned with the pane it slides over (pane 1) when "Hide Row When Empty" is enabled for pane 1. Workaround: This is a minor aesthetic issue and does not affect functionality. If necessary, disable the "Hide Row When Empty" option. |
1195009 |
Users experience a 5 to 10 second delay when selecting any option from the Configure New Asset dialog box or attempting to close the dialog box. |
1160616 |
If an admin user logs in, launches a ViewApp, and then logs off the system while leaving the ViewApp running, registry keys are unloaded in the profile of the user account. This results in continuous errors from CheckPointFileServer in the logger similar to: ""INVALID HRESULT LINE765 File CheckPointFile.cpp hResult 80003fa after logging off and logging on as different users (non-admin)." Cause: This is a known Microsoft issue. This problem typically occurs after an administrator uses a service account to log in to the server for an interactive session, and then logs off. For example, an administrator may log in to a Web Front End (WFE) server by using the farm account, and then log off. This activity forces the registry keys to be unloaded in the profile of that account, and makes the keys unavailable for future use. Microsoft recommends using either of the following workarounds to resolve this issue. For more information, see: "800703fa Illegal operation attempted on a registry key" error A COM+ application may stop working on Windows Server 2008 when the identity user logs off Workaround 1: Do not log in to the server for interactive sessions by using a service account. Workaround 2: Disable the related Windows User Profile Service feature as follows:
|
L00150114 |
SR59513303: TheGetCPTimeStamp() scripting method, when used in an InTouch OMI action or named script within a symbol, does not return the timestamp at run time. Instead, it returns characters for the timestamp format, such as "mm/dd/yyyy hh:mm:ss." No errors or warnings will appear in the logger. This is similar to issue 777504, listed below. Workaround: Use the GetCPTimeStamp() method in an object script instead of a symbol script. |
1100582 |
Switching languages during run time while using multi-content panes that use locale-specific scripting calls can sometimes result in errors in the logger. Workaround: Restart the ViewApp after switching the run-time language. This action fully resolves the issue with no loss of functionality. |
988079 |
If you upgrade or migrate from version 2017 or 2017 Update 1, and have an InTouch OMI ViewApp that uses the ShowGraphic scripting method, modeless windows will behave differently at run time in this version of InTouch OMI.
|
Missing NavTree |
After upgrading or migrating an InTouch OMI ViewApp from 2017 to 2017 Update 1, a warning message states that the NavTree entity could not be found. In 2017 Update 1, this navigation object has changed and is now called “NavTreeControl.” Workaround 1: To replace the NavTree object in a ViewApp or Layout when upgrading to System Platform 2017 Update 1:
Workaround 2: To replace references to NavTree when importing packages from System Platform 2017:
|
774717 |
When an InTouch OMI application (View.exe) that uses one of the following web controls is run in 4K mode or on multiple 1080p monitors, under certain circumstances the application may stop responding:
Workaround: When running a ViewApp that uses a web control on a 4K monitor, set the monitor resolution to 2560 x1440 or less. When running the ViewApp on 1080p monitors, do not attempt to span multiple monitors. |
777504 |
The GetCPQuality() scripting method is not supported in InTouch OMI. If used in a ViewApp, it always returns quality = 0 (bad quality). This is similar to issue L00150114, listed above. |
781006 |
If an invalid custom property is added to a symbol, no warning is logged in the System Management Console, even though no value is displayed for the custom property. |
781620 |
The Height and Width properties of a group with text elements do not change in accordance with changes made to the label font size, and are not rendered correctly. |
784470 |
Tooltip animations that contain multiple lines of text with line breaks may not display properly in deployed ViewApp. |
784474 |
A tooltip may partially cover the element with which it is associated in the deployed ViewApp. |
787192 |
When OSGroup security mode is used, the VerifiedWrite dialog is not displayed when you modify the value of a VerifiedWrite attribute from a combobox, if you first attempted to perform the VerifiedWrite without having the correct security credentials. |
789857 |
When an element style animation is configured with both a fill color and a blink color, the blink animation and color remain when an element style override is applied that specifies only a fill color and has the blink check box deselected. Workaround: Set the initial state without blink, then apply overrides as needed with blink enabled. |
789958 |
On some high resolution tablet devices, such as the Surface Pro 4, object names in the System Platform IDE may have insufficient line spacing between items, which can make it harder to read object names. |
794383 |
When a custom property is changed from public to private, the change does not have any affect, and the value of the private custom property is shown at run time (private values should not be shown). Similar situations occur when:
Workaround: Manually validate the outermost symbol and then deploy the ViewApp. |
L00138837 |
AppEngine can crash due to calls made to API dlls even when using try/catch. This issue is specific to Nullable data types. The recommendation is to use wrapped API DLLs in Application Server scripting. |
1297211 |
If an instance object with a Boolean attribute is configured with read/write I/O (and options for invert, buffer, reflect input and output, and output every scan are enabled), the instance is overwritten by its parent template at run time, if the attribute in the parent object is configured as an integer. |
1296015 |
In a client-server System Platform implementation where the client node is running a remote GR and run time features, the asb.Watchdog service may stop. As a result, MXData and Authentication warning messages appear in the logger. Workaround: Insert the System Platform installation DVD and run setup.exe, then select the Repair option. For more information, see "Repairing an Installation" in the System Platform Installation Guide. |
1295718 |
After an expression in a template is changed from locked to unlocked and adding an invalid expression to a script, a derived instance goes into a warning state when the template is checked in. Even after the object is validated, the warning remains. However, there is minimal user impact as the instance object expression does not change. The only effect is that the object is in a warning state. Workaround: To resolve the warning state of the instance, open the template, lock the script text, and check in the template. |
1292344 |
If the ArchestrA IDE running and an ipconfig /release command is followed by an ipconfig/renew command on a remote client machine, the IDE goes into an invalid state where the IDE is responsive but objects cannot be edited. |
1291740 |
After editing a parent template with child template and instance objects across multiple hierarchy levels, checking in the template takes longer than expected. |
1290449 |
A legacy object with field attributes goes into an error state after importing a package file having field attributes and converting them using the Galaxy menu option, Convert Legacy UserDefined Object, even after the object has been validated. |
1287616 |
After adding an attribute, script, or symbol to a template with about 2500 child instances, checking in the template can take more than a minute. |
1287606 |
At run time, an overview symbol shows the LocalSymbolSetting override, even though the override setting visibility was changed to false in the Object Wizard settings. This occurs only when the visibility setting is changed to false and a local override is present. |
1283400 |
An aaPKG file containing a large number of objects or symbols may take longer to export or import in System Platform 2020 as compared to System Platform 2017 Update 3. |
1279394 |
In Application Server 2020, the MxDataprovider service may have a memory leak of about 2MB per day (based on 5000 updates/sec or about 360 million changes/day). |
1258604 |
The ArchestrA IDE becomes non-responsive after attempting to edit a ViewApp associated with a layout containing more than 32 panes. |
1249822 |
If the aaGR process is restarted while importing a Galaxy, the import process does not complete. |
1173359 |
A Build operation using the Application Object Toolkit 2014 (AOT) with System Platform Update 3 SP1 does not succeed. Workaround: Do the following before building the object:
|
1157633 |
As a result of security enhancements in System Platform 2017 Update 3 SP1, ArchestrA object scripts are unable to connect to SQL Server. Workaround:
|
933752 |
Starting the IDE can take up to a minute if the node on which it is running is not connected to the internet. Root Cause: To enhance security and reliability, System Platform will validate certificates. Windows then performs a check to see if the certificate has been revoked. Without an internet connection, Windows waits until the timeout for this check has been reached before allowing the IDE to start. Workaround 1 (preferred): This method changes the default timeout for the certificate check.
Workaround 2: This method disables checks for revoked certificates.
Workaround 3: This method installs the certificates that the operating system is attempting to validate onto the local machine. Once installed locally, the operating system will no longer need to access the network to retrieve them.
|
797198 |
If the unfill color is set to a gradient in an Unfill animation with an animation fill style, and the fill style animation is changed, it changes the unfill color property. |
797226 |
If the expression type is set to string in the truth table for fill color animation, the fill style does not change when the value changes. |
The following known issues are in addition to those documented in the InTouch HMI Readme.
L00117794 |
Tooltip text on .NET control buttons is not shown when running the .NET control in InTouch. |
1291696 |
When WindowViewer is running as a service and the Historian resides locally, historical logging may not work as expected. Workaround: 1. Use the IP address as the Historian node name. 2. Edit the Wonderware WindowViewer service and change the Log On account from Local System to ArchestrA User account. |
1291671 |
When the graphic referenced in the Carousel widget is renamed or deleted, the graphic name is not automatically updated in the Carousel GraphicNames property. Workaround Manually update the Carousel GraphicNames property with the renamed graphic or remove the graphic name from the property. |
1290327 |
The Auto-Fill property is not fully supported for responsive layouts. Using Auto-Fill in combination with hidden panes may not display as expected. |
1290109 |
In a standalone application, when the $System tag is used as reference without the prefix InTouch: in an Industrial Graphic, a warning appears when the graphic is saved, although it works as expected at runtime. Workaround: Add the prefix InTouch: when using the $System tag in an Industrial Graphic. |
1283438 |
The following scenarios are not supported when InTouch windows are converted to Industrial Graphics: 1. Scripts that refer to window names with special characters are not changed on conversion. 2. Tag names created with arithmetic operators (-,+,%) are not supported. Workaround Issue 1: Manually update the window names referred in the scripts to the new names post conversion. Workaround Issue 2: Manually change the tag name. |
1283398 |
In InTouch Application Manager, the thumbnail is not visible if the application is redeployed. Workaround:
|
The following known issue is in addition to those documented in the InTouch Access Anywhere Readme.
1280717 |
InTouch Access Anywhere cannot be removed through the Modify workflow. An error message is displayed that states, "To install this product, please run Setup.exe. The setup will now exit." Workaround: Select the Remove workflow, instead of Modify, from the Maintenance dialog. This successfully deletes InTouch Access Anywhere and its components. |
924302 |
When installing Historian along with any other component, and the other component requests a system restart, if you restart immediately after closing out the Configurator, a number of warnings may appear in the logger from the Historian services. This is caused by a timing issue. The warning messages can be safely ignored because they do not affect the configuration of the Historian, and do not have any effect on the system during or after the system restart. |
931966 |
When using silent install to upgrade Historian to System Platform 2017 Update 1 from a version that set a default password for SQL Server users, warning messages are logged that alert you to set new passwords for various system users after the Configurator runs. Your system will continue to operate normally without resetting the passwords, but changing the passwords will increase system security. |
1303484 |
If "Unlimited Engine" FLEX licensing is configured for an Application Server platform, and the System Platform IDE is closed and then reopened, the FLEX licensing configuration is lost. |
1241116 |
MES 2017/2017 R2 may not acquire a trial license when installed with System Platform 2020. This is due to a file path name change for the TrialLicensePool that is part of the System Platform 2020 release. This issue only occurs if you are using a trial license. For both MES 2017 and MES 2017 R2, the file path for the TrialLicensePool folder is: For System Platform 2020, the file path for the TrialLicensePool folder is: Workarounds: Use one of the following workarounds.
|
793643 |
If you have not set a default browser, and you install System Platform with AVEVA Enterprise licensing selected, clicking the AVEVA Enterprise License Manager shortcut does not open the License Manager in the browser as it should. Instead, the shortcut opens in Windows Explorer. From Windows Explorer, you cannot open License Manager (the OK button is inactive). Workaround: Follow the instructions for your operating to set the default browser, and then open the AVEVA Enterprise License Manager from the shortcut, or: Open your browser and copy the shortcut link, http://localhost/AELicenseManager, directly into the browser's address bar. |
779958 |
When the same license is acquired on both a local node and in an RDP session that originates from the same node, the License Manager may not show all the licenses that have been acquired. This occurs even though the licenses are counted properly on the license server. The license count that you see applies only to the node you are viewing. Thus, once you reach your maximum number of licenses, you will not be able to acquire additional licenses, even though the license manager may indicate that more licenses are available. |
1300491 |
Activating OI Gateway consumes a license even though OI Gateway does not require a license unless the MQTT component has been configured and is in use. Workaround: Reserve a license for each OI Server that requires a license. No licenses will then be available because they are reserved to other OI Servers. When OI Gateway is activated but not using MQTT, no license will be consumed by OI Gateway. OI Gateway will run without interruption. |
The following known issues are in addition to those documented in the AVEVA System Monitor Readme.
8186 |
Removing machines from the Monitored Machines list does not remove the respective platform from the Galaxy diagram. Workaround: Contact AVEVA Customer Support for a stored procedure to remove the machine from MSSQL, thus removing it from the Galaxy diagram. |
8185 |
Clicking the help link opens the User Guide in browser, but the guide is never loaded. Workaround: Refer to the AVEVA System Monitor User Guide to view the PDF edition of the help. |
7294 |
Following platform undeploy, the Runtime Data Provider shuts down. On redeploy of the platform, the Runtime Provider does not restart and resume monitoring until the Galaxy is rediscovered. Workaround: Following redeploy of a platform, manually rediscover the Galaxy (in the Galaxy Diagram area). Alternatively, stop and restart the "Sentinel Agent Service." |
7123 |
Domain User Groups can be added in the System Monitor Manager User configuration area successfully, but users of an added domain group cannot log in to the application. |
7066 |
Manually specifying a proxy server in the Local Area Network (LAN) Settings configuration dialog results in the inability to access the System Monitor Manager. Workaround: Use an automatic configuration script (provided by your IT department) to configure a proxy server. |
6306 |
Email alerts cannot be sent through secured SMTP. |
If you create a filter for a history block query that results in no matches, "Not Connected" appears in the status bar and a warning is logged to the ArchestrA Logger. The status bar should show "Connected" even though no matches are returned.
The System Platform documentation is available Adobe Acrobat .pdf files that are available from the following locations on the System Platform DVD:
InstallFiles\CD-ApplicationServer\UserDocs
InstallFiles\CD-Historian\UserDocs
InstallFiles\CD-HistorianClientUserDocs
InstallFiles\CD-Intouch\UserDocs
In addition, InTouch OMI Help is installed as web help when Application Server is installed. The web help is contained in a zip file in the InstallFiles\CD-ApplicationServer\UserDocs folder on the System Platform DVD. After Application Server installation, it can be launched from the following URL:
<System Drive>:\Program Files (x86)\ArchestrA\Framework\Docs\1033\NGX\index.htm
InTouch OMI Help can also be invoked from within the Application Server IDE by selecting an InTouch OMI object, such as a layout, screen profile, or InTouch OMI ViewApp, and pressing Ctrl + F1.
To view the PDF documentation, you must first download the latest version of Adobe Reader from the Adobe Corporation web site: http://www.adobe.com/products/acrobat/readstep2.html.
You can also access online Help systems from within the software.
This section lists important System Platform documentation corrections. For documentation corrections for individual System Platform products, see the individual product Readme files.
Item |
Location of Change |
Existing Documentation |
Change |
||||||||||||||
1 |
System Platform 2020 Help
|
Settings attributes can be set from faceplate symbols and or the function bar in the Framework Cab Galaxy. |
Settings attributes can be set from faceplate symbols. You can also embed the WW_App_Function widget in a symbol and use it to control settings attributes. The WW_App_Function widget is included in Galaxies created from the Default.cab, as part of the ViewApp UI Library in the Graphic Toolbox. The sample $InTouchOMI_ViewApp, which is associated with the WWD_L_Desktop layout, uses the WW_App_Function widget. A User Input animation has been configured to set the value of the MyViewApp.Settings.TrendDuration attribute. You can configure other attributes similarly. Refer to the sample ViewApp for more information. |
||||||||||||||
2 |
Application Server 2020 User Guide IDE Help Configuring Objects > Adding Features to Attributes > Using the State Alarm Feature |
You can set an alarm message and Priority for a state alarm. The time deadband is used to filter out rapid, transitory value spikes, and the active alarm state determines the trigger value (True or False) that will activate the alarm. For each State alarm, specify the following parameters: |
You can set an alarm message and Priority for a state alarm. The time deadband is used to filter out rapid, transitory value spikes, and the active alarm state determines the trigger value (True or False) that will activate the alarm. You can also link the State alarm to an external attribute to capture alarm conditions detected in the PLC, rather than in the Application Server object. |
||||||||||||||
N/A |
Alarm for Attribute This lets you link to an external attribute, such as a PV attribute, to provide state alarm data from the PLC. This allows the PLC to pass alarm conditions it detects directly to Application Server. You can use the Attribute Browser to select which attribute to link. |
||||||||||||||||
3 |
Application Server 2020 User Guide IDE Help |
Carousel Widget symbol help exists in the AVEVA InTouch HMI Help, but this help is not currently accessible from the IDE. |
Carousel Widget A carousel widget allows you to cycle through elements—images or slides of text—like a carousel, without any input. This widget can be used to display dashboards, alerts or alarm information on large monitors on the plant floor. Properties In addition to the standard graphics properties, you can also configure properties specific to the widget, under Widget Properties.
The carousel widget is based on the Bootstrap 4.0 Carousel component, for more information on bootstrap, go here: https://getbootstrap.com/docs/4.0/components/carousel/ |
Copyright © 2020 AVEVA Group plc and its subsidiaries. All rights reserved. | Contact Us |