Application Server 2012 (3.5)

Материал из archestra.info
Перейти к: навигация, поиск

Wonderware Application Server 3.5 Readme

Wonderware Application Server 2012 (version 3.5) Readme

Last revision: 9/23/2011

About This Readme

This document provides information about Wonderware® Application Server 2012 (version 3.5) features.

Wonderware Application Server 3.5 Readme Information

Click the following links to go to the various sections of this Readme.

About Wonderware Application Server 2012 (version 3.5)

Antivirus Software Exclusions

Minimum Hardware Requirements

Software Requirements and Compatibility

Using Wonderware Application Server with Windows 7 and Windows Server 2008 R2

Upgrading to Wonderware Application Server 2012 (version 3.5)

Migrating to Wonderware Application Server 2012 (version 3.5)

Resolved Issues - Wonderware Application Server 2012 (version 3.5)

Known Issues - Wonderware Application Server 2012 (version 3.5)

Wonderware Application Server Documentation Issues

Wonderware Application Server Documentation


Important!
  • Installation - Before installing Wonderware Application Server 2012 (version 3.5):
    • Ensure that you create backups of all Galaxies.
    • If you are using a Wonderware InTouch HMI 10.0 application with ArchestrA© Symbols, run the ArchestrA Symbol Analysis and Repair Utility and ensure that all issues reported by the utility are addressed.
    • Installing Application Server on a computer used as a domain controller is not supported.
    • Installing Wonderware Application Server 3.5 automatically undeploys any platform that is currently deployed in the node that is being updated. Changes to the WinPlatform object and other components require any deployed platforms to be redeployed.
    • SQL Server Installation:
      • If you use SQL Server 2008 SP1, be sure to select the x86 option during the SQL Server installation. This will install SQL Server in 32-bit mode, which is the only mode supported.
      • SQL Server User Account: SQL Server 2008 SP1 does not deliver the BUILTIN\Administrators role by default. While installing ArchestrA System Platform, configuration changes to SQL Server are required. If the installer does not have SQL Server administrative rights, the proper configuration of SQL Server may not be applied. A post-install "SQLAdmin" utility allows you to verify if the SQL configuration has been performed.
      • SQL Server Memory Usage: After installing SQL Server, Use SQL Server Management Studio to confirm that the "Maximum Server Memory" is configured to approximately 65% of the total available RAM. By default SQL Server does not clamp this setting. The ArchestrA System Platform installation process will attempt to adjust it if it has the appropriate rights to configure SQL Server.
      • Installing SQL Server Express: If you plan to use SQL Server 2008 Express Edition with Wonderware Information Server 2012 and Wonderware InTouch 2012 on the same node, the following limitations apply. (These limitations do not apply if you use a non-Express edition of SQL Server.)
        • Installing Information Server 2012 first, using MS SQL Express default instance name set to "SQLEXPRESS", and then installing InTouch 2012 will work without issue. Notice that in this scenario, each component uses a dedicated instance of MS SQL Express.
        • Installing InTouch 2012 first, which silently installs and configures MS SQL Express, and then installing Information Server 2012, will not allow Information Server to work. In this case, during the configuration of Information Server, an error message will show in the Configuration Utility stating: "SQL Server client components not found".
          To work around this issue, configure Information Server to use an instance of MS SQL Express (or a non-Express edition) on a remote node
      • Restoring a CAB: You cannot restore a Galaxy .cab file backed up in SQL Server 2008 to a node with SQL Server 2005. SQL Server 2008 database backups are not backward-compatible with SQL Server 2005. Attempting such a restore initializes, and the progress dialog box quickly displays 100% completion of restoring the database, but the Galaxy .cab restore operation does not complete, and no Galaxy is created. When you start the IDE, the Galaxy is blank.
  • UAC - Disable User Account Control (UAC) before installing Wonderware Application Server 3.5 and Wonderware InTouch HMI 10.5, applicable for Windows Vista and above operating systems. For more information about User Access Control support, see Support for Windows Operating System User Access Control.
  • Coexistence and Upgrade:
    • If Wonderware Application Server and the InTouch HMI are installed on the same node, they both must be upgraded to Application Server 3.5 and Wonderware InTouch HMI 10.5, respectively.
    • You must install Wonderware Historian 9.0 Patch 02 or Historian 10.0 or later to take advantage of new Historian features including time propagation and late data from the Wonderware Application Server to the Historian. These versions are also required to leverage the new Historian configuration options from the IDE.
    • If the ArchestrA IDE connects remotely to the Galaxy Repository on another computer, apply Wonderware Application Server 3.5 to both nodes. A remote connection between the ArchestrA IDE and the Galaxy Repository fails if the nodes are at different versions of Wonderware Application Server.
    • It is strongly recommended that you undeploy the platform prior to upgrading the software in that node. Once the GR node is upgraded from any prior version to version 3.5, all run-time nodes hosting InTouch applications must be upgraded both to Wonderware Application Server 3.5 and to Wonderware InTouch HMI 10.5 (if you are running InTouch applications). You will not be able to deploy or undeploy objects on non-upgraded nodes. Installing the software on a run-time node will remove the running platform and objects. The platform and objects can then be redeployed after the software upgrade is complete.
  • Alarm DB Logger:
    • In order to use the Alarm DB Logger, you need to set the default SQL Server authentication mode from Windows-based to Mixed Mode. See L00116459 under Installation Issues for more information.
    • Results can be inconsistent if you attempt to log alarms from both InTouch and the Galaxy with Application Server and InTouch running in a console session on the same node under Windows Vista, Windows 7, or Windows Server 2008 operating systems. We do not recommend running both InTouch and Application Server in a console session on the same node.
  • Language Switching - Galaxies with ArchestrA Symbols or InTouchViewApp Objects containing ArchestrA Symbols that leverage the Runtime Language Switching functionality must always be modified on the same language operating system and InTouch language version, on which it was initially developed. Attempts to modify these components in a different language operating system or a different InTouch language version may result in unexpected behavior and is not presently supported. Published applications running in an operating system language that is different from the originally developed language are supported.
  • Antivirus Exclusions - The antivirus software exclusions list has been updated. Click this Antivirus Software Exclusions link for details.
  • Remote Sessions - Windows Server 2008 R2 no longer supports the /console switch as a means of setting the remote desktop client (RDC), also known as a console session. Click this Terminal Services Behavior in Windows Server 2008 link for further information about terminal services behavior changes.
  • Multiple Network Cards - Using multiple network interface cards (NICs) in Windows Server 2008 R2, as with Windows Vista, requires specific configuration.
  • License Utility - Starting the ArchestrA Licensing Utility from an existing License CD may not work on a 64-bit operating system. Start the utility from the installed shortcut instead.
  • Operating System Restrictions - All the restrictions applicable to Windows Vista and Windows Server 2008 are also applicable to Windows 7 and Windows Server 2008 R2, respectively.

About Wonderware Application Server 2012 (version 3.5)

