Metrohm viva 1.x User Manual

Metrohm AG
CH-9100 Herisau
Switzerland
Phone [phone]
Fax [phone]
[e-mail]
www.metrohm.com

1 Minimum system requirements

Operating system 32-bit version of:

￭ Windows XP Professional SP2
￭ Windows Vista Business/Enterprise/Ultimate
￭ Windows 7 Professional/Ultimate/Enterprise
￭ Windows 8 Professional/Enterprise
￭ Windows Server 2003
￭ Windows Server 2008
￭ Windows Server 2008 R2

viva 1.x

Installation

64-bit version of:

￭ Windows 7 Professional/Ultimate/Enterprise
￭ Windows 8 Professional/Enterprise
￭ Windows Server 2008 R2
￭ Windows Server 2012

RAM 4 GB

Hard disk space Program: 1 GB

Data: 64 GB

USB ports For devices with USB interface (USB version 1.1 and

higher)

Screen Resolution: 1,024 x 768

Network 10 Mbit/s, stable and permanent

Communication via TCP/IP

The Windows user must have administrator rights in order to be able to install
the viva software.

CAUTION

8.103.8017EN / 2014-03-20

Data loss may occur if the PC changes to sleep mode during a determina­tion. The sleep mode should therefore be disabled in the energy settings
of the operating system.

1

2 Single workplace installation

With the single workplace version viva full, you can install the client and the
database on your computer.

The installation process starts automatically when you insert the CD into

1

the drive. If this option is deactivated on your computer, double-click on
the setup.exe file.

If the minimum system requirements are not met (see above) an appropri­ate message appears. Click on [Yes] if you would like to install the pro­gram nonetheless.

Afterwards, click on [Next >].

During the installation process, the Welcome screen appears first. Click on

2

[Next >] to install the software.

After having read the license agreement for viva and accepted it with

3

[Yes], a window will appear where you can enter the license code.

Enter the license code for viva full and then click on [Next >].

4

2

8.103.8017EN / 2014-03-20

Now confirm the target folder for the viva installation with [Next >] or

5

select a different target folder with [Browse…].

You can define the paths for the database and default backup files in the

6

Additional installation information window:

8.103.8017EN / 2014-03-20

NOTE

The default paths are different for Windows XP, Windows Vista, Win­dows 7 and Windows 8.

The database path must not be on a network drive.

The default backup path may be on a network drive.

You can change the ports viva uses to communicate with the database
server and the administration server with the [Advanced…] button. If
the ports are already used, an appropriate error message will appear. Ask

3

your system administrator for more information about this. Continue with

[Next >].

7

This message points out again which ports viva uses. Write down these
ports and inform your system administrator in case viva is not able to
connect to the database. Confirm the message with [OK].

viva will now be installed.

Once the copying procedure has been completed you can make further

8

workplace settings:

The option This client ID must exist in the current viva system. can
only be activated if a database from a previous installation already exists
on your computer or if you want to connect to a database server which is
installed on another computer.

If you enable this option, then viva checks whether the identifier you
have entered exists in the database. If this is true the identifier and all
associated settings will be adopted. With this option reinstalling a client is
much easier.

Click on [Next >]. If the database ports are not available, an appropriate
error message will appear and the installation will be canceled. In this
case, check your server and firewall settings before installing the program
again.

4

8.103.8017EN / 2014-03-20

At the end of the installation, the file info.txt will be created. This file

9

contains all relevant information concerning your current viva installation.
Save this file on your hard drive for future reference and print it (add to
IQ).

NOTE

An InstallLog file can be found in the installation directory of viva
under …bin\InstallLog. It contains a listing of all files copied to your
computer during the installation and a confirmation that the installa­tion has been successfully completed.

Complete the installation with [Finish].

10

3 Client/server installation

With the viva multi version (client/server version with three licenses) you can
select during the installation whether you want to install a client or the server
(incl. client) on your computer.

If you want to install only a client on your computer, a server to which the cli­ent will be connected must have been previously installed on another com­puter.

The installation process starts automatically when you insert the CD into

1

the drive. If this option is deactivated on your computer, double-click on
the setup.exe file.

If the minimum system requirements are not met (see above) an appropri­ate message appears. Click on [Yes] if you would like to install the pro­gram nonetheless.

Afterwards, click on [Next >].

During the installation process, the Welcome screen appears first. Click on

2

[Next >] to install the software.

8.103.8017EN / 2014-03-20

5

After having read the license agreement for viva and accepted it with

3

[Yes], a window will appear where you can enter the license code.

Enter the license code for viva multi and then click on [Next >].

4

Now confirm the target folder for the viva installation with [Next >] or

5

select a different target folder with [Browse…].

The Additional installation information dialog appears. Here you can

6

select whether you want to install a client or the server:

6

8.103.8017EN / 2014-03-20

The option Client/Server installs the client and the database server on
your computer. Select this option if your computer will be used as server.

NOTE

The default paths are different for Windows XP, Windows Vista, Win­dows 7 and Windows 8.

The database path must not be on a network drive.

The default backup path may be on a network drive.

With Client, only the client will be installed and you have to select the
database server (has to be installed in advance!) you would like to use

with the button. The network server name or the IP address is
accepted as the name.

You can change the ports viva uses to communicate with the database
and administration server with the [Advanced…] button. If the ports are
already used, an appropriate error message will appear. Ask your system
administrator for more information about this. Continue with [Next >].

All further installation steps correspond to those of the single workplace

7

installation from point 7 onwards.

4 Modifying/repairing/removing the installation

and upgrading the license

In order to carry out modifications on the current viva installation, start the
setup.exe file on the installation CD or click under:

￭ Windows XP - Control Panel ▶ Software

8.103.8017EN / 2014-03-20

7

Modify

￭ Windows Vista / Windows 7 / Windows 8 - Control Panel ▶ Programs

and Features

on Metrohm viva. Then select Change/Remove:

With this option you can adjust the paths to the database and backup files and
change the ports which viva uses for communication. With the viva multi
version you can additionally change the path to the database server.

Repair/Update

License upgrade

If the database path is changed, the existing databases are automatically cop­ied to the new location.

With this option you can repair an existing defective installation or update an
older installation.

￭ Repairing the installation

In case of a defective viva installation because, for instance, a DLL file is
missing or a program file has been deleted by mistake, viva can be repaired
with this option.

￭ Updating the installation

In case an older version of viva is installed, it will be updated to the new
version of viva.

A direct upgrade of your current installation to a viva version with additional
features is possible with this option:

￭ viva full to viva multi

In order to do this, enter your new license code in the next dialog window.

Remove

8

This option removes your viva installation. Data which has been generated
after the installation (e.g. database entries, log files, exported data, etc.) will
not be deleted.

8.103.8017EN / 2014-03-20

5 Program update with viva full

During the program update, the configuration database (system configuration,
methods, templates) and the determination databases are automatically
updated for further use.

NOTE

The files in the database directory and the backup directory will be retained
when the program is updated.

Files in the subdirectories bin, jre, lib, res, doc and examples will be over­written by the update. Those files in these directories which are not updated
during the update will be deleted. The deleted files are listed in the Install-
Log.

Save the configuration database into an external directory using the

1

backup function of viva. In the Configuration program part, select the
File ▶ Backup ▶ Manually menu item. Select the Backup directory,

enter a name for the backup file and click on [Start]. The backup is cre­ated. Afterwards, copy the backup file to CD/DVD.

If desired, export the methods in addition to the automatic backup with

2

the configuration database (see above) into an external directory. In the
Method program part, select the File ▶ Method manager... menu
item. Select the desired Method group, mark all methods to be

exported and click on [Edit] ▶ Export.... Select the desired export direc-

tory and click on [OK]. The methods are exported into the desired direc­tory. Afterwards, copy the method files to CD/DVD.

Save all determination databases created by you into an external directory

3

using the backup function of viva. In the Database program part, select
the File ▶ Database manager... menu item. Select the desired database
and click on [Backup]. Select the Backup directory, enter a name for
the backup file and click on [Start]. The backup is created. Afterwards,
copy the backup file to CD/DVD.

Save further files created by you in the installation directory (e.g. export

4

files) into an external directory or to CD/DVD.

Close viva. Insert the installation CD and double-click on the setup.exe

5

file. Then select Repair/Update and click on [Next >].

8.103.8017EN / 2014-03-20

9

Enter your update license code and click on [Next >].

6

Complete the installation with [Finish].

7

An UpdateLog file with a list of all files that have been copied to your
computer during the program update and with a confirmation of a suc­cessful installation is saved in the viva installation folder (default: C:\Pro­gram Files\Metrohm\viva) under bin\InstallLog.

