Sys Adm
Sys Adm
715005267 / Revision A
Copyright notice
© 2002 - 2016 WATERS CORPORATION. PRINTED IN THE UNITED STATES OF AMERICA
AND IN 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. For the most recent revision of this document, consult
the Waters Web site (waters.com).
Trademarks
ACQUITY, ACQUITY UPLC, Empower, UPLC, “THE SCIENCE OF WHAT’S POSSIBLE.” ,
and Waters are registered trademarks of Waters Corporation.
Adobe, Acrobat, and Reader are registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Agilent is a trademark of Agilent Technologies, Inc.
Citrix and ICA are registered trademarks, and XenApp and Citrix Presentation Server
are trademarks of Citrix in the United States and/or other countries.
Hitachi is a registered trademark of the Kabushiki Kaisha Hitachi Seisakusho
Corporation.
Microsoft, Internet Explorer, Windows, and Windows Server are registered trademarks
of Microsoft Corporation in the United States and/or other countries.
Red Hat is a registered trademark of Red Hat, Inc.
Shimadzu is a registered trademark of the Shimadzu Corporation.
Veritas is a registered trademark of Symantec Operating Corporation.
iPad, iPhone, and Safari are trademarks of Apple Inc., registered in the U.S. and other
countries.
Android and Chrome are trademarks of Google, Inc.
VMware is a registered trademark or trademark of VMare, Inc. in the United States or
other countries.
Oracle and Solaris are registered trademarks of Oracle Corporation and/or its
affiliates.
Other registered trademarks or trademarks are the sole property of their owners.
Customer comments
Waters’ Technical Communications organization invites you to report any errors that
you encounter in this document or to suggest ideas for otherwise improving it. 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 tech_
[email protected].
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.
Internet The Waters Web site includes contact information for Waters
locations worldwide.
Visit www.waters.com
Telephone and From the USA or Canada, phone 800 252-4752, or fax 508 872 1990.
fax For other locations worldwide, phone and fax numbers appear in the
Waters Web site.
Conventional Waters Corporation
mail 34 Maple Street
Milford, MA 01757
USA
Trademarks iii
Customer comments iv
Contacting Waters iv
Table of Contents v
1 Introduction 9
1.1 System overview 9
1.2 Software description 11
1.2.1 Server software 11
1.2.2 Client software 11
1.3 System administration 12
1.3.1 System administrator qualifications 12
1.3.2 System administration tasks 13
1.3.3 System administrator's log 14
2.2 Windows user accounts 17
2.2.1 Windows administrator account privileges 17
2.2.2 Windows domain user account privileges 18
2.3 Managing the server disk space 18
2.3.1 Checking free disk space 18
2.3.2 Increasing free disk space 19
2.4 Stop and start services on the server 20
3.2 Starting and exiting Waters Database Manager 23
3.3 View and configure alerts 24
3.4 Database file organization 26
3.4.1 Server configurations 26
3.4.2 Database file organization 26
3.5 Configuring the Windows DBA account 28
3.5.1 Adding a user or group to the ORA_DBA group 29
3.6 Shutting down and starting up the database 29
3.7 Manage Database User Accounts 30
3.7.1 Locking and unlocking Oracle accounts 31
3.7.2 Changing Oracle account passwords 31
3.7.3 Change the Sys account password 32
3.8 Record database information 32
3.9 Adding tablespace datafiles to the database 32
3.10 Archiving alert logs 33
4.2 Configuring a database net service name 36
4.3 Logging in to Empower as the default administrator 38
4.3.1 Changing the Empower 3 FR4 system user account password 39
4.3.2 Changing the database password 39
4.4 Managing raw data files 40
4.4.1 Adding a raw data share 40
4.4.2 Moving project raw data files 40
4.5 Using the System Monitor 41
4.6 Checking for Empower service or feature releases 42
5.2 Scheduling database backups 45
5.3 Manage backup settings 46
5.3.1 Disk Settings 46
5.3.2 Backup Policy 47
5.4 Viewing database backup 48
5.5 Changing the database backup location 49
5.6 Recovering from a program drive or raw data share failure 51
5.6.1 Recovering from an Empower software raw data drive failure 51
5.6.2 Recovering from an Empower program files disk failure 53
5.7 Restoring the database 54
5.7.1 Copying incremental database backup files 55
5.7.2 Restoring the database 56
6 Troubleshooting 59
6.1 Additional help 59
6.2 Isolating problems 59
6.3 Reporting problems 60
6.4 Buffering and data recovery problems 61
6.4.1 Reconnecting while buffering 61
6.4.2 Continuing acquisition while buffering 62
6.5 Disconnect dead connections 62
6.6 Software problems 63
6.6.1 ACQUITY UPLC problems 65
6.7 Hardware problems 66
A Log forms 71
A.1 Database initialization parameters 71
A.2 Database storage information (Control files) 72
A.3 Database storage information (Tablespace) 72
A.4 Data file information 72
A.5 Data file information (Redo_logs) 73
A.6 Disk space usage log 73
A.7 Database backup log 74
A.8 Full disk backup log 75
A.9 System service log 75
A.10 System problem log 76
A.11 Hardware service information sheet 77
A.12 Software service information sheet 77
This guide describes the hardware and software requirements, system administrative
tasks, and security settings and policies for the server.
For information on how to back up and restore the Empower 3 FR4 database on an
Empower Personal system, refer to "Backing up the Empower Personal database" and
"Restoring the Empower Personal database" topics in the Empower Online Help.
l A central database on the server
l Distributed acquisition
l Distributed processing
You can use an Empower Personal workstation as a client in a workgroup or enterprise
environment.
Component
Empower server that contains the Empower database and raw data files (Waters
Service)
Alternate raw data storage that contains raw data files (Waters Service)
UPLC
Chromatographic system
LAC/E32 acquisition server that contains Waters Service and instrument server process
Empower client that contains Empower program files
l Operating system
l Microsoft® Windows® Server 2008 R2 Service Pack 1 (SP1) 64-bit, Enterprise
or Standard Editions or Windows Server 2012 R2 64-bit Standard Edition
l Solaris 10
l RedHat Enterprise Linux 6.8
l Oracle® Enterprise Edition
l Version 12c for Windows
l Version 12c for Solaris and RedHat
l Empower 3 FR4 Enterprise or Workgroup software
The Windows Server operating systems provide built-in networking utilities, protocol
handlers, and services including basic file and print services and client/server
application functionality.
The Empower 3 relational database resides on the server in an Empower 3 Enterprise
client/server system or an Empower 3 Workgroup configuration. Information from
projects, such as processed results, sample identifiers, and methods, is stored in the
Empower 3 database. The raw data files are not stored in the database. The raw data
files are stored on the same server disk drive or on a different one.
Oracle client software provides the Empower 3 FR4 application running on the client
computer with access to the Empower 3 database.
l Windows 7 SP1, 64-bit Enterprise or Professional Edition, or Windows 10 64-bit,
Enterprise or Professional Edition
l Empower 3 FR4 Enterprise or Empower 3 FR4 Workgroup client software
l Oracle Client Software version 12.1.0.2
l Internet Explorer® version 10 or 11
l Raw data files on the server or other computer on the network
l Network printers
l Empower 3 FR4 clients and LAC/E32 acquisition servers
See also: Refer to the release notes for your LAC/E32 acquisition server to determine
which operating system is supported.
Empower 3 FR4 software allows you to acquire data and control chromatographic
instrumentation, process data interactively or in the background, customize
management of project information, and customize report design and generation.
Oracle client software provides Empower 3 FR4 software with access to the Empower
database through TCP/IP.
To effectively administer the Empower 3 FR4 system, administrators must be familiar
with the operation of the hardware and software listed in the following tables.
Hardware:
Hardware Reference
Server computer Server documentation
and peripherals
Waters LAC/E32 Empower 3 Installation, Configuration and Upgrade Guide (latest
Acquisition version)
Server
Empower 3 FR4 Empower 3 Installation, Configuration and Upgrade Guide (latest
clients version) and the Empower 3 Feature Release 4 online Help
PCs and printers PC and printer manufacturer’s documentation
Software Reference
Empower 3 FR4 software Empower 3 Installation, Configuration
and Upgrade Guide (latest version) and
the Empower 3 Feature Release 4 online
Help
Windows 7 SP1 or 10, Professional or Microsoft Windows documentation
Enterprise Edition, 64-bit
Windows Server 2008 R2 Standard or Microsoft Windows documentation
Enterprise with Service Pack 1, 64-bit or
Windows Server 2012 R2 Standard
Edition 64-bit
Oracle 12c Oracle 12c Server online documentation
Microsoft TCP/IP Microsoft Windows Help
l Empower 3 FR4 Online Help
l Empower 3 FR4 Configuration Manager
l Windows Server 2008 R2 Standard or Enterprise with Service Pack 1, 64-bit;
Windows 7 SP1 or 10 Professional or Enterprise Edition, 64-bit Operating
System, Help Systems and Utilities; Windows Server 2012 R2 Standard Edition,
64-bit System and Utilities.
l Waters Database Manager
See also: "Waters database manager" on page 23
Periodic system administration tasks apply to both the server and the client.
In domains based on Windows Server 2008 R2 Enterprise and Windows Server 2012
R2, the domain controllers are automatically configured to act as time servers for the
domain.
To maximize service time and minimize issues related to the network environment,
Waters recommends you follow these requirements:
l All Empower-related user accounts and computers must reside within the same
domain.
l If you are using real-time virus scanning, after installation, exclude all
Empower-related directories and their sub-directories, and all raw data
directories or shares, from the scans. Some real-time virus scanners mistake
normal Empower operations for virus activity and can therefore interfere with
data buffering or cause the run to stop.
l After you install Empower software, do not change the host name on the
Enterprise server or the Personal workstation. The host name should not contain
more than 15 characters, dashes, or symbols. A static IP address is
recommended for Empower servers. If you are using DHCP instead of a static IP,
ensure that the host name remains the same.
Requirement: The server name must begin with an alphabetic character (A to
Z) and cannot begin with a numeric character (0 to 9). Empower123 is acceptable
for a server name, but not 123Empower. The server name should not contain
dashes or symbols.
l Configure preferences in Waters Database Manager to notify you by email when
tablespaces reach a user-defined size. Doing so helps you monitor database
space usage. See the Waters Database Manager Online Help or ""Adding
tablespace datafiles to the database" on page 32" in this document for more
information.
See also: "Waters database manager" on page 23
l When you add a server, LAC/E32 module, or client to a domain, ensure that the
Window’s network discovery functionality is turned on for these computers.
Refer to the Empower 3 Installation, Configuration, and Upgrade Guide.
l Place Empower nodes in their own Organization Unit (OU). For the OU, define
GPOs that minimize allowable changes: for example, test Microsoft hot fixes and
service packs before applying them to the environment.
l Grant administrators full access to the registry and file system so that they can
properly install software.
l Limit changes to the file system protections expected by the Empower
application.
GPOs can interfere with successful Empower operations. For example, data buffering
can occur if the anonymous access to the raw data share is altered, or the editors for
the COM instruments can sometimes operate improperly if the access control list for
the HTML directories is altered.
These accounts permit access to the Windows operating system:
l Administrator accounts (local or domain)
l User accounts (local or domain)
Use an administrator account to log in to the Empower 3 FR4 Enterprise/Workgroup
server when you need to perform system administration tasks.
l all public, personal, and system files and directories.
l Empower 3 FR4 database files.
l Empower 3 FR4 raw data files.
l all Windows Server 2008 R2 or Windows Server 2012 R2 user accounts and
account information on the local machine.
For more information on Windows Server 2008 R2 or Windows Server 2012 R2 server
privileges, see the Microsoft Windows Help and user documentation.
l Checking the amount of free disk space
l Increasing free disk space
l Defragmenting the hard disk
l Configuring email notifications in Waters Database Manager
Use the following procedure to check the amount of free disk space on the server. In a
standard configuration, disk space on the server is used mainly by raw data acquired
with Empower 3 FR4 software. The size of raw data files created in Empower 3 FR4
software is related to the sampling rate and the run time used to collect data. The
database size also expands with usage. For instance, the archived redo logs generated
by database activity grow over time, until they are cleaned up during database
backups.
In Empower 3 FR4 software, you can define multiple raw data paths. Before doing so,
check disk space on each drive where raw data files will be stored.
See also: Managing raw data files for more information.
Requirement: To avoid degradation in system performance, system administrators
must check available disk space regularly. On systems with heavy daily usage, check
and record available disk space frequently. If your system is used less frequently,
check and record disk space accordingly.
Tip: There are also utilities available to monitor and alarm or send an e-mail when
disk space reaches a user-defined size.
l Archiving projects
l Adding a hard disk
l Moving project raw data to another file share, on a separate drive or server
Waters offers several automated archive options for Empower 3 FR4 software. For
more information, contact your local subsidiary or see www.Waters.com.
See also: Managing raw data files for more information.
Recommendation: Exclude the drives that host the database data files.
If you defragment the drives that host the Empower Program files, the
defragmentation process does not affect database operations.
l On Empower systems running on Windows Server 2008 R2 SP1, click Start, type
"Disk Defragmenter" in the Search box, then select it from the search results.
l On Empower systems running on Windows Server 2012, from Start, click Server
Manager > Tools > Defragment and Optimize Drives.
For information on using the Disk Defragmenter utility, see the operating system Help.
Service Definition
WatersService A process, deployed as a Windows service, designed to
host generic services like WCF services and Waters
Internal services
Waters Database Required services for the Waters Database Manager.
Manager Listener RESTful listener facilitates communication with APEX for
the Waters Database Manager application
OracleServiceWATn Required services for the database instance
OracleEmpowerOracle12c Required services for the database
TNSListener
OracleJobSchedulerWATn Required services for the database
OracleVssWriterWATn Required services for the database
To stop a service:
1. Click Server Manager.
2. In the Server Manager window, click Local Server.
3. In the list of services, scroll down to the service that you want to stop.
4. Right-click the service name.
5. Click Stop Services.
To start a service:
1. Click Server Manager.
2. In the Server Manager window, click Local Server.
3. In the list of services, scroll down to the service that you want to stop.
4. Right-click the service name.
5. Click Restart Services.
These are the management tasks covered in this chapter:
l Waters Database Manager
l Starting and exiting Waters Database Manager
l Database file organization
l Configuring the Windows DBA account
l Manage Database User Accounts
l Record database information
l Adding tablespace datafiles to the database
l Archiving alert logs
l Shutting down and starting up the Empower 3 FR4 database
Notice: To avoid compromising the functionality of Empower 3 FR4 software,
requiring its revalidation, do not perform additional database tuning. Contact
your Waters data specialist before implementing any database changes.
Tip: The default login user name\password is "administrator\administrator".
You can log on to WDM using these browsers:
l Internet Explorer® 11 or later without Compatibility mode
l Google Chrome™ 35 or later
Recommendation: Google Chrome 35 or later
Result: The dashboard appears, providing several options for managing the database.
The maximum idle time for a session is 10 minutes. You can, however, log on to the
Waters Database Manager application as often as necessary. To view default settings,
click Server > Profiles.
l Tablespaces exceed the specified threshold.
l Alert and listener logs grow excessively large.
l Oracle errors are found in the log file.
Requirement: After software installation, you must configure alerts and then click
Apply. By default, customized alerts are not enabled.
You can customize alerts and thresholds. Alerts identify problematic situations that
require your attention. Thresholds define the criteria that determine when an alert
issues. For example, you can specify that the software alerts you by sending an email
when the listener log grows too large or if the tablespace is 95% full.
When the specified threshold is exceeded or a scheduled database backup fails, an
email notification is sent to administrative users whose user accounts are configured
to receive notifications. In the case of database backup failures, you do not need to
configure a threshold because the software automatically sends a notification to users
whose accounts are configured to receive notifications. You can log into Empower 3
FR4, and view the job log to determine the cause of the failure.
From the Configure Notifications page, perform these tasks, and then click Apply for
each area.
Notifications:
Field Definition
Tablespace Sizes Specify the percent to which the tablespace is filled before a
notification issues.
Specify the frequency (in hours) to check the tablespace size.
Alert and Listener Log Specify the alert and listener size, in megabytes, before a
Sizes notification issues.
Specify the frequency (in hours) to check the alert and listener
log sizes.
You can also configure Empower 3 FR4 to ignore specific Oracle errors.
After you configure the alerts, you must perform these tasks:
l Configure SMTP server and port settings
l Enable notifications for the users that you want to receive the alerts.
To receive notifications, you must specify SMTP server settings and a port number for
the server that handles email sent from Waters Database Manager.
2. From the Application Users page, select a user account, and then click Edit .
3. From the Application User page, perform these tasks, and then click Apply
Changes:
l In the E-Mail Address field, type a valid email address for the user account.
l In the Notifications field, select Yes.
l Empower 3 FR4 application program files
l Empower 3 FR4 database data files
l Empower 3 FR4 projects including raw data files
l Empower 3 FR4 Oracle database files
Tip: The location of your Empower 3 FR4 database files depends on the locations you
selected when you installed the database.
For detailed information on the Oracle database files, see the latest version of the
Empower 3 Installation, Configuration, and Upgrade Guide.
The Empower 3 FR4 database files are organized by default as shown in the following
table. The specified locations assume a standard installation of Empower Enterprise to
the recommended locations on a server with four physical drives. Replace all
occurrences of WATn in the table with your SID. The default SID is WAT12.
Drives Files
[install-drive]\ Empower\Bin The Empower software executable files.
[install-drive]\ Empower\Script The Empower 3 FR4 software scripts, including
the hot and cold backup script files.
[install-drive] Set of mirrored archive logs used for database
\WatersCDSArchive2DB recovery.
[install-drive] Control0n.ctl – Mirrored copies of the database
\WatersCDSMirrorDB\oradata\WAT control files (where n equals 2 to 3).
n Redo2n.rdo – Mirrored copies of the redo logs
(where n equals 1 to 4).
Drives Files
rawdata-drive:\ This directory is the default raw data location. It contains a
Empower\Projects subdirectory for each project in the database.
Tip: The project folder names viewed in this directory do not
always exactly match the project names displayed in
Configuration Manager when projects are part of a project
hierarchy or when projects have been renamed.
[rawdata-drive] Set of mirrored archive logs used for database recovery.
\WatersCDSArchive1DB
[Oracle drive] is the drive where you have installed the Oracle software.
Drives Files
[Oracle drive]:\Empower\Oracle\diag The Oracle alert log, which contains
\rdbms\WATn\WATn\Trace information regarding database activity.
[Oracle drive]:\Empower\Oracle\ The Oracle software executable files.
Oracle12c_4\Bin
[Oracle drive]:\Empower\Oracle\ pwdWAT12.ora file – The Oracle (not
Oracle12c_4\Database Empower) password.
SPFILEWAT12.ora – The server parameter
file.
Restriction: Do not edit the password or
SPFILEWAT12.ora file.
Drives Files
database-drive:\ INDEX0n.DBF – The index tablespace data files
EmpowerDatabase\oradata\WATn (where n is 1 to 9).
TEMP01.DBF – The temporary tablespace data
file.
SYSTEM01.DBF – The system tablespace data
file.
UndoTBS01.DBF – The undo tablespace data
file.
SYSAUX01.DBF – The sys aux tablespace data
file.
USERS0n.DBF – The user tablespace data files
(where n is 1 to 9).
CONTROL01.CTL – One copy of the database
control file.
REDO0N.rdo – The redo logs (where n is 1 to 4).
database- Backup jobs, raw data files scripts
drive\Empower\tmp\scripts
database- Database backup and raw data backup logs
drive:\Empower\tmp\scripts\logs
Requirement: To select a domain user or group, you must have access to the
domain administrator username/password. If you want to select a user account
on the local server, click Cancel when prompted for domain credentials, and then
select the database server name from the Locations dialog box.
l In the Select Users, Computer, Service Accounts or Groups dialog box, enter
the name for the user or group whose credentials will be used for database
management functions, and then click OK.
You can shut down the database by either stopping the Oracle service
(OracleServiceWATn) or stopping the Listener service
(OracleEmpowerOracle12cTNSListener).
Before stopping the Oracle service, use System Monitor to confirm that no users are
currently connected to the Empower 3 FR4 database. To start System Monitor, log in to
Requirement: When you are finished maintaining the database or server, you
must reset the Startup Type of the OracleServiceWATn to Automatic.
Recommendation: Reset user account passwords for the Oracle database after you
install Waters software and periodically thereafter, according to your organization's
security policies and standard operating procedures.
You can manage Oracle database user accounts by locking and unlocking them and
resetting users' passwords.
When you install Empower software, an operating system (OS) user account,
OracleJobs, is automatically created. This account provides operating system
credentials to run scheduled jobs, such as backing up the database and running
database scripts for the Waters Database Manager (WDM) application. The default
password for this user account is !oracle1 (this password conforms to Oracle's
requirement for password complexity). It is recommended that the password for this
OS user account never expires (User Properties dialog box, select the "Password never
expires" check box), however check with your information technology organization
before making this change. If you change the password for this account in the OS, you
2. From the Users page, select a user account, and click Edit .
3. From the Manage User page, click Lock User.
Result: The database user cannot use this account until it is unlocked.
2. From the Users page, select a user account, and click Edit .
3. From the Manage User page, click Unlock User.
Result: The database user can use this account.
Recommendation: Change the Oracle user passwords after you install the software
and periodically according to your organization's security policies and standard
operating procedures.
Requirement: When you change the Oracle Sys account password, you must also
change the password for DBM user account and assign it the same password as the
Oracle Sys account, in the Manage Application Configuration page.
2. From the Users page, select a user account, and click Edit .
3. From the Manage User page, do as follows, and then click Re-set Password.
l In the Password field, type a new password for the account.
l In the Re-enter Password field, retype the password, and then click Reset.
Parameter column, and then click Edit .
3. From the Configuration Parameter page, type the new Sys password in the
Password field, type it again in the Confirm Password field, and then click Apply
Changes.
As soon as your database is built, record the following information:
l Unique database name
l Database ID
Recommendation: Contact Waters Technical Support for assistance before adjusting
datafile storage.
the Adjust Storage Settings icon in the first column.
4. In the Adjust datafile storage settings page, change the storage settings as
follows:
l In the Increment By field, enter the number of megabytes that the storage
space will be increased when the datafile reaches its initial limit.
l In the Maximum Size field, enter a number in megabytes to specify the
maximum size of the datafile.
5. Click apply.
To archive the alert log, move it from Oracle-
drive:\Empower\Oracle\diag\rdbms\WATn\WATn\Trace to your storage location.
Tip: Once you move the alert log, a new one is recreated automatically.
Exception: If network connectivity fails while a LAC/E32 acquisition server is acquiring
data, you must use a local tnsnames file, and then upload the sample set data to
recover the interrupted data.
Recommendation: Locate the shared tnsnames.ora file in the \Empower\Projects
directory, because that folder is shared with the appropriate security settings applied
and must be available for normal Empower 3 FR4 software functionality.
Requirement: If you have multiple Empower 3 FR4 Database servers, add them
to the tnsnames.ora file using the Waters Net Configuration Assistant prior to
copying the tnsnames.ora file. For information about using the Waters Net
Configuration Assistant, see the latest version of the Empower 3 Installation,
Configuration, and Upgrade Guide.
3. Browse to the raw data drive:\Empower\Projects directory, and paste the
tnsnames.ora file into the folder.
Recommendation: Place the share in the same directory that will hold
Empower 3 FR4 raw data. If you use custom directories, set the share
permissions exactly as described in the latest version of the Empower 3
Installation, Configuration, and Upgrade Guide.
Tip: The TNS_ADMIN variable is set during installation, and a tnsnames.ora file is
created. The TNS_ADMIN variable points to the tnsnames.ora file. A tnsnames.ora file
contains the list of Empower databases that can be accessed by the client or LAC/E32
module.
Use the following procedure to create a new database net service name, or modify an
existing net service name. If you are using an Empower Personal as a client, perform
this procedure to force the use of the TNSNames.ora file. You must define the same
database net service name on each client or LAC/E32 module.
Tip: The username and password are not case sensitive.
3. Select the net service name (database alias) for your Empower 3 FR4 server.
4. Click Advanced and verify that the Requested Interface field is set to Pro.
Requirement: If you do not have access to the Pro interface, you must log in
with a different user account or modify the user properties of the current user
account. See the Empower 3 FR4 online Help for more information.
5. Click OK.
Result: The Empower Pro window appears with the name of the database and
the logged-in user displayed.
Notice: If you are logged in to Empower 3 FR4 software and then you
log out and leave some of its applications running (such as
Configuration Manager), a Running Empower Applications message
box appears. This message box reminds you that the applications
remain open and offers the option of leaving them in a locked or
unlocked state. If you leave them in an unlocked state, a user without
the required access privileges can log in and use the open applications
as if he or she were you, assuming your access privileges, regardless
of whether his or her user type grants those privileges.
When performing administrative tasks on a client, use the Empower 3 FR4 Pro
interface.
Requirement: You must be logged in as an Administrator to perform this procedure.
Recommendations:
l If your organization’s policy requires you to change this password, be certain to
change it properly from the Configuration Manager window.
l If you change the database password, restart all Empower nodes.
Restriction: Do not change this password directly in Oracle. Follow the procedure
below exactly as it is written.
Tip: To add a file service, click Add File Service, enter the node name for the
new file service, and then click OK.
3. Click Add Raw Data Share.
4. In the Add Raw Data Share dialog box, enter the share name and click OK.
Result: If the share does not already exist, a dialog box appears, allowing you to
specify the directory path for the share.
When the share is created, the default permissions are applied. The permissions vary
depending on operating systems. To ensure proper functionality and security, the
permissions on the raw data folder must be set exactly as described in the latest
version of the Empower 3 Installation, Configuration, and Upgrade Guide.
When creating a new project, you can specify the raw data path in the Name Entry
page of the New Project Wizard. You can also move existing project data to a different
raw data share. The three Empower 3 FR4 software privileges associated with this
capability are Create Project Path, Specify Project Path, and Change Project Path.
Users must have the appropriate privilege to use the different aspects of this feature.
Exception: If a raw data path that is being used by a project(s) is removed, the path
no longer appears on the list in the Manage Raw Data Files dialog box; however, the
project’s existing and newly acquired data continue to use the removed raw data path.
Tip: Ensure that the Name column is the first one in the list.
5. Save the view filter, and then exit the View Filter Editor.
Result: The Directory box displays the current raw data paths for projects.
l Users
l Systems
l Projects
l Processing
System Monitor also displays the total number of licenses used compared to the total
number of licenses available, by license type. The different license types are User
Licenses, System Licenses, Agilent LC Licenses, Agilent GC Licenses, Shimadzu LC
Licenses, Shimadzu GC Licenses, and Hitachi LC Licenses.
Tip: For each license type, the total number of available licenses is the total number of
licenses that are activated minus the total number of licenses used.
To access System Monitor, select View > System Monitor from the Configuration
Manager window.
For more information on System Monitor, see the Empower 3 FR4 online Help.
Tip: You can find the Empower software build number and determine which service
and feature releases are installed by clicking Help > About in any Empower software
window.
l Configuring corporate backup solutions, such as Veritas® , to access the contents
of the database backup location.
l Create a task using Windows' Scheduler to copy the contents of the database
backup folders.
l Move the database and raw data files off of the server and onto other media
quickly. Follow your company's standard for archival of data.
l Do not store database backups in the same location as the database files. If the
physical drive becomes corrupted, you can lose both sets of files. If you store
backup files in a location other than the one used for the original files, the
backup files will be unaffected.
Tip: In Empower 3 FR4 software, the CS_Hot_Gen.bat and CS_Cold_Gen.bat database
scripts were deprecated; however, these scripts are included in the <program-
drive>:\Empower Script directory for backward compatibility. The supported database
backup mechanism for Empower 3 FR4 is RMAN backups, which are configured using
the Waters Database Manager application.
When you install Empower 3 FR4 software on a server, daily online RMAN database
backups are automatically enabled and scheduled to run as a scheduled task. After you
install the software, a full RMAN database backup runs once immediately. A full online
backup runs every Monday morning at 2:59 a.m. Incremental backups run Tuesday
through Sunday at 3:00 a.m. You can modify the time, disable the scheduled backup,
and modify other backup settings in the Waters Database Manager application. If the
database backups ran successfully and are available, you can recover your database to
the point in time of the last database backup.
See also:"Scheduling database backups" on page 45
Notice: If you do not configure the scheduled database backups to include
backing up your project raw data files (both the meta data which resides in
the database and the project raw data files), you could lose your data in the
event of a disaster.
See also: "Manage backup settings" on page 46
Level 1 incremental backups include a weekly full database backup and daily
incremental backups with the Archive log mode active. During database backups, the
database is online and available for use (users can log on to the software, and they can
acquire data).
A database backup generates a time-stamped log file that includes details about
individual steps of the backup process.
See also: "Viewing database backup" on page 48
By default, the backup retention policy is set to "Redundancy equals 1", which means
one full backup set (full backup and incremental backups) is kept in the FRA. Archive
logs are removed when a new backup is made. When a new, full database backup
(level-0) runs, previous backups older than one week are removed from the database
backup location.
The database is backed up using backup jobs that are automatically created when you
install or upgrade Empower software on a server and run in Waters Database Manager.
You can restore the database by using scripts stored in this location: [Oracle
drive]:\Empower\Oracle\BackupRecoveryScripts folder. When you restore the
database, you must be able to access the backed up Oracle database files and the
backed up project raw data files.
The database backup process typically compresses a database, reducing its size by 50
percent.
l Periodically test your backup media sets to ensure that the backups are working
correctly and according to your organization’s standard protocols for failure
recovery.
l Create a test server with the same configuration as your actual server. Verify
your backups by restoring them on the test server.
Empower software installs three backup schedules by default on a server.
Backup Description
Schedule
First full, level 0 Full database backup that runs once immediately, after software
installation.
Full, level 0 Full database backup that runs once a week.
Increment, level Incremental backup (as opposed to a full backup) that runs once
1 daily.
You can schedule a new database backup. Database backups enable you to recover
your data in the event of a complete system failure. To create a new scheduled
backup, see Waters Database Manager Help.
Recommendation: Before you schedule a new backup, consult with a Waters data
specialist.
You can modify, disable, enable, or delete a scheduled backup. When a scheduled
database backup is no longer needed, you can delete it. If you delete a scheduled
database backup and later need to use it again, you must recreate it.
Recommendation: Waters recommends that you do not delete or disable the
scheduled backups during software installation or an upgrade. I f you do so, ensure that
you have an alternate backup strategy in place.
you want to disable and then click Edit .
3. Click Disable.
you want to enable and then click Edit Definition .
3. Click Enable and then click Apply Changes.
You can manage the backup settings by configuring disk settings and the backup
policy. You can change the location of database backup by changing both the Disk
Backup Location and the Control File location. When you do so, these settings affect all
future backup jobs.
Requirement: If you want to back up your project raw data files, you must select the
"Backup Empower Raw Data Shares" check box and then specify the location where the
raw data files will be backed up. If you do not select this method to backup your raw
data files, use an alternative method to back them up.
l Parallelism
l Change the location of the database backup
l Backup Empower Raw Data Shares
l Change the location of the raw data backup
Requirement: If you selected the "Backup Empower Raw Data Shares" check
box, type the location where the raw data files will be backed up automatically
when scheduled backups are run. The raw data file backup location must be a
local drive (local to the database server) and path name cannot contain spaces.
Policy
Backup Policy
Autobackup Automatically backs up the control files.
Control file The location where you want to back up the control file. You must be
location able to access the control file to restore the database in the event of
disaster recovery.
Requirement: The control file location must be the same as the
Disk Backup Location field.
Optimize Optimizes database backup by copying only those files that have
changed.
Tablespaces When the database is backed up, you can specify the tablespaces
Excluded from that you want to exclude from the backup.
Whole Database You can select one, all, or none of the tablespaces.
Backup
If you are also backing up the raw data files, review the "PostBackupCmd-
<date/time>" log file which is located in the "<database
drive>:\Empower\tmp\scripts\logs" directory and ensure there are no errors.
Review the results of a database backup and log files regularly.
file .
Result: The Backup Run Details page lists the results of the scheduled database
backups that ran.
l The new location to store your database backups must exist. Ensure this location
can accommodate the number of copies of the database backups that you want
Recommendation: After changing the locations of the database backups and
control files, verify that the location of the database backup files and control files
were changed to the new location.
To verify that the location of the database backup files and control files
were changed:
1. Log on to the Waters Database Manager application.
2. From the Dashboard, click Manage Backups. and then View Backup Settings.
When you change the location of the database backups, the datafiles are backed up to
the new location. The database backup files that were stored in the previous location
remain in that location. They are not moved to the new location, and they are not
deleted from the previous location.
Recommendation: Run a full backup by enabling the First Full Level 0 backup job.
When you do so, all previous full and incremental backups are deleted, and a new, full
database backup is created in the new location. This creates a new backup set. The full
backup and the incremental backups that are run subsequently can be used as a set to
restore your database back to the point of the last incremental backup.
See also: "Scheduling database backups" on page 45
When the full backup job ends, verify that the backup files (.bkp) and the control files
(files that begin with the letter "C") reside in the new location. View the backup log for
error messages.
See also: "Viewing database backup" on page 48
If you changed the location of the database backups and the control file and want to
recover the database, you must enter the location of the backup files and control files
that must be restored in the recovery script. However, if you are recovering the
See also: "Restoring the database" on page 54
Specifically, this section describes how to recover from these scenarios:
l an Empower raw data drive failure
l an Empower program files disk failure
Tip: The recovery procedures described in this section assume that the Empower
server is configured exactly as described (the application configured on four separate
physical drives and partitions) in the Empower 3 Installation, Configuration, and
Upgrade Guide. If your server is configured differently, you will need the raw data file
backup and the backup of the program drive, or the Empower application media. If you
have performed a custom installation, you must modify the recovery procedures as
needed. For example, the default SID name is WAT12. If you selected a SID name
other than WAT12, supply your SID in the space designated by WATn in this procedure.
Because chromatographic files produced between the last backup and the time of a
disk failure are not recoverable, you cannot review or otherwise use chromatograms
acquired or their results during that time period; however, all methods created or
edited, sample loading information, and results generated since the last backup are
available.
l Log in to the operating system as the administrator.
l If the database is running, shut it down as described in “Shutting down and
starting up the Empower 3 FR4 database”.
rawdatadrive:\Empower\Projects.
Tip: Your configuration may consist of multiple shares with raw data.
3. Share the Projects directory with the share name Waters_Projects$ and set the
appropriate level of security as described in the Empower 3 Installation,
Configuration, and Upgrade Guide.
4. From the database drive:\EmpowerDatabase\oradata\WATn directory, copy
Control01 to the rawdata drive:\WatersCDSMirrorDB\oradata\WATn.
5. In the rawdata drive:\WatersCDSMirrorDB\oradata\WATn directory, rename
Control01.CTL to Control02.CTL.
6. From the database drive:\EmpowerDatabase\oradata\WATn directory, copy
Control01 to the rawdata drive:\WatersCDSMirrorDB\oradata\WATn.
7. In the rawdata drive:\WatersCDSMirrorDB\oradata\WATn directory, rename
Control01.CTL to Control03.CTL.
8. From the databasedrive:\EmpowerDatabase\oradata\WATn directory, copy
REDO0n log files (where n is 1 to 4) to the rawdata
drive:\WatersCDSMirrorDB\oradata\WATn.
9. In the rawdata drive:\WatersCDSMirrorDB\oradata\WATn directory, rename
REDO0n.RDO log files to REDO2n.RDO (where n is 1 to 4).
10. Create the archive log directory rawdata drive:
\WatersCDSArchive1DB.
11. From the program-drive:\WatersCDSArchive2DB directory, copy all contents of
the directory to rawdata drive:\WatersCDSArchive1DB.
12. Restart your database by stopping and then starting OracleServiceWATn or
restart the server.
13. You may need to restore the database also. If you need to do so, follow the
procedures outlined in the "Restore the database" section of this guide.
Tip: This procedure assumes a single raw data drive or share. Empower software
supports multiple raw data shares.
Tip: Empower software and Oracle can both occupy the same program disk, but can
also exist on separate program disks.
In the case of partial disk failure (such as bad data sectors), where all archive (*.arc)
files can be saved from the disk, back up the database drive immediately. You can
then copy the archive files to a tape or network drive before the disk is repaired. This
allows restoration of the database to the state at the time of failure.
Recommendation: Back up all other drives, in case any files are inadvertently
deleted or overwritten. Ensure that the target directories have sufficient disk space to
copy the files.
In the event of the loss of your server, you can restore the database by running the
Restore_Full_DatabaseEmp.bat script which is located in the [Oracle
drive]:\Empower\Oracle\BackupRecoveryScripts folder. The restoration process
replaces all data files, control files, and tablespaces from the most recent backup. I t
does not restore changes made after the last backup. Any changes made since the last
backup are lost.
After you restore the database, you must restore your project raw data files. If you
specified that you wanted to back up your project raw data files in Waters Database
Manager (Backup and Recovery > Backup Settings > Disk Settings), you can restore
them using a batch file. You must also specify where the project's raw data files are
stored in the WDM application.
Important: The computer name and IP address must remain the same for the
database restoration process to work correctly. If you are replacing a server with a
new computer, you cannot restore the database on a server that has a different
computer name and IP address.
Requirement: The path indicating the location of the folder to which you copy
database backups must not contain spaces in the path name.
When you run this script, you must provide the information listed in the Restore Full
DatabaseEmp.bat parameters table. Upon completion, this script restores the latest
full database backup, and the incremental backups.
Parameter Description
Location Location where full and incremental backups are copied.
where all Example: F:\All_backups
backups are
copied
Latest Location of the latest control file.
control file Example: F:\All_backups\C-2839594718-20160906-0B
name with
Tip: Control files are copied to the file system FRA backup location
full name
along with backup files under a date-and-time-stamped folder.
Database ID The database ID.
Tip: The control file also contains the database ID number.
Example: C-2839594718-20160906-0B, the database ID is the first
digits after C- (2839594718).
Disaster If your server is inoperable, you must install Empower 3 software on
recovery: new hardware following the procedures outlined in the Empower 3
true or false Installation and Configuration Guide, and then restore the database. In
this case, disaster recovery is true. When you restore the database for
all other situations, disaster recovery is false.
Sys user The password for the Oracle Sys user account.
password
Before you restore the database, perform these tasks:
l Copy the control file to the FULL_backup folder.
l Identify the database ID.
l Identify Sys user account password.
l Ensure the database is started.
l Identify the location of the RAW data backups (for disaster recovery situations
only).
l Identify the recover_DF.BAT script is within Raw data backups\Backupscript
folder.
l In the case of disaster recovery, recreate the file shares.
Tip: You can copy both the full and incremental backup files to the same folder, or you
can copy the backup files in their original folders, keeping the original folder structure
intact.
Example: C-43843433-201507-06, where C is control file, 43843433 is the database
ID, and 201507-06 is the date.
Example: Restore_Full_DatabaseEmp.bat F:\All_backups F:\All_backups\C-
2839594718-20160906-0B 2839594718 true <syspassword>.
2. When the restoration process ends, close the Command Prompt dialog box when
the prompt appears.
3. Restart Waters services on the server.
Tip: When the database base is recovered, Waters services are started on the
server.
4. Review the restore log for any Oracle or RMAN errors, which is located in this
directory: <Database drive>:\Empower\tmp\scripts\logs folder.
Tip: Some of the ORA- and RMAN errors are expected; error numbers are noted
at the end of the log file.
5. After disaster recovery, you must perform these tasks:
l Create a folder with the same name as the raw data backup folder.
l Copy the Raw data files mimicking the <your backup
location> projects\<share name> folder structure.
l Open an Administrator's Command prompt, and from the <your backup
location> projects\backupsripts folder run the recover_DF.bat script.
Example: F:\RAWDataBackup\projects\<share name>\<Empower projects>
Result: The database and the project's raw data files are restored to their
original location.
6. When recovery is complete and before you run any new backup jobs, delete all
files from the \<Rawdata backup>\Backupscript folder.
Requirement: Delete these files prior to running any new backup jobs. If you
fail to do so, the next time a run backup job is run, it will not backup any new
Raw data files.
7. Log in to Empower and ensure all projects are present.
8. Verify that all Raw data files are present in the Raw data share location.
9. Log in to Waters Database Manager and ensure that the first full level 0 database
backup job is enabled.
For complete information on reporting shipping damages and submitting claims, see
Waters Licenses, Warranties, and Support Services on the Empower 3 FR4 on the
Waters web site.
l Empower 3 Feature Release 4 online Help
l Windows Help
l Hardware documentation shipped with your system hardware
l Operator’s guides for detectors, pumps, autosamplers, and other components of
the chromatography system
l Empower 3 Feature Release 4 Release Notes
l www.Waters.com
l Waters Technical Service
If the corrective actions suggested here fail to correct a problem, consult “Reporting
problems” and then contact Waters for assistance.
Customers in the USA and Canada can report the problems to Waters Technical Service
(800 252-4752). Others can phone their local Waters subsidiary or Waters corporate
headquarters in Milford, Massachusetts (USA), or visit www.waters.com.
Keep in mind the following recommendations when attempting to isolate a problem:
l Develop a systematic troubleshooting strategy.
l Check simple things first, such as cable connections and privileges.
l Try to reproduce a symptom and note all steps leading up to the problem.
Record all system problems and troubleshooting activities in the System Problem Log.
When you contact Waters, be ready to offer the following information:
l Software support plan number
l A description of the symptoms
l An accurate assessment of the problem’s severity; for example, system down,
server down, PC down, PC client not connecting to server, printer printing
unusual characters, or occasional malfunction
l When the problem started; whether it is reproducible, intermittent, or constant;
and whether it is data-related or account-related
l The specific sequence of events leading to the problem
l Whether the system has been recently modified, new hardware or software has
been installed, or maintenance has been performed
l Actions you took to correct the problem
l Version information for:
l Empower 3 FR4 software (obtain the build number and any service or feature
releases from any Help > About dialog box)
l Windows operating system software (use the System applet in Control Panel
for the software version)
l Waters HPLC devices and instruments (see the Empower 3 FR4 installation
log —C:\Windows\Empower.log — or use the Verify Files utility to obtain
ICS/ICF Software Driver versions; see Node Export to text for firmware
versions)
l Basic configurations and serial numbers of the hardware components involved
l Hard-copy examples of printouts
l User manuals for the components
l Swap cables, if you have not already tested cables
l E-mail or fax hard-copy documentation of the problem
Recommendation: Be sure to call from a location that is close to the system in
question. Your Waters Technical Support representative can help you more effectively
if you have access to the system while you are on the telephone.
Tip: Database information (sample identifiers, method information, results, and so on)
is stored in the Empower 3 FR4 database on the Empower 3 FR4 server. By default,
chromatographic raw data are stored in the rawdata-drive:\Empower\Projects
directory on the Empower 3 FR4 server.
You can change the location of raw data using the Manage Raw Data Files capability to
another computer as long as the Waters Service is present. Hence, data are buffered
when the Empower 3 FR4 database or the computer storing the project raw data
(\\servername\Waters_Projects$, by default) is not available on the network for any
reason.
See also: Managing raw data files
l If the acquisition server reconnects, then the buffered injection(s) data is copied
over the network to the appropriate location(s). The software then deletes the
raw data files on the acquisition server’s hard drive, buffering stops, and normal
acquisition continues.
The appropriate network connection(s) must be intact before you can acquire a sample
set. Immediately after acquisition of a sample set begins, the Empower 3 FR4 software
downloads all methods required to complete data acquisition to the acquisition server.
This downloading sequence must end before acquisition can begin, and is necessary if
subsequent buffering is required.
Tip: The Empower 3 FR4 software also buffers data from all queued sample sets, if
necessary.
l Acquisition continues in Run Only, Continue on Fault mode.
l The real-time plot does not always appear in Run Samples.
l The buffered data cannot be seen in the Review window.
l An “x” appears on the disk icon in the Run Samples window. (This icon appears in
the status bar in the lower right-hand corner, next to the clock.)
When the network connection is restored, and normal acquisition resumes, these
conditions no longer apply; however acquisition continues in Run Only mode.
Look at the Projects tab in System Monitor to determine whether processes need to be
disconnected. You can also automatically check for dead connections by editing the
sqlnet.ora file.
sqlnet.authentication_services = (NTS)
sqlnet.expire_time=X
database to check for dead connections, for example, every 10 minutes.
Tip: If you set this parameter too small, such as 2 minutes, database
performance is sometimes slowed.
4. Reboot the database server.
5. Check System Monitor to ensure all processes are clear.
Troubleshooting issues:
See also: Connections INSIGHT Quick Start Guide for information on installing
Connections INSIGHT software and Connections INSIGHT User’s Guide for information
on using Connections INSIGHT software.
Tip: Select Method and Directory to provide Waters with the methods used in the
project last downloaded to the instrument or device. Doing so does not send
chromatographic data to Waters. Nevertheless, this function is useful for
troubleshooting software related issues.
4. Click Submit iHelp Request.
Result: The service profile is created and sent to the Connections INSIGHT
Enterprise Server. The file uploading process triggers an e-mail alert to the
Waters Expert Center, which contacts you after reviewing the service profile.
l Acquisition
l Printer
l Citrix
If the troubleshooting procedures in this section do not correct the problem with your
system, see the manual shipped with the hardware and perform the recommended test
and diagnostic procedures. If you discover a problem that requires repair of a
component, check your maintenance agreement for the appropriate support
organization to contact.
See the Empower 3 Feature Release 4 online Help for additional troubleshooting
information, maintenance procedures, and status messages.
For additional information, click the ? button, the Help button, or the F1 key.
For more information about Windows operating system and utility error messages, see
the Windows 7 Help, Windows 10, Windows 2008 R2 or Windows 2012 R2 Help, or the
Microsoft Web site.
If you need to call Technical Support about an error message, note the particular error
and document the steps required to re-create the error before contacting Waters.
Notice: I f you create or modify database objects in response to Oracle error
messages you can negatively affect Empower 3 software performance and
sometimes need to re-validate the software. Contact your Waters Data
Specialist before implementing any database changes.
If you need to call Technical Support about an error message, note the particular error
and document the steps required to re-create the error before contacting Waters.
Tip: When sending log files to the Waters Technical Support department, save them as
a compressed (zip) file and include "WATZIP" in the subject line.
Control files:
Name of service company:
Address:
Telephone number:
Contact person:
Service access number:
Service contract expiration date:
Name of service company:
Address:
Telephone number:
Contact person:
Service access number:
Service contract expiration date: