Agilent VWorks Automation Control 14.0 Installation Manual

VWorks Automation Control 14.0

VWorks Plus and VWorks Standard editions

Installation Guide

This guide contains the following topics:

• “About this guide” on page 2

• “About computer requirements” on page 3

• “Before you install the software” on page 3

• “Uninstalling a previous VWorks version” on page 5

• “Installation workflow” on page 6

• “Installing Agilent OpenLab for VWorks” on page 6

• “Installing VWorks 14.0 software” on page 12

• “Uninstalling VWorks software 14.0” on page 19

• “Upgrading an installation from VWorks Standard to VWorks Plus” on page 20

• “Converting an installation from VWorks Plus to VWorks Standard” on page 21

Original Instructions

About this guide

This guide provides installation instructions for the VWorks 14.0, which is available in either of the following editions:

• VWorks Plus. In addition to the standard features, this edition includes features that

enable compliance with FDA rules and guidelines for Part 11 of Title 21 of the Code of Federal Regulations (21 CFR Part 11).

• VWorks Standard. This edition includes all the software components for running the

standard VWorks software.

About the user documentation

User guides Content

Administrator guides:

• VWorks Automation Control Plus

Administrator Guide

• VWorks Automation Control Standard

Administrator Guide

Quick reference:

• VWorks Plus Quick Reference Guide

• VWorks Standard Quick Reference Guide

VWorks Automation Control Setup Guide How to set up labware definitions, liquid classes, and if

VWorks Automation Control User Guide How to use the VWorks software, including setting up

To access the user guides, do one of the following:

• From within VWorks software, select Help > Knowledge Base or press F1.

How to manage user access and licenses, and how to maintain the system, including system backup and restore procedures.

Overview of the VWorks features and workflow.

applicable, an experiments database and labware inventory database, and how to migrate protocols from previous versions of VWorks software.

VWorks Plus only. Describes how to set up and manage audit trails and record states and how to run tamper detection.

devices, writing protocols, creating forms, running protocols, and troubleshooting and maintenance.

• From the Windows desktop, click Start ( ) > All apps > Agilent Technologies >

VWorks Knowledge Base.

Contacting Agilent Technologies

Web: https://www.agilent.com

Contact page: https://www.agilent.com/en/contact-us/page

Documentation feedback: documentation.automation@agilent.com

2 VWorks Automation Control 14.0 Installation Guide

About computer requirements

The Agilent-supplied computer, if purchased, meets the computer requirements. The computer is an HP Z2G4 or equivalent, with 16 GB RAM.

If you are installing the software on a different computer, refer to one of the following for computer requirements:

• VWorks Software 14.0 Site Preparation Checklist

• VWorks Automation Control 14.0 Release Notes

Before you install the software

Before you start the installation, ensure that you have purchased a license for the VWorks edition that you plan to install:

• VWorks Plus. In addition to the standard features, this edition includes features to

enable compliance with 21 CFR Part 11. All records and results are stored in Content Management.

• VWorks Standard. The compliance-related features are unavailable in this edition.

The records and results are stored in the local file system.

Note: If you are upgrading from a previous version of Agilent OpenLab for VWorks, see

“Upgrading an installation from VWorks Standard to VWorks Plus” on page 20.

About computer requirements

Prerequisite checklist

Item Task

1 Decide on a computer name.

2 If applicable, install your automation devices, including power and

The computer name will be reflected in the license. To avoid effort, Agilent recommends that the computer name remain unchanged after installing VWorks Plus or VWorks Standard.

IMPORTANT To make sure that a DNS server can resolve the computer

name, follow the internet standard for protocols (RFC952) and make sure the name contains only approved characters (letters (a-z, A-Z), digits (0-9), and hyphen (-)).

IMPORTANT Do not use an underscore! Installation is not possible if the

computer name contains an underscore.

communication cables.

VWorks Automation Control 14.0 Installation Guide

Before you install the software

Item Task

3 To enable the successful installation and activation of all components:

4 If you use Trend Micro as an antivirus software, turn off Web Reputation to

5 If applicable, uninstall any previous versions of the VWorks software. See

6 Ensure the following:

• Ensure that the LAN-cable is connected and a network is available. A local

network is sufficient, such as the connection between the computer and the automation device.

VWorks Plus only. If you install Agilent OpenLab for VWorks without this connection, the activation of the Content Management component will fail.

• Ensure that the Windows Sleep mode is set to Never.

allow the installation of all components.

“Uninstalling a previous VWorks version” on page 5.

• No Windows updates are performed during the installation.

• No system reboot is pending. Pending reboots are indicated in the

System Preparation Tool.

LAN power management

Microsoft Windows may be set to turn instruments/components off to save power while sleeping or hibernating, which can interrupt VWorks processing.

