Proficy Batch Upgrate
Proficy Batch Upgrate
Proficy Batch Upgrate
UPGRADE GUIDE
Version 5.6
December 2010
All rights reserved. No part of this publication may be reproduced in any form or by any electronic or mechanical
means, including photocopying and recording, without permission in writing from GE Intelligent Platforms, Inc.
The information contained in this manual is believed to be accurate and reliable. However, GE Intelligent Platforms,
Inc. assumes no responsibilities for any errors, omissions or inaccuracies whatsoever. Without limiting the foregoing,
GE Intelligent Platforms, Inc. disclaims any and all warranties, expressed or implied, including the warranty of
merchantability and fitness for a particular purpose, with respect to the information contained in this manual and the
equipment or software described herein. The entire risk as to the quality and performance of such information,
equipment and software, is upon the buyer or user. GE Intelligent Platforms, Inc. shall not be liable for any damages,
including special or consequential damages, arising out of the user of such information, equipment and software, even
if GE Intelligent Platforms, Inc. has been advised in advance of the possibility of such damages. The user of the
information contained in the manual and the software described herein is subject to the GE Intelligent Platforms, Inc.
standard license agreement, which must be executed by the buyer or user before the use of such information, equipment
or software.
Notice
©2010 GE Intelligent Platforms, Inc. All rights reserved. *Trademark of GE Intelligent Platforms, Inc.
Microsoft® is a registered trademark of Microsoft Corporation, in the United States and/or other countries.
All other brands or names are property of their respective holders.
We want to hear from you. If you have comments, questions, or suggestions about our documentation, send them to the
following email address:
doc@ge.com
Table of Contents
About This Guide .............................................................................................................................. 1
Overview ........................................................................................................................................... 1
iii
Upgrade Guide
Index ............................................................................................................................................... 37
iv
About This Guide
This guide is intended for existing customers who are upgrading from a previous version of the Proficy
Batch Execution product. It contains the instructions for upgrading existing Batch Execution systems,
after you run the product install program.
Reference Documents
Refer to the following manuals for detailed information on configuring and using Proficy Batch
Execution. These manuals are available in electronic form. You can access these books by selecting
Batch Execution Books from the Proficy Batch Execution program group or from any Help menu.
• Application Guide
• System Configuration Manual
• WorkInstruction Manual
• Phase Programming Manual
• PLI Development Manual
• Equipment Configuration Manual
• Recipe Development Manual
• Operations Manual
• Custom Applications manual
Overview
Listed below are the tasks that you need to perform before, during, and after an upgrade of the Batch
Execution product.
• Read the Release Notes in the Important Product Information help (IPIBatchEx.chm on the
Batch Execution CD) for the latest information.
• Make sure that all of the Archiver data has been processed prior to upgrading. If you do not,
intermediate event data stored in .cch, .evt, and .dmp files may be inaccessible after the
upgrade, due to the new Archiver format beginning in Batch 5.1.
TIP: If you have unprocessed Archiver data files such as cache (.cch), event (.evt), or dump
(.dmp) files, and you continue with the upgrade, you will not be able to use this data in Batch
1
5.5. To recover this data, copy the files from the 5.5 computer to a computer with 5.0 installed.
Configure your ODBC data source in Windows, and then in the Batch WorkSpace, navigate to
the Batch Execution Configuration dialog box. Select the Archiver tab, enter the data source
with the user name and password. Use the Batch Archiver Utility to process the files –
converting them to SQL and send them to the database. For more information on this utility,
go to the GE GlobalCare SIM download page.
• Be aware that if your Archiver was configured to run remotely from your Batch Server you
will need to reconfigure your Archiver to run locally. For more information, refer to the
Configuring the Batch Execution Archiver section.
• Prior to Batch 5.1, it was possible to configure the Batch Archiver to run remotely from the
Batch Server. Beginning with Batch 5.1, the Batch Archiver can only run local to your Batch
Server computer. Remote Batch Archiver configurations must be reconfigured locally to the
Batch Server. This information includes the DSN, username, and password specified under the
Archiver tab within the WorkSpace in the Batch Execution Configuration dialog box. A Test
Connection button allows you to verify the newly established connectivity to the target SQL or
Oracle database. Please verify this connection before resuming batch operations.
• Make sure you shut down all Proficy Batch Execution applications. It is important that no
Proficy Batch Execution applications are running when you run the installation program. To
verify that there are no applications running, such as VBIS, launch the Task Manager and
look for any Batch applications. If there are any running, abort the application from the Task
Manager.
• Back up your existing .INI files with your application preferences.
• Make sure you note the Batch Serial Number in the VBEXEC.ini file. This file is located in
your Windows directory.
IMPORTANT: You need to make sure you save a copy of the old VBEXEC.INI so that when
you copy it over the new one, the batch serial number will get set back to the last number that
was generated by the Batch Execution Server. The batch serial number is a unique number
that the Batch Execution Server generates for each batch that is added to the Batch List.
• Create a backup of your Projects folder. Usually, this folder is: C:\Program
Files\Proficy\Proficy Batch Execution\Projects. Back up all files and subdirectories within the
Projects directory, including the .WKB files.
• Be sure that Internet Explorer is installed.
• Ensure that you have a product key. Without this new key, you will not be able to use Batch
Execution, WorkInstruction or Campaign Manager.
2
Upgrade Guide
1. Click the Start button, and point to Settings, Control Panel, Administrative Tools, and then
Local Security Policy.
2. In the left pane, click Account Policies.
3. In the right pane, double-click Password Policy.
4. Double-click Password must meet complexity requirements. The Password Must Meet
Complexity Requirements dialog box appears.
5. Click Disabled and then click OK.
3
Relational Database Upgrades
If you are storing recipes in, or are archiving Event Journal data to a relational database, you need to
upgrade the following items in your relational databases:
As a precautionary measure, before you upgrade your relational databases, you should back up the data
in these tables.
Batch Execution provides upgrade scripts for Microsoft ® SQL Server and Oracle ® databases. Refer
to the following sections for instructions on running the upgrade scripts for SQL and Oracle databases:
IMPORTANT: GE does not support the use of Microsoft ® Access for archiving data in a production
environment. WorkInstruction only works with Oracle or SQL Server.
For information on the table structures, refer to the appendices in the Custom Applications manual.
Refer to the following table for a listing of the scripts used to upgrade the database. The same scripts
are used for upgrading SQL Server 2005 and SQL Server 2008 databases.
4
Upgrade Guide
version 5.1 to SP1 If you want to use the Formulation Management feature
within Batch Execution Recipe Editor, you need to run
the following script files:
msql6x_FormulationUpgrade.sql
MSQLArchiver_FormulationsUpgrade.sql
IMPORTANT: If you want to use the Batch Analysis
product with Batch Execution, you also need to run this
script file:
msqlarchiver_BatchAnalysis_V51toV51Sp1Upgrade.sql.
5
SQL Database Upgrade Scripts
Refer to the following table for a listing of the scripts used to upgrade the database. The same scripts
are used for upgrading Oracle 10g and Oracle 11g databases.
6
Upgrade Guide
version 5.1 to SP1 If you want to use the Formulation Management feature
within Batch Execution Recipe Editor, you need to run
the following script files:
OraSQL7x_FormulationUpgrade.sql
OraSQLArchiver_FormulationsUpgrade.sql
IMPORTANT: Batch Execution does not support the Microsoft ODBC for Oracle driver because it does not
implement all the required features. Oracle users should use the Oracle ODBC driver instead.
Once the data sources are defined, log into your relational database server with the client software you
installed to ensure the Batch Execution Server can connect to your relational database server.
7
Batch Execution Project File Upgrades
You must upgrade your relational database tables before you upgrade your project files. Refer to the
Relational Database Upgrades section for instructions.
IMPORTANT: You must upgrade your recipes in order to run them in the latest version of Batch
Execution. Failure to do so will cause problems with the Batch Execution Server.
To upgrade an EIB from a previous version of WorkInstruction, you need to check out the older
version of the EIB in the new WorkInstruction Editor. When you open an older file, WorkInstruction
can also upgrade all EIBs in that same folder.
After you upgrade an EIB, you need to verify and then resave it in the WorkInstruction Editor before
you check it back in (to the Work project) so that you can move it to the Production project in the
DMS.
If you do not want to upgrade VBIS, existing applications written against previous versions of VBIS
will still work without having to recompile. The older VBIS interfaces were left intact to provide
backward compatibility so that you do not need to recompile existing VBIS applications. However, if
you are programming a new VBIS application or want to upgrade existing applications to take
advantage of the new functionality with the latest version of Batch Execution, you will need to use the
revised interfaces.
8
Upgrade Guide
Also, be aware that when you are upgrading from a previous version, you need to change the
RECIPE_ID field to 255 characters in the BATCH table. In previous releases, the RECIPE_ID field
was limited to 40 characters. You can update this value by going into the database software and
changing it.
When you upgrade Batch Execution, your ActiveX controls are automatically upgraded. You may
want to configure some of the new properties provided in this release, such as the Enter Operator
Comments feature in the BatchList and SFC controls.
The .EXD files are essentially temporary files that contain the type library of the control and extended
properties used by the container (Name, IsSelectable, HorizontalPosition, VerticalPosition, and so on). The
.EXD file is regenerated the first time the control is dropped onto an iFIX picture and is also regenerated as
needed if the .EXD file is deleted. So, when upgrading from 4.6 to 5.5, you must delete these old .EXD
files since they will contain old type library information and will not include the new properties.
These files are located in the Temp folder. The files that you need to delete are as follows:
• ewixlib.exd
• batchlistlib.exd
• bacthaddlib.exd
• recipelistlib.exd
• alarmlistlib.exd
• operpromptslib.exd
• bindingpromptslib.exd
• sfclib.exd
• manualphaselib.exd
9
How Do I...
This section outlines the steps to perform the following tasks:
NOTE: If your upgrade path is not listed above, then you must complete, in order, the update
procedures for each upgrade between your version of Batch and the current version of Batch. For
example, if you have Batch 4.7, then you must perform the upgrade procedures for 4.7, 5.0, 5.1, and
5.1 SP1 in that order. Failure to do so may have unintended consequences for your database.
1. Are you currently using the Campaign Management feature? If so, go to Step A. If not, go to
Step B.
A. Copy the following script file from the DatabaseFiles folder of your Batch Server to
any folder on the SQL Server computer, and proceed to Step 2:
MSQLCampaign_V55toV56Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
10
Upgrade Guide
B. If you want to use the Campaign Management feature, copy the following script file
from the DatabaseFiles folder of your Batch Server to any folder on the SQL Server
computer, and proceed to Step 2:
CampaignMSSQL.sql
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLCampaign_V55toV56Upgrade.SQL script and click Open. The script opens
as a new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V51to55Upgrade.SQL
• CampaignMSSQl.sql (only if you want to use the Campaign Management feature)
• msqlarchiver_BatchAnalysis_V51toV55Upgrade.sql and
Archiver3x_Trigger_V51to55Upgrade.sql (only if you use the Batch Analysis
product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
11
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_V51to55Upgrade.SQL script and click Open. The script opens as a
new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
11. If you want to use the Campaign Manager or Batch Analysis, repeat steps 6-10 for the
CampaignMSSQl.sql and the msqlarchiver_BatchAnalysis_V51toV55Upgrade.sql script.
12. Add the BUILTIN\Administrators to the Logins. To do so:
a. In the left pane, under the Security folder, right-click the Login folder.
b. Click New Login. The Login – New window appears.
c. In the Login Name field enter BUILTIN\Administrators.
d. From the left pane, select Server Roles.
e. In the Server Roles area, select sysadmin.
f. Click OK.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• msql6x_FormulationUpgrade.sql
• MSQLArchiver_FormulationsUpgrade.sql
• msqlarchiver_BatchAnalysis_V51toV51Sp1Upgrade.sql (only if you use the Batch
Analysis product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the msql6x_FormulationUpgrade.sql script and click Open. The script opens as a new
tab in the Microsoft SQL Server Management Studio window.
12
Upgrade Guide
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V50to51Upgrade.SQL
• MSQLRecipe_v50tov51Upgrade.SQL
• msqlarchiver_BatchAnalysis_V50toV51Upgrade.sql (only if you want to use the
Batch Analysis product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_V50to51Upgrade.SQL script and click Open. The script opens as a
new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 6-10 for the MSQLRecipe_v50tov51Upgrade.SQL script.
12. If you use Batch Analysis with Batch Execution, repeat steps 6-10 with the
msqlarchiver_BatchAnalysis_V50toV51Upgrade.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V47to50Upgrade.SQL
• MSQLRecipe_v47tov50Upgrade.SQL
• MSQLAudit_V47to50Upgrade.SQL
13
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_V47to50Upgrade.SQL script and click Open. The script opens as a
new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 6-10 for the MSQLRecipe_v47tov50Upgrade.SQL script and then the
MSQLAudit_V47to50Upgrade.SQL script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_v46tov47Upgrade.SQL
• MSQLRecipe_v46tov47Upgrade.SQL
• MSQLAuditTable.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
14
Upgrade Guide
9. Select the MSQLArchiver_v46tov47Upgrade.SQL script and click Open. The script opens as
a new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 6-10 for the MSQLRecipe_v46tov47Upgrade.SQL script and then the
MSQLAuditTable.SQL script.
1. Copy this script file from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
MSQLArchiver_v45tov46Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_v45tov46Upgrade.SQL script and click Open. The script opens as
a new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_v41tov45Upgrade.SQL
• MSQLRecipe_v41tov45Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
15
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_v41tov45Upgrade.SQL script and click Open. The script opens as
a new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 6-10 for the MSQLRecipe_v41tov45Upgrade.SQL script.
1. Are you currently using the Campaign Management feature? If so, go to Step A. If not, go to
Step B.
A. Copy the following script file from the DatabaseFiles folder of your Batch Server to
any folder on the SQL Server computer, and proceed to Step 2:
MSQLCampaign_V55toV56Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
B. If you want to use the Campaign Management feature, copy the following script file
from the DatabaseFiles folder of your Batch Server to any folder on the SQL Server
computer, and proceed to Step 2:
CampaignMSSQL.sql
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
16
Upgrade Guide
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_V51to55Upgrade.SQL script and click Open. The script opens as a
new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V51to55Upgrade.SQL
• CampaignMSSQl.sql (only if you want to use the Campaign Manager feature)
• msqlarchiver_BatchAnalysis_V51toV55Upgrade.sql and
Archiver3x_Trigger_V51to55Upgrade.sql (only if you use the Batch Analysis
product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears and the
Connect to Database Engine dialog box appears.
3. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
4. Click the Options button to view more configurable fields.
5. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. Click Connect.
6. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
7. Select the Tables folder for the database that you plan to upgrade.
8. On the File menu, click Open and then File. The Open File dialog box appears.
9. Select the MSQLArchiver_V51to55Upgrade.SQL script and click Open. The script opens as a
new tab in the Microsoft SQL Server Management Studio window.
10. In the toolbar, click the Execute button.
17
11. If you want to use the Campaign Manager or Batch Analysis, repeat steps 6-10 for the
CampaignMSSQl.sql and the msqlarchiver_BatchAnalysis_V51toV55Upgrade.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• msql6x_FormulationUpgrade.sql
• MSQLArchiver_FormulationsUpgrade.sql
• msqlarchiver_BatchAnalysis_V51toV51Sp1Upgrade.sql (only if you use the Batch
Analysis product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the msql6x_FormulationUpgrade.sql script and click Open. The Connect to Database
Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 5-10 for the MSQLArchiver_FormulationsUpgrade.sql script.
12. If you use the Batch Analysis product with Batch Execution, repeat steps 5-10 for the
msqlarchiver_BatchAnalysis_V51toV51Sp1Upgrade.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V50to51Upgrade.SQL
• MSQLRecipe_v50tov51Upgrade.SQL
• msqlarchiver_BatchAnalysis_V50toV51Upgrade.sql (only if you want to use the
Batch Analysis product with Batch Execution)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
18
Upgrade Guide
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the MSQLArchiver_V50to51Upgrade.SQL script and click Open. The Connect to
Database Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 5-10 for the MSQLRecipe_v50tov51Upgrade.SQL script.
12. If you use Batch Analysis with Batch Execution, repeat steps 5-10 with the
msqlarchiver_BatchAnalysis_V50toV51Upgrade.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_V47to50Upgrade.SQL
• MSQLRecipe_v47tov50Upgrade.SQL
• MSQLAudit_V47to50Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the MSQLArchiver_V47to50Upgrade.SQL script and click Open. The Connect to
Database Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
19
10. In the toolbar, click the Execute button.
11. Repeat steps 5-10 for the MSQLRecipe_v47tov50Upgrade.SQL script and then the
MSQLAudit_V47to50Upgrade.SQL script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_v46tov47Upgrade.SQL
• MSQLRecipe_v46tov47Upgrade.SQL
• MSQLAuditTable.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the MSQLArchiver_v46tov47Upgrade.SQL script and click Open. The Connect to
Database Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 5-10 for the MSQLRecipe_v46tov47Upgrade.SQL script and then the
MSQLAuditTable.SQL script.
1. Copy this script file from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
MSQLArchiver_v45tov46Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
20
Upgrade Guide
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the MSQLArchiver_v45tov46Upgrade.SQL script and click Open. The Connect to
Database Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
10. In the toolbar, click the Execute button.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
SQL Server computer:
• MSQLArchiver_v41tov45Upgrade.SQL
• MSQLRecipe_v41tov45Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Click the Start button and point to Programs, Microsoft SQL Server, and then SQL Server
Management Studio. The Microsoft SQL Server Management Studio window appears.
3. In the tree view, in the Databases folder, double-click the database name that you want to
upgrade. For example, the database name might be BatchExecution or ARCHIVER.
4. Select the Tables folder for the database that you plan to upgrade.
5. On the File menu, click Open and then File. The Open File dialog box appears.
6. Select the MSQLArchiver_v41tov45Upgrade.SQL script and click Open. The Connect to
Database Engine dialog box appears.
7. In the Server Name field, make sure that the server you want appears in this field. If it does
not, select the server from the drop-down list or browse for it.
8. Click the Options button to view more configurable fields.
9. In the Connect to Database field, select the database name from the drop-down list or browse
for a database. The script opens as a new tab in the Microsoft SQL Server Management
Studio window.
10. In the toolbar, click the Execute button.
11. Repeat steps 5-10 for the MSQLRecipe_v41tov45Upgrade.SQL script.
21
Upgrade an Oracle 11g Database
The following steps describe how to upgrade your Oracle 11g database from previous versions of
Batch Execution:
1. Are you currently using the Campaign Management feature? If so, go to Step A. If not, go to
Step B.
A. Copy the following script file from the DatabaseFiles folder of your Batch Server to
any folder on the Oracle Server computer, and proceed to Step 2:
OraSQLCampaign_V55to56Upgrade.sql
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
B. If you want to use the Campaign Management feature, copy the following script file
from the DatabaseFiles folder of your Batch Server to any folder on the Oracle
Server computer, and proceed to Step 2:
CampaignOra.sql
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLCampaign_V55to56Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLCampaign_V55to56Upgrade.sql"
22
Upgrade Guide
1. Copy the script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V51to55Upgrade.sql
• CampaignOra.sql (optional – if you want to use the Campaign Manager, you need to
run this script)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_V51to55Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_V51to55Upgrade.sql"
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_FormulationsUpgrade.sql
• OraSQL7x_FormulationUpgrade.sql
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_FormulationsUpgrade.sql script. To do so, enter the following at
the command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_FormulationsUpgrade.sql"
23
To upgrade your database from 5.0 to 5.1:
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V50to51Upgrade.sql
• OraSQLRecipe_v50to51Upgrade.sql
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_V50to51Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_V50to51Upgrade.sql"
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V47to50Upgrade.SQL
• OraSQLRecipe_v47to50Upgrade.SQL
• OraSQLAudit_V47to50Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_V47to50Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_V47to50Upgrade.sql"
24
Upgrade Guide
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraArchiver_v46tov47Upgrade.SQL
• OraSQL7x_v46tov47Upgrade.SQL
• OracleAuditTable.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraArchiver_V46to47Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraArchiver_V46to47Upgrade.sql"
1. Copy this script file from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
OraSQLArchiver_v45tov46Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_V45to46Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_V45to46Upgrade.sql"
25
To upgrade your database from 4.1 to 4.5:
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_v41tov45Upgrade.SQL
• OraSQLRecipe_v41tov45Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. From the Start menu, point to Programs, Oracle, Application Development, and then SQL
Plus.
3. Enter the user name and password for the account you want to use to connect to the database.
4. Run the OraSQLArchiver_V41to45Upgrade.sql script. To do so, enter the following at the
command line:
@"file location of script"
For example:
@"c:\Program Files\Proficy\Proficy Batch
Execution\databasefiles\OraSQLArchiver_V41to45Upgrade.sql"
1. Are you currently using the Campaign Management feature? If so, go to Step A. If not, go to
Step B.
A. Copy the following script file from the DatabaseFiles folder of your Batch Server to
any folder on the Oracle Server computer, and proceed to Step 2:
OraSQLCampaign_V55to56Upgrade.sql
26
Upgrade Guide
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
B. If you want to use the Campaign Management feature, copy the following script file
from the DatabaseFiles folder of your Batch Server to any folder on the Oracle
Server computer, and proceed to Step 2:
CampaignOra.sql
NOTE: If you installed Batch Execution to the default location, you can find the
script files in the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles
folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraSQLCampaign_V55to56Upgrade.sql file in a text editor, such as Notepad, and
copy the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
14. After the script finishes running, click Clear.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V51to55Upgrade.sql
• CampaignOra.sql (optional – if you want to use the Campaign Manager, you need to
run this script)
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
27
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraSQLArchiver_V51to55Upgrade.sql file in a text editor, such as Notepad, and
copy the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
14. After the script finishes running, click Clear.
15. If necessary, repeat steps 7-14 with the CampaignOra.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_FormulationsUpgrade.sql
• OraSQL7x_FormulationUpgrade.sql
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
28
Upgrade Guide
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V50to51Upgrade.sql
• OraSQLRecipe_v50to51Upgrade.sql
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraSQLArchiver_V50to51Upgrade.sql file in a text editor, such as Notepad, and
copy the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
29
14. After the script finishes running, click Clear.
15. Repeat steps 7-14 with the OraSQLRecipe_v50to51Upgrade.sql script.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_V47to50Upgrade.SQL
• OraSQLRecipe_v47to50Upgrade.SQL
• OraSQLAudit_V47to50Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraSQLArchiver_V47to50Upgrade.SQL file in a text editor, such as Notepad, and
copy the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
14. After the script finishes running, click Clear.
15. Repeat steps 7-14 with the OraSQLRecipe_v47to50Upgrade.SQL and then the
OraSQLAudit_V47to50Upgrade.SQL script.
30
Upgrade Guide
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraArchiver_v46tov47Upgrade.SQL
• OraSQL7x_v46tov47Upgrade.SQL
• OracleAuditTable.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraArchiver_v46tov47Upgrade.SQL file in a text editor, such as Notepad, and copy
the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
14. After the script finishes running, click Clear.
15. Repeat steps 7-14 with the OraSQL7x_v46tov47Upgrade.SQL and then the
OracleAuditTable.SQL script.
1. Copy this script file from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
OraSQLArchiver_v45tov46Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
31
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
8. Open the OraSQLArchiver_v45tov46Upgrade.SQL file in a text editor, such as Notepad, and
copy the script contents.
9. Go back to the Internet Explorer window, and in the Workspace area, paste the script. Make
sure that there are no extra paragraph spaces after you paste the text.
10. Click the Preferences button.
11. In the Output Page Setup area, select Single Page so that all output displays on a single page,
and click Apply.
12. Click the Workspace tab to return to your pasted script.
13. Click Execute. The results appear in the bottom half of the window, displaying messages that
let you monitor your progress.
14. After the script finishes running, click Clear.
1. Copy these script files from the DatabaseFiles folder of your Batch Server to any folder on the
Oracle server computer:
• OraSQLArchiver_v41tov45Upgrade.SQL
• OraSQLRecipe_v41tov45Upgrade.SQL
NOTE: If you installed Batch Execution to the default location, you can find the script files in
the C:\Program Files\Proficy\Proficy Batch Execution\DatabaseFiles folder.
2. Open Internet Explorer, and in the Address field, enter the IP address and port to open your
Batch Execution database. For example:
http://5.22.72.1:5501/em
3. Enter a User Name and Password for the user account with administrative privileges for the
Batch Execution database tables. After a few moments, the main screen appears.
4. At the bottom of the screen, in the Related Topics, click the iSQLPlus link. The iSQLPlus
Login screen appears.
5. Leave the Connect as Normal option selected and click Continue.
6. Enter a user name and password, and then click Login to start iSQLPlus.
7. Leave the Internet Explorer window open.
32
Upgrade Guide
IMPORTANT: Batch Execution does not support the Microsoft ODBC for Oracle driver because it
does not implement all the required features. Oracle users should use the Oracle ODBC driver
instead.
1. Click the Start button and point to Programs, Administrative Tools, and then Data Sources
(ODBC). You can also access the Administrative Tools folder from the Control Panel.
The ODBC Data Source Administrator program opens.
33
IMPORTANT: You must upgrade your recipes in order to run them in the latest version of Batch
Execution. Failure to do so will cause problems with the Batch Execution Server.
7. If you are upgrading from Batch 5.1 SP1, update your formulations. To do so:
a. In the Recipe Editor, on the toolbar, click Formulation Parameters.
b. Right-click each formulation and select Update Formulation.
c. If required, provide values for the new parameters added to the updated
formulations.
7. Repeat steps 5-6 for each EIB in that folder that you created in the previous version of
WorkInstruction.
8. Click Close.
9. On the File menu, click Open. The Open dialog box appears.
10. Select a file and click Open to open and convert the EIB document in the WorkInstruction
Editor. As the file opens it converts to the newest version.
A message box appears asking you if you want to upgrade the rest of the EIBs in that folder.
34
Upgrade Guide
8. Repeat steps 6-7 for each EIB that you checked out and resaved.
9. When you are finished checking in each file, select the first EIB in the Work project.
10. Click the Copy to Production Project button. A message box appears asking you to confirm
the action.
11. Click Yes to continue. The EIB Label dialog box appears.
12. Enter a label and click OK.
NOTE: If the Use Signature Verification for DMS Commands option is enabled, you will also
be prompted to enter a user name and password (from the iWorkUsers Windows security
group) to proceed.
13. Repeat steps 9-12 for each EIB in the Work folder, until all of the desired EIBs are moved
into the Production project.
35
Upgrade VBIS Applications from Version 4.6 and Earlier
The steps below explain how to upgrade VBIS from version 4.6 and earlier:
• Modifying the Batch_ID and Recipe_ID length in SQL Server for VBIS
• Modifying the Batch_ID and Recipe_ID length in Oracle for VBIS
To modify the Batch_ID and Recipe_ID length in SQL Server for VBIS:
36
Index
O databases, upgrading ...................................... 4
P projects .......................................................... 8
S V
37