Empower 2 Feature Release 5 Upgrade Guide

Transcription

1 Empower 2 Feature Release 5 Upgrade Guide /Revision A Copyright Waters Corporation 2008 All rights reserved

2 Copyright notice 2008 WATERS CORPORATION. PRINTED IN THE UNITED STATES OF AMERICA AND IRELAND. ALL RIGHTS RESERVED. THIS DOCUMENT OR PARTS THEREOF MAY NOT BE REPRODUCED IN ANY FORM WITHOUT THE WRITTEN PERMISSION OF THE PUBLISHER. The information in this document is subject to change without notice and should not be construed as a commitment by Waters Corporation. Waters Corporation assumes no responsibility for any errors that may appear in this document. This document is believed to be complete and accurate at the time of publication. In no event shall Waters Corporation be liable for incidental or consequential damages in connection with, or arising from, its use. Trademarks Waters is a registered trademark of Waters Corporation, and Empower, PowerLine, ZQ, LAC/E, SAT/IN, and THE SCIENCE OF WHAT S POSSIBLE are trademarks of Waters Corporation. Adobe, Acrobat, and Reader are registered trademarks of Adobe Systems Incorporated in the United States and/or other countries. ControlIT is a trademark of CA, Inc. or one of its subsidiaries. Citrix, ICA, and MetaFrame are registered trademarks of Citrix in the United States and/or other countries. Intel and Pentium are registered trademarks of Intel Corporation. Microsoft, Internet Explorer, Windows, Windows XP, and Windows Vista are registered trademarks of Microsoft Corporation in the United States and/or other countries. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Solaris and Sun are trademarks of Sun Microsystems, Inc. UNIX is a registered trademark of The Open Group. Other registered trademarks or trademarks are the sole property of their owners. ii

3 Customer comments Waters Technical Communications department invites you to tell us of any errors you encounter in this document or to suggest ideas for otherwise improving it. Please help us better understand what you expect from our documentation so that we can continuously improve its accuracy and usability. We seriously consider every customer comment we receive. You can reach us at iii

4 Contacting Waters Contact Waters with enhancement requests or technical questions regarding the use, transportation, removal, or disposal of any Waters product. You can reach us via the Internet, telephone, or conventional mail. Waters contact information: Contacting medium Information Internet The Waters Web site includes addresses for Waters locations worldwide. Visit and click Waters Division > Regional/Global Contacts. Telephone and fax From the USA or Canada, phone HPLC, or fax For other locations worldwide, phone and fax numbers appear in the Waters Web site. Conventional mail Waters Corporation 34 Maple Street Milford, MA USA Empower Software Intended use Use the Waters Empower 2 Software for acquiring, processing, reporting, and managing your chromatographic information. Safety information See the operator s guides of the instruments or devices associated with this software product for information on how to safely operate and maintain them. iv

5 Table of Contents Copyright notice... ii Trademarks... ii Customer comments... iii Contacting Waters... iv Empower Software... iv Intended use... iv Safety information... iv 1 Introduction Hardware and software requirements Upgrading a Standalone or Personal Workstation Scope Requirements Backing up projects Archiving projects Backing up the database Upgrading to Empower 2 FR Starting the upgrade Completing the upgrade Configuring the buslac/e driver Verifying installed files Viewing the installation log Using the file verification utility Table of Contents v

6 Viewing installed licenses and options Upgrading an Enterprise Server or Primary Workgroup Server planning Upgrading to Empower 2 FR Archiving projects Before starting the Empower 2 FR 5 upgrade Starting the upgrade Completing the upgrade Verifying the installed files Viewing installed Empower licenses and options Post-upgrade database file cleanup Freeing up disk space Upgrading a Client Preparing the client Upgrading to Empower FR Starting the upgrade Configuring the buslac/e driver Configuring a database net service name Verifying installed files Viewing the installation log Using the file verification utility Viewing installed licenses and options Upgrading a LAC/E 32 Module Preparing a LAC/E 32 module Upgrading to Empower 2 FR Starting the upgrade Configuring the buslac/e driver vi Table of Contents

7 Configuring a database net service name Verifying installed files Viewing the installation log Using the file verification utility Viewing installed licenses and options Upgrading a File Server Considerations and requirements Considerations Requirements Upgrading to Empower 2 FR Unsharing the existing raw data folder Uninstalling the existing WatersService service Installing the WatersService service Re-share the existing raw data folder Configuring raw data directory permissions Upgrading the Empower Oracle Database on UNIX Introduction Upgrading the Solaris server for Empower 2 FR Updating the Oracle database to Connecting to the database from an Empower 2 FR 5 client Table of Contents vii

8 viii Table of Contents