The release of Wonderware Application Server 2012 (version 3.5) includes the following enhancements and new features:

  • Buffered Data Support: The Buffered Data Support feature enables data updates from field devices, which support Buffered Data Value Time Quality tag data, to be accumulated and propagated efficiently to data consumers such as objects, alarms, and Historian without losing the buffered data between engine scans.
    Buffered data is defined as data captured and stored locally on a remote device for later transfer to a supervisory system for processing, analysis, and long-term storage.
  • Node-to-Node Version Protection: The Node-to-Node Version Protection feature provides a mechanism to identify and synchronize object components on a client that falls out of sync with the deploying Galaxy Repository node. Deployed object components of the client node are synchronized with the connected Galaxy Repository on the Server node.
  • Import Enhancements: A new Import Object Type Filter will restrict overwriting objects during an import operation, regardless of user preference options, based on the import overwrite restriction configuration.
  • Enhancements to Toolkits: The Wonderware Application Server Toolkits (GRAccess, MXAccess and ArchestrA Object Toolkit) support the new Buffered Data Support feature.
  • Platform Deployment Enhancements: You can now modify and test WinPlatform by deploying it without deploying its hosted objects. A configurable option permits a choice of whether or not to cascade deploy the platform object.
  • Associate All Galaxy Graphics with an InTouchViewApp Template: Associating all Galaxy graphics with an InTouchViewApp template enables deployed and published InTouch applications to execute "show graphic" requests made of any graphic in the Galaxy without having to embed them in the application.

< top of document >


Antivirus Software Exclusions

After installing Wonderware Application Server, configure your antivirus software to prevent archive files from being scanned.

NOTE:
  • Ensure that subfolders of the listed directories are also excluded.
  • If you are using a 64-bit operating system, folder names must be specified accordingly. For example, the program files root directory in a 64-bit operating system is C:\Program Files (x86)\... and the application data root directory in a 64-bit operating system is C:\ProgramData\...
Antivirus software should not scan files in the following ArchestrA folders:
  • C:\Program Files\ArchestrA\*.*
  • C:\Program Files\Common files\ArchestrA\*.*
  • C:\Program Files\FactorySuite\*.* (may not exist in newer installations)
  • C:\Program Files\Wonderware\*.*
  • C:\InSQL\Data\*.*
  • C:\Historian\Data\*.*
  • C:\Documents and Settings\All Users\Application Data\ArchestrA*.*

From Wonderware Application Server Platform objects:

  1. History Store Forward directory default location:
    • C:\Documents and Settings\All Users\Application Data\ArchestrA\
    • C:\Users\All Users\ArchestrA\
  2. Checkpoint directory location default location:
    • C:\Program Files\ArchestrA\Framework\bin
    • C:\Program Files (x86)\ArchestrA\Framework\bin
  3. InTouch Application folder path:
    • C:\Documents and Settings\All Users\Application Data\ArchestrA\
  4. SMC Logger Storage file path:
    • C:\Documents and Settings\All Users\Application Data\ArchestrA\LogFiles\
  5. SQL Server database files of type:
    • .mdf
    • .ldf

< top of document >


Minimum Hardware Requirements

The following list shows the minimum computer hardware requirements to host Wonderware Application Server 3.5 on both 32-bit and 64-bit systems. The Intel Itanium 2 processor is not supported.

Application Server Galaxy Repository or ArchestrA System Platform 2012 Combination of Products

  • The recommended operating system for a Galaxy Repository is Windows 2008 R2 SP1.
  • SQL Server 2008 SP1 Standard or Enterprise (32-bit) is the only supported version at this time.
Hardware Requirements Small
(1 - 5,000 I/O)
Medium
(5,000 - 20,000 I/O)
Large
(> 20,000 I/0)
CPU (GHz) 2 2.5 2.5
Minimum Cores 1 2 4
RAM (Min GB) 2 4 8
Hard Disk size
(Available in GB)
100 250 500
Monitor 1024 x 768 1280 x 1024 1280 x 1024
Network card (MBPS) 100 100 1000

Input Devices
     
DVD drive for installation      
Keyboard      
Mouse or compatible pointing device      

Application Server Development or Run Time

  • The recommended operating system for development (IDE) or run-time nodes (Bootstrap) is Windows 7 SP1.
Hardware Requirements Small
(1 - 5,000 I/O)
Medium
(5,000 - 20,000 I/O)
Large
(> 20,000 I/0)
CPU (GHz) 2 2.5 2.5
Minimum Cores 1 2 4
RAM (Min GB) 2 4 4
Hard Disk size
(Available in GB)
100 100 100
Monitor 1024 x 768 1280 x 1024 1280 x 1024
Network card (MBPS) 100 100 1000

Input Devices
     
DVD drive for installation      
Keyboard      
Mouse or compatible pointing device      

The hardware requirements for using the Alarm Client and Trend Client at run time are the same as for the InTouch HMI version 10.1 run time. Windows 7 and Windows Server 2008 R2 operating systems and SQL Server 2008 impose hardware requirements that may exceed the minimum requirements for Wonderware Application Server 3.5. If you intend to install Wonderware Application Server 3.5 on a computer running Windows 7, Windows Server 2008, or SQL Server 2008, see the following Microsoft Web sites for hardware requirements:


www.microsoft.com/windowsserver2008/en/us/system-requirements.aspx

www.microsoft.com/windows/windows-7/get/system-requirements.aspx

msdn.microsoft.com/en-us/library/ms143506.aspx#EE32

< top of document >


Software Requirements and Compatibility

This section describes the operating system, database, and other software requirements to install Wonderware Application Server 3.5, along with product compatibility.

Operating Systems

  • For server components: Windows Server 2008 R2 is the recommended operating system for computers running server components.
  • For client components: Windows 7, 64-bit, is the recommended operating system for computers running client components.

The following table lists the supported operating systems that can be installed on computers running as Wonderware Application Server development, application, and GR nodes. Development and application nodes are considered to be clients of the server GR node.

Operating Systems Wonderware Application Server Components
ArchestrA IDE
(Development Node)
ArchestrA Run time
(Application Node)
Galaxy Repository
(GR Node)
Windows XP SP3
Professional
(32-bit)
Y Y N
Windows Vista SP2
Business or Ultimate
(32/64-bit)
Y Y N
Windows 7
Professional or Ultimate
(32/64-bit)
Y Y N
Windows 7 SP1
Professional or Ultimate
(32/64-bit)
Y Y N
Windows Server 2003 SP2
Standard or Enterprise
(32-bit)
Y Y Y
Windows Server 2008 SP2
Standard or Enterprise
(32/64-bit)
Y Y Y
Windows Server 2008 R2
Standard or Enterprise
(64-bit)
Y Y Y
Windows Server 2008 R2 SP1 (Standard, Enterprise)
(64-bit)
Y Y Y

Operating System Notes

  1. The computer designated as the Galaxy Repository node can run on Windows XP Pro only as a single-node configuration of Wonderware Application Server. Windows Server 2008 R2 is the recommended operating system for the GR node.
  2. The Bootstrap, IDE, and Galaxy Repository are supported by the following language versions of Microsoft operating systems: English, Japanese, Simplified Chinese, German, and French. The Galaxy Repository is also supported by the English, Japanese, Simplified Chinese, German, and French versions of Microsoft SQL Server 2005 and SQL Server 2008 SP1.
Support for Windows Operating System User Access Control

Application Server versions 3.1, 3.1 SP1, 3.1 SP2, 3.1 SP2 Patch 01, 3.1 SP3, 3.2, and 3.5 support User Access Control-enabled run-time operations without elevated privileges.

For all configuration and installation operations, including those called during run-time operations, User Access Control must be disabled or privileges must be elevated to the required level.

DDE Support

In Windows Vista, Windows Server 2008 and later operating systems, DDE is supported only on a local node. Windows Server 2008, as with Windows Vista, does not support NetDDE. ArchestrA Symbols use the client layer when accessing InTouch tags and appear as a third-party client trying to access WindowViewer as a data server. Therefore the use of NetDDE for communication is not supported and not recommended.

In ArchestrA Symbols, InTouch:<tagname> is still a valid method of referring to an InTouch tag on a local node.

Product Compatibility

Wonderware Application Server 3.5 is compatible and can co-exist with the following products:

Product Version Compatibility Co-existence
Wonderware InTouch HMI 10.5 Y Y
Wonderware InTouch HMI 10.1, 10.1 SP2 P01, 10.1 SP3, 10.2 Y N
Wonderware Historian Client 10.0 SP1 Y N
Wonderware Historian Client 10.0 SP2 Y Y
Wonderware InTouch CE 10.1 N N
Wonderware Historian Server 10.0 SP1 Y Y
Wonderware Manufacturing Execution System 4.0, 4.0 SP1 Y Y
Wonderware Information Server 4.0, 4.0 SP1 Y N
Wonderware Information Server 4.5 Y Y
Wonderware InControl&#153 7.11 SP2 P01 Y Y
Wonderware Manufacturing Execution Module 1.0 Y Y
Wonderware InBatch&#153 9.0 SP1, 9.0 SP2, and 9.5 Y Y
Wonderware QI Analyst&#153 8.0 SP2 Y Y
Wonderware SCADAlarm&#153 6.0 SP2 P01 Y Y
ArchestrA Workflow&#153 1.1 Y Y
Wonderware Intelligence 1.5 Y Y

In some cases, Wonderware Application Server 3.5 is supported in newer environments than a compatible product. Wonderware Application Server 3.5 has been tested for compatibility with a listed product only in the environments that are supported by that particular product.

SQL Server Requirements

SQL Server Database Requirements

Microsoft SQL Server 2008 SP1 is supported by Wonderware Application Server 3.5. You must use the Standard SQL Server 2008 SP1.

  • SQL Server 2008 SP1 must be installed on the computer designated as the ArchestrA Galaxy Repository node prior to installing Wonderware Application Server Galaxy Repository feature.
  • If multiple versions of SQL Server are installed, the one utilized as the Galaxy Repository must be the default instance.
  • The Galaxy Repository locks the SQL Server maximum memory usage to 65% of the computer's physical memory.
  • TCP/IP must be enabled on the computer hosting a SQL Server 2008 database. The TCP/IP protocol setting can be verified from the SQL Server Network Configuration under SQL Server Configuration Manager.
  • In order to use the Alarm DB Logger with SQL Server Express, you need to change the default authentication mode from Windows-based to Mixed Mode.
Upgrading SQL Server on the Galaxy Repository Node

When upgrading SQL Server on the Galaxy Repository node, back up the Galaxy before starting the upgrade. Upload any run-time changes for critical objects. You cannot upload any run-time changes after you upgrade the system. For more information, see Upgrading to Wonderware Application Server 3.5 and Galaxy Repository Node Upgrade. Also see the Application Server Installation online Help.

SQL Server Rights Requirements

SQL Server 2008 does not automatically create the BUILTIN\Administrators role delivered in SQL Server 2005. Because of this change to SQL Server, the Wonderware Application Server 3.5 installation process will create the necessary operating system user group (aaAdministrators) as well as the necessary SQL Server role. This automated process will provide the rights required to allow operations within the Galaxy Repository without the need for blanket BUILTIN\Administrator rights. The aaAdministrators group must be present and enabled. If you accidentally delete the aaAdministrators group from the Windows operating system, you can run either of two options to restore it:

  • Run the Change Network Utility from the Windows Start menu.
  • Run the aaConfig SQL Utility from the Windows Start menu.

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 Wonderware Application Server User's Guide, About ArchestrA User Accounts, for further information and procedures about restoring the aaAdministrators group.

Other Software Requirements

The other third-party software required for Wonderware Application Server version 3.5 is Microsoft .NET Framework 3.5 SP1. This must be installed on every computer that hosts a Wonderware Application Server component. The GR node will require .NET Framework 3.5 SP1 if it is being installed with SQL Server 2008 as .NET Framework 3.5 SP1 is a SQL Server 2008 prerequisite. Wonderware Application Server 3.5 has been validated with .NET Framework 3.5 SP1.

Alarm Client and Trend Client Requirements

If you want to trend data from the Wonderware Historian (formally known as IndustrialSQL Server), version 9.0 or Wonderware Historian 10.0 is required.

The Trend Client is compatible with the following Wonderware products:

  • Wonderware InTouch HMI 10.1, 10.1 SP2, 10.2 and 10.5
  • Wonderware Application Server 3.1, 3.1 SP1, 3.2, and 3.5
  • Wonderware Historian 9.0 and 10.0
  • ActiveFactory 9.2 and Wonderware Historian Client 10.0 SP1 and SP2
  • QI Analyst 8.1

< top of document >


Using Wonderware Application Server with Windows 7 and Windows Server 2008 R2

This section describes specific behaviors and restrictions when using the Windows 7 and Windows Server 2008 R2 operating systems with Wonderware Application Server.

  • In ArchestrA, when the DDESuiteLinkClient is connected to the local DAServer using DDE, it does not work with User Access Control enabled. The same works when User Access Control is disabled.
  • For toolkits such as the ArchestrA Object Toolkit, GRAccess Toolkit, and MXAccess Toolkit to function properly on Windows Vista and later operating systems, you may need to start the toolkit by right-clicking on the file and then clicking Run As Administrator.
  • Wonderware Application Server may experience performance degradation when running on the Windows 7 or Windows Server 2008 R2 operating systems, depending on how certain operating system tuning parameters are configured. For more information, see Tech Note #719.
  • Using multiple NICs in Windows 7 and Windows Server 2008 R2 operating systems requires specific configuration. For more information, see "Configuring Multiple NICs for the Vista and Windows Server 2008 Operating Systems" in the Wonderware Application Server User's Guide.

Terminal Services Behavior in Windows Server 2008

In a change from Windows Server 2003, Windows Server 2008 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. In Windows Server 2008, Session 0 is no longer an interactive session, and is reserved only for Windows services. Windows Server 2008 treats all remote connections as remote RDP sessions regardless of /console, /admin, or any other switches used to make the connection.

This impacts InTouch functionality such as Alarm Manager that depends on the Terminal Server Console session. Refer to the Wonderware InTouch HMI 10.2 Readme for further information about InTouch applications running in the Terminal Server Console. The impact to Wonderware Application Server is minimal as most Wonderware Application Server processes run as services. One impact to Wonderware Application Server is to carry forward the restriction introduced with the Windows Vista operating system which permits only one alarm provider. While both Wonderware Application Server and InTouch can be configured as alarm providers, only one alarm provider can be configured at any one time.

Wonderware Application Server and InTouch detect when the application is running in the console. In Windows Server 2008 R2 it implies that the application was started by a user physically at the machine. However, this behavior requires that you disable Fast User Switching in both Windows 7 and Windows Server 2008 operating systems.

To disable Fast User Switching in Windows 7 or Windows Server 2008 R2, use the following procedure:

  1. Click Start, then Run, and enter gpedit.msc in the text box. Press Enter.
  2. Go to the following location: Local Computer Policy\Administrative Templates\System\Logon.
  3. Set Hide entry points for Fast User Switching to Enabled.
  4. Exit the Group Policy Editor.

By enabling the policy, Administrators hide the Switch User button in Windows logon, in the Start menu, and in the Task Manager. Note that the Group Policy Editor does not exist in certain editions of Windows 7. Alternately, you can configure the setting by editing the Registry.

  1. Click Start, then Run, and enter regedit.exe in the text box. Press Enter.
  2. Navigate to the following branch: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System.
  3. Create a DWORD (32-bit) Value named HideFastUserSwitching.
  4. Set the Value data for HideFastUserSwitching to 1.
  5. Exit the Registry Editor.

< top of document >


Upgrading to Wonderware Application Server 2012 (version 3.5)

