Wonderware InBatch Version 9.0

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

Wonderware InBatch Version 9.0 Readme

Last revision: 09/04/2008

About This Release

This document contains important information about Wonderware® InBatch 9.0. Review this document for known issues and changes to the InBatch documentation included on this CD.

New Features

The following new features are available for InBatch version 9.0.

InBatch Integration with Wonderware Application Server

The following changes have been made to integrate InBatch with Application Server.

Communication with Wonderware Application Server

The new InBatch Message Exchange (IBMX) component supports MX communications to Application Server. IBMX enables the Batch Manager Service to perform standard, secured, and verified writes to supervisory objects without the need for a user interface. InBatch can more accurately record the date and time stamp of values being collected for the Actuals and Process Data attributes.

Galaxy as Tag Server

A Galaxy can now serve as the default tag server for InBatch. IBMX enables you to use Application Server as a tag server. The InBatch tag naming convention has been modified to match the naming conventions used in Application Server. Tags in InBatch have been changed to use a dot (.) as a tag delimiter. The size of unit and phase names have been increased to 16 characters to enable InBatch tag names to map directly to Application Server tag names.

Security

InBatch security has been extended to support Application Server (ArchestrA) security. InBatch can obtain the list of valid users from Application Server at configuration time and authenticate users against Application server at run time.

Reporting Services

Crystal Reports have been removed from InBatch. All reporting services have been moved to the Wonderware Information Server portal. The new reporting system for InBatch leverages Microsoft Reporting Services.

Merging InBatch and IABatch

With this release, IABatch specific components have been added to the InBatch code base. The InBatch installation process has been updated to support components specific to IABatch. Documentation sets have been combined.

< top of document >


InBatch Demo

An InBatch Demo application is provided in the InBatch CD-ROM. It consists of the InBatch configuration files with the Model and Recipe databases and an InTouch Application to interact with batch processing.

  • The InBatch configuration files are located in the following folder on the InBatch CD-ROM: D:\InBatch\cfg\PremierDemo, where D:\ is the drive letter of your CD ROM drive.
  • The InTouch application is located in the following folder on the InBatch CD-ROM: D:\InBatch\InBatchDemoApp, where D:\ is the drive letter of your CD ROM drive.

Using the Demo

The following steps explain how to use the configuration files for the InBatch demo:

  1. Replace the files in the :C\Program Files\Wonderware\InBatch\cfg\Config_A folder with the files in the C:\Program Files\Wonderware\InBatch\cfg\dflt_cfg folder.
  2. Copy the demo configuration files from the C:\Program Files\Wonderware\InBatch\cfg\PremierDemo folder into the C:\Program Files\Wonderware\InBatch\cfg\Config_A folder.
  3. From the Environment Display dialog box, start the Runtime Applications and use the Batch Scheduler and Batch Display to schedule and run batches.

Using the InTouch Application

To Use the InTouch demo application, you must follow these steps:

  1. Install RecipeManager from the InTouch CD-ROM.
  2. Copy the files in the WWTSup71.zip file into the InTouch directory.
  3. From the InTouch Application Manager, locate and launch the InBatch Demo using WindowViewer.
  4. Use the InTouch application to interact with the InBatch system by scheduling and running batches.

< top of document >


System Requirements

This section describes the hardware and software requirements to install InBatch version 9.0.

Recommended Hardware Requirements

The following hardware is recommended to support InBatch version 9.0:

  • Computer with 3.0 gigahertz (GHz) or faster processor
  • 2 gigabyte (GB) of memory
  • At least 4 GB of available disk space
  • Super VGA (1024 × 768) or higher-resolution video adapter and monitor
  • CD-ROM or DVD drive for installation
  • Keyboard
  • Mouse or compatible pointing device

Software Requirements

I/A Series and InFusion configurations are supported only on the operating systems and platforms tested, based on the current technologies that we support. For details, refer to the InBatch User's Guide.

We support InBatch Server on Windows XP for both InBatch and IABatch.

Vista Restrictions

  • Vista does not support a traditional InBatch single-node configuration that includes Wonderware Historian (formerly IndustrialSQL Server).
  • Vista does not support NetDDE. By design, an InBatch application does not serve data to any other source, including InBatch itself.
  • Refer to individual product documentation for support of the Vista operating system.

< top of document >


Upgrading from a Previous Version

You can upgrade to InBatch 9.0 from either InBatch 8.0 or InBatch 8.1. Refer to the details that follow.

Upgrading from InBatch Version 8.0 to InBatch Version 9.0

You can upgrade InBatch version 8.0 to InBatch version 9.0 by first converting the configuration and then upgrading the InBatch History database.

To Convert the InBatch Version 8.0 Configuration

  1. If the databases in C:\Program Files\Wonderware\InBatch\cfg\config_A are not empty, delete the contents of C:\Program Files\Wonderware\InBatch\cfg\config_A and copy the contents of \dflt_cfg to \Config_A.
  2. Open the Environment Display.
  3. From the File menu, click Exit and Shutdown.
  4. Close the LogViewer.
  5. From the Start menu, select Run and type C:\Program Files\Wonderware\InBatch\bin\CvtMaster.exe.
  6. Acknowledge the message that informs you to back up your configuration, and ensure that the InBatch History server is operating properly.
  7. Click Configuration to browse and select the location of your configuration.
  8. Click Convert to start the conversion. When the conversion has finished, the conversion program displays information about the databases that were converted, those that failed to be converted or were skipped, and those that were up to date. (You can find a detailed log of the conversion operations is contained in DbCvt.txt.) This file is located in the configuration folder specified in step 5.
  9. Copy the converted configuration files to C:\Program Files\Wonderware\InBatch\cfg\Config_A.
  10. On the Environment Display, on the Update menu, click Runtime.

The procedure updates CfgLinkDB, EnvDB, RecipeDB, and SecurityDB.

As part of the upgrade process, you also must upgrade the InBatch 8.0 history database to InBatch 8.1 so that the installation wizard can then upgrade the database to InBatch 9.0.

To upgrade an InBatch Version 8.0 history database to InBatch Version 8.1

  1. If your Batch archive database is marked read-only, remove this restriction.
  2. Copy \convert\xp_ListReports.dll to C:\Program Files\Microsoft SQL Server\MSSQL\bin.
  3. Copy \convert\xp_SyncReportLog.dll to C:\Program Files\Microsoft SQL Server\MSSQL7\bin.
  4. Run the convert81.bat file that is located in the \convert folder on the InBatch CD. Copy this file to your local drive before you run it. The syntax for running the file is as follows:

Convert81 <ServNM> <HistDB> <ArchDB>

where

<ServNM> is the name of the station where SQL Server resides. This is required. Use the name of the machine being used for the InBatch History Server.

<HistDB> is the name of the history database. By default, the name is BatchHistory, and the command appears use the default name if it is not provided. Use the name of the history database created by running IB71_SQL_Install.exe.

<ArchDB> is the name of the archive database. By default, the name is BatchArchive, and the command appears use the default name if it is not provided. Use the name of the archive database created by running IB_SQL_Install.exe

Example:

Convert81 InBatch_SQL BatchHistory BatchArchive

After you have finished upgrading the InBatch version 8.0 History database to InBatch version 8.1, follow the standard upgrading process for the InBatch History server described in the installation instructions.

Upgrading from InBatch Version 8.1 to InBatch Version 9.0.

You can upgrade from InBatch version 8.1 by using the installation program. For details, see Chapter 2, "Installation" of the InBatch User's Guide .

< top of document >


Known Issues–InBatch Version 9.0

Installation Issues

L00079361: When the InBatch Development Client is installed, files that cannot be deleted are not listed in a message.

When you uninstall an InBatch component (server or client), remove all items that may have been left behind, including the \InBatch folder.

L00079872: In the Feature Selection list of the InBatch Setup dialog box, "1" appears on the icon for the InBatch Development Client.