9 1 Introduction This guide describes the upgrade to Empower 2 Feature Release 5 (FR 5). Throughout, Empower configurations and Empower software are referred to as follows: Empower Software for the generic Empower Software product. Empower 1154 for Empower software, Build Empower 2 for Empower software, Build Empower 2 FR 5 for Empower software, Build 2154 Feature Release 5 (FR 5). Requirements: Your system must be running Empower 2 Feature Release 3 (FR 3) software as a minimum before you can upgrade to Empower 2 Feature Release 5 (FR 5). If your Empower 2 system is running a feature release level prior to FR 3, then Empower 2 FR 5 will not install. If your system is running Empower 2 software, build 2154 (pre-fr 3), first install the necessary service packs and feature releases required to update your system to Empower 2 FR 3. Then follow the instructions in this guide to upgrade from FR 3 to Empower 2 FR 5. If your system is running Empower 1154 software, follow the instructions in the Empower 2 Upgrade and Configuration Guide, Revision A to upgrade to Empower 2 (available on the Empower 2 DVD or the Empower 2 FR 5 documentation CD). Install the necessary service packs and feature releases required to update the Empower 2 system to Empower 2 FR 3. Then follow the instructions in this guide to upgrade to Empower 2 FR 5. If you are running Millennium 32 software (version 4.0 or earlier), you must perform these tasks to upgrade to Empower 2 FR 5: Back up all of your projects using the Backup Project wizard in Configuration Manager. 1-1

10 Install Empower 2 FR5 following the instructions in the Empower 2 Installation and Configuration Guide, Revision B (available on the Empower 2 FR 5 documentation CD). Restore your projects using the Restore Projects wizard in Configuration Manager. This chapter describes the hardware and software needed to work with Waters Empower 2 FR 5 software. Hardware and software requirements The following tables describe the major subsystems, hardware, and operating system configurations that Empower software supports. Requirements for Empower Personal or client computers, LAC/E modules Component Minimum Operating system Windows XP Professional with Service Pack 2 Random access memory (RAM) Hard disk drive DVD drive Monitor Graphics capability Printer Optional control card Application software Network interface card Intel Pentium 4, 1.7 GHz CPU 1 GB 8 GB Access to a DVD drive required Required svga video at bit color resolution Access to a printer required Waters Bus Laboratory Acquisition and Control/ Environment (buslac/e ) card or 8-port serial card Empower software Microsoft Internet Explorer 7.0 Recommended for Personal Required for secondary PC and client 1-2 Introduction

11 Restrictions: Windows 2000 Professional is no longer supported on Personal or client computers, or on LAC/E modules. The Empower 2 FR 5 upgrade is not supported on Citrix. If you have a previous version of Empower on your Citrix server, you must first uninstall the software using the Add/Remove program. Uninstall all Instrument Control Option Packs (ICOPs) first, then any Instrument Control Software (ICS), then any AQTs, and then the Empower client. When you have uninstalled these components, follow the instructions in the Empower 2 Installation and Configuration Guide, Revision B to install Empower 2 FR 5 on your Citrix server. Requirement: When you uninstall Empower, you must also manually delete the old milerror.log file from the Windows directory. Since this file contains information about prior error conditions which may no longer exist with a new installation of Empower, deleting the milerror.log file prevents any non-existent error conditions from being included in Verify Files. Any subsequent error conditions that occur with the new Empower installation are then accurately captured in Verify Files. Exception: The Empower 2 FR 5 installer gathers information about your system and compares your system settings to the minimum allowed specifications. If your system lacks any of the necessary requirements, the installation is not allowed, and the installation procedure stops and exits. In some instances, the installer allows you to continue; however, the installation will not be validated. Requirements for the workgroup computer Component Operating system Random access memory (RAM) Hard disk drive DVD drive Backup device Minimum Windows 2000 Server with Service Pack 4 or Windows 2000 Advanced Server with Service Pack 4 or Windows Server 2003 R2 SP2 Intel Pentium III, 1 GHz CPU 1 GB 3 hard drives Access to a DVD drive required Recommended (optional) Hardware and software requirements 1-3

12 Requirements for the workgroup computer (Continued) Component Monitor Graphics capability Printer Application software Network interface card Minimum Required bit color resolution Access to a printer required Empower server software Microsoft Internet Explorer /100 NIC Restriction: Windows 2000 is supported only for the Windows workgroup or Empower Enterprise server upgrades. Requirements for the Windows Empower Enterprise server Component Operating system Random access memory (RAM) Hard disk drive DVD drive Backup device Monitor Graphics capability Printer Application software Network interface card Minimum Windows 2000 Server with Service Pack 4 or Windows 2000 Advanced Server with Service Pack 4 or Windows Server 2003 R2 SP2 Intel Pentium III, 1.2 GHz CPU 2 GB 4 hard drives Access to a DVD drive required Recommended (optional) Required bit color resolution Access to a printer required Empower server software Microsoft Internet Explorer /100 NIC Required 1-4 Introduction

13 Requirements for the Solaris Empower Enterprise server Component Minimum Operating system Solaris 10 (64 bit) Random access memory 2 GB (RAM) Hard disks 2 hard drives (3 recommended) DVD drive Access to a DVD drive required Backup device Recommended (optional) Monitor Required Graphics capability bit color resolution Printer Access to a printer required Application software Oracle RDBMS Network interface card 10/100 NIC Required Requirement: You must have at least these minimum requirements. The installer checks for sufficient resources to run Oracle. The installer will not continue if your system has insufficient memory or contains any incorrect environmental settings. Tip: If you are using real-time virus scanning, exclude all Empower-related folders and their sub-directories. Some real-time virus scanners mistake normal Empower functionality for virus activity, which can cause data-buffering problems. Hardware and software requirements 1-5

