LICENSING GUIDE |
This video walks through an example of offline (no internet needed) activating a Wonderware license using the Schneider Electric License Manager. ArchestrA License Manager Guide. Describes the ArchestrA License Manager and how to use it to install and manage licenses and license servers on local and remote computers. Documentation Issues. The following table lists important Wonderware System Platform documentation corrections.
Description
Everything you need to know about how to licenses for InTouch TSE.
Wonderware has created a Deployment Guide specifically to help users understand and properly architect a project using Remote Desktop Services (formerly Terminal Services) and InTouch for Terminal Services. The deployment guide can be found HERE.
Author | Jimmy McGlaughlin |
Publish Date | 01/14//2014 |
Applies to Software | InTouch for Terminal Servcies |
Applies to Version | 10.x |
Applies to System/Module | Terminal Services |
Article Version | 01.01.01 |
************************************************************************************************************************************************************
Overview of Wonderware License Management
Licenses for Wonderware products are maintained in license files or on a license server. The license file contains one or more license components, which are lines of information that specify licensing for an individual product.
Each license component is assigned a unique part number and contains information such as the:
- Product name
- Serial number
- Type and duration of license
- Number of seats and other information
License Types
There are two kinds of licenses, unserved and served. For this document, only unserved licenses are included, since InTouch does not use served (server-based) licensing.
Unserved licenses, also known as local licenses, are installed on the same computer as the applications using them. Unserved licenses do not run on a license server. Unserved license files usually have the file names wwsuite.lic or ArchestrA.lic.
Information about the license Type appears with the license name and license components when you view it in the ArchestrA License Manager.
Products can have a demonstration period, which allows you to run the specified application for a defined period when the license is not available. Licenses can also define a grace period, which is entered when a license is unavailable. The grace period is a limited time period tracked by the application. The application determines what happens during the grace period.
How Wonderware Software Uses Licenses
When a Wonderware application starts, it looks for an unserved license on the same computer in the background. If no license is found locally, the application searches all license servers specified in ArchestrA License Manager for the computer.
When a license file is found, the application checks that this version is licensed for use. If more than one license is found, the order in which licenses are acquired by applications is:
- Unserved licenses
- Named device licenses
- Named user licenses
- Concurrent licenses
If the application is not supported by the license or if the required license is not found, the software component defaults to either a demonstration mode or an absent license mode.
Wonderware CAL (Client Access License)
A CAL is not a software product. It is a license that gives a user the permission to access the services of a database server. It is a paper license!
CALs are used to connect with a database Server like
- WW Historian Server (WWCAL)
- Information Server (WWCAL)
- MS SQL Server (MSCAL)
A client always needs a WWCAL when connecting to a WW Historian and always needs a MSCAL when connecting to a MSSQL database.
There are 4 types of WW CAL that include the MS CAL:
- WW Basic CAL for per device, per user, per seat
- WW Basic CAL per processor.
- WW Enterprise CAL for per device, per user, per seat.
- WW Enterprise CAL per processor.
When You Need A CAL
- Active Factory or InTouch to connect to Historian Server
- IS Standard and Advanced Client to connect to Information Server
- Any node (WW node or third party software) connecting to Historian Server or MS SQL Server
- InTouch, Active Factory, Wonderware Information Server Client
- InBatch Server
- InTrack Server
InTouch Runtime TSE License File
WWSUITE.LIC is a license file name that contains the InTouch feature line to enable InTouch (Dev, RT, Tag Count).
It also contains the InTouch TSE feature line, which enables InTouch Terminal Services capability, enforces number of terminal server sessions as well as Bitstring that indicates the number of sessions licensed.
How InTouch for Terminal Services Licenses Work
Every session/instance of InTouch must be licensed, whether that instance is running on a remote computer or on the Terminal Server as a session. An instance of InTouch can be a terminal services session on a remote computer or InTouch running on the Terminal Server.
InTouch 10.1 and above do not include a separate DVD for InTouch for Terminal Services . For InTouch for Terminal Services, make sure the server was configured as a terminal server.
Caution: If you exceed the number of allowed sessions you will see the following error message:
The number of allowed TSE count already exceeded.
InTouch for Terminal Services v10.1 License Example
In the following graphic
- InTouch Runtime TSE 3 Client Description
- Microsoft Terminal Services
- 1 Terminal Server
- 3 HMI TS display devices without IO capability (use IO on Terminal Server)
- All HMI sessions are running the same Application so the same Tag count
- No HMI view on Terminal Server
- Terminal Server acts as a Device Integration IO Server
Node | Qty | License Description |
1 | 1 | I/O Server |
2 | 1 | InTouch RT 3K Tags without I/O TSE |
3&4 | 2 | InTouch RT 3K Tags without I/O TSE |
Remote Desktop Licensing
Remote Desktop Licensing (RD Licensing), formally Terminal Services Licensing (TS Licensing) manages the Remote Desktop Services client access licenses (RDS CALs) that are required for each device or user to connect to a terminal server.
You use TS Licensing to install, issue, and track the availability of RDS CALs on a Remote Desktop Services license server.
When a client (either a user or a device) connects to a RD Session Host server, the RD Session Host server determines if a RDS CAL is needed. The RD Session Host server then requests a RDS CAL from the Remote Desktop Services license server on behalf of the client attempting to connect to the RD Session Host server. If an appropriate RDS CAL is available from a license server, the RDS CAL is issued to the client, and the client will be able to connect to the RD Session Host server.
Note: Remote Desktop Services Licensing is additional to other licenses that might be needed, such as FactorySuite licenses, operating system licenses, and any BackOffice family Client Access Licenses.
If you purchase ThinManager™ from ACP, it only includes the necessary licenses to run ThinManager. The licenses mentioned above are still required.
Installing Your Licenses
To install InTouch for Terminal Services license you can use License utility or License Manager Server software. The License Manager Server software manages Server-based licenses and is installed with several Wonderware products, or as a separate install. It is found on the Active Factory CD and the Wonderware Information Server CD or you can find it on the System Platform 2012 DVD on this path: CD:WISLicenseServer.
Note: The WWSuite.lic is not required on InTouch version 10.5 or higher. Only the ArchestrA.lic is used.
License Installation
Start the ArchestrA License Manager by doing the following:
Ensure that the installation DVD is in your DVD drive.
Wonderware Archestra License Manager Guide Pdf
Click Start, and then Programs to show the Wonderware folder.
Click the Wonderware folder, and then click the Common folder to show the list of common utilities.
Click ArchestrA License Manager.
Click File, and then Install License File. The Choose a License File to Install dialog box appears.
Browse the small license DVD (or other path to your license file), select the ARCHESTRA.LIC file, and click Open.
The Destination Computer for Installation dialog box appears. Type the domain and computer names.
The ArchestrA License Manager copies the ARCHESTRA.LIC file to the C:Program FilesCommon FilesArchestrALicense folder on the selected computer.
Related Videos
INSTALLATION GUIDE |
Description
Step by Step Installation of Wonderware's InTouch version 2014 (11.0)
Author | Jimmy McGlaughlin |
Publish Date | 01/14//2014 |
Applies to Software | InTouch Classic |
Applies to Version | 11.0 |
Applies to System/Module | n/a |
Article Version | 01.01.01 |
************************************************************************************************************************************************************
Pre-Requisites
Important!
FactorySuite Gateway (FS Gateway) 3.0 SP1 is installed as a hidden feature of InTouch HMI 2014 (v11.0) in an Wonderware System Platform (ASP) 2014 installation.
- If you previously installed FS Gateway 2.0 SP1 without any other InTouch products, then installing ASP 2014 will upgrade FSGateway to version 3.0 SP1.
- If you previously installed FS Gateway 2.0 SP1 as part of ASP 2012 with InTouch 10.5, you must uninstall FS Gateway before upgrading to ASP 2014.
For more information about FS Gateway installation, upgrade, and uninstall, see the Wonderware System Platform Installation Guide, 'InTouch HMI Requirements and Prerequisites' section, 'Installing FS Gateway and Modifying FS Gateway Installations' topic.
System Requirements
Introduction
This section describes the hardware and software requirements to support Wonderware System Platform 2014 products, including InTouch HMI 2014.
Hardware Requirements
Hardware Requirements by Installation Type
The following table lists the hardware requirements of different types of Wonderware System Platform 2014 installations based on the expected number of I/O operations per node.
Hardware Requirements Notes:
Windows 7 and Windows Server 2008 R2 operating systems and SQL Server versions impose hardware requirements that may exceed the minimum requirements for Wonderware Application Server 2014 (v4.0). If you intend to install Wonderware System Platform 2014 on a computer running Windows Server 2008 R2, Windows 8, Windows Essentials 2012, or SQL Server 2012, see the following Microsoft Web sites for a complete list of hardware requirements:
- www.microsoft.com/windowsserver2008/en/us/system-requirements.aspx
- www.microsoft.com/windows/windows-8/get/system-requirements.aspx
- msdn.microsoft.com/en-us/library/ms143506.aspx#EE32
Auxiliary Hardware Requirements
This section describes any optional hardware requirements beyond the specific hardware requirements discussed earlier in this ReadMe.
Alternative Authentication Using Smart Cards
- Smart Card: Raak Technologies C2-40 Mini Driver Smart Card
- Smart Card Reader: OK 3021 USB Smart Card Readers
Using Multiple Network Interface Cards
If you are using multiple network interface cards (NICs), you must configure certain settings for the firewall or else a remote node cannot connect to the Galaxy Repository node.
A connection is a term used to define a network interface card (NIC), its settings and the settings of whatever the NIC is connected to. Under certain circumstances, the connection on your computer can change if, for example, the IP address on your network card changes. Your computer's connection can be affected by external factors. During computer startup, and each time a connection changes, the operating system goes through an 'Identifying' process to determine which profile should be assigned to the connection.
A profile is a collection of firewall settings that can be applied to a connection. There are three profiles currently defined in the operating system: Domain, Public, and Private.
- The Domain profile is active only when the computer can authenticate with a domain controller on all active interfaces such as LAN, wireless, and VPN. The domain profile may be more or less restrictive than the other two profiles depending on network security policies.
- The Private profile is active whenever the network type for all active network connections on the computer are identified as private networks. The private profile typically is used in a more trusted environment and is less restrictive than the public profile to allow for network discovery.
- The Public profile is active in all other circumstances. The public profile typically is more restrictive than the private profile because the computer often is connected to the Internet in an insecure location. Network discovery and remote access are disabled rather than explicitly blocking specific traffic. Firewall exceptions and rules can be created on any or all of these profiles.
This is important because the OS Configuration utility and the Firewall utility apply their firewall exceptions to the Domain and Private profiles only.
As previously noted, you can specify which profile you want assigned to a connection as long as that connection is not a Domain connection. This is done through the 'Network and Sharing Center'. Click the Network icon located on the right side of the task bar and then click one of the networks that are shown. You can change a connection from a Public profile to a Private profile. The firewall calls these settings 'Profiles' but the network calls them 'Location types.'
On computers using dual NICs, the first NIC is normally connected to the domain and is assigned the Domain profile automatically. Windows typically assigns the second NIC the Public profile.
The first issue is that your entire computer (all connections) is restricted to the most restrictive of the profiles assigned to any connection. So if the second connection was assigned a profile of Public, none of the firewall exceptions set by the OS Configuration or Firewall utilities will be allowed. The exceptions were set for Domain and Private only, not Public. You must set the second connection to the Private profile for any of the firewall exceptions to work. You want the active profile on the message exchange (MX) NIC to be the profile opened by OS Configuration.
The second issue is that it appears that a restart of your computer, or even a restart of a computer to which you are connected, can change your connection back to the Public profile. Once again the firewall exceptions will not be effective. You'll have to change the connection back to the Private profile after each restart or a restart of the connected computer.
To avoid these NIC issues and prevent the “Identifying” process from taking place on a connection and changing the assigned profile, certain items must be present in the definition of the connection. Follow these rules and procedures:
- If you have only one NIC, no action is required. The profiles and firewall rules are automatic.
- To configure two NICs, do the following:
1. If the second NIC is not physically connected to anything (that means no wire in it), no action is required. The profiles and firewall rules are automatic.
2. If the second NIC is connected, it MUST be configured. Follow the rules for configuring a normal redundancy setup provided in the Wonderware Application Server User's Guide and the accompanying online help.
- Assign the NIC an IP address, subnet mask and gateway address. Typically, these addresses are internal, non-routable addresses. For example, 192.168.1.xx and 10.x.x.x are common addresses of this type.
- A NIC acting as Redundancy Message Channel (RMC) does not require a default gateway. Otherwise, the gateway can be the same as the IP address. Vista and Windows Server 2008 will identify this NIC and assign it a Private profile.
If you do not configure the second NIC, Windows 7 and Windows Server 2008 will assign a profile of Public to this NIC and cause all of the Wonderware product firewall exceptions to be deactivated on all NICs.
3. Set a security policy so that Windows 7 and Windows Server 2008 do not re-set the RMC NIC to a Public profile on rebooting the system or changing the IP address. To make the Private profile setting persistent, do the following:
- On the Windows Start menu, click Run.
- Enter and run this command: SECPOL.MSC. The Local Security Settings menu appears.
- Select Network List Manager Policies on the menu tree.
- Select Unidentified Network from the Network Names displayed.
- Right-click, then select Properties, and then change the Location type from Not configured to Private.
- Exit the menu and return to Windows.
4. If you have more than two NICs, make sure all connected NICs are configured with an IP address.
Operating System, .NET Framework, and Virtualization Requirements
Summary of Software Requirements for InTouch HMI Version 11
The following table lists the operating system, .NET Framework, and virtualization requirements for the suite of Wonderware System Platform products, including InTouch HMI Version 11.
Note: Only those Windows and SQL versions and service packs shown in the following tables are supported for Wonderware System Platform 2014 components.
Software Requirement Notes:
- The entry for Application Server applies to the ArchestrA IDE (Development Node) and ArchestrA Run time (Application Node).
- The Galaxy Repository (GR Node) can run on a client Windows operating system only in a single-node configuration.
- Development and application nodes are considered to be clients of the server GR node.
- Other .NET Framework versions can coexist except .NET 4.0. But, all scripts in objects run in .NET Framework 4.5. For more information about .NET Framework requirements and compatibility, see .NET Framework Requirements and Compatibility
- .NET 3.5 is installed by System Platform only because the supported SQL Server versions require it. No other dependencies to .NET 3.5 must exist.
Operating System Notes Common to Wonderware Products
ActiveX Controls Behavior on Windows 7, Windows 2008 R2, and Windows 8 Operating Systems
Due to the Data Execution Prevention (DEP) feature of Windows 7, Windows 2008 R2, or Windows 8 operating systems, any ActiveX control built with ATL version 7.1 or earlier will fail to host or will have unpredictable behaviors in InTouch HMI 11.0 either in WindowMaker or WindowViewer running on supported versions of Windows. For more information, contact Wonderware Technical Support.
Configuring Remote Alarm Retrieval Queries When Running Windows 7, Windows 8, or Windows Server 2008 R2
The process to configure remote alarm retrieval queries has changed for interactive applications such as InTouch HMI when running on Windows 7, Windows 8, and Windows Server 2008 R2.
When InTouch WindowViewer is started and generates alarms from an interactive Windows 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
1. After starting InTouch WindowViewer (alarm provider) on the Windows 7, Windows 8, or Windows Server 2008 R2 node, open the SMC Logger and look for the most recent string generated by AlarmMgr. For example: 'Registering AlarmMgr with SLSSVC as AlarmMgr 253.127.148.120'. The indicated IP address will be unique to your alarm-providing node. Note the IP address.
2. In the Alarm Query tab of the AlarmViewer control on the remote computer, configure the alarm query as follows, substituting your nodename of the alarm providing InTouch HMI for 'nodename' below and substituting your IP address noted in the previous step:
nodename:ip_addressintouch!$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.
3. Test to validate that the alarms generated from the alarm-providing node are shown accurately in the AlarmViewer control.
Wonderware InTouch HMI and Alarm DB Logger
In earlier releases of InTouch HMI that supported Windows Vista, Windows 7, or Windows Server 2008, the Alarm DB Logger could not be enabled to run as a service. The Alarm DB Logger now runs as a Service in Windows Vista and later operating systems primarily to support Galaxy Alarms and InTouch HMI Alarms from Terminal sessions. However, there is a limitation in that the combination of Alarm DB Logger configured as a service and InTouch HMI running locally as a console application is still not supported. If InTouch HMI needs to run in the Console session, the Alarm DB Logger must be configured in the Alarm DB Logger Manager as a 'Normal Application' instead of a 'Windows Service'.
Also, if you are running the Alarm DB Logger as a console application, you cannot run it in the Terminal session until you close the one that is running in as a console application.
Refer to the updated Tech Note 725, 'Running InTouch HMI and AlarmDBLogger Services on Vista and Later Operating Systems,' for full details of the supported scenarios and applicable alarm query syntax.
Terminal Services Behavior in Windows Server 2008 and Later Operating Systems
In a change from Windows Server 2003, Windows Server 2008 and later Windows versions no longer support 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 or later, Session 0 is no longer an interactive session, and is reserved only for Windows services. From Windows Server 2008 and later, all remote connections are treated 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.
Wonderware Archestra Manual
In another aspect of Terminal Services behavior, InTouch HMI functions such as TSEGetClientID() can return a null value when running on Windows 2008 SP2 and Windows 2008 R2 operating systems with InTouch running in a remote desktop (RDP) client session. The cause of this behavior is that the relevant roles are not installed on the Terminal Server. You must install the 'Terminal Server' role for Windows 2008 SP2 or the 'Remote Desktop Host' role for Windows 2008 R2 in order for TSEGetClientId() and other related functions to work properly.
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 HMI can be configured as alarm providers, only one alarm provider can be configured at any one time.
Wonderware Application Server and InTouch HMI detect when the application is running in the console. In Windows Server 2008 R2 and later, 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.
When running Windows Server 2008 or later versions of Windows, you must modify the terminal services behavior for the Wonderware software to operate properly.
Wonderware software detects when an application is running in the console. From Windows Server 2008 and later versions of Windows, all remote connections are treated as a remote RDP session regardless of /console or /admin switches in the mstsc connection.
To disable fast user switching through the Group Policy interface
1. Click Start and then Run. The Run dialog box appears.
2. Enter gpedit.msc and click OK. The Group Policy dialog box appears.
3. Go to the following location: Local Computer Policy > Administrative Templates > System > Logon.
4. Set Hide Entry Points for Fast User Switching to Enabled. Enabling this policy hides the SwitchUser option in the Logon interface, the Start menu, and the TaskManager.
5. On the File menu, click Exit to close the Group Policy dialog box.
By enabling the policy, Administrators hide the Switch User button in Windows logon, in the Start menu, and in the Task Manager.
Certain editions of Windows Vista do not have the Group Policy editor. So, alternatively, you can configure the Switch User settings through the registry.
To disable fast user switching through the Registry Editor
1. Click Start and then Run. The Run dialog box appears.
2. Enter regedit.exe and click OK. The Registry Editor dialog box appears.
3. Go to the following location: HKEY_LOCAL_MACHINE > SOFTWARE > Policies > Microsoft > Windows > CurrentVersion > Policies > System.
4. Right-click and select DWORD (32-bit) Value. Name it HideFastUserSwitching.
5. Set the HideFastUserSwitching data value to 1.
6. On the File menu, click Exit to close the Registry Editor.
In a Terminal Server environment that has a managed application deployed to it, the following behavior applies to references in the InTouch HMI application to the InTouchViewApp object:
ArchestrA Symbols referencing InTouchViewApp_001.Tag1:
Running on the Console - Refers to the tag value of the application running on the console.
Running in a Session - Refers to the tag value of the application running on the console.
Restarting the Window Viewer application running on the console causes references from the terminal session to disconnect and then reconnect.
InTouch Graphic referencing Tag1:
Running on the Console - Refers to the tag value of the application running on the console.
Running in a Session - Refers to the tag value of the application running in the session.
ArchestrA Graphic referencing InTouch:Tag1:
Running on the Console - Refers to the tag value of the application running on the console.
Running in a Session - Refers to the tag value of the application running in the session.
InTouch Graphic referencing Galaxy:InTouchViewApp_001.Tag1:
Running on the Console - Refers to the tag value of the application running on the console.
Running in a Session - Refers to the tag value of the application running on the console.
Wonderware InTouch HMI 2014 (v11.0) Operating System Notes
The following table lists the supported operating systems that can be installed on computers that run InTouch HMI server and client components.
Notes:
- The recommended operating system for a Galaxy Repository is Windows Server 2008 R2 SP1.
- Microsoft Windows 7 SP1(32-bit or 64-bit) is the recommended operating system to run InTouch HMI client components.
- Microsoft Windows Server 2008 R2 SP1 is the recommended operating system to run InTouch HMI server components.
- The recommended operating system for InTouch HMI development is Windows Server 2008 R2 SP1 or Windows 7 SP1.
- The recommended operating system for run-time nodes is Windows 7 SP1.
- Window 7 SP1 Embedded is supported on compact systems only.
Wonderware InTouch HMI 2014 (v11.0) with Windows 7 and Later Versions of Windows
- The following InTouch legacy script functions do not operate on 64-bit versions of Windows: WWPoke(), WWExecute(), WWRequest(), ActivateApp() and SendKeys().
- If Recipe Manager is started using the path StartProgramWonderwareInTouchRecipe, then select Run as Administrator on Windows 7 or later operating systems.
- The InTouch Extensibility Toolkit might need to be started by right-clicking and selecting Run As Administrator on Windows 7 or later operating systems to function properly.
- The onscreen keyboard options have changed for the Windows 7 and Windows Server 2008 R2 operating systems.
- Hovering to select from the Windows keyboard does not work in the Windows 7 Professional and Windows Server 2008 R2 Standard operating systems.
Wonderware InTouch HMI 2014 (v11.0) View Applications and DDE Support
Windows 7 and Windows Server 2008 do not support NetDDE 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.
Windows Server 2003 and Windows XP Pro still support NetDDE.
In ArchestrA Symbols, InTouch:‹tagname› is still a valid method of referring to an InTouch tag on a local node.
Wonderware InTouch HMI 2014 (v11.0) Support for Windows User Account Control
Wonderware System Platform 2014 with InTouch HMI v11.0 supports User Account Control-enabled operations on run-time nodes. You must disable User Account Control (UAC) before installing Wonderware System Platform 2014 and before performing Configurator operations. UAC also must be disabled on IDE and GR nodes.
.NET Framework Requirements and Compatibility
IMPORTANT: We strongly recommended that prior to upgrading your existing applications to Wonderware System Platform 2014, that you back up your applications, become familiar with the changes introduced by Microsoft in .NET 4.5, and that you review your .NET scripts and .NET controls for any required changes. We also recommend you test the upgrade in a staging system prior to upgrading your production system.
Wonderware System Platform 2014 leverages Microsoft .NET Framework 4.5. The Wonderware System Platform installation program will install .NET 4.5 if it is not already present in your system. If .NET 4.0 is your current .NET version, note that it is possible for .NET 4.0 and .NET 4.5 to coexist in the same machine. In this scenario, ASP 2014 will use .NET 4.5. Other applications you may have on the same machine with dependencies on .NET 4.0 will access .NET 4.5.
Although .NET Framework 4.5 is highly compatible with applications that are built with earlier .NET Framework versions, Microsoft has introduced changes in .NET 4.5 to improve security, standards compliance, correctness, reliability, and performance that may require changes to .NET scripts you may have created with Wonderware System Platform 2012 and earlier versions of Application Server, InTouch HMI, the Historian, Historian Client, and Wonderware Information Server. These changes may also affect .NET controls developed with .NET 4.0.
Virtualization Support
Wonderware System Platform 2014 supports the following virtualization environments:
- Microsoft Hyper-V: based on the supported operating system version
- VMware 5.0: basic virtualization without High Availability and Disaster Recovery
- VMware VSphere 5
SQL Server Requirements for All Wonderware Components
The following table lists the SQL Server requirements for Wonderware System Platform 2014 components, including InTouch HMI 2014. The recommended environment is a 64-bit operating system and SQL Server 2008 R2 SP2, Standard, Enterprise, 32/64-bit.
Note: SQL 2012 SP1 Express is installed automatically if no other version of SQL Server is installed on the computer where InTouch HMI 2014 will be installed.
SQL Server Notes Common to All Wonderware Products
SQL Server Rights Requirements
SQL Server 2008 does not automatically create the BUILTINAdministrators role delivered in SQL Server 2005. Because of this change to SQL Server, the Wonderware Application Server 2014 (v4.0) 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 BUILTINAdministrator 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.
Alarm Client and Trend Client Prerequisites
The Trend Client is compatible with the following Wonderware products:
- Wonderware InTouch HMI 10.1, 10.1 SP2, 10.2, 10.5, 10.6, and 11.0
- Wonderware Application Server 3.1, 3.1 SP1, 3.2, 3.5, 3.6, and 4.0
- Wonderware Historian 9.0, 10.0, 10.5, and 11.5
- Wonderware Historian Client 10.0 SP1/SP2, 10.1, 10.2, and 10.5
- ActiveFactory 9.2
- QI Analyst 8.0 SP2
InTouch Access Anywhere Requirements
The following sections describe the requirements to run Wonderware InTouch Access Anywhere Server and supported browsers. For detailed information, see the Wonderware InTouch Access Anywhere documentation.
Requirements
The InTouch Access Anywhere Server can be installed as a Wonderware System Platform installation option. The InTouch Access Anywhere Secure Gateway is an optional component installed on a separate computer within a DMZ.
The following requirements must be met before you install the InTouch Access Anywhere Server or a Secure Gateway.
- Wonderware InTouch Access Anywhere must be installed on the same RDP Server computer as Wonderware InTouch HMI 2012 R2 (version 10.6) or later.
- Remote Desktop (RDP) must be enabled and properly configured on the host computer. For information and guidance, see Tech Note 782, 'Installing Remote Desktop Services on Windows 2008 Server R2 for Wonderware Products'. You also can refer to http://technet.microsoft.com/en-us/l.../dd883253.aspx.
- You must install an InTouch 2012 R2 TSE Concurrent License on the same computer as your Wonderware InTouch and InTouch Access Anywhere Server installations.
Supported InTouch Access Anywhere Browsers
Wonderware InTouch Access Anywhere can run on smart phones, tablets, laptop computers, or any other device that supports an HTML5-compliant web browser. Browsers supported by Wonderware InTouch Access Anywhere include the following:
Browsers Tested with InTouch WindowViewer
- Internet Explorer 11
- Internet Explorer 10
- Firefox 22
- Safari 7
- Chrome 28
- Opera 15
Functionally Compatible Browsers
Certain versions of the following browsers may be functionally compatible with InTouch Access Anywhere, but have not been tested running InTouch HMI.
- Firefox 4-21
- Safari 5, 6
- Chrome 11-27
- Opera 11-14
You are strongly recommended to upgrade to one of the supported browser versions listed in Browsers Tested with WindowViewer. For a complete list of considerations to run an InTouch application with InTouch Access Anywhere on a portable device, see the InTouch Access Anywhere User Guide.
Wonderware InTouch HMI 2014 (v11.0) Component Compatibility
In a single-node environment, if you need to combine multiple components delivered within Wonderware System Platform 2014, all components need to be at the versions delivered in Wonderware System Platform 2014.
In a node-to-node environment, components are compatible between the current licensed version and one licensed version back.
The following table lists Wonderware component products and their compatibility with InTouch HMI 2014 (v11.0).
In some cases, the Wonderware InTouch HMI is supported in newer environments than a compatible product. Wonderware InTouch HMI has been tested for compatibility with a listed product only in the environments that are supported by that particular product.
Detailed Steps
Performing the InTouch HMI Installation
Before you start installing InTouch HMI, you should have a clear idea whether you want to develop, deploy, and publish your own applications, or require only the InTouch run time, to run applications already created and deployed.
The following procedure will guide you through the installation, with information specific to the InTouch HMI.
To install the InTouch HMI
- Insert the installation DVD into the computer’s DVD drive.
- Using Windows Explorer, manually start the installation by double-clicking setup.exe on the DVD.
- Follow the prompts to commence the installation and to install system prerequisites, as necessary.
- The installation program prompts you to select an installation type: either product-based selection or installation by computer roles. As you are installing a single product—InTouch HMI—click the product-based selection as your installation type
- Choose the components you want to install.
- If you choose InTouch Run Time Only, the following will be installed:
- InTouch Run Time
- InTouch documentation
- Alarm DB Logger
- FS Gateway (as a silent installation)
- Application Server Bootstrap
- InTouch Supplemental Components: InTouch Recipe Manager, InTouch SQL Access, and Symbol Factory
Note: The 16 Pen Trend supplementary component is not installed by default. You must select the Customize Installation option and select 16 Pen Trend from the product list to install it as part of the InTouch HMI installation procedure.
- If you choose InTouch Development and Run Time, the following will be installed:
- All items listed under step a in these instructions.
- Application Server Bootstrap, IDE, Galaxy Repository, SQL Server 2012 Express with SSMSE, and Application Server documentation
- InTouch sample applications
- If you choose InTouch Run Time Only, the following will be installed:
- When the installation prompts you to verify your selection, you have the opportunity to customize your installation.
- If you choose InTouch Run Time Only, you can add the following components:
- InTouch sample applications
- InTouch 16 Pen Trend Supplementary Component:
- If you chose InTouch Development and Run Time, you can add the following components:
- InTouch 16 pen trend
- InTouch Access Anywhere
- If you choose InTouch Run Time Only, you can add the following components:
- After you verify and customize your selection, you are prompted to select the language you want to install. English is selected by default, but you can choose another language.
- Follow the subsequent installation steps to:
- Accept the End User License Agreement.
- Create a new ArchestrA user account, or specify an existing account.
- Install any prerequisite software components not yet installed on the computer.
- The installation proceeds to completion. You must restart the computer after completing the installation.
Installing Your Invensys Product License
Wonderware enforces the use of its products with a software license. After you install a Wonderware product, you must install a single license file, ARCHESTRA.LIC, which contains your customer information, product data, and software features. Until you apply your Wonderware license, you can only run the InTouch HMI in demonstration mode.
You use the Invensys License Manager to install the contents of the ARCHESTRA.LIC file on the computer where InTouch HMI has been installed. The Invensys License Manager is included as an Invensys component when you install the InTouch HMI.
To install your Wonderware product license
- Start the Invensys License Manager by doing the following:
- Place the installation DVD in the computer's DVD drive.
- Click Start from the Windows desktop, and then click All Programs to show the Invensys folder.
- Click the Invensys folder, and then click the Invensys License Manager folder.
- Click Invensys License Manager.
- Click File, and then Install License File. The Choose a License File to Install dialog box appears.
- Browse the installation DVD, select the ARCHESTRA.LIC file, and click Open.
- The Destination Computer for Installation dialog box appears. Type the domain and computer names.
- The Invensys License Manager copies the ARCHESTRA.LIC file to the C:Program FilesCommon FilesArchestrALicense folder on the selected computer.
Antivirus Software Exclusions
After installing Wonderware InTouch HMI Version 11.0, configure your antivirus software to avoid scanning archive files.
Antivirus software should not scan files in the following ArchestrA folders for 32-bit operating systems:
- C:Program FilesArchestrA
- C:Program FilesCommon filesArchestrA
- C:Program FilesFactorySuite (The FactorySuite directory may not exist in newer installations)
- C:Program FilesWonderware
- C:InSQLData
- C:Documents and SettingsAll UsersApplication DataArchestrA
- C:HistorianData
For 64-bit operating systems, the exclusion must reflect the (x86) program files directory instead:
- C:Program Files (x86)ArchestrA
- C:Program Files (x86)Common filesArchestrA
- C:Program Files (x86)FactorySuite (The FactorySuite directory may not exist in newer installations)
- C:Program Files (x86)Wonderware
From Application Server Platform objects:
- History Store Forward directory: (if not default)
From Application Server Engine objects:
- Checkpoint directory location (if not default)
<InTouch Application folder path> including:
C:Documents and SettingsAll UsersApplication DataArchestrA
<SMCLoggerStoragefilepath>. The default is:
C:Documents and SettingsAll UsersApplication DataArchestrALogFiles
SQL Server database files of type:
- .mdf
- .ldf
Note: Ensure that the subfolders of the listed directories are also excluded. Specify folder names accordingly if you are using a 64-bit operating system. For example, the program file's root directory in a 64-bit operating system is C:Program Files (x86)... and the application data root directory in a 32-bit operating system is C:ProgramData...
Modifying, Repairing, or Removing the InTouch HMI
To modify, repair, or remove an installation
- Insert the installation DVD into the computer’s DVD drive.
- Click the Programs and Features option in Windows Control Panel. The list of software installed on your computer appears.
- Select the InTouch component, and then click the Uninstall/Change button. The Modify, Repair or Remove Installation dialog box appears.
- Follow the prompts to modify, repair, or remove the installation.
Note: The name of the Uninstall/Change button varies depending on the Windows operating system installed on your computer.
Upgrading to Version 11.0 from an Earlier Version of the InTouch HMI
Upgrading InTouch HMI installs Version 11.0 on a computer that has a previous version currently installed. An upgrade removes or uninstalls the previous version of InTouch HMI and installs Version 11.0.
After the hardware and software requirements are met, including the proper operating system, SQL server and other prerequisites, you can upgrade to Wonderware InTouch HMI Version 11.0 from the following versions of the InTouch HMI:
- Version 10.0 SP2
- Version 10.1 (All service packs and patches)
- 10.1
- 10.1 SP2
- 10.1 SP2 P01
- 10.1 SP3
- 10.1 SP3 P01
- Version 10.6
You can only upgrade Wonderware System Platform products that are already installed and you will not be able to install new products within the Wonderware System Platform that have an upgrade process. The installed components that need to be upgraded are selected and disabled. You can neither clear these check boxes nor select more components during the upgrade.
To upgrade from a previous version of the InTouch HMI
- Insert the DVD into your DVD-ROM drive. Run setup.exe to start the set-up program.
The upgrade feature dialog box appears. - Follow the prompts to complete the upgrade.
Migrating Applications to Wonderware InTouch HMI Version 11.0
Migration converts applications created with earlier versions of InTouch HMI to the current version. You can migrate applications to version 11.0 that were developed with the following versions of InTouch HMI:
- Version 7.11 P07
- Version 8.0 SP2 P04
- Version 9.0 P03
- Version 9.5 SP1
- Version 10.0 SP2
- Version 10.1 (All service packs and patches)
- 10.1
- 10.1 SP2
- 10.1 SP2 P01
- 10.1 SP3
- 10.1 SP3 P01
- Version 10.6
Licensing
For General System Platform 2014 Licensing click HERE