6 Program update with viva multi

During the program update, the configuration database (system configuration,
methods, templates, user-specific data for all clients) and the determination
databases on the server are automatically updated for further use with the new
version of viva multi.

10

8.103.8017EN / 2014-03-20

NOTE

The files in the database directory and the backup directory will be retained
when the program is updated.

Files in the subdirectories bin, jre, lib, res, doc and examples will be over­written by the update. Those files in these directories which are not updated
during the update will be deleted. The deleted files are listed in the Install-
Log.

Make sure viva multi is closed on all clients.

1

NOTE

In the bin subdirectory of the viva installation, you can find the Cli­ents.exe application, with which all clients and their status can be dis-

played.

Open viva multi on the server and save the configuration database into

2

an external directory using the backup function of viva. In the Configu­ration program part, select the File ▶ Backup ▶ Manually menu item.

Select the Backup directory, enter a name for the backup file and click
on [Start]. The backup is created. Afterwards, copy the backup file to CD/
DVD.

If desired, export the methods in addition to the automatic backup with

3

the configuration database (see above) into an external directory. In the
Method program part, select the File ▶ Method manager... menu
item. Select the desired Method group, mark all methods to be

exported and click on [Edit] ▶ Export.... Select the desired export direc-

tory and click on [OK]. The methods are exported into the desired direc­tory. Afterwards, copy the method files to CD/DVD.

Save all determination databases on the server into an external directory

4

using the backup function of viva. In the Database program part, select
the File ▶ Database manager... menu item. Select the desired database
and click on [Backup]. Select the Backup directory, enter a name for
the backup file and click on [Start]. The backup is created. Afterwards,
copy the backup file to CD/DVD.

Save further files created by you in the installation directory (e.g. export

5

files) into an external directory or to CD/DVD.

6

Updating the server

Close viva multi on the server and on all clients. Insert the installation CD
on the server and double-click on the setup.exe file. Then select
Repair/Update and click on [Next >].

8.103.8017EN / 2014-03-20

11

Enter the update license code for viva multi and click on [Next >].

7

8

NOTE

12

The update of viva multi consists of the server license and three client
licenses. If an existing installation contains additional client licenses,
these will be deleted.

Click on [OK] in the corresponding message in order to continue the
installation.

Complete the installation with [Finish].

9

An UpdateLog file with a list of all files that have been copied to the
server during the program update and with a confirmation of a successful

8.103.8017EN / 2014-03-20

installation is saved in the server's viva installation folder (default: C:\Pro­gram Files\Metrohm\viva) under bin\InstallLog.

In case additional licenses have been removed during the server update or

10

if further additional licenses are to be added, the Administrator can
enter them in viva (dialog: Configuration ▶ Tools ▶ Program admin-

istration... ▶ Licenses ▶ Add licenses).

11

Updating clients

For each client, insert the installation CD and double-click the setup.exe
file. Then select Repair/Update and click on [Next >]. Complete the
installation with [Finish].

NOTE

In order to facilitate the updating of many clients, the installation can
be copied from the CD to a writeable medium and the file viva_init.ini
can be modified. There, user-defined parameters for the installation
(license code, installation path, server name, etc.) can be set in
advance, which allows you to only have to click through the installa­tion.

An UpdateLog file with a list of all files that have been copied to the cli­ent computer during the program update and with a confirmation for a
successful installation is saved in the client's viva installation folder
(default: C:\Program Files\Metrohm\viva) under bin\InstallLog.

7 Installation of drivers

In normal cases, the installation routine of viva automatically installs all the
drivers necessary for controlling the supported devices.

If you are using a 64-bit operating system, it may be necessary to install drivers
manually in combination with a few devices. This is the case if the operating
system displays a message when connecting a device to the computer, e.g.
Device driver software was not installed. No driver found. The mes­sage should also show the name of the corresponding device. Write down this
name and proceed as follows to install the driver manually:

NOTE

8.103.8017EN / 2014-03-20

The following description applies for Windows 7 (64-bit version). It may
slightly vary for your system.

Open the Windows Device Manager. The corresponding device can be

1

found under Other devices.

13

Right-click on the device. The context menu opens.

2

In the context menu, select Update Driver Software…. A dialog win-

3

dow opens.

Select Browse my computer for driver software. The file selection

4

dialog opens.

Navigate to the installation folder of viva (default: C:\Program Files

5

\Metrohm\viva).