14 1-6 Introduction

15 2 Upgrading a Standalone or Personal Workstation This chapter explains how to upgrade an Empower Personal workstation running Empower 2 FR 3, FR 4, SPC, SPD, or SPE software to a Personal workstation that runs Empower 2 FR 5 software. Restriction: Windows 2000 Professional is no longer supported on personal or client computers, or on LAC/E 32 modules. Requirements: Your system must meet the requirements specified on page 1-1. Before installing any hardware or software, perform a full backup of your hard drives (see the instructions provided by your computer s manufacturer). Contents Topic Page Scope 2-2 Requirements 2-2 Backing up projects 2-3 Archiving projects 2-3 Backing up the database 2-3 Upgrading to Empower 2 FR Verifying installed files 2-6 Viewing installed licenses and options

16 Scope The upgrade process involves these procedures: Backing up all projects (see Backing up projects on page 2-3). Backing up the database (see Backing up the database on page 2-3). Upgrading Empower software (see Upgrading to Empower 2 FR 5 on page 2-4). Requirements Each Empower Personal workstation requires the hardware and software specified in the table on page 1-2. Restriction: Upgrades are not supported on Empower Personal workstations running Windows Recommendation: When Setup restarts the system at the end of the upgrade, any unsaved Windows data are permanently lost. Save and close all open files on your system before upgrading. Before you begin the upgrade, perform these actions: Log in to an account with administrator privileges. Back up your projects using Configuration Manager. Archive any Empower projects that are no longer in use or needed in day-to-day activities using Configuration Manager. Back up your database and raw data files. Back up and defragment the hard drive (see the Microsoft documentation and Help system) to ensure a smooth installation and optimum performance from Empower. Close all applications, and then restart the workstation. Verify that the disk drive has enough disk space for the upgraded database. 2-2 Upgrading a Standalone or Personal Workstation

17 Backing up projects Use the Configuration Manager to back up your existing projects. To back up your projects 1. In Configuration Manager, select the projects to back up. 2. Click File > Backup Project. 3. Follow the instructions in the Backup Project Wizard. Archiving projects Archiving Empower projects that are no longer in use or needed in day-to-day activities reduces the total amount of data converted during the upgrade process. This type of system maintenance benefits the upgrade process by shortening the time to complete the upgrade while ensuring the archived data can be retrieved and accessed at a later time after the upgrade is complete. Archiving project data involves backing up projects that you may need later but do not need now using the Configuration Manager Backup Wizard, and then deleting them from Empower. Use this technique to minimize upgrade time. Waters offers several automated archive options for Empower. For more information, contact your local subsidiary or visit Backing up the database Before you back up the database, check the Oracle SQLNET.ORA file to ensure authentication is set to on. If authentication is set to off when you attempt to back up the database, it might not back up properly. To check authentication in the Oracle SQLNET.ORA file 1. Locate the Oracle SQLNET.ORA file (typically in X:\Empower\Oracle\Oracle10g\NETWORK\ADMIN\SQLNET.ORA, where X is the drive where Empower software is installed). 2. Open the file using the Windows Notepad application. Backing up projects 2-3

18 3. Locate the authentication setting: SQLNET.AUTHENTICATION_SERVICES = (NTS) If the setting is NTS, do not change it. Close the SQLNET.ORA file, and then proceed to back up the database. If the setting is NONE, change it to NTS. Save and close the SQLNET.ORA file, and then proceed to back up the database. To back up the database 1. In Configuration Manager, click File > Backup Database. 2. Follow the instructions in the Backup Database Wizard. Upgrading to Empower 2 FR 5 Waters supplies Empower 2 FR 5 software on a DVD. Caution: The Empower 2 FR 5 installer upgrades your version of Oracle from to The process cannot be reversed once it has begun. Recommendation: Make a full backup of your system before installation using the Backup Database option in Configuration Manager. Allow at least 60 minutes for the upgrade. Starting the upgrade To start the Empower 2 FR 5 upgrade 1. Insert the Empower2 FR 5 DVD into the DVD drive. 2. Browse to the Personal folder on the DVD, and double-click EmpowerPersonalFR5setup.exe. Result: The Upgrade installer initializes. 3. On the Choose Setup Language page, select a language from the drop-down list. Requirement: If Microsoft.NET Framework 3.0 software is installed on your system, the upgrade continues. However, if the software is not 2-4 Upgrading a Standalone or Personal Workstation

