Metrohm tiamo 2.4 Installation

Metrohm AG CH-9100 Herisau Switzerland Phone +41 71 353 85 85 Fax +41 71 353 89 01 info@metrohm.com www.metrohm.com

1 Minimum system requirements

Operating system 32-bit version of:

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

Installation tiamo 2.x

64-bit version of:

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

RAM Windows Vista and higher: 2 GB

Windows XP: 1 GB

Hard disk space Program: 1 GB

Data: 2 GB

Serial ports For devices with RS-232 interface

USB ports For devices with USB interface

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 tiamo software.

8.101.8056EN

CAUTION

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

2 Single workplace installation

With the single workplace version tiamo light or tiamo full, you can install both the tiamo client and the server on the computer.

The installation process starts automatically when you insert the CD into

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 appropriate message appears. Click on [Yes] if you would like to install the program nonetheless.

Afterwards, click on [Next >].

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

[Next >] to install the software.

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

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

Enter the license code for tiamo light or tiamo full and then click on

[Next >].

NOTE

If you have entered the license code of an update license, then the license code of the previous full version will additionally be requested.

8.101.8056EN

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

select a different target folder with [Browse…].

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

Additional installation information window:

8.101.8056EN

NOTE

The default paths are different for Windows XP, Windows Vista, Windows 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 tiamo 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 your system administrator for more information about this. Continue with [Next >].

Follow the instructions of the program until the following message

appears:

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

tiamo will now be installed.

Once the copying procedure has been completed you can make further

workplace settings:

The option This client ID must exist in the current tiamo 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 (the latter case only applies to tiamo multi).

If you enable this option, then tiamo 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

8.101.8056EN

case, check your server and firewall settings before installing the program again.

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

contains all relevant information concerning your current tiamo 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 tiamo under …bin\InstallLog. It contains a listing of all files copied to your computer during the installation and a confirmation that the installation has been successfully completed.

Complete the installation with [Finish].

3 Client/server installation

With the tiamo multi version (multi-client version with three licenses) you can select during the installation whether you want to install only a Client or a client and a server (database server) on your computer.

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

Follow steps 1 to 5 of the single workplace installation (see Chapter 2,

page 2).

The Additional installation information dialog appears. Here you can

select whether you want to install only a Client or a client and a server (database server) on your computer.

8.101.8056EN

The option your computer. Select this option if your computer will be used as server.

The default paths are different for Windows XP, Windows Vista, Windows 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 which tiamo uses to communicate with the database and administration server under [Advanced…]. 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

installation from point 7 onwards (see Chapter 2, page 2).

Client/Server installs the client and the database server on

NOTE

4 Modifying/repairing/removing the installation

and upgrading the license

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

￭ Windows XP - Control Panel ▶ Software

8.101.8056EN

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

and Features

on Metrohm tiamo. Then select Change/Remove:

Modify

Repair/Update

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

If the database path is changed, the existing databases are automatically copied 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 tiamo installation because, for instance, a DLL file is missing or a program file has been deleted by mistake, tiamo can be repaired with this option.

￭ Updating the installation

In case an older version of tiamo is installed, it will be updated to the new version of tiamo, see Program update with tiamo light/full or Program update with tiamo multi.

CAUTION

8.101.8056EN

When older tiamo versions (1.x) are updated to tiamo 2.x, the databases will be converted to the new versions; depending on the size of the database, this may take some time. For each database a progress bar which informs about the status of the conversion is displayed.

The computer must not be restarted or Windows shut down as long as the conversion is running!

License upgrade

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

￭ tiamo light to tiamo full or tiamo multi ￭ tiamo full to tiamo multi

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

Remove

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

5 Program update with tiamo light/full

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

NOTE

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

Files in the subdirectories bin, jre, lib, res, doc and examples will be overwritten 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.

CAUTION

The computer must not be restarted or Windows shut down as long as the conversion is running!

Save the configuration database into an external directory using the

backup function of tiamo. 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 created. It is recommended to copy the backup file to CD/DVD afterwards.

8.101.8056EN

If desired, export the methods in addition to the backup with the configu-

ration database (see above) into an external directory. In the Method program part, select the File ▶ Method manager... menu item. Select the desired Method group, select all methods to be exported and click on [Edit] ▶ Export…. Select the desired export directory and click on [OK]. The methods are exported into the desired directory. Afterwards, copy the method files to CD/DVD.

Save all determination databases created by you into an external directory

using the backup function of tiamo. 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

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

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

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

8.101.8056EN