To c h an g e t he W ind ows power management setting:

1 In the Microsoft Control Panel, open the Network and Sharing Center.

Note: View the items by icon to see a list of all items

2 Select Change adapter settings. Right-click Local Area Connection> Properties>

Configure.

3 Select the Power Management tab. 4 Clear the Allow the computer to turn off this device to save power check box.

4 VWorks Automation Control 14.0 Installation Guide

Uninstalling a previous VWorks version

If the computer contains:

• A previous installation of VWorks Plus or VWorks Standard, see “Upgrading an

installation from VWorks Standard to VWorks Plus” on page 20 for instructions.

• VWorks 13.1.x or earlier versions, follow the instructions in this topic.

Before you uninstall

Create backup copies of the following items for safekeeping:

• Copy the C:\VWorks Workspace\ folder.

• Export the full set of Velocity11 registry keys to a file (.reg).

To export the Velocity11 registry keys:

1 Open Registry Editor. 2 In the Registry Editor window, right-click the following, and then click Export.

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Velocity11

3 In the Export Registry File dialog box, specify a file name and storage location, and

click Save.

Uninstalling a previous VWorks version

About migrating your VWorks files

Even though you must uninstall any previous VWorks versions before installing VWorks 14.0 or later, the files and records created by the previous version remain on the hard drive of the computer and will be accessible by the VWorks Migration Wizard. The VWorks 14.0 Migration Wizard enables you to migrate the VWorks protocols and associated files from VWorks 12.3, 13.0, or 13.1.x.

Uninstalling VWorks 13.1.x or earlier versions

Uninstall any previous versions of the following:

• Agilent Bravo IQOQ Test Utilities

• Agilent Bravo Metabolomics Workbench, Protein Sample Prep Workbench, and

BenchCel Workstations, if applicable

• Agilent Software Verification Tool

• VWorks software

To uninstall a previous version:

1 In Windows, go to Settings > Apps & features. 2 Select the program, for example, VWorks xx.x.x.xxx, and click Uninstall to uninstall

the selected software.

3 Click Yes to allow the installer to make changes to your device.

After uninstalling the VWorks software, ensure that the following folder is not present. If necessary, delete it.

C:\Program Files (x86)\Agilent Technologies\VWorks\Plugins

VWorks Automation Control 14.0 Installation Guide

Installation workflow

Perform the following steps to install VWorks Plus or VWorks Standard 14.0.

Step For this task... See...

1 Prepare for the installation. “Before you install the software” on page 3

2 Run the Agilent OpenLab for VWorks installer. “Installing Agilent OpenLab for VWorks” on page 6

3 Run the Agilent VWorks 14.0 installer. “Installing VWorks 14.0 software” on page 12

4 Get your license via SubscribeNet.

5 Configure the software: Authentication,

Security policy, and User management

Administrator guide for your VWorks edition

Installing Agilent OpenLab for VWorks

About the OpenLab for VWorks installer

This section describes a new installation of the software. For information on upgrading an existing OpenLab for VWorks installation, see “Upgrading an installation from

VWorks Standard to VWorks Plus” on page 20.

The Agilent OpenLab for VWorks installation wizard installs and configures the following required software tools and components:

• Control Panel and Shared Services

These components of the OpenLab software control the user access and storage for the VWorks software.

• VWorks Plus only. Content Browser and Content Management

Note: Shared Services stores VWorks files in this secure repository.

• Agilent Software Verification Tool

Agilent support providers may use this tool to qualify the software installation.

• Database (PostgreSQL) and license tracking software (Flex-Net Publisher) required

by Shared Services

The installation wizard puts a Control Panel shortcut on the Windows desktop

and updates the Windows Start () menu under Agilent Technologies to include the installed apps and utilities.

6 VWorks Automation Control 14.0 Installation Guide

Installing Agilent OpenLab for VWorks

IMPORTANT

Do not attempt to install the software directly from the USB drive because the installation may fail. Ensure that you install the software from C:\Temp\ on your local computer.

To install Agilent OpenLab for VWorks:

1 Copy the entire contents of the USB drive to the following location on your

computer and then remove the USB drive from the computer. C:\Temp\

2 Unzip the OpenLabForVWorks_2.5.0.927.zip archive to the following folder:

C:\Temp\

Installing Agilent OpenLab for VWorks

The installation wizard may trigger an reboot if the computer does not have all the software prerequisites. Ensure that you save any work in process before continuing.

3 Double-click the unzipped OpenLabForVWorks_2.5.0.927.exe file.

Note: If you have an antivirus software on your computer, it may block or quarantine this installer. If that occurs, either disable the antivirus or restore the file from the antivirus' quarantine to continue with the installation.

VWorks Automation Control 14.0 Installation Guide

+ 15 hidden pages