19 installed, the Requirement wizard page appears. On that page, click Install. 4. On the Welcome page, click Next. 5. On the Oracle Upgrade Information page, review the information, select Yes, I have made a full backup of my Empower 2 database and projects, and then click Next. Result: The Empower Personal Feature Release 5 Installation Wizard page appears. Click Next to continue. Tip: If you changed the Oracle system account password from the previous version, the Oracle Database Password page appears. Enter the password, and then click Verify Password. Click OK when the validation pop-up box appears. When the Empower Personal - Feature Release 5 Installation Wizard page displays, click Next. The Installing Empower Personal Updates page displays, indicating the progress of the installation. You will see several pop-up status boxes as the installation continues. 6. When the InstallShield Wizard Completed page displays, click Finish. 7. Click Yes on the next page to restart the workstation. Completing the upgrade After the computer restarts, perform these tasks: Log in to the operating system using an account with administrator privileges. (The account must be the same one that you logged in to when starting the installation.) If your system includes a buslac/e card, you must configure the buslac/e driver for Empower. Follow the procedure in the next section. If you want to install software support for one or more instruments, use the Waters Instrument Control Options Pack (ICOP) installation DVD. Browse to the appropriate language folder on the DVD, locate the setup.exe file, and then double-click the file. Follow the prompts to install the software support you need. Log in to Empower using an Administrator account. Verify the installed files. View installed licenses and options. Upgrading to Empower 2 FR 5 2-5

20 Configuring the buslac/e driver If you have a buslac/e card installed on your system, the first time you log in to the computer after the upgrade is complete, the Found New Hardware Wizard dialog appears. To configure the buslac/e driver 1. On the Found New Hardware Wizard page, select No, not this time and then click Next. 2. Select Install from a list or specific location (Advanced) and then click Next. 3. Select Search for the best driver in these locations and select the checkbox Include this location in the search. 4. Click the Browse button and browse to the following directory: C:\Empower\BusLaceDrivers. 5. Click OK to include the location, and then click Next. Result: The BusLAC/E Driver installs. 6. Click Finish. Result: The buslac/e driver appears as Buslace PCI KMDF Device Driver under BusLAC/E Drivers in Device Manager. Verifying installed files The Empower Setup wizard creates an Empower program folder in the Start menu. The Empower program folder contains these programs: Empower Starts the Empower software and displays the Empower Login page. After you log in, you can select one of several Empower applications. For details, see Starting and exiting from Empower in the Empower Help. Empower Installation Log Provides information about the current installation. Waters Licensing Wizard Starts the Waters Licensing Wizard, which you can use to request software registration, activate and deactivate licenses and options, or view Waters licenses and their serial numbers. 2-6 Upgrading a Standalone or Personal Workstation

21 Remove Waters Instrument Component Software Provides a way to remove instrument component software. (This appears in the menu list whether or not ICOP instruments are installed.) Instrument documents Lists the documentation (online Help or PDF files) that accompany any installed ICOP instruments. Register Empower Node Printers Registers printers so that you can print Empower reports. Verify Files Verifies the integrity of the Empower software files on your hard disk. Viewing the installation log The installation log contains information about your Empower installations. You can read the log file to review your installation choices. In case of a partial or unsuccessful installation, you can review the installation log to check for errors. To view the installation log 1. Click Start > Programs > Empower > Empower Installation Log. Result: The program displays the Empower.log file in Notepad. 2. Review the contents of the installation log file. Tip: The most recent installation information is at the end of the file. 3. Click File > Exit. Using the file verification utility The file verification utility checks the integrity of the installed Empower program files. Requirement: Log in to Empower at least once before you use the file verification utility. This ensures that your database is properly upgraded. After the installation, run the file verification utility to verify the Empower program files only (not the database files): As part of your installation qualification if you purchased the Empower Qualification option To ensure that the Empower files did not change since installation Verifying installed files 2-7

22 To run the file verification utility 1. Click Start > Programs > Empower > Verify Files. Result: The file verification utility compares the installed Empower files checksum with a previously stored checksum and then creates a file verification results log. 2. Review the contents of the file, and then print or save a copy of the results. 3. Click File > Exit. Viewing installed licenses and options With Empower 2 Feature Release 5, Waters introduces a new Software License Management System for managing Waters software licenses and options. Empower 2 FR 5 Personal workstations on Windows XP can use the new License Management System or the license floppy key disks, but you cannot use both. You can view active licenses and options using the Show Licenses option in the Waters Licensing Wizard. This option is available whether you use the key disks or the Wizard to activate your licenses and options. If you purchased new licenses or options, you cannot use the Wizard to install additional licenses or options unless you first remove the licenses or options you installed using the key disks. You must then use the Wizard to activate all your licenses and options. Once you use the Wizard to activate your licenses and options, you must also use it to deactivate them. For details and instructions on using the new Waters Licensing Wizard, see the Empower 2 Installation and Configuration Guide, Revision B (available on the Empower 2 FR 5 documentation CD). 2-8 Upgrading a Standalone or Personal Workstation

23 3 Upgrading an Enterprise Server or Primary Workgroup This chapter explains how to upgrade client/server or workgroup installations to Empower 2 FR 5 software. Requirements: Your system must meet the requirements specified on page 1-1. Before installing any hardware or software, perform a full backup of your hard drives (see the instructions provided by your computer s manufacturer). Contents Topic Page Server planning 3-2 Upgrading to Empower 2 FR Post-upgrade database file cleanup