The following steps are a workaround for this problem. The final step removes the number 1 and does not produce any changes to the installed state:

  1. Install the InBatch development client and the InBatch run-time clients.
  2. Launch setup.exe.
  3. In the Application Maintenance dialog box, click Modify and then click Next.
  4. Uninstall the InBatch run-time client by deselecting it and install the InBatch PDF documentation. As a result, the InBatch PDF documentation is successfully installed and the In Batch run-time client is successfully uninstalled.
  5. Modify and select the InBatch development client that displays the number 1 and install the InBatch development client.

L00081166: An error message appears during the installation of InBatch Server with I/A components.

This message can appear if you select the root directory of the C:\ drive. Respond OK to the message and the installation will continue and complete successfully.

L00082077: When InBatch cannot find a valid attribute reference in ArchestrA, the batch stops.

Use the following workaround for this issue:

  1. Start IBMX services in Advise All mode. In the Advise All mode, IBMX advises all Galaxy tags during services startup.
  2. Check the LogViewer for any configuration errors.
  3. If you do not find configuration errors, stop all services.
  4. Remove the Advise All mode.
  5. Start the services.
  6. Schedule and run the batch.

L00082238: An error dialog box appears when uninstalling InBatch 9.0. This error prevents the uninstall from completing.

The following steps are a workaround to this problem. Step 6 allows the selection to be uninstalled without any issue when this error occurs.

  1. Install InBatch Server.
  2. Double-click setup.exe, select Modify, and click Next.
  3. From the Select Features list, deselect InBatch Server and select InBatch Development Client (without I/A support).
  4. Continue the installation to completion.
  5. Click Modify.
  6. Select the InBatch Development Client (a 1 appears on the image) and click Next to install the development client.
  7. Perform the uninstall from the Control Panel (select Add/Remove Programs).

Other Issues

L00016907: WinXMLExporter does not recognize InBatch 8.1 ActiveX controls as "WONDERWARECONTROL" although they have an entry in the CFGOCX.xml file.

The workaround is to look in the 3rd Party Controls folder.

L00030115: A header file that contains all the I/A Batch parameters with their type information has not been updated in the last few releases

The workaround is to link the tags to an available data type. For a list of available data types, see "Validating Tags" in the Tag Linker chapter of the InBatch User's Guide.

L00033867: The Batch Manager shuts down unexpectedly with an error during a stress test.

The disk could be full. Check the disk and clean it.

L00077400: Editors are not opening on the InBatch development client.

Use the following workaround:

  1. Open Windows Explorer.
  2. Navigate to C:\Programs\Wonderware\InBatch\cfg\Config_A.
  3. Right-click the file named vista.taf and select Delete.

L00079313: License detection is inconsistent between the InBatch server and InBatch clients.

When a valid license is not available on the InBatch Server, a message box with the "Invalid Security Key" message does not appear. The message appears only on the SMC Logger.

L00079952: [IBMX Component] --- IBMX is crashing when services are stopped after undeploying and deploying Entire Galaxy.

Stop all the InBatch Services before you undeploy the entire galaxy.

L00081552: Running InBatch with IA components in a redundant configuration does not fail over when IADriver is shut down.

The following table shows the redundancy batch status on master/slave nodes when IBMX, IBCli, and IADriver are stopped from the Runtime Services dialog box or when you end the process from Task Manager.

IBMX IBCli IADriver
Action on the master node Master Node Status Slave Node Status Master Node Status Slave Node Status Master Node Status Slave Node Status
End process from Task Manager Master failed Master with invalid backup Master failed Master with invalid backup Master failed Master with invalid backup
Stopped from Runtime Services Master with valid backup Valid backup Master with valid backup Valid backup Master with valid backup Valid backup

L00082068: An error message does not pop up in InTouch when Batch Manager stops working.

When you stop all the InBatch services from the Environment Display, the OCxBatch running on the InTouch application does not pop up an error message box.

L00082366: Unable to import InBatch 9.0 tags to InTouch using DBload.exe.

InBatch uses a dot (.) instead of a hyphen (-) as a delimiter in tagnames. InTouch supports only a hyphen as a delimiter. Before you load the InBatch tagnames into InTouch, edit the .csv file and replace the dot delimiters with hyphens.

L00082612: Custom-created reports that are populated to the batch report directory are not available for being configured and scheduled.