After the hardware and software requirements are met, including the proper operating system, SQL server and other pre-requisites, you can upgrade to Wonderware Application Server 3.5 from the following versions of Wonderware Application Server:

  • Version 3.0 SP2
  • Version 3.1 (All service packs and patches)
    • 3.1
    • 3.1 SP1
    • 3.1 SP2
    • 3.1 SP2 PO1
    • 3.1 SP3
    • 3.1 SP3 PO1
NOTE: Upgrading to Application Server 3.5 will affect run-time nodes. Node-by-Node upgrade is supported with limitations. Changing the security or history model in a node-by-node upgrade of the run-time nodes is not supported. Nodes that are currently deployed will not receive any history or security changes from the upgraded GR node.

Wonderware Application Server 2012 (version 3.5) Upgrade Requirements

The following requirements apply when upgrading existing Wonderware Application Server components to version 3.5:

  1. Upgraded IDE/Client nodes cannot connect to a non-upgraded Galaxy Repository (GR) and vice-versa.
  2. The GR Node will be undeployed before upgrading to Wonderware Application Server 3.5.
  3. Running platforms must be undeployed during the upgrade process.
  • WinPlatform and other related objects on a remote node will be marked as "software update pending".
  • You will not be able to deploy from an upgraded GR node to non-upgraded remote nodes.

Galaxy Repository Node Upgrade

Important: Back up the Galaxy before starting the upgrade. Also, upload any run-time changes for critical objects. You cannot upload any run-time changes after you upgrade the system. For more information, see the Application Server Installation online Help.

The basic upgrade sequence is:

  1. Upgrade your software prerequisites to the required versions.

  2. Important: If you are upgrading the SQL Server on the Galaxy Repository node, you must undeploy the Galaxy Repository node before starting the SQL Server upgrade.
  3. Upgrade the Application Server software in the Galaxy Repository node to the current version.
  4. Upgrade at least one IDE installation. If the Galaxy Repository node has the IDE as a feature, then the IDE is also updated. However, if you have any IDE-only nodes, you need to upgrade them separately.
  5. Use the upgraded IDE to connect to the upgraded Galaxy Repository node and migrate the Galaxy database. For more information, see GR Node Migration.
  6. Deploy the Galaxy Repository Platform.
  7. Upgrade run-time nodes.
  8. Upgrade non-redundant run-time nodes one at a time and redeploy them.

  9. Important: Redundant nodes must be upgraded together. You cannot leave one node running, while the other one is being upgraded.
  10. Upgrade redundant pairs as a set.

If you upgrade a remote Platform node before you migrate the Galaxy database, the remote Platform and hosted objects show the software upgrade pending icon after you migrate and deploy the Galaxy. To resolve this, undeploy and redeploy the remote Platform. The preferred sequence of upgrade is to upgrade the Galaxy Repository node, migrate the Galaxy database, and then upgrade the remote Platforms.

< top of document >


Migrating to Wonderware Application Server 2012 (version 3.5)

You can migrate applications from the following earlier versions of Wonderware Application Server to version 3.5:

  • Version 2.1 PO2
  • Version 3.0 SP2
  • Version 3.1 (All service packs and patches)
    • 3.1
    • 3.1 SP1
    • 3.1 SP2
    • 3.1 SP2 PO1
    • 3.1 SP3
    • 3.1 SP3 PO1
  • Version 3.2

GR Node Migration

While migrating the GR Node, the existing database schema is migrated to the new version 3.5 schema. The GR node migration fails if the GR node is used as a run-time node for another GR.

< top of document >


Resolved Issues - Wonderware Application Server 2012 (version 3.5)

This section describes important resolved issues in Wonderware Application Server 3.5. The following list is not a comprehensive list of all resolved issues.

L00111263: HF CR L00110348 (Hotfix 2357) SR 15315947: During the creation of a test Galaxy, when you open the template and run it on ArchestrA IDE, the correct symbol is displayed. However, when you deploy the instance and run it on WindowViewer, then an incorrect symbol is displayed.
L00111626: HF CR L00109139 (Hotfix 2254) SR 22316915: During RDI (Redundant DI object) failover, the total number of items in the SMC\Client Groups and Device Groups do not match with the number of RDI items.
L00111631: HF CR L00111464 (Hotfix 2416) SR 33811636: Galaxy Dump crashes ArchestrA IDE, and the following error message appears in the SMC Logger:
Error when trying to refresh proxies -No connection could be made because the target machine actively refused it 127.0.0.1:8090
L00111640: HF CR L00111068 (Hotfix HF2403) SR 103120006: When you click a symbol button that is configured with the ShowSymbol animation script and a pop-up dialog box, the symbol appears. After entering text in the dialog box, when you close the symbol, the symbol button still remains selected.
L00111722: HF CR L00111418 (Hotfix 2425): After deployment or failover of DDESL (DDESuitelink) object, some items are displayed as good and some as bad. Items whose values should be displayed as good are stuck at initializing. After the value of the item is updated in the field device, it is displayed as good in the DDESuitelinkClient object. Some items whose values should be displayed as bad are also stuck at initializing.
L00111969: HF CR L00111725 (Hotfix 2425) SR 22316791/37111660: Double polling occurs in RDI even after ACM (Advanced Communication Management) is disabled by following Hotfix 2033.
L00112580: HF CR L00110749 (Hotfix 2383) SR 103119448: On engine failover, RDI cannot connect to DI sources and the platform communication errors appear. After the failover of an engine hosting OPC client objects and another hosting the RDI object, RDI shows one OPC client object to be connected and the other to be disconnected.
L00112581: HF CR L00102633 (Hotfix 1900) SR 22316050: The engines restart automatically and the same process ID is associated to the engine name. Hence it seems that their private byte memory leaks after installing Hotfix 1676C.
L00112613: HF CR L00110688 (Hotfix 2379) SR 103120710: When you request a tag through View, the tag opens but does not close. For every tag that is left open, ScanGroupRuntime reports the following message:
<tagname> was already deleted due to reentrancy from data provider
L00112617: HF CR L00109819 (Hotfix 2325): When a block is edited and checked in within the ArchestrA IDE, then the objects remain in the memory and they are released only when the operation completes.
L00112619: HF CR L00108335 (Hotfix 2200) SR 103119265: After the switchover of a redundant AppEngine, the redundant DIObject does not set some items to active state.
L00112622: HF CR L00111832 (Hotfix 2463) SR 38231298: The changes made in a parent template do not transmit to its derived/child objects.
L00113007: HF CR L00110198 (Hotfix 2352) SR 23333459: The ArchestrA graphic symbol changes its position or becomes bigger, and then becomes small after a few hours or days on its own.
L00113077: HF CR L00112646 (Hotfix 2493) SR 103121180: When you point to an RDI object, double advisement is required.
L00113406: HF CR L00112999 (Hotfix 2507) SR 15315956: When a template object is imported into a customer’s test Galaxy from SI’s (System Integrator) test Galaxy, then the deleted objects also get imported. However if the template object is imported into another Galaxy, the deleted objects are removed.
L00113415: HF CR L00098344 (Hotfix 2480) SR 19417204: The Config Set Handler code stops working on an instance that is derived from a template that is derived from the base template built by the ArchestrA Object Toolkit.
L00114446: HF CR L00113943 SR 103121317: If a graphical object has an embedded object with text substituted at the host level, then the XML file creates a code similar to the following:

<Context>MySymbol:txt_test1;StringSubstitution;NovaString:-&gt;Translation</Context>

If any of the text strings (NovaString or Translation) contains a colon or a semicolon, the code is broken, the object translation import fails, and an error appears.