24 Server planning Requirement: Your system must meet the requirements specified on page 1-1. The Waters Empower 2 FR 5 DVD contains Oracle 10g Release 2 software (Oracle ) and Empower 2 FR 5 software. Restriction: If you previously installed Empower 2 and the Oracle software separately, you cannot upgrade to Empower 2 FR 5. Upgrading to Empower 2 FR 5 The Empower 2 FR 5 upgrade utility provides an automated means to migrate your existing database to Empower 2 FR 5. Requirement: Before installing or upgrading any hardware or software, shut down the database, and perform a full backup of your hard drives (see the instructions provided by your computer s manufacturer). If errors occur during the upgrade procedure, you can restore the original database from the backup. Recommendation: Archive any Empower projects that are no longer in use or needed in day-to-day activities using Configuration Manager. Waters supplies Oracle and Empower 2 FR 5 software on a DVD. Procedures in this chapter assume that you want to install Oracle automatically using default settings. Allow at least 60 minutes for the upgrade. Caution: The Empower 2 FR 5 installer upgrades your version of Oracle from to The process cannot be reversed once it has begun. Archiving projects Archiving Empower projects that are no longer in use or needed in day-to-day activities reduces the total amount of data converted during the upgrade process. This type of system maintenance benefits the upgrade process by shortening the time to complete the upgrade while ensuring the archived data can be retrieved and accessed at a later time after the upgrade is complete. Archiving project data involves backing up projects that you may need later but do not need now using the Configuration Manager Backup Wizard, and 3-2 Upgrading an Enterprise Server or Primary Workgroup

25 then deleting them from Empower. Use this technique to minimize upgrade time. Waters offers several automated archive options for Empower. For more information, contact your local subsidiary or visit Before starting the Empower 2 FR 5 upgrade Requirement: Before you start the Empower 2 FR 5 upgrade, you must first stop three Oracle services. To stop the required Oracle services: 1. Right-click My Computer and select Manage. 2. Expand Services and Applications, and then click Services. 3. Scroll down the list of services until you locate OracleCSService. 4. Right-click the service named OracleCSService and select Stop. 5. Repeat steps 3 and 4 for the OracleDBConsoleWATX (where X is your database SID) and OracleEmpower10gTNSListener services. Note: If you do not stop the above-referenced services, the metadata export may fail. If the metadata export fails, the FR 5 Upgrade installer automatically exits without modifying the pre-fr 5 database. If this happens, stop the services and restart the upgrade installer. Requirement: If you restart the server before continuing with the upgrade, you must stop the services again. Starting the upgrade To start the Empower 2 FR 5 upgrade 1. Insert the Empower 2 FR 5 DVD into the DVD drive. 2. Browse to the Server folder on the Empower 2 FR 5 DVD, and double-click EmpowerServerFR5setup.exe. 3. On the Choose Setup Language page, select a language from the drop-down list, and then click OK. Requirement: On Windows 2003 Server systems, if Microsoft.NET Framework 3.0 software is installed on your system, the upgrade Upgrading to Empower 2 FR 5 3-3

26 continues. However, if the software is not installed, the Requirement wizard page appears. On that page, click Install. Tip: Microsoft.NET Framework 3.0 is not installed on Windows 2000 Server systems. 4. On the Welcome to the InstallShield Wizard for Empower Server Feature Release 5 page, click Next. 5. On the Oracle Upgrade Information page, review the information, select Yes, I have made a full backup of my Empower 2 Database and Projects, and then click Next. Tip: If you changed the Oracle database password for the system account, the Oracle Database Password page appears. Enter the password, and click Verify Password. Then click OK when the validation pop-up box appears. 6. On the Empower Server - Feature Release 5 Installation Wizard page, click Next. 7. On the Custom Setup page, you can specify where you want the program features installed. Tip: By default, the Empower Projects and Empower Program Files features are installed in the same location as the previous version. These locations cannot be changed. Recommendation: Change the location of the Oracle Application and Empower Oracle Database features by selecting these features and clicking the Change Feature Location button. On the Change Current Destination Folder page, select the desired drive, and then click OK. When you return to the Custom Setup page, click Next. 8. On the Database Options page, specify the locations of the database mirror and archive directories by changing the drive letter of the provided paths, and then click Next. Recommendation: For best performance and fault tolerance reasons, spread the components across multiple drives by changing the drive letter from C to different letters. Requirement: Change only the drive letter of the path. 9. On the Oracle Database Domain Name and SID page, enter the Oracle Service Identifier (SID) and the Oracle Database Domain Name, and then click Next. 3-4 Upgrading an Enterprise Server or Primary Workgroup

27 Restriction: You cannot use the same Oracle SID that was used for the previous version. If you try to use the same SID, an error message appears. The Empower 2 FR 5 installer appends the letter A to the name you entered. Click OK in the error message box, enter a new SID, and then click Next. 10. On the Ready to Install Empower Server - Feature Release 5 page, click Install to start the installation. Tip: If a Windows Security page appears, click Unblock to continue the installation. You may need to do this more than once. 11. On the InstallShield Wizard Completed page, click Finish. Completing the upgrade After the computer restarts, log in to the operating system using an account with administrator privileges to complete the upgrade to Empower 2 FR 5. (The account must be the same one that you logged in to when starting the installation.) Configuring a database net service name Use the following procedures to configure the net service name. To configure a net service name 1. Click Start > Programs > Oracle Empower10g > Configuration and Migration Tools > Net Configuration Assistant. 2. On the Welcome page, select Local Net Service Name configuration, and then click Next. 3. On the Net Service Name Configuration page, ensure that Add is selected, and then click Next. 4. On the Service Name page, enter the global database name, and then click Next. Tip: The global database name is the combination of the (Oracle) Service Identifier (SID) and the database domain name, as supplied during installation. Example: If the SID is WAT7 and the database domain name is Empower1.Waters.com, the global database name is WAT7.Empower1.Waters.com. Upgrading to Empower 2 FR 5 3-5