When updating older tiamo versions (1.x) to tiamo 2.x, you have to enter

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

Complete the installation with [Finish].

NOTE

An UpdateLog file with a list of all files that have been copied to your computer during the program update and with a confirmation for a successful installation is saved in the tiamo installation folder under …bin\InstallLog.

6 Program update with tiamo multi

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

NOTE

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

8.101.8056EN

CAUTION

The computer must not be restarted or Windows shut down as long as the conversion is running!

Make sure tiamo multi is closed on all clients.

NOTE

In the bin subdirectory of the tiamo installation, you can find the Clients.exe application, with which all clients and their status can be dis-

played.

Open tiamo multi on the server and save the configuration database

into an external directory using the backup function of tiamo. In the Configuration program part, select the File ▶ Save ▶ 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 backup with the configu-

ration database (see above) into an external directory. In the Method program part, select the File ▶ Method manager… menu item. Select the desired Method group, select all methods to be exported and click on [Edit] ▶ Export…. Select the desired export directory and click on [OK]. The methods are exported into the desired directory. Afterwards, copy the method files to CD/DVD.

Save all determination databases that are present on the server into an

external directory using the backup function of tiamo. In the Database program part, select the File ▶ Database manager… menu item. Select the desired database and click on [Backup]. Select the Backup direc- tory, 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 in the installation directory (e.g. export files) into an

external directory or to CD/DVD.

Updating the server

Close tiamo 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.101.8056EN

When updating older tiamo versions (1.x) to tiamo 2.x, you have to enter

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

NOTE

The update of tiamo 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].

8.101.8056EN

NOTE

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 installation is saved in the installation folder of tiamo under bin\InstallLog.

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

if further licenses are to be added, the Administrator can enter them in tiamo (dialog: Configuration ▶ Tools ▶ Program administration ▶ Licenses ▶ Add licenses).

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 tiamo_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 installation.

NOTE

An UpdateLog file with a list of all files that have been copied to the client computer during the program update and with a confirmation for a successful installation is saved in the client's tiamo installation folder under bin\InstallLog.

7 Installation of drivers

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

8.101.8056EN

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 message should also show the name of the corresponding device. Write down this name and proceed as follows to install the driver manually:

NOTE

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

found under Other devices.

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

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

dow opens.

Select Browse my computer for driver software. The file selection

dialog opens.

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

(x86)\Metrohm\tiamo).

In the installation folder, open the drivers subfolder. This folder contains

the Avantes subfolder, in which you can find the driver for the Avantes spectrometer.

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

and select the driver file (*.inf).

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

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

After successful installation, close the Device Manager.

8 Adding additional licenses with Windows Vista

or newer

General

Since Windows Vista, Microsoft has introduced the UAC (User Account Control), which permits running tasks either as non-administrator or as administrator (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

tiamo.

8.101.8056EN

Problem description

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

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

If one adds the 5 licenses and then looks at this file license.mlic, only the standard license code will be listed (for 3 licenses).

If one highlights the file license.mlic and presses Compatibility files in the bar, then one will arrive in the directory C:\Users\'User'\AppData\Local\Vir- tualStore\Program Files\Metrohm\tiamo\bin ('User' being the abbreviation (UID) for the user logged in on the operating system). The file license.mlic with the license codes for the standard licenses and the 5 newly added licenses is to 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 file license.mlic from the directory C:\Users\'User'\AppData\Local

\VirtualStore\Program Files\tiamo\bin to the detail list of the directory C: \Program Files\Metrohm\tiamo\bin.

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

Remedy

￭ For new installations

– To enter additional licenses, the program must be started as adminis-

trator (position the mouse on the Program icon and click the right mouse button – select Run as administrator there).

– If one then adds the license code for additional licenses in the usual

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

8.101.8056EN

￭ For existing installations

– First of all, the file license.mlic in the directory C:\Users

\'User'\AppData\Local\VirtualStore\Program Files\Metrohm \tiamo\bin must be deleted.

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

– Afterwards, the program must be started as administrator (position

the mouse on the Program icon and click the right mouse button – select Run as administrator). If one then adds the license code for additional licenses in the usual way, then the file license.mlic in the directory C:\Program Files \Metrohm\tiamo\bin will contain both license codes.

9 User rights for tiamo

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

Metrohm tiamo 2.4 Installation

Specifications and Main Features

Frequently Asked Questions

User Manual

1 Minimum system requirements

2 Single workplace installation

3 Client/server installation

5 Program update with tiamo light/full

6 Program update with tiamo multi

7 Installation of drivers

9 User rights for tiamo