L00114500: SR 19417537 If the network address of the platform uses an alias in the hosts file that is different from the NetBIOS name of the target computer, the deployment status in the IDE is not updated and the Platform Manager does not get an update for the run-time status.

This issue has been fixed. The platform's alias name must be included in the hosts file on both on the GR node and target node in the following format.

<IPAddress> <AliasName>

L00115103: HF CR L00114486 SR 33932491: The deployment of an InTouchViewApp takes more than 40 minutes and when the deployment is complete, many graphics are missing.

< top of document >



Known Issues - Wonderware Application Server 2012 (version 3.5)

This section describes important known issues identified in Wonderware Application Server 3.5.



L00069519: In a redundant load sharing environment, the cascade deployment of a backup platform does not deploy InTouch ViewApp instances, if the redundant AppEngine has InTouch proxy objects configured. Backup redundant object errors are logged.

After the InTouch ViewApp deploy fails, it can be manually re-deployed.
L00076557: Opening and closing a view window when "Advanced Communication Management" is enabled for the Galaxy may cause a different timestamp to be returned for the attribute from the DAServer, even though nothing has changed on the device.
L00077487: During tag registration, Wonderware Historian discards the value for SampleCount (isSamples) provided by Application Server.

Before installing Wonderware Application Server 3.1, apply Wonderware Historian 9.0 Patch 02 to resolve this issue.
L00077490: Importing a client control from a Galaxy imports another version of the same client control if the other version resides in a different Galaxy on the same node.
L00078221: After you migrate an Application Server 2.1 application to Application Server 3.0 or later, the wrong value is returned for the .NET ToLocalTime() function.

Application Server 2.1 supports .NET 1.1, while Application Server 3.0 supports .NET 2.0. The DateTime structure in .NET 2.0 includes a new Kind property that indicates whether the time represents a local time, a Coordinated Universal Time (UTC), or whether UTC or local time is not specified. For more information, see the following Microsoft documentation: http://msdn.microsoft.com/en-us/library/system.datetime.aspx

To migrate an Application Server 2.1 application to version 3.0 or higher, you must modify scripts that use the ToLocalTime() function. Use the new Kind property (DateTime.KindProperty) and specify the time before you run the ToLocalTime() function. For example:

dim aTime as System.datetime;
dim aTime2 as System.DateTime;
aTime = me.lastpolltime;
aTime = system.datetime.SpecifyKind(aTime, system.dateTimekind.utc); me.locallastpolltime = aTime.tolocaltime();
L00078446: The ArchestrA Symbol Editor stops responding when you edit the "format string" property of the "checked list box" client control.
L00078465: Dates earlier to 1970 are not valid for purposes of the LogDataChangeEvent() script function. Using a date earlier than 1970 sends a warning message to the logger.

Use a date on or after 1/1/1970 when using the "LogDataChangeEvent()" script.
L00079595: Attempting to import a client control with the ArchestrA IDE fails if the file is located at a remote network location. Copy the client control file to the local computer where the ArchestrA IDE is installed to import operation.
L00081837: The following error message appears when a non-upgraded IDE node (earlier than Wonderware Application Server 3.0 SP2) tries to connect to an upgraded Galaxy Repository node. Error message: "IDE cannot connect to remote GR node <name> because it is an older version <number> than this IDE version supports."
L00083270: Spaces are not imported as part of the translation for the selected language.
L00083909: InTouch applications receive Quality Status and Locale information from the deployed Galaxy. InTouch applications cannot receive data from an undeployed Galaxy.
L00084306: StringFromTime() results are different in InTouch and Application Server. InTouch converts a timestamp given in UTC time to local time and returns the result as a string. This function takes Daylight Saving Time into account. The ArchestrA StringFromTime function still returns the time as GMT. Also, if you change the time zone while WindowViewer is running, the new time zone is not taken into consideration for script functions. On restart of the WindowViewer, the new time zone is taken into account for the script functions. This behavior occurs because time zone information is set during the view initialization.
L00085806: The font used for graphics in ArchestrA symbols does not render properly in the Symbol Editor and on print outs, if the DPI of the screen or printer is less than or greater than 96-dpi.

Wonderware does not support running the product in DPIs other than 96 DPI.
L00086242: Unable to connect to test server nodes when using the SuiteLinkDDEClient object and trying to connect to a local server on Windows Vista. Connection is successful to the Windows XP and Windows Server 2003 nodes. The issue does not occur if you put "localhost" in the node name of the DDESuiteLink DI object.
L00087046: An embedded symbol is lost after swapping symbol names. VERL (Visual Element Reference List) corruption is artificially causing a circular reference.
L00087247: InTouchViewApp fails to undo a checkout when there is a file-lock within the CheckOut folder. You should not attempt to check-in the InTouchViewApp.

Fix the file-lock issue, and perform the "undo-checkout" again.
L00087305: When you rename a referenced symbol while an object editor is open, the reference to the renamed symbol may be lost.
L00087471: The background reference binding thread may stop processing because of a database connection failure. The following message is logged in the System Management Console: "Warning WWCdi CRefString(TagName Validation). Database connection is no longer valid."

You must restart the aaGR.exe process to reestablish the connection to the database server.
L00087752: You must restart the aaGR.exe after you import an object with a minor version increment, if the object is written in .NET.

The issue may occur for ApplicationObjects written in .NET with the ApplicationObject Toolkit 3.1, versus ApplicationObjects written with an older version of the ApplicationObject Toolkit.