28 5. On the Select Protocols page, ensure that TCP/IP is selected, and then click Next. 6. On the TCP/IP Protocol page, enter either the host name or the IP address of the server in the Host Name field. 7. Leave the default port selection (1521) unchanged, and then click Next. To test the connection 1. On the Test page, select Yes, perform a test, and then click Next. Result: The test will fail, indicating the ORA invalid username/password error. If the failure is associated with any error other than ORA-01017, contact Waters Technical Support. 2. Click Change Login. 3. On the Change Login page, enter System in the Username field and Empower in the Password field. Tip: Empower is the default password for the Oracle System account in Empower Click OK. To specify the net service name 1. On the Net Service Name page, enter a name in the Net Service Name field, and then click Next. Requirement: The name that you enter appears in the Database field of the Empower Login page. When using a client with a LAC/E 32 module, the client and the module must use the identical net service name. 2. On the Another Net Service Name? page, select No, click Next until the Welcome page of the Oracle Net Configuration Assistant wizard reappears, and then click Finish. Verifying the new SID If any of your clients and LAC/Es use the TNS_ADMIN variable, verify that the SERVICE_NAME information in the tnsnames.ora file (located in a shared folder typically the Empower\Projects directory) matches the new SID that was chosen during the upgrade. 3-6 Upgrading an Enterprise Server or Primary Workgroup

29 Verifying the installed files The Empower Setup wizard creates an Empower program folder in the Start menu Programs folder. The Empower program folder contains the following program items: Empower Starts the Empower software and displays the Empower Login page. After you log in, you can select one of several Empower applications. For details, see Starting and exiting from Empower in the Empower Help. Empower Installation Log Contains information about the current installation. Waters Licensing Wizard Starts the Waters Licensing Wizard, which you can use to request software registration, activate and deactivate licenses and options, or view Waters licenses and their serial numbers. Remove Waters Instrument Component Software Provides a way to remove instrument component software. This item appears in the menu list, regardless of whether ICOP instruments are installed. Instrument documents Lists the documentation (online help or PDF files) that accompany any installed ICOP instruments. Register Empower Node Printers Registers printers so that you can print Empower reports. Verify Files Verifies the integrity of the Empower software files on your hard disk. Viewing the installation log text The installation log contains information about your Empower installation. You can use the log file to review your installation choices. In case of partial or unsuccessful installations, you can view the installation log to check for errors. To view the installation log 1. Select Start > Programs > Empower > Installation Log. Result: The program displays the empower.log file in Notepad. 2. Review the contents of the file. You can print a copy by selecting File > Print. 3. Select File > Exit. Upgrading to Empower 2 FR 5 3-7

30 Before using the file verification utility Before you use the file verification utility for the first time after the upgrade, you must log in to Empower using an Administrator account. Before you use the file verification utility 1. Log in to Empower using an account with Empower Administrator privileges. 2. On the C/S Update Server Database page, enter the following password exactly as it appears here (you must use all capital letters): EMPOWERCSUPDATE Click OK. 3. On the Empower Pro page, at the Database needs to be updated to the next point revision prompt, click OK. Using the file verification utility The file verification utility checks the integrity of the installed Empower program, data, and database files. After the installation, run the utility to verify the Empower program and data files only (not the database files): As part of your installation qualification, if you purchased the Empower Qualification option To ensure that the Empower files did not change since installation To use the file verification utility 1. Select Start > Programs > Empower > Verify Files. Result: The file verification utility compares the installed Empower files checksum with a previously stored checksum and then creates a file verification results log. 2. Review the contents of the file. Print or save a copy of the results. 3. Select File > Exit. 3-8 Upgrading an Enterprise Server or Primary Workgroup

31 Viewing installed Empower licenses and options With Empower 2 Feature Release 5, Waters introduces a new Software License Management System for managing Waters software licenses and options. Empower 2 FR 5 Personal workstations on Windows XP can use the new License Management System or the license floppy key disks, but you cannot use both. You can view active licenses and options using the Show Licenses option in the Waters Licensing Wizard. This option is available whether you use the key disks or the Wizard to activate your licenses and options. Restriction: You cannot use the Waters Licensing Wizard on computers with a Windows 2000 Server operating system. If you purchased new licenses or options, you cannot use the Wizard to install additional licenses/options unless you first remove the licenses/options you installed using the key disks. You must then use the Wizard to activate all your licenses and options. Once you use the Wizard to activate your licenses and options, you must also use it to deactivate them. For details and instructions on using the new Waters Licensing Wizard, see the Empower 2 Installation and Configuration Guide, Revision B (available on the Empower 2 FR 5 documentation CD). Post-upgrade database file cleanup The Empower 2 FR5 installer creates a new instance during the upgrade process. The new instance uses files from the previous version of Empower. You can copy the old files from their current location to the directory where the rest of the new database files reside. Recommendation: This is a copy action and not a move action. The original datafiles remain in the directory. Before you perform the copy action, verify there is sufficient space on the disk for the new files to be generated. Restriction: Relocate only the database files that are the datafiles associated with USER_DATA and INDEX_DATA. You can find these datafile locations using the Oracle Enterprise Manager (OEM) Web Administration tool located in the Empower Start menu. Post-upgrade database file cleanup 3-9