After the custom reports are populated or deployed to the InBatch > Execute Reports > InBatch list on the Launch Pad, use the following steps to configure and schedule the reports. For example, suppose that a report named "Custom Batch Detail" is populated in the list.

You must update the RepServicesConfig.xml file in the following location:

<systemdrive>:\Inetpub\wwroot\Wonderware\InBatchReports\ReportConfig

  1. Open the file RptServicesConfig.xml for editing.
  2. Add the following line under the <Folder> node:

    <Report Name="Custom Batch Detail" />

  3. Save the file.

Example:

<Folder>
<Report Name="Custom Batch Detail: />
.......
.......
.......
</Folder>

Now, the report named Custom Batch Detail is available for configuring and scheduling. Add a similar line for each custom report that is populated in the Execute Reports list.

< top of document >


Known Issues–InBatch Documentation

This table lists known issues in the product documentation.

Item Location of Change Existing Documentation Change
1 InBatch User's Guide , Section 2: "Installation." In the second table under "Software Requirements," see the entry for I/A Series Batch Station Type of InBatch IDE/IEE Extension. Change the word in italics.

Wonderware Application Server 3.1 bootstrap and IDE (only when integrating and InFusion)

Wonderware Application Server 3.1 bootstrap and IDE (only when integrating with InFusion)

2 InBatch User's Guide, Section 2: "Installation." Instructions for upgrading from InBatch 8.0 to 9.0 are missing.

Refer to "Upgrading from a Previous Version" in this Readme file.

3 InBatch User's Guide, Section 4: "Process Modeling." See the table on page 216 (Example - Automatic Tagnames).

Tag names have dashes for delineators.

Tag names should have dot delineators.

4 InBatch User's Guide, Section 12: "Reporting System." In the section "Scheduling Configured Reports," the procedure for scheduling an End of Batch Report has been omitted.

Missing

See the procedure immediately following this table.

5 InBatch User's Guide, Section 24: "System Administration." See the topic "Batch System Configuration Files." In the table entries for CfgIALinkDB and IALinkDB, the file locations are incorrect.

Location: IASeriesBatch\cfg\Config_A

Location: InBatch\cfg\Config_A

To schedule an End of Batch Report

  1. In the Name box, type the name for the scheduled report.
  2. Select the Enabled check box.
  3. From the Report Selection list, select the End of Batch report that you previously configured.
  4. From the Schedule Type list, select End of Batch.
  5. In the Description box, optionally type text that describes the report.

< top of document >


InBatch Documentation

The InBatch product library consists of a set of Portable Document Files ( PDF) located in the UserDocs folder of the InBatch installation CD. You need Adobe Reader installed on your computer to view InBatch documentation. You can download the latest version of Adobe Reader from the Adobe Corporation web site: http://www.adobe.com/products/acrobat/readstep2.html After installing Adobe Reader, double-click on a PDF file with your pointing device to view the book with Adobe Reader. You can also open a book with the Adobe Reader Open command from the File menu. InBatch installation instructions are located in the root folder of the InBatch installation CD as an online help file. You can view these instructions by clicking Help as you complete the InBatch installation procedure.

Searching InBatch Books with Adobe Reader

Rewrite the procedure and substitute your product's name. The InBatch version 9 books are delivered as an Adobe PDF package that provides a master index of all books. Using Adobe Reader, you can simultaneously search for a specific topic across all books that belong to the InBatch product library.

To search for information across all InBatch books simultaneously

  1. Open Adobe Reader.
  2. Press CTRL+SHIFT+F or select Search from the Edit menu. The Search dialog box appears.
  3. Type the word or phrase that you want to search for in the InBatch books.
  4. In the Where would you like to search area, select the option to search all PDF books.
  5. If necessary, locate the InBatch version 9 PDF package located on your Wonderware CD or on a network folder containing copies of the InBatch PDF book files.
  6. Click Search. Adobe Reader lists the InBatch books containing information that matches your search criteria.
  7. Click on the links to open the InBatch book to the topic containing the information that meets your search criteria.

< top of document >


© 2008 Invensys Systems, Inc. All Rights Reserved.