Restart of the aaGR.exe is required if all of the following apply:
  • DotNetAppObject version 1.0 is loaded in the Galaxy
  • An object vendor creates a new minor version of DotNetAppObject version 1.1
  • An IDE user imports the new .aaPKG file with DotNetAppObject version 1.1 into the Galaxy that has DotNetAppObject 1.0 loaded.

    You must restart aaGR.exe for the new object to be recognized and deployed to the IDE nodes.
  • L00089937: Importing a major version of an object instance that is on a platform which is currently deployed will result in aaPIM logged messages. To resolve the issue, the platform hosting the object must be undeployed to clear the errors.
    L00092635: Application Server 3.1 SP2 will import an alarm comment file for language switching of format Galaxy_ACLSGalaxy1_2058_Alarm_Comments_Untranslated.txt but InTouch WindowMaker doesn't recognize the file. This behavior is as-designed. InTouch will only recognize file format %_AlarmComment.txt. The option to export untranslated comments was provided in Application Server in order to diagnose and verify quickly whether all translations for a specific locale have been done, and to manage or find untranslated alarm messages in large galaxies. This functionality was provided as value added for Wonderware Application Server, but was not required for InTouch.
    L00092675: In the alarm comment run-time language switching feature, the PhraseId can go out of sync in exported files for the same alarm message in different languages. This does not cause problems in exporting or importing alarm messages into the Galaxy, but it can lead to a failure in InTouch to switch the alarm comment language in run time. Alarms for which the PhraseId does not match between the different languages will not switch. Instead of showing the translated message, the default alarm message, in English if the Galaxy was created in English, will be displayed.

    The Lang.dll in InTouch has been modified to log a warning in the SMC that the current alarm message does not match across translated languages. The message recommends that you re-export all the languages of the conflicting file from the Galaxy, and re-import them to the InTouch application. The conflicting file name will be part of the message. We recommend that you keep all the translated exported language files in sync.

    L00093428: In Windows Vista and higher operating systems, the DDE cannot communicate across sessions. This is a User Interface Privilege Isolation (UIPI) issue. For example, with Wonderware Application Server running in Session 0 as a service, Excel would run in a session other than 0, a User interactive session. In this scenario, DDE is not able to communicate across the session. SuiteLink can work in place of DDE under certain conditions.
    L00093558: When you upgrade from Wonderware Application Server version 2.5 to version 3.1 SP1, the following error message appears: "ArchestrA.Configuration.PackageServerNet.PackageServerNet instance not properly disposed." The error message is informational. No action is required.
    L00093559: The calendar control in the graphic editor is drawn with different size fonts on different operating systems. For example, the sizes shown are different on Windows Server 2003 and 2008 operating systems. The size of the calendar control does not change when you change the font on the Windows Vista operating system. If a symbol with calendar control is saved in a Windows Server 2003 system and then opened in a Windows Server 2008 system, the size changes after export and import. This affects the symbol layout as well. As a workaround, ensure that your operating system themes are consistent in screen resolution, DPI, icon size, and font size settings.
    L00095432: After Installing ArchestrA products such as InTouch, InTouch CE, Application Server, InSQL, and ActiveFactory 9.2, some DAServers cannot be installed. During the DAServer installation, a Prerequisite Setup Error appears, "Rainbow Sentinel setup failed to complete successfully." The issue does not occur if the DAServers are installed first and then ArchestrA products are installed. This issue will be addressed in future DAServers releases.
    L00095452: The Reactor_Demo_Application_Server displays name conflict errors while attempting to enable history for several $ReactorSet.Reactor field attributes such as ConcPump and ConcValve. The issue appeared in Wonderware Application Server 3.1 which added the capability in the Extensions section to add a description in the history extension. This modification has created a conflict with field attributes and object graphics.
    L00095695: When using Microsoft SQL Server 2008 Development Edition, the GR service fails to connect and freezes. This issue occurs because the Development Edition of SQL Server, which is not supported by Wonderware Application Server, does not enable TCP/IP service by default.
    L00095744: The Microsoft OLE DB provider for Oracle and neither Driver do Microsoft Access[*.mdb] nor Driver do Microsoft Excel[*.xls] are visible in a Windows Server 2008 64-bit SP2 Standard Edition operating system with SQL Server 2008 SP1 installed. These drivers are 32-bit drivers and are not visible in a 64-bit system directly from Control Panel, Administrative Tools, DataSources(ODBC). You can create ODBC connections by running C:\Windows\SysWOW64\odbcad32.exe. This is a 32-bit application, which will display 32-bit drivers. This issue does not occur on 32-bit systems.

    Microsoft does not provide a 64-bit OLE DB Provider for Oracle. Oracle provides a separate OLE DB Provider for use on 64-bit systems.

    L00097202: Memory use rapidly grows when running an application that has InputSource changes every 5 seconds (200 UDAs) and BindTo changes every 10 seconds. Due to a synchronous script timeout, the code does not clean up the local indirect created at the time of script execution, which increases the size of the reference table in the LMX and leads to the memory leak.

    There are three possible workarounds to stop the memory leak:

    1. Declare the array of indirect into the Declarations section rather than inside the script.
    2. Reduce the sleep time inside the script or increase the Maximum time for script to execute in the engine configuration, so that script does not timeout.
    3. Use the asynchronous script with an appropriate timeout limit.
    L00097788: Existing license CDs have issues running aaLicView.exe in a 64-bit operating system and will not correctly install a license. You must use the license utility installed with the Wonderware Application Server or InTouch software.
    L00098305: After upgrading the GR node, a Deploy/Un-deploy attempt on a non-upgraded remote platform undeploys InTouchViewApp and ViewEngine assigned under the non-upgraded Remote platform.
    L00098946 With Scan on Demand (SOD) enabled, if an item is activated, deactivated, then reactivated it will return the last value available before it was suspended rather than the current live value. This behavior does not occur if SOD is disabled.
    L00099445 With SQL Server 2008 installed, and Wonderware Application Server 3.1 SP2 installed (IDE and Bootstrap only), attempting to add a Galaxy Repository using Modify, add GR (Add/Remove Programs, Change option) fails as the Add GR option does not automatically run the aaConfigSQL utility. WWCdi and WWPackageServer errors appear in the logger. This occurs only with SQL Server 2008 installed, and only when the initial Wonderware Application Server installation was performed using a local account.

    As a workaround, you can run the aaConfigSQL utility manually prior to running the Modify, Add GR option.

    L00099447 An object attribute with an input extension referring to another object attribute remains suspended after deployment when used in a script. This behavior only happens if the object attribute has no other references and is deployed to the backup engine with the primary engine undeployed. The workaround is to add a reference to the object attribute, such as adding it to a watch window, to trigger the activation so that its value, timestamp and quality can be posted appropriately.
    L00099472 On Windows Server 2008 32/64-bit and Windows Vista 32/64-bit operating systems, with Wonderware Application Server installed from CD media rather than from a network location or local install folder, adding a Galaxy Repository using the Modify, add GR option (Add/Remove Programs) fails to add a GR. Modify fails to find the path to setup.msi. This issue does not occur with Windows Server 2003 SP2.

    As a workaround, you can run the Modify option from the CD image with elevated privileges.

    L00099557 If you create a symbol with two or more custom properties, then modify the values of one custom property in the properties grid, then select the value field of the other custom property to modify it, the second property's value field shows as blank. Any already existing value disappears from the second custom property value field. The value itself is not erased, but is not shown.

    As a workaround, reopen the symbol and use the Custom Properties dialog box to populate the custom property values.

    L00104907: Tooltip animations are not working for WCC controls.
    L00105138: On the Windows Server 2008 and 2008 R2 operating systems, the UI controls for the $WinPlatform derived template do not align correctly.

    Workaround: Right-click Computer and then click Properties. Click Advanced system settings, and then click the Advanced tab. In the Performance area, click Settings. Click to clear the Smooth edges of screen fonts check box.

    L00106038: Errors are logged while deploying PEM objects. Factelligence 3.5 (PEM, FMM, MEM) objects are not supported in the current version of Wonderware Application Server. Upgrade to MES version 4.0 or higher is required.
    L00106046: On Windows Server 2008 R2 64-bit and Windows 7 32-bit operating systems, if you attempt to uninstall Wonderware Application Server while the IDE is open or while connected to a Galaxy, you will see a warning message. If you click Retry, without closing the IDE or Galaxy connection, Wonderware Application Server will continue to uninstall as if you had selected the Ignore option.
    L00106124: Importing objects built in AOT 3.1 or higher, minor version upgrade, can take a long time even if the object is changed only for editor assembly. Use the following steps to create an AOT object with minor version changes which should contain only editor changes and no changes in package logic:
    1. Open the base version AOT 3.1 or higher object in Visual Studio and do the required changes to the editor.
    2. To bump up the <Object name>Editor1.dll file version by modifying the file version information in the AssemblyInfo.cs file in the following example "<Object name>Editor" project:
      assembly: AssemblyFileVersion("1.2.0.0")
    3. To bump up the object's minor version modify the <Object name>.cs file in the following example "<Object name>.cs" project:
      ObjectAttributes.MinorVersion(2)
    4. Rebuild the object to get an object with a minor version change containing changes in the editor only.
    L00106403: If extensions (InputOutput, Input, Output, Alarm, or History) are added to a Field Attribute via the Extensions tab and the Field Attribute is later renamed, the Field Attribute's configuration structure can become corrupted.

    Workaround: Configure Field Attributes using only the options available on the Field Attributes tab in the editor of the $UserDefined object; do not configure a Field Attribute using options from the Extensions tab of the editor.

    L00106782: Certain IDE operations performed under the following configuration are much slower on Windows Server 2008 R2 and Windows7 operating systems than on earlier releases of Microsoft Windows:
    • The GR-node is a member of DomainA.
    • The interactive (logged-in) user on the GR is a member of DomainA.
    • The ArchestrA Network User is an account in DomainB.
    • The network connection to the DomainB Domain Controller is slow (little bandwidth, high latency).

    The following operations may slow down by a factor of 2 or 3:

    • Editing objects.
    • Deploying objects.
    • Deleting objects.

    Workaround:

    1. Ensure the network connection between the GRnode/IDEnode and the domain controller (that the ArchestrA network user is a member of) is fast and has low latency.
    2. Have the Galaxy nodes, the interactive user (logged in user) and ArchestrA Network user all are members of the same domain.

    For more information, see Tech Note #719.

    L00107322: The Windows Server 2008 R2 (64-bit) operating system running on VMware occasionally "locks up" or "hangs," and the user interface is no longer responsive (although tasks may still run in the background). This problem is not related to any software application installed on the computer and can be corrected by upgrading the VMware video driver. To upgrade VMware video drivers, you must upgrade the VMware tools, which includes all the drivers for the system.

    This problem was experienced during testing of this release using the following VMware Software:

    • VMware, Inc. vCenter Lab Manager 4.0 (4.0.1.1233)
    • VMware Tools = Old Version (add/remove programs) = 3.1.2.7193
    • VMware Tools = Old Version (Help/about) = 3.5.0, B123630
    • Video driver version = Old Version (Display properties) VMWare SVGA2 version 11.04.03.0002 (11.4.3.2) 7-28-2008

    The problem can be corrected by upgrading VMware tools and the video driver with the following versions. Note that additional information can be found at the following VMware link: http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1011709.

    • VMware Tools = Upgraded Version (add/remove programs) 8.0.2.14744
    • VMware Tools = Upgraded Version (Help/about) = 4.0.0 B208167
    • Video driver version = New Version (Display properties) VMware SVGA 3D (Microsoft Corporation - WDDM) Version (7.14.1.31) 9-17-2009

    L00107919: When you log on to the ArchestrA System Management Console (SMC) Platform Manager with a newly-created, Active Directory OS Group account for Wonderware Application Server, and that OS Group account does not contain a "Full Name" description, the following error is generated: "User does not belong to any of the configured Roles". This also occurs when you log on to an InTouch application or Object Viewer.

    To work around this issue, log on to the ArchestrA IDE first using the new OS Group account and then log on to the SMC, InTouch application, or Object Viewer.

    L00108399: When saving an object ("myudax0" in this example) that has a User Defined Attribute (UDA) with input extension created using GRAccess with the buffered data property enabled, the follow error message is displayed: Buffered enabled UDA 'myudax0' does not have an input source.

    As a workaround, add the extension in GRAccess with type "inputextension" instead of "InputExtension".

    L00108539: The following message is displayed when AOT tries to connect to a Galaxy from an out-of-sync IDE node even though there are no other clients connected to the same Galaxy:
    Test Galaxy
    Connection to Galaxy 'Test' failed.
    Text: Unknown error.
    CustomMessage: Cannot Synchronize client as other clients are active.
    OK
    As a workaround, synchronize the Galaxy through the IDE first and then start the AOT.
    L00109396: The following warning is logged in IDE and Bootstrap nodes during upgrade of an undeployed galaxy:
    Warning msiexec GetArchestrAInstallPath(): Failed to Read the Registry ArchestrA install path Key."
    There is no workaround required. The error message does not impact the node upgrades.
    L00110185: Remote Platforms are unable to be deployed if the Galaxy Repository and remote nodes have same domain user, but one is specified by the fully-qualified domain name (mydomain.xxx.mycompany.com) and the other by just the domain name (mydomain). The following error message is shown: "Error: Failed to deploy WinPlatform_002 : Remote Node's UserId/Password don't match GR Node's."

    To work around this issue, make sure that the user\domain\password match identically for the nodes. Either both nodes need to use the fully-qualified domain name or both nodes do not.

    L00112178: Objects built using ArchestrA Object Licensing Toolkit (AOLT) version 1.0 are not compatible with Wonderware Application Server 3.5 (2012). You must rebuild the objects with AOLT version 1.1 licensing.
    L00112189: Installing Wonderware Application Server on a computer used as a domain controller is not supported.
    L00113652: If you import objects that have dependencies in scripting to custom DLLs and if these custom DLLs are not present in the Galaxy, these objects being imported are placed in an error condition.

    As a workaround, you can import the custom DLLs used by scripts and validate the objects being imported to resolve this issue.
    L00113709: Objects created in Wonderware Intelligence 1.1 are not compatible with Wonderware Application Server 3.5.
    L00115036: If the identity of a ShowGraphic script is already in use, the graphic opened with that same identity will be replaced. During the replacement process, the OnHide script of that graphic will not be executed.

    As a workaround, use a HideGraphic script or a HideSelf script first to hide the open graphic. Then use a ShowGraphic script to open a new graphic.
    L00115135: In the OPCClient object, the installed DAServers are not listed under the Server Name. For the OPCClient object, the following error message is shown in the SMC log:

    .Net Editor Info - 17:35:14.3125809
    Failed to create instance of OPCEnum on server node COMPST01: 0x80040153

    As a workaround, if you invert the installation sequence by installing the OPC Server first and then the Bootstrap, the OPCEnum is installed without anonymous logon and a remote connection to the OPC Server is possible. You can also resolve this issue by deleting and creating the anonymous logon on the OPCEnum permission.
    L00115589, L00115710, L00116055: Any deployed InTouchViewApp instance that is configured to include all Galaxy graphics is incorrectly marked as pending a change if you:

    • Undeploy an object instance with an inherited graphic.
    • Perform an IDE operation after deploying of an object instance with an inherited graphic. Examples of IDE operations are renaming an instance, editing an instance and then closing without saving, adding a user-defined attribute, and so on. This can done on any object with or without graphics.
    • Import a new client control into the Galaxy.
    • Delete an unused client control (not referenced by any graphic) from the Galaxy.

    L00115681: If you configure an InTouchViewApp object and select the Include all galaxy graphics with this application check box, when you export the object to another Galaxy, the new InTouchViewApp object will not have this option selected. You must manually select the option again.
    L00115869: If a field attribute is configured as buffered and has an input extension to a non-buffered user-defined attribute, the field attribute returns bad quality even though the value updates. In order to get good quality, configure the input extension to a buffered user-defined attribute.
    L00116266: The database transaction log can significantly increase in size after migration of .cab files. As a workaround, use the Galaxy Database Scrubber utility to improve the operating performance of your Galaxy database. Also, you can increase the hard drive size. Follow the guidelines provided under Minimum Hardware Requirements in this Readme.
    L00116279: If there are bad visual element references in an object, warnings occur in the Logger when the object is deployed. To get the name of the object using the visual element ID from the log message, run the following SQL query against the Galaxy Repository database:

    select pri.tag_name ObjectName, pri.primitive_name SymbolName, pri.visual_element_id
    from visual_element_reference ver
    inner join internal_visual_element_description_view pri
    on pri.gobject_id = ver.gobject_id and
    pri.package_id = ver.package_id and
    pri.mx_primitive_id = ver.mx_primitive_id
    where ver.checked_in_unbound_visual_element_name is null
    and ver.visual_element_bind_status = 0
    and pri.visual_element_id = <visual element id>
    L00116317: SR 20114029: If you rename an ActiveFactory control that is used in an ArchestrA symbol before you export the object containing the symbol, and you then import the object into a Galaxy that contains a newer version of the same control, the import of the older control is skipped. By design, if a newer version of a client control already exists in the Galaxy, then the import of an older version of the client control is skipped. However, the control reference in the symbol retains the name change. Because the target Galaxy does not contain a control by this name, the object goes into warning and the "symbol not found" text is shown.

    To avoid this, do either of the following:

    • Make sure that the name of the control matches the version in the target Galaxy before you perform the export.
    • Rename the control in the target Galaxy to match the one in the export file. Make sure that the reference in the symbol is updated after you rename the control.
    L00116381: After opening a ShowGraphic() modal symbol from a container script that takes an expression as input, such as a data change script, all data subscriptions are blocked in the base symbol. As a workaround, open the ShowGraphic() symbol from an action script.
    L00116422: Opening a pop-up symbol from a ShowGraphic() script is different from opening the same symbol from Show Symbol animation, and Window Viewer occasionally hangs on script execution. Although you can use the ShowGraphic() script functions inside container scripts, you cannot use ShowGraphic() in WhileTrue or periodic scripts such as WhileShowing.
    L00116459: A remote node fails to connect to an WWALMDB database that is created using SQL Express Edition.

    Workaround: Change the SQL Server Express authentication from Windows mode to Mixed mode.

    To change SQL Server Express Authentication mode
    1. Download and install the x86 version of SQL Server 2008 Management Studio Express from http://www.microsoft.com/download/en/details.aspx?id=7593.
    2. After installation, right-click SqlExpress Connection, click Properties, and then click Security.
    3. Change the SQL Server Express authentication from Windows mode to Mixed mode and click OK.
    4. Restart the database instance or computer.
    L00116508: Writing to a secured array attribute using the SignedWrite() function can result in a .NET error in WindowViewer. Writing to an array is not supported. Instead, you can write to an array element.
    L00116555: If two pop-up windows open in InTouch WindowViewer, one from a ShowGraphic script and another from a ShowSymbol animation, then you cannot close the pop-up windows.

    Workaround: In the modeless ShowSymbol dialog box, click the Push button with the ShowSymbol animation. This Push button that is already selected changes, and you can interact with ShowSymbol dialog box.
    L00116641: If you attempt to acknowledge an alarm from an Alarm Control list with a Smart Card reader installed, but open the certificate list in the Ack Alarms dialog and remove the smart card, then click the empty certificate list, the system will display an error and fail to acknowledge the alarm.
    L00116828: If you attempt to modify the value of a UDA configured with Secured Write or Verified Write security classification using the MxAccess sample ActiveX control in InTouch, the value will not change as expected. As a workaround, the write to a Secured Write UDA value will succeed after you log on to InTouch with operator credentials. However, this workaround does not affect the issue of being unable to modify the Verified Write UDA value.

    < top of document >


    Wonderware Application Server Documentation Issues

    The following table lists all documentation corrections to Wonderware Application Server 2012 (version 3.5) documentation.

    Item Location of Change Existing Documentation Change
    2 OPCClient Object Help (help.htm),

    "Overview" section
    n/a In the "Overview" section, insert a new subsection "OPC Client Reconnection" (following the existing "Block Reads and Block Writes" subsection):

    Following is the OPC Client connect/reconnect behavior:
    1. When the OPC Client starts, it will immediately attempt to connect.
    2. If the OPC Client is connected and gets disconnected it will immediately try to reconnect, raising the restartCnt by 1. After RestartPeriod it will again attempt to reconnect, again raising restartCnt by 1. When Restart Max is reached, after exactly RestartMax * RestartPeriod seconds, it will raise the RestartAlarm and no further restart attempts will be made.
    3. When the OPC Client connects, it will set RestartCnt to 0 and lower the RestartAlarm.
    4. When ResetRestart is set to true, it will set RestartCnt to 0 and lower the RestartAlarm and attempt to reconnect immediately. If it is already connected, setting ResetRestart will not cause a disconnect followed by a connect.

    When a connection fails, OPC Client will try to connect after each "Restart Period" for "Restart attempts" times. If the "Restart Period" is 20000 ms, it will try to reconnect after 20 sec instead of at each scan period. Because this represents a change from earlier restart connection functionality, you may need to modify the "Restart Period" for "Restart attempts" accordingly.

    < top of document >


    Wonderware Application Server Documentation

    The Wonderware Application Server product library consists of a set of Portable Document Files (PDF) available in the following location in the ArchestrA System Platform DVD:
    \Archestra System Platform\CD-ApplicationServer\UserDocs\English

    You need Adobe Reader installed on your computer to view Wonderware Application Server documentation. You can download the latest version of Adobe Reader from the Adobe Corporation web site:

    http://www.adobe.com/products/acrobat/readstep2.html

    After installing Adobe Reader, double-click on a PDF file with your pointing device to view the book with Adobe Reader. You can also open a book with the Adobe Reader Open command from the File menu. Product documentation is also available with Wonderware Application Server online help.

    Documentation Set

    The Wonderware Application Server documentation set includes the following guides:

    • Wonderware Application Server User's Guide. Explains configuring and deploying Wonderware Application Server applications.
    • Creating and Managing ArchestrA Graphics User's Guide. Explains how you create and manage graphical symbols using the ArchestrA Symbol Editor within the Integrated Development Environment (IDE).
    • Application Server Scripting Guide. Reference for the scripting language in Application Server.
    • Object Viewer User's Guide. Explains how to acquire run-time data using the Object Viewer.
    • Guide to the ArchestrA Alarm Control. Explains how to configure the alarm control (client) to show current and historical alarms and events in a grid.
    • Guide to the ArchestrA Trend Client. Explains how to configure a chart to trend real-time data values.
    • Platform Manager User's Guide. Explains how to start and stop system components.
    • Galaxy Database Manager User's Guide. Explains how to backup and restore the Galaxy database.
    • Log Viewer User's Guide. Explains how to use the Log Viewer utility to determine system diagnostics.
    • Log Flag Editor Utility Guide. Explains how to turn on and off certain diagnostics logging messages.
    • Wonderware FactorySuite License Utility Guide. Explains how to use the License Utility to manage the license required for the running application.
    • Wonderware ArchestrA Protocol Guide. Explains background information on the main protocols used between components of Wonderware products.
    • InTouch HMI and ArchestrA Integration Guide. Explains how you can use the ArchestrA Integrated Development Environment (IDE) to manage InTouch applications so that you can use symbols you create in the ArchestrA Symbol Editor. available in the following location in the ArchestrA System Platform DVD:
      \Archestra System Platform\CD-Intouch\UserDocs\English

    Information included in these guides is provided in online Help, which can be opened using the Help menu options in each utility. During product installation, you can choose to install the documentation PDF on your local hard drive.

    Searching Wonderware Application Server Books with Adobe Reader

    The Wonderware Application Server books are delivered as an Adobe PDF package, which provides a master index of all books. Using Adobe Reader, you can simultaneously search for a specific topic across all books that belong to the Wonderware Application Server product library.

    To search for information across all Wonderware Application Server books simultaneously

    1. Open Adobe Reader.
    2. Press CTRL+SHIFT+F or select Search from the Edit menu. The Search dialog box appears.
    3. Type the word or phrase that you want to search for in the Application Server books.
    4. In the Where would you like to search area, select the option to search all PDF books.
    5. If necessary, locate the Wonderware Application Server 3.2 PDF package located on your Wonderware CD or on a network folder containing copies of the Wonderware Application Server PDF book files. After product installation, these files can be found at:<driveletter>:\Program Files\ArchestrA\Framework\Docs.
    6. Click Search. Adobe Reader lists the Wonderware Application Server books that contain a match for your search criteria.
    7. Click the links to open the Wonderware Application Server book to the topic containing the information that meets your search criteria.

    < top of document >


    © 2011 Invensys Systems, Inc. All Rights Reserved.