In the installation folder, open the drivers subfolder. It contains a sub-

6

folder in which the necessary drivers are stored for each of the corre­sponding devices.

In the drivers subfolder, open the subfolder of the corresponding device

7

and select the driver file (*.inf).

Apply the selection with [OK]. A Windows safety prompt is displayed. In

8

order to install the driver, click on [Install].

After successful installation, close the Device Manager.

9

8 Adding additional licenses with Windows Vista

or newer

General

Starting with Windows Vista, Microsoft has introduced the UAC (User Account
Control), which permits running tasks either as non-administrator or as admin­istrator (without changes of user, switching off or similar).

http://technet.microsoft.com/en-us/library/cc709691%28WS.10%29.aspx

http://technet.microsoft.com/en-us/magazine/2007.06.uac.aspx

This function can, however, cause difficulties with client/server installations of
viva.

Problem description

A user would like to add additional licenses for the program; the license code
for an additional five licenses, for example, is added (on the server) in the Con-
figuration program part in the Program administration dialog window
(accessible via the Tools ▶ Program administration... menu item, Licenses
tab).

The file license.mlic, which contains the standard license code and the addi­tional license codes, is stored in the bin directory of the program installation
(C:\Program Files\Metrohm\viva\bin).

14

8.103.8017EN / 2014-03-20

If the user adds the five licenses and then looks at this license.mlic file, only
the standard license code will be listed (for three licenses).

If the user highlights the license.mlic file and clicks on Compatibility files in
the bar, then he or she will be taken to the C:\Users\'User'\AppData\Local
\VirtualStore\Program Files\Metrohm\viva\bin directory ('User' being the
unique identifier (UID) of the user logged in on the operating system). The
license.mlic file with the license codes for the standard licenses and the five
newly added licenses can be found here, i.e., the additional licenses are stored
in the VirtualStore only for the Windows user who was logged in on the PC
at the time the additional licenses were added.

On the server, the program recognizes all of the licenses. The operating system
adds the license.mlic file from the C:\Users\'User'\AppData\Local\Virtual-

Store\Program Files\viva\bin directory to the detail list of the C:\Program
Files\Metrohm\viva\bin directory.

For the client/server functionality of the database server, however, the
license.mlic file in the C:\Program Files\Metrohm\viva\bin directory is rel­evant, and here only the basic license is listed. Therefore, problems are to be
anticipated when adding additional clients (more than the three clients present
in the default settings).

Remedy

￭ For new installations

– To enter additional licenses, you must start the program as an admin-

istrator (right-click on the program icon and select Run as adminis-
trator there).

– If you then add the license code for additional licenses in the usual

way, then the license.mlic file in the C:\Program Files\Metrohm
\viva\bin directory will contain both license codes.

￭ For existing installations

– First of all, the license.mlic file in the C:\Users\'User'\AppData

\Local\VirtualStore\Program Files\Metrohm\viva\bin directory

must be deleted.
This file must not be present in the VirtualStore of any user – you
must check to make sure this is the case, and any such files which
may be found must be deleted.

– Afterwards, you must start the program as an administrator (right-

click on the program icon and select Run as administrator there).
If you then add the license code for additional licenses in the usual
way, then the license.mlic file in the C:\Program Files\Metrohm
\viva\bin directory will contain both license codes.

9 User rights for viva

In order for the logged-in user to be able to access all functions with viva, the
Windows system administrator must ensure that the permissions are set for the
directories as listed below:

8.103.8017EN / 2014-03-20

15

Directory Permission Group name or

user name

Database directory

Directory where the databases will be saved (…\Data).

Backup directory

Modify SYSTEM

User

Modify User

Directory where the backup copies will be stored
(…\Backup).

%ALLUSERSPROFILE%\Application Data\Metrohm

(Windows XP)

**

%PROGRAMDATA%\Metrohm (Windows Vista and

higher)

**

Export directories

Modify User

Modify User

Modify User

Directories where the exported files are to be saved.

PDF directories

Modify User

Directories where the PDF files are to be saved.

Desktop Modify User

%PROGRAMFILES%\Metrohm\viva Read Execute User

*

User = name of the user who is logged in

**

During installation of viva the permission Full Control is set for the following groups: SYSTEM,
Administrators, Users, Guests, Main users.

*

*

*

*

*

*

*

*

16

8.103.8017EN / 2014-03-20