ASP Install Guide
ASP Install Guide
9/20/11
All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Invensys Systems, Inc. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and the author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Invensys Systems, Inc. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements.
Contents
Chapter 1
Chapter 2
Contents
Chapter 3
Chapter 4
Chapter 5
Contents5
Historian_Tagcount Feature Line .............................................. Historian_ServerOS Feature Line ............................................. Historian_RemoteIDASCount Feature Line ............................. Historian_ModifyHistoryData Feature Line ............................. Historian_HistoryDuration Feature Line .................................. Historian_Processors Feature Line ............................................ Support for Non-English Operating Systems ............................... Integration with Other Wonderware Products ............................. System Sizing Examples ................................................................ Process (Non-Tiered) Historian Sizing Examples ..................... Server 1: 2.4 GHz Single Processor Quad-Core CPU ............ Server 2: Four Dual-Core 2.7 GHz CPUs .............................. Server 3: Four Dual-Core 3.4 GHz CPUs .............................. SCADA (Tiered) Historian Sizing Examples ............................. Topology 1: Centralized Tiered Historian Topology on a Slow/Intermittent Network .......................................... Topology 2: Centralized Tiered Historian Topology for a Single Physical Location .............................................. Topology 3: Simple Tiered Historian Topology for a Modem Configuration ..................................................
69 69 70 71 71 71 72 72 73 73 73 75 77 79 79 82 84
Chapter 6
Contents
Chapter 7
Chapter 8
Chapter 9
Contents7
Guidelines for Installing Microsoft SQL Server ......................... Guidelines for Installing Microsoft SQL Server 2008 ............. Guidelines for Installing IIS and ASP.NET ............................... Guidelines for Installing IIS and ASP.NET on Windows Server 2003 ........................................................... Guidelines for Installing IIS and ASP.NET on Windows 7 ............................................................................. Guidelines for Installing IIS and ASP.NET on Windows Server 2008 and Windows Server 2008 R2 ......................... Guidelines for Installing Microsoft Reporting Services ............. Guidelines for Configuring SQL Server 2008 Reporting Services ................................................................................. Guidelines for Installing and Uninstalling SharePoint Services ...................................................................................... Configuring Windows SharePoint Services 3.0 ....................... Installing SQLXML for HTTP Access to Wonderware Historian Data .......................................................................... Installing Language Packs for Multilingual Systems ................
122 123 126 126 127 128 130 130 132 132 135 135
Chapter 10
Contents
Upgrading from a Previous Version ............................................ Upgrading ActiveFactory Components .................................... Upgrading the Server from Wonderware Information Server 3.1, 4.0 or 4.0 with SP1 ............................................. Installing the Product License ....................................................
Index..................................................... 159
You can use the ArchestrA System Platform installation program to install the entire suite of products or any of the components.
You must have the following software installed and enabled on your computer before you install the ArchestrA System Platform:
Microsoft .NET Framework 3.5 SP1 is required by the software, as well as by the installation framework. The Windows Server 2008 R2 operating system requires this feature to be enabled prior to allowing the install.
To enable the .NET Framework feature in Windows 2008 Operating System 1 2 3 4
In Control Panel, open Administrative Tools. Open Server Manager, and then click Features. Click Add Features to start the wizard. In the features list, select the .NET Framework 3.5.1 Features check box.
Enabling .NET Framework 3.5.1 feature does not actually install .NET Framework 3.5 SP1. The ArchestrA System Platform media will install it if it is not already installed in the computer.
The ArchestrA System Platform installation installs both system-specific and product-specific prerequisites. You do not have to exit from the ArchestrA System Platform installation procedure to install the prerequisite software.
Important: The exception to the prerequisites installation workflow is the SQL Server requirement for installing the Galaxy Repository (GR). If you select the GR for installation, and if the supported version of SQL Server is not already installed, you must exit the installation program, install the supported SQL Server version, then resume the installation. We recommend that you install the supported SQL Server version before you begin the ArchestrA System Platform installation program.
For information on prerequisites and software requirements for the specific products, see the Readme files of the specific products located in your documentation directory, or see the specific product information chapter in this installation guide.
It is recommended that you define the node you are installing and select the appropriate role before starting the installation program. During the installation, you can click a role to see its description, as described in "Installing the ArchestrA System Platform" on page 13. The following roles are available for selection:
Insert the DVD into your DVD-ROM drive. Browse the DVD and run setup.exe in the root directory of the DVD.
The installation program detects the initial system requirements. It first checks if the minimum operating system and hardware requirements are met. If the requirements are met, the installation proceeds to verify the general installation prerequisites. For more information on specific system requirements, see the ArchestrA System Platform 2012 Readme.
If your computer does not meet the initial system prerequisites, the Prerequisites dialog box appears.
You can select the Show All check box to view all prerequisites.
3
Click the prerequisite whose status is Not Met, and then click Install Prerequisites. The general system prerequisites are installed. Click Next. The select installation type dialog box appears.
Select whether you want a product-based or a computer role-based installation, and then click Next. The select components dialog box appears.
Note: The select components dialog box varies depending on whether you have selected a product-based or a role-based installation.
If you select the Product Based Selection option, then the product based installation dialog box appears.
If you select the ArchestrA System Platform Computer Roles option, the role based installation dialog box appears.
Note: You can select multiple products or roles. All the selected components will be installed together. 6
Select the check boxes to indicate which products or roles you want to install, and then click Next. The verify selection dialog box appears.
7 8
On the verify selection dialog box, view your selection. Select the Customize Installation check box to change your configuration, if required, and then click Next. The customize installation dialog box appears.
Note: You can click Browse on the customize installation dialog box to change the program installation destination folder.
Change your selection, and then click Next. If you have selected an InTouch HMI installation, the language selection dialog box appears. Click the language for your InTouch HMI installation.
If you select InTouch features, you need to select a language for the InTouch installation. The localized InTouch versions are supported only in the paired operating system. For example, the German version of the InTouch HMI is only supported on the German operating system.
10 Click Next. The End User License Agreement dialog box appears.
11 Click the I Accept the License Agreement option, and then click
Next. The ArchestrA User Account dialog box appears.
ArchestrA user account if no other ArchestrA-enabled software is installed on the computer, or specify an existing user account. If you create a new account, do the following:
a b
Type your user name and password. Click the Create Local Account check box if not already selected. By default, this is selected and the Domain/Local Machine box displays your computer name. Specify a different domain/local machine name if necessary. If you clear the check box, the Domain/Local Machine box displays the default domain name. You can then modify it.
If you select an existing user account, it should meet the following requirements:
User account in which the password cannot be changed. User account that is a member of the local Administrators
group.
a b
Type the user name and password for the existing account. Clear the Create Local Account check box.
The ArchestrA user account is a user name and password combination that enables inter-node communication between all computers in an ArchestrA environment. You must specify the same user account on every node when you install the ArchestrA System Platform components for the first time on computers that communicate with each other. Wherever an ArchestrA user account is required, the ArchestrA System Platform 2012 Installation dialog box appears and you need to provide a valid user name and password.
WARNING! The ArchestrA user account is a Windows operating system account located on the local computer or on a domain. Do not delete this account with operating system account management tools. If you do, ArchestrA-enabled software may stop functioning properly.
appears. The prerequisites listed vary depending on the products or product combinations selected.
14 Click any prerequisite with status of Not Met, and click Install
Prerequisites. When all prerequisites are installed, click Next.
appears. If the installed products do not need configuration, click Finish, else click Configure. For more information on configuring products, see "Configuring Products" on page 23.
Note: You must restart the system to complete the installation.
Configuring Products
Some products require post-installation configuration for initial setup. You need to configure your products using the Configurator dialog box after you have installed them. The Configurator dialog box lists all product components that you have installed. You can configure the locations for the product database and the data files.
Note: You need to configure the products only if you have installed Wonderware Historian Server or Wonderware Information Server.
For more information on the products, see the following chapters in this guide:
Modifying an Installation Repairing an Installation Uninstalling an ArchestrA System Platform Component Upgrading an ArchestrA System Platform Component
To configure products 1
In the complete installation dialog box, click Configure. The Configurator dialog box appears.The following example shows configuration for the Historian Server
2 3
On the left pane, select the component and configure the details on the right pane. Click Configure. After the installation is complete, the system may prompt you to restart. You can restart now or later.
Note: The installed programs may not function properly until you restart the system.
Modifying an Installation25
Modifying an Installation
You can change the ArchestrA System Platform components installed on your computer. You can add new components or remove the existing ones. You can modify any component of ArchestrA System Platform.
Note: You must have the installation DVD inserted in the DVD-ROM drive before you can modify a program. To modify an installation 1
Click the Add or Remove Programs option in Windows Control Panel. (In Windows Server 2008 R2, this is called Uninstall or Change a Program.) The list of software installed on your computer appears. Select any ArchestrA System Platform component, and then click the Uninstall/Change button. The Modify, Repair or Remove Installation dialog box appears.
Note: The name of the Uninstall/Change button varies depending on the Windows operating system installed on your computer.
Click the Modify option, and then click Next. The list of ArchestrA System Platform components appears.
Select or clear the components that you want to add or remove, and then click Next. The verify change dialog box appears.
Modifying an Installation27
Click Modify. The selected components are added or removed and the complete modification dialog box appears.
Repairing an Installation
You can repair the installation of any component of the ArchestrA System Platform. You can repair missing or corrupt files, registry keys or shortcuts. You can also reset the registry key to the default value.
Note: You must insert the installer DVD in the DVD-ROM drive before you can repair a program. To repair an installation 1
Click the Add or Remove Programs option in Windows Control Panel. (In Windows Server 2008 R2, this is called Uninstall or Change a Program.) The list of software installed on your computer appears. Select the ArchestrA System Platform component that you want to repair, and then click the Uninstall/Change button. The Modify Repair or Remove Installation dialog box appears.
Note: The name of the Uninstall/Change button varies depending on the Windows operating system installed on your computer.
Repairing an Installation29
Click the Repair option, and then click Next. The Confirm Repair dialog box appears.
Click the Add or Remove Programs option in Windows Control Panel. (In Windows Server 2008 R2, this is called Uninstall or Change a Program.) The list of software installed on your computer appears. Select the ArchestrA System Platform component that you want to uninstall, and then click the Uninstall/Change button. The Modify Repair or Remove Installation dialog box appears.
Note: The name of the Uninstall/Change button varies depending on the Windows operating system installed on your computer.
Click the Remove option, and then click Next. The confirmation dialog box appears.
Click Uninstall. The component is uninstalled and the complete uninstallation dialog box appears.
Insert the DVD into your DVD-ROM drive. Run setup.exe to start the set-up program. The upgrade feature dialog box appears.
Note: You can only upgrade the products that are already installed and you will not be able to install new products 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.
35
If no other ArchestrA-enabled software is installed on the computer, you are prompted to create a new ArchestrA user account or specify an existing user account during the Application Server installation. If you select an existing user account, it should meet the following requirements:
User account with a permanent password that does not expire. User account in which the password cannot be changed. User account that is a member of the local Administrators group.
Note: The Application Server installation will add the necessary SQL Server privileges for SQL Server 2008. For more information, see "SQL Server Rights Requirements" on page 37.
After you install the Application Server, you can use the ArchestrA Change Network Account utility to change or recreate the ArchestrA user account. This utility is located in the Common folder after you install Application Server. You must have Administrator privileges on the computer to make changes with the Change Network Account utility. For more information, see the Change Network Account utility documentation.
Note: If you recreate the user account using the Change Network Account utility, the Microsoft Windows security component on the computer can take several minutes to update this information on the ArchestrA Galaxy node. Until that occurs, the ArchestrA component may not function properly. Restarting the Galaxy node updates this information immediately.
If you accidentally delete the aaAdministrators group from the Windows operating system, you can run either of the two following options to restore it:
39
You can upgrade previous versions of the Application Server to version 3.5.
Version 3.0 SP2 Version 3.1 Version 3.1 SP1 Version 3.1 SP2 Patch 01 Version 3.1 SP3 Patch 01
Important: Ensure that you have installed the latest patch for your existing version, wherever possible, before upgrading to version 3.5. Also, only systems that meet the minimum system requirements, including operating system and SQL Server version, can be upgraded.
You can upgrade the following components of Application Server to version 3.5:
Bootstrap
You will see a warning message if you attempt to upgrade a computer with a deployed WinPlatform. You have the choice to continue with the upgrade or to cancel. If you continue with the Bootstrap upgrade, the WinPlatform object is removed and upgraded to version 3.5. If an InTouchViewApp instance is deployed for a managed InTouch application, the folder is undeployed and deleted. You are prompted to stop InTouch WindowViewer from running the managed application.
Run-time node
Upgrading the Bootstrap on any computer removes the running WinPlatform and AppEngine. Both of these system objects are marked as undeployed if they are running on any Galaxy node.
Note: No system objects are removed on non-GR nodes when migrating from earlier versions of Application Server.
If a remote node is disconnected from the GR node, or if you upgrade the remote node before you upgrade the GR node, the remote Platform is not marked as undeployed. You must undeploy and redeploy the Platform. The run-time functionality of Application Server continues throughout the upgrade process, except during a run-time node upgrade. Configuration, however, must be done using components that are at the same version level. For example, you cannot use the Galaxy Browser in the InTouch HMI on a non-upgraded node to view or select attributes from an upgraded Galaxy. You can, though, view or modify run-time data using an InTouch window or the Object Viewer.
Upgrade your hardware and prerequisite software such as the operating system or Microsoft SQL Server to the required versions. For information on hardware and software requirements, see the Readme file. If you are upgrading the SQL Server 2008 database on the GR node, you must undeploy the GR node before starting the SQL Server 2008 upgrade.
Upgrade the GR node. For more information, see "Upgrading a Galaxy Repository Node" on page 42.
Upgrade at least one IDE installation. If you upgrade the GR node, that IDE installation is upgraded. However, if you have any IDE-only nodes, you will have to upgrade them separately. For more information, see "Upgrading an IDE-only Node" on page 43. Use the upgraded IDE to connect to the upgraded GR node and migrate the Galaxy database. For more information, see "Migrating the Galaxy Database" on page 44. Deploy the GR Platform. Upgrade run-time nodes.
5 6
Upgrade the GR node. Upgrade the IDE node. Migrate the Galaxy database. Upgrade the remote Platforms.
Important: After you have upgraded the GR node to Application Server version 3.5, you will not be able to deploy or undeploy from the GR node to non-upgraded remote nodes. Also, the upgraded GR node will not be able to connect to an IDE node that has not been upgraded to version 3.5. Note: As long as the operating system and SQL requirements are met, upgrade is supported. During software installation, operating system upgrade is not supported.
Run Setup.exe from the DVD. The Welcome dialog box appears. Click Next. Review the recommended steps before you upgrade and take appropriate action, if needed. Click Next. Review the status of objects deployed in the system and take appropriate action, if needed. Click Next. The Select Features dialog box appears. Any previously-installed features appear dimmed. Click Next. The Prerequisites dialog box appears. You can select the Show All check box to view all prerequisites. Click the prerequisite whose status is "Not Met", and then click Install Prerequisites. The general system prerequisites are installed. Click Next. Follow the prompts to complete the upgrade.
On the IDE node, run Setup.exe from the DVD. The Welcome dialog box appears. Click Next. The Select Features dialog box appears. Any previously-installed features appear dimmed. Click Next. The Prerequisites dialog box appears. You can select the Show All check box to view all prerequisites. Click the prerequisite whose status is Not Met, and then click Install Prerequisites. The general system prerequisites are installed. Click Next. Follow the prompts to complete the upgrade.
The IDE you use to migrate the database must be the current
version.
Start the IDE. Connect to the Galaxy database to migrate. You are prompted to migrate it. Follow the prompts to complete the migration.
Upgrading to Application Server 3.5 on a run-time node will remove any deployed Platforms on that node. After you upgrade and then deploy a run-time node, it continues to function with other run-time nodes as long as the other nodes are the current version or from the previous version. The run-time node does not function while you are upgrading it. You cannot roll back the upgrade. After you upgrade the run-time node and all hosted objects, you need to redeploy the WinPlatform to the node. The GR node migration fails if the GR node is used as a run-time node for another GR.
To upgrade a run-time node 1 2
Run Setup.exe from the DVD. The Welcome dialog box appears. Click Next. Accept the license agreement.
3 4 5 6
Click Next. Review the status of objects deployed in the system and take appropriate action, if needed. Click Next. The Select Features dialog box appears. Any previously-installed features appear dimmed. Click Next. Follow the prompts to complete the upgrade. Deploy the platform and all hosted objects to the run-time node.
Using the System Management Console (SMC), set all engines on the redundant pair platforms to off-scan.
Note: Alarms do not update in alarm clients while the engines are set to off-scan. 2
Run Setup.exe from the DVD. The Welcome dialog box appears. Click Next. Accept the license agreement. Click Next. Review the status of objects deployed in the system and take appropriate action, if needed. Click Next. The Select Features dialog box appears. Click Next. Follow the prompts to complete the upgrade.
3 4 5
Repeat step 2 for the backup node. Deploy the primary platform. Deploy the backup platform.
47
You need to meet the requirements and prerequisites for Wonderware products.
If you are licensed for a ArchestrA System Platform or the Wonderware Application Server, you can use all the functionality in these products up to the limits in your license files. If you are licensed for only InTouch 10.5 development and run time, you are licensed to use:
All InTouch product software capabilities InTouch tags up to the licensed limit ArchestrA graphics ArchestrA IDE
Important: You are not licensed to use or deploy in production any Object templates in the IDE other than InTouchViewApp Object.
However, you can use the additional functionality in the Wonderware Application Server in a Demo mode as you learn about its capabilities and consider the advantages of upgrading to full Wonderware System Platform license. Wonderware provides you with most or all of the product software in a demonstration, or Demo, mode. Demo mode lets you learn about and experience the full breadth of the Wonderware product line, technology, and capabilities without requiring a legal license file to run the software.
How to obtain licensing information:
You can browse licensing information for any computer that appears in the ArchestrA License Manager browser.
You can navigate to the ArchestrA License Manager from Start, All Programs, Wonderware. You can start the ArchestrA License Manager from any Wonderware product by clicking Help, About, then click View License.
You can use the License Information utility to see whether the current local or remote I/O counts exceed the maximum specified by your Wonderware license.
In addition, carefully read the License Certificate documentation, which describes the licensed products you received. The License Certificate is included with your Licensing CD.
Important: Attempting to deploy unlicensed functionality to a production environment is illegal and results in problems when upgrading to a future version. Deploying unlicensed functionality is not supported by Wonderware.
For further explanation of licensing compliance, see Appendix B of the InTouch Data Management Guide installed with the software. Or, contact your local Wonderware Distributor or Wonderware Technical Support.
51
For your Wonderware Historian to achieve maximum performance, make sure your hardware and software meets the following requirements. Because the Wonderware Historian is a high-performance relational database, it is also important to size your system to handle the level of data that you expect to store. The Wonderware Historian is tightly integrated with Microsoft products, and a working knowledge of both Microsoft SQL Server and Microsoft Windows operating systems is required. For more information on Microsoft SQL Server or Windows operating systems, see your Microsoft documentation.
Server Requirements
The minimum hardware and software requirements for the Wonderware Historian are based on the tag count and the anticipated data throughput rate. These requirements are divided into four levels, which are outlined in this section.
The recommended memory configuration for SQL Server 2005 (32-bit) and SQL Server 2008 (32-bit) is to clamp their memory consumption to 50 percent of the amount of physical memory installed on the server or 512 MB, whichever is larger. For SQL Server 2008 R2 Standard and Enterprise editions (32-bit), the recommended physical memory configuration is 1 GB. The recommended Windows virtual memory setting is twice the amount of physical RAM installed on the server. (See the Microsoft Web site, www.microsoft.com, for updated installation requirements for SQL Server versions.) For tag counts less than 30,000, the data throughput rate is assumed to be equal to the tag count. For tag counts greater than or equal to 30,000, the data throughput rate is assumed to be 30,000 values per second. This is the guaranteed throughput that the system can handle, but throughput rates substantially higher, are possible depending on the hardware configuration. You can install the Wonderware Historian on operating systems that have the User Account Control (UAC) turned on. If you are running the Wonderware Historian on a virtual server, the historian must have an adequate CPU, adequate network memory, and disk I/O resources at all times. Overloading the virtual server leads to unpredictable behavior.
Note: If the Wonderware Historian is running on the Windows Server 2003 or later operating system, DDE is not supported.
Operating Systems
Windows Server 2003 Enterprise R1/R2 SP2 Windows Server 2003 Standard Edition R1/R2 SP2 Windows XP Professional SP3 Windows Server 2008 Standard (32 or 64-bit) Windows Server 2008 Enterprise Edition SP2 (32 or 64-bit) Windows Server 2008 R2 Standard Windows Vista Business SP2 (32 or 64-bit) Windows Vista Enterprise SP2 (32 or 64-bit) Windows Vista Ultimate Edition SP2 (32 or 64-bit) Windows 7 Professional Edition (32 or 64-bit) Any of the above running under VMWare ESX, Server version 4.0 Stratus with Windows Server 2008 SP2
Server Requirements53
The following are the supported SQL Server versions (32-bit versions only):
Microsoft SQL Server 2008 SP1 Enterprise Edition Microsoft SQL Server 2008 SP1 Standard Edition Microsoft SQL Server 2005 SP3 Standard Edition Microsoft SQL Server 2005 SP3 Enterprise Edition
Disk Space
300 MB of free disk space to install the Wonderware Historian Appropriate space for history block storage. For more information,
see "Disk Sizing and Data Storage" on page 56.
Level 1 Server - Hardware
A Level 1 server can handle a load of about 5,000 tags. For example, 2,600 analogs, 2,200 discretes, 300 strings, and 20 non-I/O Server (manual) tags. The requirements are:
Processor: Minimum: P4 3.2 GHz CPU Recommended: dual-core CPU RAM: Minimum: 1 GB (Windows Server 2003 and Windows XP) Minimum: 2 GB (Windows Server 2008 and Windows Vista) Recommended: 4 GB 100 Mbps network interface card (NIC)
Level 2 Server - Hardware
A Level 2 server can handle a load of about 63,000 tags. For example, 40,000 analogs, 20,000 discretes, 300 strings, and 5,000 non-I/O Server (manual) tags. The requirements are:
Processor: Minimum: P4 3.0 GHz dual CPU Recommended: quad-core CPU RAM: Minimum: 4 GB Recommended: 6 GB 1 Gbps network interface card (NIC)
A Level 3 server can handle a load of 130,000 tags. For example, 70,000 analogs, 50,000 discretes, 6,000 strings, and 20 non-I/O Server (manual) tags. The requirements are:
Processor: Minimum: P4 2.7 GHz Xeon quad CPU Recommended: dual processor, quad-core CPUs RAM: Minimum: 6 GB Recommended: 10 GB 1 Gbps network interface card
A performance report for different historian systems is provided in "System Sizing Examples" on page 73.
Any of the following operating systems: Windows Server 2003 Enterprise R1/R2 SP2 Windows Server 2003 Standard Edition R1/R2 SP2 Windows XP Professional SP3 Windows Server 2008 Standard SP2 (32 or 64-bit) Windows Server 2008 Enterprise Edition SP2 (32 or 64-bit) Windows Server 2008 R2 Standard Windows Vista Business SP2 (32 or 64-bit) Windows Vista Enterprise SP2 (32 or 64-bit) Windows Vista Ultimate Edition SP2 (32 or 64-bit) Windows 7 Professional (32 or 64-bit) Any of the above running under VMWare ESX Stratus with Windows Server 2008 SP2
ArchestrA System Platform Installation Guide
Microsoft Management Console 2.0 MDAC 2.7 Internet Explorer 6.0 or later 20 MB of free disk space
Note: The InTouch History Importer is installed as part of the server installation.
When you install the historian, you must specify an administrative user account under which all of the historian services run. Make sure that this same user account is added to the Administrators security group on the remote IDAS computer. The existence of the same administrative user account on both the computers, allows the historian to access the remote IDAS, and vice versa.
Note: A remote IDAS only requires the same administrative account to exist on the local computer and the historian. It is not required for you to log on to the remote IDAS computer using the administrator account.
If you change the Windows login using the System Management Console, after installing the historian, make sure that the user account change is reflected on the remote IDAS computer. If you are running the historian in a domain environment (recommended), you can create the administrative user account on the domain controller and add the account to the Administrators group on the historian computer and the remote IDAS computer. Do not create a local user on any computer with the same name and/or password as the administrative user account. If you are running a remote IDAS in a workgroup environment, there is no centralized management and authentication of user accounts (no domain controller). Create the same administrative user account on each individual computer running a historian component. For example, if you have a computer running the historian and plan to install remote IDASs on two other computers, create the user account (that is, matching user names and passwords) on all three computers. For information on workgroups, domains, creating user accounts, and adding accounts to the Administrators security group, see your Microsoft operating system documentation.
How often is data in the Microsoft SQL Server database changing? Is anyone in the organization going to require operating data that
is older than a month? Older than a year?
What happens if the system stops storing data? What happens if stored data is lost as a result of a hard drive
failure?
Disk space required to store the historian database files. Disk space required to store the historian data files. If a remote IDAS is used, the disk space required on the local IDAS
computer to store cached data if the network connection to the historian fails.
The Runtime and Holding databases are set to automatically expand at a 10% rate (the default). You cannot change these defaults during the installation. The databases can be resized later using Microsoft SQL Server utilities. For more information on sizing databases, see your Microsoft SQL Server documentation for guidelines.
Note: If you are upgrading version 9.0 or 10.0 of the Wonderware Historian, the installation program needs space to save a copy of the old Runtime database while it creates the new one. To upgrade, the database space required is twice the size of the old database, plus the database size for the new install.
A performance report for different historian systems is provided in "System Sizing Examples" on page 73.
The disk usage per day for 10,000 discrete tags (that is, Storage Size = 1 byte) that are changing, on average, every 60 seconds would be (1.15*(1+3)*10000)*(60/60)*60*24/2, which is approximately 32 MB per day. The disk usage per day for 10,000 8-byte string tags (that is, Storage Size = 8 bytes) that are changing, on average, every 60 seconds would be (1.15*(8+3)*10000)*(60/60)*60*24/2, which is approximately 87 MB per day.
Performance Considerations61
Performance Considerations
For a complete Wonderware Historian system, the following components put a demand on memory.
The associated Microsoft SQL Server The operating system Client access (data retrieval), which includes caching
When determining the amount of memory to purchase, remember that adding more memory is the cheapest and easiest thing that you can do to improve performance. Increasing the amount of memory reduces the amount the server has to use virtual memory, thus lowering the load on the storage subsystem. Even if you have a large amount of memory, additional memory is used as additional disk cache, speeding up disk access and therefore file service. Also, processes needed by the server become faster because they are memory-resident. A major factor in system performance is the amount of plant data you anticipate storing in the system, including considerations about how often that data is stored and retrieved. In general, the more you store, the more often you store it, and the more you retrieve it, the slower the system. The major storage factors affecting the performance of the system are:
Effective analog flow rate (analog updates per second). Period of online data storage required. Effective discrete variable flow rate. Number of concurrent end users required. Complexity of end user queries. Number and size of string tags, as well as the effective flow rate of
string values.
Server Loading
When a user connects to the Wonderware Historian with a client, configuration information is immediately requested from the historian. This information includes the tags that the server stores, their descriptions, engineering units, and other tag data. SQL Server reads this information from the database (stored on disk) and places it in memory. As the user selects time periods to trend, the historian reads data from files located on the disk and prepares the results of the client's data request to be transmitted back to the client. The ability of the server to quickly handle subsequent requests for data from the same client and others is dependent on the server's ability to keep as much information in memory without having to again access data from the disk. As a higher load is placed for memory, a higher load is placed on the disk I/O system as the server has to use disk caching and read from the data files. The following table summarizes the loading for various systems.
System Load Description
Base load of the historian. This load exists as long as the system is running. However, this load is not affected by client activity. Variable loading caused by data retrieval from client applications. When the client initially connects, the data requested is configuration data, which is stored in SQL Server. The historian requests data from SQL Server, causing its loading to increase. As the client requests historical data, the disk time increases as information from the data files is transferred to memory. This continues as the client requests additional data. If the client application requests data that has already been transferred to memory, there is no associated disk activity and transfer of data to memory.
The server must be able to adequately handle the variation on loading caused by the client applications. To accomplish this, make sure that your hardware is sized so that it can handle the base load created by the acquisition and storage systems and that there are adequate resources still available for the retrieval system.
Performance Considerations63
IDAS Performance
An IDAS can acquire an unlimited number of real-time data values, from an unlimited number of I/O Servers, each with an unlimited number of topics. However, IDASs are subject to the following limitations.
The size of any data value is limited to 64,000 bytes. The maximum number of tags supported by any single IDAS is
30,000.
Tiered Historians
If you are installing a tiered historian, tier 1 nodes use the same basic configuration for the number and types of tags and data collection rates. The tier 1 configuration should be delta data collected and stored:
12,000 analog tags every 2 seconds 2,900 discrete tags every 2 seconds 100 32-character string tags every 30 seconds
For the analog and discrete tags, the averages and value state aggregates are:
1500 tags replicated (not aggregated) in tier 2 1500 tags stored only in tier 1 (no aggregates or replication)
Networking Recommendations
The Wonderware Historian is a highly configurable package that can be set up in many different ways depending on your needs. The historian can use any protocol currently supported by Microsoft SQL Server 2008. You can use the default Microsoft SQL Server 2008 protocol (named pipes) with TCP/IP. TCP/IP is required if SuiteLink is used.
Note: If the historian is running on the Windows Server 2003 or later operating system, DDE is not supported.
It is highly recommended that you run the historian on a dedicated computer. For example:
Do not use the historian computer as a workstation. Do not use the historian computer for InTouch HMI software,
InControl, or other Wonderware products.
Networking Recommendations65
Generally, it is recommended that you split the process and IS networks to ensure that the process network does not become overloaded. The following illustration shows one possible network architecture where the historian is the link between the process network and the business LAN/WAN:
For this architecture, install two network cards on a server computer and configure them to segment the IS network from the process network.
Note: All tags to be stored in historian are on "advise" all the time. This may cause heavy load conditions on the process network. Before you install the historian, investigate the possible load impact of installing the historian on your network.
Client Access
All clients should connect to the Wonderware Historian using the default Microsoft SQL Server connection. Usually, this means using the name of the computer on which the historian is running as the server name when logging on.
Event System: Each different time interval for event tags uses a
database connection and zero Windows connections. For example, if there are 15 event tags with time interval of 30 minutes, and 10 event tags with an interval of 60 minutes, that consumes two connections. The event subsystem uses zero Windows connections.
Local IDAS: Consumes no connections. Remote IDAS: Each remote IDAS uses one Windows connection
and zero database connections.
Client Access67
Licensing
The Wonderware Historian requires a valid license to run. Use the ArchestrA License Utility to manage licenses and associated feature lines. The historian allows functionality based on the presence of a valid license file and/or feature lines. The historian checks that:
A valid license file exists at the expected location on disk. One or more feature lines relevant to the product is contained in
the license file. A feature line defines specific behavior that is allowed for the product. Typically, feature lines are bundled together according to predefined licensing schemes. If a valid license file cannot be found, or if the file does not contain the appropriate feature lines, the historian is considered to be unlicensed. If unlicensed, the historian starts up and runs for an unlimited period of time. However, data is only collected and stored for system tags. The historian reads the license file and appropriately updates the system behavior when:
The historian starts. You commit changes to the system using the System Management
Console.
Historian_Tagcount Feature Line Historian_ServerOS Feature Line Historian_RemoteIDASCount Feature Line Historian_ModifyHistoryData Feature Line Historian_HistoryDuration Feature Line Historian_Processors Feature Line
Use the System Management Console to view license and feature line information relevant to the historian. For more information, see "Viewing License Information" in Chapter 9, "Viewing or Changing System-Wide Properties," in the Wonderware Historian Administration Guide.
Licensing69
Windows Server 2003 Enterprise R1/R2 SP2 Windows Server 2003 Standard Edition R1/R2 SP2 Windows Server 2008 Standard or Enterprise Editions SP2 (32 or
64-bit)
The local IDAS is counted only once, even if it has a failover node
configured. At runtime, the failover IDAS (which must be on a remote node), does NOT run unless a valid license for at least one remote IDAS is present.
Licensing71
If the feature line is present, all CSV file import operations, as well
as SQL inserts and updates, are permitted.
Hyperthreaded and multi-core CPUs are supported and recommended. From a licensing perspective, a "processor" is the physical "package" and a multi-core or a hyperthreaded processor is counted as a single processor.
Any client application that can retrieve information using SQL can retrieve data from Wonderware Historian. For example, some Wonderware products that can retrieve data by means of SQL queries are the InTouch HMI, Wonderware Information Server, Historian Client applications and controls, SPCPro, Manufacturing Execution Module, and InBatch products. The historian further extends SQL to improve the ability to handle time series data.
Also, Wonderware Historian I/O Server (aahIOSvrSvc.exe) is an interface for clients to access current data values a historian by means of the SuiteLink protocol. The Wonderware Historian I/O Server can update items with current values for given topics, providing "real-time" I/O Server functionality. Finally, you can use InTouch to configure the historian by importing tag definitions and I/O Server definitions from the InTouch Tagname.x file into the Runtime database.
DELL OptiPlex 755 with 2.4 GHz single processor quad-core CPU 4 GB RAM 512 MB Virtual Memory 1 Gbps NIC Windows XP Professional SP2 Microsoft SQL Server 2005 Standard Edition SP3 SQL memory clamped @ 512 MB 12-hour history block duration
Tag Information
Tag count (total) = 5,187 Analog tags = 2,607 Discrete tags = 2,285 String tags = 295
None.
Event Information
3 snapshot events, each having: 1 analog snapshot 1 discrete snapshot 1 string snapshot 2 summary events, each having: 1 AVG calculation (1 tag every 8 hours) 1 MAX calculation (1 tag every 8 hours) 1 MIN calculation (1 tag every 8 hours) 1 SUM calculation (1 tag every 8 hours) 1 SQL insert every 4 hours 2 SQL multi-point updates every hour
Query Load
For the following seven queries, each are occurring at different times in the hour:
1 query (trend): live mode - 1 second update 1-hour duration 10 tags (7 analogs, 3 discretes) 1 query: 1-hour range / hour (1 tag) 4 queries: 15-minute range / hour (1 tag) 1 query: 24-hour report every 24 hours (25 to 30 tags)
Average CPU load (%) Wonderware Historian memory (Private Bytes) consumption (MB) Number of online history blocks Uncompressed hard drive disk space per history block (MB)
4 GB RAM 3072 MB Virtual Memory 1 Gbps NIC Windows 2003 Standard Server Microsoft SQL Server 2005 Standard Edition SP3 SQL memory clamped @ 1024 MB 4-hour history block duration
Tag Information
Tag count (total) = 63,000 Analog tags = 39,359 Discrete tags = 19,734 String tags = 295 Manual tags = 5,057 Update rate of +/- 30,000 updates/second
Remote IDAS
P4 1.7 GHz 1 GB RAM 34,000 tags via the remote IDAS and the rest via the local IDAS
Note: Because this configuration was used for performance and stress testing, the remote IDAS tag count is more than the recommended 30,000 maximum. Event Information
3 snapshot events, each having: 1 analog snapshot 1 discrete snapshot 1 string snapshot 2 summary events, each having: 1 AVG calculation (1 tag every 8 hours) 1 MAX calculation (1 tag every 8 hours) 1 MIN calculation (1 tag every 8 hours) 1 SUM calculation (1 tag every 8 hours) 1 SQL insert every 4 hours 2 SQL multi-point updates every hour
Query Load
For the following seven queries, each are occurring at different times in the hour:
1 query (trend): live mode - 1 second update 1- hour duration 10 tags (7 analogs, 3 discretes) 1 query: 1-hour range / hour (1 tag) 4 queries: 15-minute range / hour (1 tag) 1 query: 24-hour report every 24 hours (25 to 30 tags)
Average CPU load (%) Wonderware Historian memory (Private Bytes) consumption (MB) Number of online history blocks Uncompressed hard drive disk space per history block (GB)
DELL PowerEdge 6800 with four dual-core Intel Xeon 3.4 GHz
CPUs
16 GB RAM 4096 MB Virtual Memory 1 Gbps NIC Windows 2003 Enterprise Server Microsoft SQL Server 2005 Standard Edition SP3 SQL memory clamped @ 3967 MB 2-hour history block duration
Tag Information
Tag count (total) = 133,941 Analog tags = 73,600 Discrete tags = 53,560 String tags = 6920 Update rate of +/- 50,000 updates/second
MDAS
In the total tag count, 4009 tags originated from Wonderware Application Server.
Remote IDAS
Remote IDAS 1: P4 1.9 GHz, 1 GB RAM Remote IDAS 2: P4 2.5 GHz, 512 MB RAM
44,370 tags via the remote IDAS 1 45,584 tags via the remote IDAS 2 44,383 tags via the local IDAS
Note: Because this configuration was used for performance and stress testing, the remote IDAS tag counts are more than the recommended 30,000 maximum. Event Information
3 snapshot events, each having: 1 analog snapshot 1 discrete snapshot 1 string snapshot 2 summary events, each having: 1 AVG calculation (1 tag every 8 hours) 1 MAX calculation (1 tag every 8 hours) 1 MIN calculation (1 tag every 8 hours) 1 SUM calculation (1 tag every 8 hours) 1 SQL insert every 4 hours 2 SQL multi-point updates: 1 every 15 minutes 1 every 30 minutes
Query Load
For the following seven queries, each are occurring at different times in the hour:
1 query (trend): live mode - 1 second update 15-minute duration 15 tags (10 analogs, 5 discretes) 1 query: 1-hour range / hour (1 tag)
4 queries: 15-minute range / hour (1 tag) 1 query: 24-hour report every 24 hours (25 to 30 tags)
Performance Results Category Value
Average CPU load (%) Wonderware Historian memory (Private Bytes) consumption (MB) Number of online history blocks Uncompressed hard drive disk space per history block (average GB)
The 400 Kbps data transfer limit reflects a typical data transfer speed between remote locations over the Internet. The data transfer from each tier-1 historian to a tier-2 historian is assumed to be through a dedicated 400 Kbps connection; multiple tier-1 historians do not share the same 400 Kbps connection. It is assumed that the 400 Kbps is a bandwidth that can be fully used.
Tier 2 Historian Specifications
DELL PowerEdge 6800 with four dual-core Intel Xeon 3.4 GHz
CPUs
16 GB RAM with enabled PAE or 4 GB RAM Disk I/O subsystem of a 100MB/s throughput, 6 ms access time. 100/1000 Base-T network card 400 Kbps network connection (actual usable bandwidth)
Tier 1 Historian Specifications
4 GB RAM Disk I/O subsystem of a 60MB/s throughput, 16 ms access time. 100/1000 Base-T network card
Loading Information
Assume that the total tag count on the tier-1 historian is 15,000. The tier-1 historian receives 15,000 tags from I/O Servers of the following types and data rates:
2,800 1-byte discrete delta tags changing every 2 seconds 200 variable-length string delta tags of 32-character length
changing every 30-seconds The tier-2 historian stores the following:
Average CPU load (%) (with no queries executing) Wonderware Historian memory (Virtual Bytes) consumption (GB) Number of online history blocks Uncompressed hard drive disk space per history block (average MB)
Latency Results Category Value
Latency is the difference in time between when the value is received by the tier-1 historian and when it is received by the tier-2 historian.
Tier-2 Historian
DELL PowerEdge 6800 with four dual-core Intel Xeon 3.4 GHz
CPUs
16 GB RAM with enabled PAE or 4 GB RAM Disk I/O subsystem of a 100MB/s throughput, 6 ms access time. 100/1000 Base-T network card 100 Kbps network connection (actual usable bandwidth)
Tier 1 Historian Specifications
4 GB RAM Disk I/O subsystem of a 60MB/s throughput, 16 ms access time. 100/1000Base-T network card
Loading Information
Assume that the total tag count on the tier-1 historian is 15,000. The tier-1 historian receives 15,000 tags from I/O Servers of the following types and data rates:
2,800 1-byte discrete delta tags changing every 2 seconds 200 variable-length string delta tags of 32-character length
changing every 30-seconds The tier-2 historian stores the following:
Average CPU load (%) (with no queries executing) Wonderware Historian memory (Virtual Bytes) consumption (GB) Number of online history blocks Uncompressed hard drive disk space per history block (average MB)
Latency Results Category
Value
Latency is the difference in time between when the value is received by the tier-1 historian and when it is received by the tier-2 historian.
Tier-2 Historian
56 Kbps
4 GB RAM Disk I/O subsystem of a 60MB/s throughput, 16 ms access time. 100/1000Base-T network card 56K modem
Tier 1 Historian Specifications
OptiPlex 755 with single processor quad-core CPU 2.4 GHz 4 GB RAM Disk I/O subsystem of a 60MB/s throughput, 16 ms access time. 100/1000Base-T network card 56K modem
Loading Information
In the tier-1 historian modem configuration, the tier-1 historian receives 3,000 tags from I/O Servers of the following types with average update rate 300 items per second:
1,500 4-byte analog delta tags (1,400 always fitting the real-time
window and 100 falling outside of the real-time window being 50 minutes late)
1,350 1-byte discrete delta tags 150 variable-length string delta tags of 32 bytes each
Performance Results for the Tier-2 Historian Category Value
Average CPU load (%) (with no queries executing) Wonderware Historian memory (Virtual Bytes) consumption (GB) Number of online history blocks Uncompressed hard drive disk space per history block (average GB)
Latency Results Category Value
1% 1.86 GB 30 43 MB
Latency is the difference in time between when the value is received by the tier-1 historian and when it is received by the tier-2 historian.
87
Microsoft SQL Server Historian program files, database files, and history data files System Management Console, the configuration and control tool One or more local or remote IDASs (at least one must be defined) Wonderware Historian documentation.
You should have a definite plan for implementing the historian in your plant environment before you start the installation process. This plan should include the type of network architecture for the historian system, the amount of disk space required for data storage, and the amount of space required for the historian database files and log files. Also, any administrative security accounts that you specify for either the Microsoft SQL Server or the historian should be accounts that do not change often, if ever. In particular, do not change an administrative password during any part of the installation process. You must have administrative rights on the local computer to install the historian. The account with which you log on to the computer must also be a sysadmin for the SQL Server or you must be able to provide a sysadmin account for the SQL Server when prompted for it during the installation. For SQL Server 2008, computer administrators are not automatically added as SQL Server sysadmins by default.
The installation program detects any previous versions of the historian and notifies you of your migration options.
Microsoft SQL Server 2005 or 2008 is required. Microsoft Client Utilities must be installed. The historian must run with the Microsoft SQL Server default
instance name (that is, the computer name).
Make sure that the x86 option is selected from the Options panel
before installing SQL Server. If SQL Server is installed as a native 64-bit application, it wont work with Wonderware Historian.
Remote Microsoft SQL Servers are not supported by the historian. For networking support, use named pipes and any other support
required at your site. However, you must select at least named pipes and TCP/IP sockets (the defaults). It is highly recommended that you do not modify the default configuration for named pipes and TCP/IP sockets.
As you select the path to the data files, you must consider that the
historian Runtime database will grow, especially if you are going to use the event subsystem (including summaries) or storing data in the ManualAnalog, ManualDiscrete, or ManualString tables.
For obvious security reasons, you should not use a blank password
for Microsoft SQL Server.
Installs or re-installs the historian, configuration tools and utilities, a local IDAS, and ActiveEvent. An IDAS, which can be used remotely. The IDAS is always installed if you select to install a complete historian. The server management tools include Wonderware Historian Configuration Editor and Wonderware Historian Management Console. Both of these applications are MMC snap-ins that are contained in the System Management Console. These tools are always installed on the same computer as the historian and can also be installed on a different computer on the network. The Wonderware Historian Database Export/Import Utility is also an installed configuration tool. ActiveEvent is an ActiveX control that allows you to notify the historian event system when an event has occurred in another application, such as InTouch HMI software.
Configuration Tools
ActiveEvent
Checks for required disk space based on the features that you
select.
Creates and/or configures the required databases. Creates the directory for the history data files (history blocks).
To install the Wonderware Historian for use in a tiered historian environment, install the Wonderware Historian on the individual computers, then implement them as described in Chapter 7, "Managing and Configuring Replication," in the Wonderware Historian Administration Guide. Use the ArchestrA System Platform installation program to install the entire system or any of the features. It is assumed that you are familiar with the installation options. The installation program does not log any errors that may occur. You must have administrative rights on the local computer to install the historian. The account with which you log on to the computer must also be a sysadmin for the SQL Server or you must be able to provide a sysadmin account for the SQL Server when prompted for it during the installation. For SQL Server 2008, computer administrators are not automatically added as SQL Server sysadmins by default.
Important: Do not install Wonderware Historian on a computer named INSQL, because this conflicts with the name of the Wonderware Historian OLE DB provider and the installation eventually fails.
For detailed instructions on installing, see Chapter 1, "ArchestrA System Platform Installation." After the installation completes, configure the server using the instructions in "Configuring Databases and Data File Locations" on page 91. Refer the Readme file before using the historian.
Click Configure on the final installation dialog box. The Configurator dialog box appears. The product feature tree expands by default.
The Legend box shows the status indicators. The status indicators are:
Error
- Indicates that an error occurred during configuration. - Indicates that the feature is installed, but not configured.
- Indicates that configuration is complete, but with - Indicates that configuration completed - Indicates that the feature is not installed.
Configured
successfully.
Not Installed
Click the Historian Server node. The Configurator dialog box appears. The prerequisite status check automatically starts.
Unless you have specific requirements, keep the default SQL Server database path. This is the path where the configuration database is deployed. Click the ellipsis button to specify a different directory in which to install the historian database files.
Data Path
Click the ellipsis button to specify a different directory for the historian history blocks. Make sure that you have a sufficient amount of available space on the drive you specify, because the plant data will be stored primarily in the path you specify in the Data Path box, which is used for history blocks. The SQL Server database files typically take less disk space.
If the database is created for the first time, then this option is not available. When re-configuration is done, then the Drop and Create New Database option is available. If you select this check box, then the existing database is dropped and a new database is created. If this check box is cleared, then the database would not be dropped, but will be configured for changes, if any.
4
Historian Database
In the Service Configuration area, configure options that pertain to components of the Historian that run as Windows services.
Replication TCP Port
If you are configuring a tiered historian server, enter the port number for tag replication between the tier 1 and tier 2 servers. You must enter the same port for all the tier 1 and tier 2 systems working together in the tiered configuration. The port you specify is added to the exclusions list of Windows Firewall.
Auto Start Historian
In the Start Applications area, click the appropriate button to start the License Manager or the InTouch Tag Importer. These buttons are not available until the server is successfully configured. In the SQL Login Information area, you can log on to the SQL Server if you have the "sysadmin" privileges enabled. You can select the Windows Authentication radio button to use the interactive users account or select SQL Server Authentication radio button and provide the credentials as required. This connection information is not stored and is used only for completing the configuration. When you click Connect, the connection to the SQL Server is tested.
In the Configuration Messages area, you can view the messages regarding prerequisite checks, current configuration state, and configuration activities that are logged.
Click Configure. The Processing SQL Script dialog box appears. You can see the historian database configuration scripts running. Multiple scripts run during the configuration.
After the system finishes running the SQL scripts, the Wonderware Historian node and Historian Server node are shown with a green status indicator if the database is successfully configured.
Start the historian. Start the storage system and check that the system is receiving data from the system tags.
After the historian is installed, no additional configuration is required to run client tools against the server using named pipes. However, you may want to change the system or server configuration using the System Management Console
Antivirus Software
After installing the Wonderware Historian, configure your antivirus software to prevent archive files from being scanned. Also, antivirus software should not scan files in the following folders (ensure the sub folders of the listed directories are also excluded): The datapath that you enter in the Data Path field in the configurator while configuring the database. The default path is c:\Historian\Data\*.* c:\Program Files\ArchestrA\*.* c:\Program Files\Wonderware\*.* c:\Program Files\Common Files\ArchestrA\*.* c:\Program Files (x86)\ArchestrA\*.* c:\Program Files (x86)\Wonderware\*.* c:\Program Files (x86)\Common Files\ArchestrA\*.* For Windows XP Professional and Windows Server 2003 operating systems, the path is: c:\Documents and Settings\All Users\Application Data\ArchestrA\ For Windows Vista, Windows Server 2008, Windows 7 Professional, and Windows Server 2008 R2 operating systems, the path is: c:\ProgramData\ArchestrA\ For Windows XP Professional and Windows Server 2003 operating systems, the <SMC Logger Storage file path> is: c:\Documents and Settings\All Users\Application Data\ArchestrA\LogFiles
For Windows Vista, Windows Server 2008, Windows 7 Professional, and Windows Server 2008 R2 operating systems, the <SMC Logger Storage file path> is: c:\ProgramData\ArchestrA\LogFiles SQL Server database files of type: .mdf .ldf
Database Configuration Export and Import Import InTouch Historical Data Wonderware Historian Historian Books Online
In addition, the shortcut to the System Management Console appears in the Start\Programs\Wonderware folder.
Note: If you performed a complete historian installation, the System Management Console is configured so that the local SQL Server is already registered. However, if you only installed the client tools, the console is empty.
Back up the Runtime database. Shut down and disable Wonderware Historian 9.0 using the Management Console. Any remote sending data of IDAS to Wonderware Historian 9.0 will go into store-and-forward mode.
Run the ArchestrA System Platform installation program to perform the upgrade. For more information, see "Upgrading an ArchestrA System Platform Component" on page 32. Migrate the 9.0 Runtime database or create the new database and finish the install. Restart the computer. Start the Historian. The Historian will start acquiring and storing the store-and-forward data from the existing remote IDASs. After the Historian Server node is upgraded, you can upgrade any remote IDAS nodes.
4 5 6 7
If Wonderware Historian 9.0 is not running on an operating system or SQL Server supported by Wonderware Historian 10.0 SP1, you cannot migrate the operating system or SQL Server. You will need to set up another computer.
To upgrade from Wonderware Historian 9.0 on a computer NOT running Windows 2003 SP2 and SQL Server 2005 SP3 1 2
Back up the Runtime database. Shut down and disable Wonderware Historian 9.0 using the Management Console. Any remote IDASs sending data to Wonderware Historian 9.0 will go into store-and-forward mode. Set up a computer with the desired supported operating system and SQL Server.
Make sure that you install all the necessary requirements. For
more information, see "Server Requirements" on page 51.
Select the same collation and sort order that was used for your
previous SQL Server installation. For more information, see "Microsoft SQL Server Installation" on page 88.
4 5
Restore the Runtime database using SQL Server database management tools. Run the ArchestrA System Platform installation program to perform the upgrade. For more information, see "Upgrading an ArchestrA System Platform Component" on page 32. The installation program detects the Runtime 9.0 database and prompts you to migrate the database or recreate the new database. The existing Runtime database is renamed to Runtime 9.0 and the version 10.0 SP1 database is created. If you chose to migrate, the utility runs the migration scripts (Migrate90To100.sql and MigrateSQLHistData90to100.sql) to transfer the historian configuration and history data from the old database. Finish the installation of Wonderware Historian.
8 9
Copy history blocks from the previous version to the new computer. Use the historian System Management Console to update the storage locations and system parameters to configure paths as per your new hardware configuration and the Runtime parameters as per your new implementation.
Shut down and disable Wonderware Historian 10.0 using the Management Console. Any remote IDAS nodes to Wonderware Historian 10.0 will go into store-and-forward mode. Run the ArchestrA System Platform installation program to perform the upgrade. For more information, see "Upgrading an ArchestrA System Platform Component" on page 32. The installation program detects the Runtime 10.0 database and prompts you to keep the existing database or recreate the new database. If you re-create the database, existing Runtime database will not be re-named but will be overwritten with a new Runtime 10.0 SP1 database. If you do not re-create the database, the existing database will remain intact. Finish the installation of Wonderware Historian. Restart the computer. Start the Historian. The Historian will start acquiring and storing the store-and-forward data from the existing remote IDASs. After the Historian Server node is upgraded, you can upgrade any remote IDAS nodes.
5 6 7 8
Note: While upgrading from 10.0, you will not be prompted for any kind of database migration. Database migration will only take place if you intend to upgrade Wonderware Historian 9.0, Wonderware Historian 9.0 P01, or Wonderware Historian 9.0 P02 to Historian 10.0 or Historian 10.0 SP1.
The scripts used to migrate the SQL Server history data can be found in the Wonderware Historian installation directory. By default, this directory is:
\Program Files\ArchestrA\Historian\Install\Scripts
The filename is: MigrateSQLHistData90to100.sql Do not attempt to migrate the data until you complete the upgrade to the Wonderware Historian 10.0. To migrate the data, execute these scripts using SQL Server Management Studio. You may prefer to run the script in blocks (that is, execute the syntax commands between the GO statements).
105
You can use the Wonderware Historian Client software to address specific data representation and analysis requirements. The Wonderware Historian Client software maximizes the value of the data present in the Wonderware Historian and helps you organize, explore, analyze, present, and distribute process data in a variety of formats. With the Wonderware Historian Client software, you can:
Explore data graphically to find important information Analyze data Develop and execute ad hoc queries against any data stored in the
Wonderware Historian database
Visualize the current process state Produce rich automated reports, publish Trend charts and static
and dynamic Excel reports on the Wonderware Information Server portal.
Desktop Applications
The Wonderware Historian Client software includes the following stand-alone applications:
Wonderware Historian Client Trend
Allows plotting of historical and recent data over time Allows you to compare data over different time periods
Wonderware Historian Client Query
Allows you to query the Wonderware Historian database Provides complex, built-in queries Eliminates the need to be familiar with the database structure or
SQL
Hardware Requirements
The hardware requirements for installing the Wonderware Historian Client are described in the following table:
Minimum Server Requirement Recommended Server Requirement
Processor
2 GHz or higher
1 GB RAM or more 55 MB
Supported Supported
Supported Supported
Supported Supported
Supported Supported
Operating System
You can visit the Microsoft Web site for instructions on installing the various supported operating systems.
Note: The Wonderware Historian Client components are supported on Microsoft Windows Vista and Windows 7 operating systems with the User Access Control enabled, and without running as an administrator.
109
The ArchestrA System Platform installation program allows you to install the Wonderware Historian Client software. The ArchestrA System Platform installation program copies the files from the setup DVD to the target computer. For more information on the components installed, see "Wonderware Historian Client Components" on page 106.
When the aaHistClientReportingService.exe service stops, any scheduled reports for Wonderware Information Server will not be generated during the Historian Client installation. After the Historian Client installation completes, the aaHistClientReportingService.exe service needs to be started manually for the scheduled reports to get generated. This issue occurs if:
For instructions on installing the Wonderware Historian Client software files, see "Installing the ArchestrA System Platform" on page 13. After the Wonderware Historian Client software is installed on the computer, you must install the Language Packs manually.
Install the Wonderware Historian Server. For installation information, see the Wonderware Historian Server documentation. Install Microsoft Internet Information Services (IIS). IIS can be installed on the same computer as the historian or on a different computer. If you use Windows authentication for HTTP access, SQLXML/IIS must be installed on the same computer as the Wonderware Historian Server. A single IIS Server can provide HTTP access to multiple SQL Servers, but at least one IIS Server is required to provide HTTP access to a SQL Server. For installation information, see the Microsoft documentation.
Note: For a single IIS Server to provide HTTP access to multiple SQL Servers, SQLXML must be separately installed for each SQL Server. If SQLXML is already installed and you attempt to install it again, you are not prompted to modify or repair the existing installation. Rather, a new installation starts for support of an additional SQL Server. 3
Install the Microsoft SQLXML software. For more information, see "Installing the Microsoft SQLXML Software" on page 112. The SQLXML software can only be uninstalled using the Add/Remove Programs application in Control Panel.
No software or special configuration is required on the client computer, other than what is generally required to support the Wonderware Historian Client software installation. When you configure the server connection from within a client application, you must specify the web server URL and virtual directory, as well as provide authentication credentials. For more information, see the Wonderware Historian Client Software User's Guide or the Wonderware Historian Client software Help file.
Insert the Wonderware Historian Client software DVD into your DVD drive. In the \SQLXML directory of the DVD, double-click SQLXML.msi. The Welcome dialog box appears. Click Next. The License Agreement dialog box appears. Be sure that you understand the license agreement before installing. You cannot continue with the installation without consenting to the agreement.
To print out the license agreement, click Print License. If you accept the terms of the license agreement, click I accept
the License Agreement.
Click Next. The Enter the IndustrialSQL Server name dialog box appears.
Click Next. The Enter the Virtual Directory Name dialog box appears.
Click Next. The Ready to Install the Application dialog box appears. Click Next to start the installation. The Updating System dialog box appears. When all of the files have been installed and configured, the final dialog box appears. Click Finish.
For more information on the configuration of the IIS virtual directory for SQL Server, see "Configuring an IIS Virtual Directory for SQL Server" in the Wonderware Historian Client Software User's Guide or the Wonderware Historian Client Help file. This information is provided for reference only.
ActiveFactory 9.2 Wonderware Historian Client 10.0 Wonderware Historian Client 10.0 SP1
The upgrade program automatically backs up the product files, configuration, and user content before the upgrade occurs. When the installation detects the correct previous versions and prerequisite software, the upgrade starts. For more information, see "Upgrading an ArchestrA System Platform Component" on page 32.
115
Wonderware Information Server provides enterprise-wide viewing of all information from the plant floor over the Internet or company intranet. You can use Wonderware Information Server together with Internet Explorer to view reports from a variety of data sources, including reports, documents, alarms, and historical and real-time information. You can also use Wonderware Information Server to view and interact with InTouch application windows that have been converted with the Win-XML Exporter or ArchestrA Web Exporter. These windows show all graphics and animation with real-time links to the factory floor, just as they do in InTouch WindowViewer, but they do not require InTouch to be installed on the client computer. The Wonderware Information Server uses the latest rendering technologies so that application windows developed in InTouch can be viewed over the Internet with better performance using only a browser. Wonderware Information Server is tightly integrated with Microsoft Internet Information Server. Working knowledge of Microsoft Internet Information Services, Microsoft SQL Server, and Windows operating systems is required. It is assumed that you are familiar with administering an Internet Information Server and using the administrative tools provided with Microsoft Windows operating systems. For more information on Internet Information Server, Microsoft SQL Server, and Microsoft Windows operating systems, see your Microsoft documentation.
Installing and configuring pre-requisite software, such as the operating system, Microsoft SQL Server, Internet Information Services (IIS), and so on. Installing the Wonderware Information Server product files. Configuring the Wonderware Information Server, so that it is ready for use.
2 3
For details on hardware requirements and the specific versions of required and supported software prerequisites, see the Readme file.
Software Requirements
You must install the following software on the web server computer before installing Wonderware Information Server. For details regarding the specific versions of required and supported software prerequisites, see the Readme file.
In addition, client users must be members of the same Windows domain, or a trusted domain, as the web server. You must install an ArchestrA Bootstrap on the Wonderware Information Server portal computer to support any process graphic that uses an ArchestrA reference to get data.
Install the operating system on an NTFS partition. Install the defaults for Windows Server 2003 components. Select
the following IIS components:
Common Files Documentation Internet Information Services Internet Services Manager (HTML) SMTP Service World Wide Web Service If you have decided not to use a domain controller (not
recommended), set up the local computer with users and passwords at this time. For more information, see "Using Wonderware Information Server without a Domain Controller" on page 119.
Check the Microsoft web site for updates and patches that you may
need to install.
Install the operating system on an NTFS partition. Install the defaults for Windows Server 2008 components. If you
have decided not to use a domain controller (not recommended), set up the local computer with users and passwords at this time. For more information, see "Using Wonderware Information Server without a Domain Controller" on page 119.
Check the Microsoft web site for updates and patches that you may
need to install.
Install the operating system on an NTFS partition. Install the Windows 7 components. If you have decided not to use a
domain controller (not recommended), set up the local computer with users and passwords at this time. For more information, see "Using Wonderware Information Server without a Domain Controller" on page 119.
Check the Microsoft web site for updates and patches that you may
need to install.
The following instructions are provided as a guide and do not constitute the entire Windows Server 2008 R2 setup that your company guidelines may require, or that you may encounter while installing the operating system software. These instructions only document the specific options you need to configure during the installation.
Install the operating system on an NTFS partition. Install the defaults for Windows Server 2008 R2 components. If
you have decided not to use a domain controller (not recommended), set up the local computer with users and passwords at this time. For more information, see "Using Wonderware Information Server without a Domain Controller" on page 119.
Check the Microsoft web site for updates and patches that you may
need to install.
Exclude TCP Port 1433 and Port 80 from the Windows firewall on
the remote SQL Server computer. Wonderware Information Server can be used with a case-sensitive or case-insensitive SQL Server database. If you want to use the ArchestrA Reporting Services feature of Wonderware Information Server, you must install SQL Server Reporting Services on the Wonderware Information Server portal computer. It is best to select Reporting Services as part of the original SQL Server installation, rather than to try to add it later.
Insert the SQL Server installation CD into the DVD drive. The SQL Server Installation Center window appears. In the left pane, click Installation. In the right pane, click to start the new SQL Server stand-alone installation wizard. Click Next to progress through the installation windows. When the Feature Selection window appears, select the following features, at a minimum:
6 7
Click Next. The Instance Configuration window appears. Click Default instance.
Click Next. Continue with the installation until the Server Configuration window appears.
For the service accounts, specify the network account unless otherwise required by your environment. If the SQL Server is installed on the same computer as the Wonderware Information Server, then you can use the localsystem account. However, you will need to be sure to specify a network account when you use the Wonderware Information Server Backup and Restore utility.
10 Continue with the default settings in the Collation tab. The default
Click Mixed Mode (SQL Server authentication and Windows authentication). Enter your system administration username and password.
appears.
14 Click Install the native mode default configuration. 15 Click Next to continue installing the SQL Server per your
requirements.
On the Windows Start menu, point to Settings, and then click Control Panel. The Control Panel appears. Double-click Add or Remove Programs. The Add or Remove Programs window appears. Click Add/Remove Windows Components. The Windows Components Wizard appears. Select Application Server. Click Details. A list of subcomponents of the application server appears. Check ASP.NET and Internet Information Services (IIS). Highlight Internet Information Services (IIS) and click Details. Select the following subcomponents of Internet Information Services (IIS):
Common Files Internet Information Services Manager SMTP Service World Wide Web Service
On the Windows Start menu, click Control Panel. The Control Panel appears. Click Programs, and then double-click Programs and Features. Click Continue in the User Account Control dialog box. Click Turn Windows features on or off. In the Windows Features dialog box, expand Internet Information Services, expand Web Management Tools, expand IIS6 Management Compatibility, and then select the following check boxes:
Expand World Wide Web Services, expand Application Development Features, and then select the following check boxes:
Expand Common HTTP Features, and then select the following check boxes:
Default Document Directory Browsing HTTP Errors HTTP Redirection Static Content WebDAV Publishing
Expand Health and Diagnostics, and then select the following check boxes:
Expand Performance Features, and then select the Static Content Compression check box.
11 After you enable the required features, start the World Wide
Publishing service if you want to install the default configuration of Reporting Services. Otherwise, the SQL Server Setup program only installs Reporting Services and does not configure Reporting Services.
Guidelines for Installing IIS and ASP.NET on Windows Server 2008 and Windows Server 2008 R2
The procedure for installing IIS and ASP.NET on both Windows Server 2008 and Windows Server 2008 R2 is the same. IIS is not installed by default on these operating systems.
To configure ASP.NET and IIS on Windows Server 2008 and Windows Server 2008 R2 1
Open Control Panel, click System and Maintenance, and then click Administrative Tools. In the right pane, double-click Server Manager.
2 3 4 5
In the left pane of Server Manager, select the node that represents the server you are currently working on. In the right pane, expand Roles Summary and click Add Roles. The Add Roles Wizard appears. Click Next. The wizard moves to the Select Server Roles step. Select the Web Server (IIS) check box and click Next. The next wizard step that appears is information that guides you in the installation. Click Next. The wizard moves to the Role Services step. A list of available role services is displayed. If you click the name of a role, a short description of the role is displayed.
Select the Application Development role service, and then select the ASP.NET check box. A message is displayed prompting you to select the related options that are also required for Web application development. Click Add Required Role Services.
8 9
Click Next and verify the role service selection. Click Install to start the IIS and ASP.NET installation process.
10 After the installation is complete, click Close. 11 Install the Microsoft WebDAV extension.
There are two versions of WebDAV, one for 32-bit operating systems and one for 64-bit. You can download the extension from http://www.iis.net. You only need to install the extension files. The Wonderware Information Server Configurator utility will enable and set up authoring rules for the winroot folder during the core Information Server configuration.
Note: In Windows Server 2008 R2, WebDAV installation can be done during IIS configuration. To configure Windows authentication for IIS 1 2 3 4 5 6
In Server Manager, under the Roles node, select the Web Server (IIS) role. In the Role Services section, click Add Role Services. The Add Role Services wizard appears. Under the Security role service, select the Windows Authentication check box. Click Next and verify the role service changes to be applied. Click Install to start the IIS and ASP.NET installation process. Click Close to close the Add Role Services wizard.
In Server Manager, click the Web Server (IIS) node. If the node does not appear under the Roles node, refresh the view. In the System Service section, make sure that the World Wide Web Publishing Service is running. If the service is not running, start it. Under the Web Server (IIS) node, select Internet Information Services (IIS) Manager, expand the name of the Web server, and then expand Sites.
4 5
Right-click Default Web Site and select Start. If you need a secure Internet connection, set up Secure Sockets Layer (SSL).
On the Windows Start menu, point to Programs, Microsoft SQL Server 2008, Configuration Tools, and then click Report Server Configuration Manager. The Reporting Services Configuration Connection dialog box appears.
In the Server Name box, enter the name of the local report server node. In the Report Server Instance box, enter MSSQLSERVER.
Click Connect. After the connection has been established, the Report Server Status page appears. The Server Status appears as Started.
Make sure that the following components are configured with no errors:
Click Exit.
http://localhost/reports http://yourservername/reports
If the home page does not appear, exclude Reports and ReportServer from the SharePoint virtual directory using the SharePoint Administration web site. Make sure that SharePoint allows applications to be created on the default site.
Important: If you uninstall SharePoint Services 3.0, the default website is deleted, which will make the Wonderware Information Server portal inaccessible. Back up the portal before uninstalling SharePoint Services 3.0.
You must delete the "Sharepoint - 80" web site that is using the default port.
On the Windows Start menu, point to Programs, point to Administrative Tools, and then click SharePoint 3.0 Central Administration. The web site appears. Click Application Management tab. Under SharePoint Web Application Management, click Delete Web Application. The Delete Web Application page appears. Do the following:
a b
2 3 4
In the Web Application list, click Change Web Application. The Select Web Application page appears. Select the Windows SharePoint Services 3.0 default Web site "SharePoint - 80" (http://ServerName).
Note: Make sure that you delete the default web site: http://ServerName:80 c d e 5
Under Delete content databases, click Yes. Under Delete IIS Web sites, click Yes. Click Delete. When a warning message box appears, click OK.
Wait for the Application Management tab to appear, and then close the Windows SharePoint Services Central Administration site. Open Internet Information Services (IIS) Manager and check that the "Sharepoint - 80" default website created by Sharepoint has been deleted.
Right-click Default Web Site and then click Start to start the services.
On the Windows Start menu, point to All Programs, point to Administrative Tools, and then click SharePoint 3.0 Central Administration. Click the Application Management tab. Under SharePoint Web Application Management, click Create or extend web application. The Create or Extend Web Application dialog box appears. Create a new web application. Do the following:
a b c
2 3
Click Create a new Web application. The Create New Web Application dialog box appears. In the IIS Web Site section, click Use an Existing IIS Web site and make sure that Default web site is selected in the list. In the Application Pool section, click Predefined and make sure that Network Service is selected as the security account for the application pool. In the Database Name and Authentication section, make sure that Windows authentication is selected. Click OK and wait while your changes are processed. The Application Management page appears.
d e 5 6
In the Application Management page, click on Create Site Collection. The Create Site Collection page appears. Do the following:
a
In the Web Application section, click Change Web Application in the Web Application list. The Select Web Application page appears. Select the new web application that you created in step 4. In the Title and Description section, type the title and description. In the Template section, click Blank Site. In the Primary Site Collection Administrator section, specify the user name of the person administering this site (for example, svadmin1). Click OK and wait while your changes are processed. The Top Level Site Successfully Created page appears, Click OK button.
b c d e
f g 7
When you use the installation Configurator utility to set up an initial data source, you select to use HTTP access and then provide a name for the virtual directory. The Configurator utility takes care of setting up the virtual directory for you and configuring the HTTP access. Install the SQLXML software on the computer that:
Has IIS installed. Is accessible over the network using HTTP from the Wonderware
Historian server computer.
Locate the \SQLXML folder on the Wonderware Information Server installation CD. Run the SQLXML.msi file.
Note: You may encounter an error while installing SQLXML on the 64-bit version of the Windows 7 operating system. As a workaround, you can install SQLXML by executing the SQLXML.msi file from the command prompt. To do this successfully, the command prompt must be run using the Run as Administrator option.
137
Wonderware Information Server consists of a set of services, a COM+ package of components, and a customizable web server of ASP and HTML pages. You do not need to be familiar with web building software to set up Wonderware Information Server. The Wonderware Information Server installation program and Configurator utility builds and configures the entire web server for you. You use the ArchestrA System Platform installation program to copy the required resources, such as files, from the setup DVD to the target computer. You then use the Configurator utility to finish the setup. For information on installing or upgrading the Win-XML Exporter, see the Wonderware Information Server Win-XML Exporter Guide. For information on installing the ArchestrA Web Exporter, see the ArchestrA Web Exporter Guide.
Installable Features
You can select from the following features during the Wonderware Information Server install:
Installation Pre-Requisites139
Installation Pre-Requisites
The installation program checks for the following basic system pre-requisites:
A file system partitioned with NTFS. You are a member of the local computers administrator group. IIS is installed. For more information, including which roles and
features are required for each supported operating system, see "Guidelines for Installing IIS and ASP.NET" on page 126.
Install the Wonderware Information Server using the ArchestrA System Platform installation program. For detailed instructions, see "Installing the ArchestrA System Platform" on page 13. The installation path must be a valid path to which the currently logged in user has write permissions.
When the installation is complete, continue with the configuration steps required for Wonderware Information Server. For more information, see "About Wonderware Information Server Configuration" on page 141.
Important: If you exit the installation program without clicking Configure, required files, such as the ActiveFactory language packs, are not installed. To install ActiveFactory language packs, run the Wonderware Information Server installation program, select to modify the install, and then remove the ActiveFactory Reporting Website feature. Then run the installation program again and add the ActiveFactory Reporting Website feature. The language packs will be installed.
If you are using a remote SQL Server, you must enable File and
Printer Sharing in the Windows firewall configuration to permit
If you are using a remote SQL Server, Port 1433 and port 80 must
be open in the Windows firewall on the remote node to access the Reporting Service web pages.
Open the "BUILTIN\Administrators" login properties and add it to the sysadmin security role.
On the Start menu on the Windows Taskbar, point to Programs, Wonderware, then to Common, and then select Configurator. The Configurator main window appears.
In the left pane, expand Wonderware Information Server. A list of Wonderware Information Server features appears. The icon to the left of the feature name shows the configuration status of the feature.
When you click a feature name, configuration options appear in the right pane. Status and error messages appear in the window in the bottom right of the dialog box. For more information about a message, including possible actions you need to take, double-click the message text in the window.
A supported operating system is installed. IIS is installed. A supported version of ASP.NET is enabled. SQL Server Client Components are installed on the local
computer.
Sets up Windows registry entries. Creates the required exceptions in the Windows firewall on the
local computer.
Open the Configurator utility. In the left pane, click Information Server. The configuration options appear in the right pane.
In the Virtual Folder Name box, type the virtual folder name. The virtual folder name is the address you enter in Internet Explorer to access Wonderware Information Server. The virtual folder name is not case-sensitive, can be any characters other than /,*,?, and \. The maximum length is 240 characters. For example, if you specified MyInfoServer, run-time users would type http:\\<computername>\MyInfoServer to access Wonderware Information Server.
In the Database Configuration area, specify the SQL Server host on which you want to create the Wonderware Information Server database that is used to store administration and configuration information. Do the following:
a b
In the Server box, type the name of the SQL Server host. Select the authentication mode you want to use. Click Windows to log on to SQL Server using your current Windows login account, or click SQL and type your SQL Server username and password. The account you specify must be an administrative SQL Server account.
Note: This account information is only used by the installation to create the administration database. It is not stored on the computer in any way or used by the Wonderware Information Server at any later time. 5
In the Application Account area, type the user account information used by portal components to log on and run as Windows services. The account you specify must have sufficient rights on the domain to retrieve a list of domain users. Otherwise, domain users do not appear in the User Manager page of Wonderware Information Server. In the License Status area, verify the licensing status. If no valid license is found, click License Manager to install the license. For more information, see "Installing the Product License" on page 157. Click Configure. A green check appears in the left pane when Wonderware Information Server is successfully configured.
Excludes the virtual directory from SharePoint. Configures the Wonderware Historian database to support
ActiveFactory Reporting.
Be sure that Microsoft Excel is not running while you configure ActiveFactory Reporting.
To configure ActiveFactory Reporting 1 2
Open the Configurator utility. In the left pane, click ActiveFactory Reporting. The configuration options appear in the right pane.
In the Virtual Folder Name box, type the report web site name. In the Historian Data Source area, specify the name of the Wonderware Historian to use as the source of report data. You can either select an existing data source from the list or click Define New Historian Data Source to define a new one. For more information, see "Defining a New Historian Data Source" on page 148. ActiveFactory Reporting does not support a data source that uses Windows authentication.
In the Historian Configuration area, provide an administrative SQL Server account that the Configurator will use to log on to the Wonderware Historian and configure the database to support ActiveFactory Reporting. Click Configure. A green check appears in the left pane when ActiveFactory Reporting is successfully configured.
In the configuration pane, click Define New Historian Data Source. The New Historian DataSource Form page appears.
In the Data Source Name box, type name of the Wonderware Historian as you would like it to appear for Wonderware Information Server users. In the Database Server Name box, type the name of the Wonderware Historian. In the Database Name box, type Runtime.
b c
Configure the account used to connect to the Historian. Do any of the following:
In the Connection Timout box, type the time, in seconds, that Wonderware Information Server should wait for the connection to the Historian to be established, before returning an error message. In the Query Timeout box, type the time, in seconds, that the Wonderware Information Server should wait for the results of a database query to the Historian to be returned, before returning an error message.
In the Provider box, type the provider name for SQL Server. For SQL Server 2005, type SQLNCLI. For SQL Server 2008, type SQLNCLI10. If you want to access the Historian using HTTP instead of TCP/IP, do the following:
a b
Select the Has HTTP mode check box. In the URL Connection box, enter the web service URL.
Click OK.
Creates and configures the aaReports database in SQL Server. Creates Windows security groups. Also creates the aaReportsUser
login ID.
Creates any necessary Windows registry keys. Configures the aaReports data source for Wonderware Information
Server.
Creates the ArchestrA Reports folder under the root of the SQL
Server Reporting Services web site.
Open the Configurator utility. In the left pane, click ArchestrA Reporting. The configuration options appear in the right pane.
Select the Deploy Sample Reports to use the sample reports with a historian or alarm data source. If you do not select his check box, you can use ArchestrA Reporting for products that do not use a historian or alarm data source, such as the InBatch software. In the Historian Data Source for Sample Reports area, specify the name of the data source for the report data. You can either select an existing data source from the list or click Define New Historian Data Source to define a new one. For more information, see "Defining a New Historian Data Source" on page 148. In the Alarm Data Source for Sample Reports area, specify the name of the InTouch alarm database to use as the source of alarm data. You can either select an existing data source from the list or click Define New Alarm Data Source to define a new one. For more information, see "Defining a New Alarm Data Source" on page 150. Click Configure. A green check appears in the left pane when ArchestrA Reporting is successfully configured.
In the configuration pane, click Define New Alarm Data Source. The New Alarm DataSource Form page appears.
In the Data Source Type list, click Alarm. In the Data Source Name list, type name of the alarm data source as you would like it to appear for Wonderware Information Server users. In the Description box, type a description for the data source that is shown to Wonderware Information Server users. In the ServerName box, type the name of the computer that hosts the alarm database. In the Database box, type WWALMDB.
c d e 3
Configure the account used to connect to the alarm database. Do any of the following:
Select the Default for this Data Source type check box to make this defined data source the default alarm data source used by ArchestrA Reports.
In the Connection Timout box, type the time, in seconds, that Wonderware Information Server should wait for the connection to the alarm database to be established, before returning an error message. In the Query Timeout box, type the time, in seconds, that the Wonderware Information Server should wait for the results of an alarm query to be returned, before returning an error message.
In the Provider box, type the provider name for SQL Server. For SQL Server 2005, type SQLNCLI. For SQL Server 2008, type SQLNCLI10. Click OK.
Configuring MultiViews
The Configurator checks for the following pre-requisite before configuring MultiViews:
Includes MultiViews navigation in the hierarchy. Deploys Web Parts. Creates sites and document libraries.
Note: The Multiviews feature is not supported on the 64-bit versions of Windows Server 2008. To configure MultiViews 1 2
Open the Configurator utility. In the left pane, click MultiViews. The configuration option appears in the right pane.
In the Select SharePoint Application list, click the name of the SharePoint application to use for MultiViews. Click Configure. A green check appears in the left pane when MultiViews is successfully configured.
Creates the FactorySuiteSample database in SQL Server. Creates and configures Wonderware Information Server data
sources for the samples.
Open the Configurator utility. In the left pane, click Sample Content. There are no configuration options. Click Configure. A green check appears in the left pane when the sample content is successfully configured.
Wonderware Information Server 3.1 Wonderware Information Server 4.0 Wonderware Information Server 4.0 with SP1
For versions older than these, you must uninstall the existing version and install Wonderware Information Server 4.5. The upgrade program automatically backs up the product files, configuration, and user content before the upgrade occurs. After the upgrade is completed, each feature has to be configured using the Configurator tool. Features that are not configured will not be available until the configuration is completed.
ActiveFactory Reporting Website 8.5 or earlier only ActiveFactory Reporting Website 9.0 or 9.1
Not supported. You must uninstall this version manually and then install Wonderware Information Server 4.5. Not supported. You must uninstall this version manually and then install Wonderware Information Server 4.5. Not supported. You must uninstall this version manually and then install Wonderware Information Server 4.5. Direct upgrade. Direct upgrade. Direct upgrade.
Wonderware Information Server 3.1 (all combinations of features) Wonderware Information Server 4.0 (all combinations of features) Wonderware Information Server 4.0 with SP1 (all combinations of features)
When you upgrade from Wonderware Information Server 3.1, 4.0 or 4.0 with SP1 to Wonderware Information Server 4.5, the feature selection functionality will be unavailable. You can upgrade only the features that are already installed. If you want to install additional features, you must run the setup program again, after the upgrade, and select to modify the installation. Existing ArchestrA Reports and sample content are migrated to Wonderware Information Server 4.5. For detailed information on upgrading ActiveFactory components, see "Upgrading ActiveFactory Components" on page 157. For information on installing or upgrading the Win-XML Exporter, see the Wonderware Information Server Win-XML Exporter Guide. For information on installing the ArchestrA Web Exporter, see the ArchestrA Web Exporter Guide.
Upgrading the Server from Wonderware Information Server 3.1, 4.0 or 4.0 with SP1
If the ActiveFactory desktop applications are installed on the Wonderware Information Server computer, you must manually uninstall them before upgrading Wonderware Information Server. You may be required to restart the Wonderware Information Server computer after the installation program updates the files and before the Configurator runs. For instructions on upgrading Wonderware Information Server, see "Upgrading an ArchestrA System Platform Component" on page 32.
On the Start menu on the Windows Taskbar, point to Programs, Wonderware, then to Common, and then select ArchestrA License Manager. The ArchestrA License Manager main window appears.
159
Index
A
acquisition loading 62 ActiveEvent installing 89 ActiveFactory upgrading 157 ActiveFactory reporting web services 140 ActiveFactory reporting, configuring 146 ActiveX and .NET Controls aaHistClientQuery 107 aaHistClientTrend 107 alarm data source defining 150 analog tags disk space requirements 59 antivirus software 97 Application Server ArchestrA user account requirements 35 hardware requirements 41 upgrading previous version 39 ArchestrA Bootstrap 118
ArchestrA Change Network Account utility 24, 36 ArchestrA License Manager 138, 157 ArchestrA reporting, configuring 149 ArchestrA System Platform installing 13 upgrade 32 ArchestrA user account requirements for use with Application Server 35 updating with ArchestrA Change Network Account utility 36 ASP.NET installing 126, 127
B
Bootstrap upgrading 40 upgrading with Galaxy Repository 40 upgrading with IDE 40 upgrading with IDE and Galaxy Repository 41 building block controls aaHistClientTagPicker 107 aaHistClientTimeRangePicker 107
160Index
C
client connections 66, 67 common components 38, 90 Configuration Utility 91 Configurator starting 142 configuring ActiveFactory reporting 146 ArchestrA reporting 149 MultiViews 152 sample content 153 Wonderware Information Server 141, 142, 144 Configuring Products 23 connections 66 CSV data licensing 71
G
Galaxy database migrating 44 Galaxy Repository upgrading 42 upgrading with the Bootstrap 40 upgrading with the Bootstrap and IDE 41
H
hardware recommendations storage 57 hardware requirements 41 disk space 57, 58 IDASs 55 System Management Console 54 Wonderware Historian 51 Historian Client 72 historian data source defining 148 Historian Database Export/Import Utility requirements 54 history blocks disk space requirements 59 licensing 71 history data licensing 71 migrating from older versions 103 Holding database disk space 58 HTTP 111 HTTP access 135
D
database configuring 91 database files disk space requirements 58 DDE Windows Server 2003 52, 64, 72 demo mode 48 discrete tags disk space requirements 59 disk sizing 56 disk space history blocks 59 planning 57 domain controller 118, 119 security 118 using with Wonderware Information Server 118, 119
I
IDASs installing 89 licensing 70 performance 63 requirements 55 security 55 IDE upgrading 43 upgrading with the Bootstrap 40 upgrading with the Bootstrap and Galaxy Repository 41 IIS 111, 112, 121, 127 installing 126, 127 InBatch 72 installation
E
event data migrating from older versions 103
F
FAT 57 fault-tolerant servers 54 feature lines 68 features 138 firewall exceptions 141
Index161
about 87 components 87 Microsoft SQL Server 88 modifying 25 repairing 28 Wonderware Historian 87 installation pre-requisites 139 installing ArchestrA System Platform 9 IIS and ASP.NET 126, 127 Microsoft SQLXML 112 product license 157 SharePoint Services 132 SQL Server 122, 123 Windows Server 2003 119 Windows Server 2008 120, 121 Wonderware Historian Client 109 Wonderware Information Server 137, 140 Internet Information Services 120, 121 InTouch 115, 119, 140 InTouch History Importer 55 InTouch windows running within browser 115 InTouch WindowViewer 72
Microsoft Client Utilities 88 Microsoft .NET Framework 108 Microsoft SQL Server installation 88 Microsoft Windows Server 2003 119 Microsoft Windows Server 2008 120 Microsoft Windows Server 2008 R2 121 modify installation 25 modifying Wonderware Information Server 154 multilingual systems 135 MultiViews about 116 configuring 152
N
named pipes 88 navigation tree 116 network cards 65 network protocol 67 networking 64 NTFS 57, 59, 119, 120, 121, 122
L
LAN 65 language packs 135, 155 legacy software 38 License Viewer 90 licensing 47 about 68 feature lines data modification 71 history duration 71 operating system 69 processor 71 remote IDAS 70 tag count 69 loading Wonderware Historian 62
O
operating system requirements 117 operating system, upgrading 41 operating systems licensing 69 non-English 72
P
performance 61 examples 73 IDASs 63 storage 64 physical memory 52 process graphics 115 process network 65 processors licensing 71 product license 157 installing 157 products configuring 23 protocols 67 recommendations 64
M
Management Console 89 Manufacturing Execution Module 72 memory requirements 52, 61
162Index
R
RAID 57 repair installation 28 repairing 113 Wonderware Historian 98 repairing Wonderware Information Server 154 Requirements hardware 107 other 108 software 107 requirements 107 Historian Database Export/Import Utility 54 retrieval loading 62 roaming profiles 110 Runtime database disk space 58 migration 100
loading 62 performance 64 string tags disk space requirements 59, 60 SuiteLink 64 summary data migrating from older versions 103 system sizing 73 System Management Console installing 89 requirements 54
T
tags licensing 69 TCP/IP 64, 88 tiered historian sizing 79
U
uninstall ArchestrA System Platform Component 30 uninstalling 113 uninstalling Wonderware Information Server 155 upgrade basic steps 41 Galaxy Repository 42 Galaxy Repository node 42 IDE 43 operating system 41 redundant pairs 45 run-time nodes 44 SQL Server 41 upgrading 99, 100 ActiveFactory components 157 previous version 155 Wonderware Information Server 3.1 157 Wonderware Information Server 4.0 157 Wonderware Information Server 4.0 with SP1 157
S
sample content, configuring 153 SCSI 57 security domain controller 118 remote IDASs 55 SharePoint Services 132 installing 132 software requirements 41 software requirements 117 IDASs 55 System Management Console 54 Wonderware Historian 51 SPCPro 72 SQL Server 108, 112 installing 122, 123 upgrading 41 SQL Server Reporting Services 116, 130 SQL statements licensing 71 SQLXML 111, 135 storage disk sizing 56 hardware recommendations 57
V
variable length strings 60 virtual memory 52 VMWare 52
Index163
W
WAN 65 web server requirements 116 Windows 7 121 Installing 121 windows authentication 142 Windows Server 2003 52, 64, 72, 119, 120, 121, 126 installing 119 Windows Server 2003 R2 119 Windows Server 2008 52, 120, 128 installing 120, 121 Windows Server 2008 R2 121, 122 Windows Vista 52 Windows XP Professional 52 Wonderware Application Server 119 Wonderware Historian components 89 installation 90
installing 87 loading 62 memory requirements 61 repairing 98 requirements 51 upgrading 99 Wonderware Historian Client Components 106 Query 106 Report 106 Trend 106 Workbook 106 Wonderware Historian Server 111 Wonderware Information Server 72 configuring 141, 142 installing 137, 140 modifying 154 repairing 154 uninstalling 155 using with a domain controller 118 using without a domain controller 119
164Index