32 Tip: This process is optional and may take a while if the database files are large. You must run the script separately for each database file to be moved. Caution: Ensure the database is up and running before proceeding. To move the database files 1. Open a command prompt and navigate to the Empower\Script directory. 2. Run the following command, replacing the following parameters: movedatafile.bat <ORACLE_SID> <ORACLE_HOME> <SYS PASSWORD> <FROM DATAFILE NAME INCLUDING PATH> <TO DATAFILE NAME INCLUDING PATH> Example: movedatafile WAT7 E:\EMPOWER\ORACLE\ORACLE102 ORACLE D:\EMPOWER\DATABASE\ORADATA\WAT6\USERS01.DBF D:\EMPOWER\DATABASE\ORADATA\WAT7\USERS01.DBF Tip: If the file already exists in the destination location, the script will not run. Manually delete the file and run the script again. If the file does not delete, contact Waters Technical Support. 3. Repeat step 2 for each database file to be moved. Freeing up disk space If you changed the path to the database mirror and archive directories during the upgrade, remove the old files after the upgrade is complete to free up disk space Upgrading an Enterprise Server or Primary Workgroup

33 4 Upgrading a Client This chapter explains how to upgrade Empower software on a client (or an acquisition client) in an Empower Enterprise system or a Workgroup to Empower 2 FR 5. Requirement: Before installing any hardware or software, perform a full backup of your hard drives (see the instructions provided by your computer s manufacturer). Contents Topic Page Preparing the client 4-2 Upgrading to Empower FR Configuring a database net service name 4-4 Verifying installed files 4-5 Viewing installed licenses and options

34 Preparing the client Restriction: Windows 2000 Professional is no longer supported on Personal or client computers, or on LAC/E modules. The Empower software on a client or acquisition client using the Windows XP operating system requires the hardware and software specified in the table titled Requirements for Empower Personal or client computers, LAC/E modules on page 1-2. Caution: The Empower 2 FR 5 installer upgrades your version of Oracle from to The process cannot be reversed once it has begun. Restriction: If you previously installed Empower 2 and the Oracle software separately, you cannot upgrade to Empower 2 FR 5. Upgrading to Empower FR 5 Requirement: Your system must be running a minimum of Empower 2 Feature Release 3 software before you can upgrade to Empower 2 FR 5. Starting the upgrade Waters supplies Empower 2 FR 5 software on a DVD. To start the Empower 2 FR 5 upgrade 1. Browse to the Client folder on the Empower 2 FR 5 DVD and double-click EmpowerClientFR5setup.exe. 2. On the Choose Setup Language page, select a language from the drop-down list. Requirement: If Microsoft.NET Framework 3.0 software is installed on your system, the upgrade continues. However, if the software is not installed, the Requirement wizard page appears. On that page, click Install. 3. On the Welcome to the InstallShield Wizard for Empower Client/LACE Updates page, click Next. 4-2 Upgrading a Client

35 4. On the Empower 2 FR5 Client/LACE Oracle Upgrade Information page, click Next. 5. On the Empower 2154 Update Installation Wizard page, click Next. 6. On the InstallShield Wizard Completed page, click Finish. 7. Click Yes on the next page to restart the client. If you want to install software support for one or more instruments, use the Waters Instrument Control Options Pack (ICOP) installation DVD. Browse to the appropriate language folder on the DVD, locate the setup.exe file, and then double-click the file. Follow the prompts to install the software support you need. Configuring the buslac/e driver If you have a buslac/e card installed on your system, the first time you log in to the computer after the upgrade is complete, the Found New Hardware Wizard dialog appears. You must configure the buslac/e driver for Empower 2 FR 5. To configure the buslac/e driver 1. On the Found New Hardware Wizard page, select No, not this time and then click Next. 2. Select Install from a list or specific location (Advanced) and then click Next. 3. Select Search for the best driver in these locations and select the checkbox Include this location in the search. 4. Click the Browse button and browse to the following directory: C:\Empower\BusLaceDrivers. 5. Click OK to include the location, and then click Next. Result: The buslac/e Driver installs. 6. Click Finish. Result: The buslac/e driver appears as Buslace PCI KMDF Device Driver under BusLAC/E Drivers in Device Manager. Upgrading to Empower FR 5 4-3

36 Configuring a database net service name You must configure a net service name (previously called a database alias) on each client to connect to the Empower database unless you are using the TNS_ADMIN environment variable. Restriction: You cannot use the original tnsnames.ora file. After the upgrade is complete, an original copy is stored in the C:\Windows folder, and it is named tnsnamesold.txt. Use the following procedure to configure the net service name. To configure a net service name 1. Select Start > Programs > Oracle - Empower10g > Configuration and Migration Tools > Net Configuration Assistant. 2. On the Welcome page, select Local Net Service Name configuration, and then click Next. 3. On the Net Service Name Configuration page, ensure that Add is selected, and then click Next. 4. On the Service Name page, enter the global database name, and then click Next. Tip: The global database name is the combination of the (Oracle) Service Identifier (SID) and the database domain name, as supplied during installation. Example: If the SID is WAT7 and the database domain name is Empower1.Waters.com, the global database name is WAT7.Empower1.Waters.com. 5. On the Select Protocols page, ensure that TCP/IP is selected, and then click Next. 6. On the TCP/IP Protocol page, enter the host name or the IP address of the server in the Host Name field. 7. Leave the default port selection (1521) unchanged, and then click Next. 4-4 Upgrading a Client

37 To test the connection 1. On the Test page, select Yes, perform a test, and then click Next. Result: The test will fail, indicating the ORA invalid username/password error. If the failure is associated with any error other than ORA-01017, contact Waters Technical Support. 2. Click Change Login. 3. On the Change Login page, enter System in the Username field and Empower in the Password field. Tip: Empower is the default password for the Oracle System account in Empower Click OK. To specify the net service name 1. On the Net Service Name page, enter a name in the Net Service Name field, and then click Next. Requirement: The name that you enter appears in the Database field of the Empower Login page. When using a client with a LAC/E 32 module, the client and the module must use the identical net service name. 2. On the Another Net Service Name? page, Select No, click Next until the Welcome page of the Oracle Net Configuration Assistant wizard reappears, and then click Finish. Verifying installed files The Empower Setup wizard creates an Empower program folder in the Start menu. The Empower program folder contains these programs: Empower Starts the Empower software and displays the Empower Login page. After you log in, you can select one of several Empower applications. For details, see Starting and exiting from Empower in the Empower Help. Empower Installation Log Provides information about the current installation. Waters Licensing Wizard Starts the Waters Licensing Wizard, which you can use to request software registration, activate and deactivate licenses and options, or view Waters licenses and their serial numbers. Verifying installed files 4-5

38 Remove Waters Instrument Component Software Provides a way to remove instrument component software. (This appears in the menu list whether or not ICOP instruments are installed.) Instrument documents Lists the documentation (online help or PDF files) that accompany any installed ICOP instruments. Register Empower Node Printers Registers printers so that you can print Empower reports. Verify Files Verifies the integrity of the Empower software files on your hard disk. Viewing the installation log The installation log contains information about your Empower installations. You can read the log file to review your installation choices. In case of a partial or unsuccessful installation, you can review the installation log to check for errors. To view the installation log 1. Click Start > Programs > Empower > Empower Installation Log. Result: The program displays the Empower.log file in Notepad. 2. Review the contents of the installation log file. Tip: The most recent installation information is at the end of the file. 3. Click File > Exit. Using the file verification utility The file verification utility checks the integrity of the installed Empower program files. Requirement: Log in to Empower at least once before you use the file verification utility. This ensures that your database has been properly upgraded. After the installation, run the file verification utility to verify the Empower program files only (not the database files): As part of your installation qualification if you purchased the Empower Qualification option To ensure that the Empower files did not change since installation 4-6 Upgrading a Client

39 To run the file verification utility 1. Click Start > Programs > Empower > Verify Files. Result: The file verification utility compares the installed Empower files checksum with a previously stored checksum and then creates a file verification results log. 2. Review the contents of the file. Print or save a copy of the results. 3. Click File > Exit. Viewing installed licenses and options With Empower 2 Feature Release 5, Waters introduces a new Software License Management System for managing Waters software licenses and options. Empower 2 FR 5 Personal workstations on Windows XP can use the new License Management System or the license floppy key disks, but you cannot use both. You can view active licenses and options using the Show Licenses option in the Waters Licensing Wizard. This option is available whether you use the key disks or the Wizard to activate your licenses and options. If you purchased new licenses or options, you cannot use the Wizard to install additional licenses/options unless you first remove the licenses/options you installed using the key disks, and then use the Wizard to activate all your licenses and options. Once you use the Waters Licensing Wizard to activate your licenses and options, you must also use the Wizard to deactivate them. For details and instructions on using the new Water Licensing Wizard, see the Empower 2 Installation and Configuration Guide, Revision B (available on the Empower 2 FR 5 documentation CD). Viewing installed licenses and options 4-7

40 4-8 Upgrading a Client

41 5 Upgrading a LAC/E 32 Module This chapter explains how to upgrade to Empower 2 FR 5 software on a Waters LAC/E 32 module. To upgrade to Empower 2 FR 5 software on an acquisition client, follow the installation instructions in Chapter 4. Requirement: Before installing any hardware or software, perform a full backup of your hard drives (see the instructions provided by your computer s manufacturer). Contents Topic Page Preparing a LAC/E 32 module 5-2 Upgrading to Empower 2 FR Configuring a database net service name 5-4 Verifying installed files 5-5 Viewing installed licenses and options