Metrohm MagIC Net 3.0 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 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

MagIC Net 3.0

Installation

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 1024 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 MagIC Net software.

8.102.8051EN

1

CAUTION

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

2 Single workplace installation

With the single workplace version MagIC Net Basic, MagIC Net Compact
or MagIC Net Professional, you can install both the MagIC Net client and
the server on the 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 file setup.exe.

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 MagIC Net and accepted it

3

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

2

8.102.8051EN

Enter the license code for MagIC Net Basic, MagIC Net Compact or

4

MagIC Net Professional and 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.102.8051EN

Now confirm the target folder for the MagIC Net installation with [Next

5

>] or select a different target folder with [Browse…].

3

In the Additional installation information window you can define the

6

paths for the database and backup files:

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 MagIC Net uses to communicate with the
database server and the administration server with the button
[Advanced…]. If the ports are already used, an appropriate error mes­sage will appear. Ask your system administrator for more information
about this. Continue with [Next >].

4

8.102.8051EN

If you would like to create a shortcut on your desktop to start the

7

MagIC Net software, activate [Yes] and then click on [Next >].

In normal cases, you can confirm the selection of the program folder by

8

clicking on [Next >].

8.102.8051EN

The installation settings can now be checked. Start the copy process with

9

[Next >].

5

Follow the instructions of the program until the following message

10

appears:

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

MagIC Net will now be installed.

11

Once the copying procedure has been completed you can make further

12

workplace settings:

6

8.102.8051EN

The option

This client ID must exist in the current MagIC Net sys-

tem is only selectable if a database from a previous installation already

exists on your computer or if you want to connect to a database server
which has been installed on another computer.

If you activate this option, then MagIC Net 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.

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

13

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

NOTE

8.102.8051EN

An InstallLog file can be found in the installation directory of
MagIC Net under …bin\InstallLog. It contains a listing of all files cop-

ied to your computer during the installation and a confirmation that
the installation has been successfully completed.

Complete the installation with [Finish].

14

7

3 Client/server installation

With the MagIC Net Multi version (multiple workplace version with three
licenses) you can select during the installation whether you want to install a
MagIC Net client or a MagIC Net client plus server 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 file setup.exe.

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 MagIC Net and accepted it

3

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

8

8.102.8051EN

Enter the license code for MagIC Net Multi and click on [Next >].

4

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.102.8051EN

Now confirm the target folder for the MagIC Net installation with [Next

5

>] or select a different target folder with [Browse…].

9

The Additional installation information dialog appears. Here you can

6

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

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.

10

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 accep­ted as the name.

8.102.8051EN

With the button [Advanced…] the ports MagIC Net uses to communi­cate with the database and administration server can be changed. 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 6 onwards.

4 Modifying/repairing/removing the installation

and upgrading the license

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

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

and Features

on Metrohm MagIC Net. Then select Change/Remove:

Modify

Repair/Update

8.102.8051EN

With this option you can change the paths to the database and backup files
and set the ports which MagIC Net uses for communication. With the
MagIC Net Multi version you can additionally change the path to the data­base server.

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.

11

License upgrade

￭ Repairing the installation

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

￭ Updating the installation

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

CAUTION

During updating older MagIC Net versions the databases will be converted
to the new version. 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 or Windows must not be restarted or shut down as long as
the conversion is running!

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

￭ MagIC Net Compact to MagIC Net Professional or MagIC Net Multi
￭ MagIC Net Professional to MagIC Net Multi

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

Remove

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

5 Program update with MagIC Net Compact/Pro-

fessional

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 of MagIC Net Compact/Pro-

fessional.

NOTE

12

The files in the database and backup directory will be retained when updat­ing the program.

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.

8.102.8051EN

Save the configuration database into an external directory using the

1

backup function of MagIC Net. In the Configuration program part,
select the File ▶ Save ▶ Manually menu item. Select the Backup direc-
tory, enter a name for the backup file and click on [Start]. The backup is
carried out automatically. It is recommended to copy the backup file to
CD/DVD afterwards.

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, select 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. It is recommended to copy the method files to CD/DVD afterwards.

Save all determination databases created by you into an external directory

3

using the backup function of MagIC Net. 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 car­ried out automatically. It is recommended to copy the backup file to CD/
DVD afterwards.

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

4

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

Close MagIC Net. Insert the installation CD and double-click on the file

5

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

8.102.8051EN

Enter the update license code for MagIC Net Compact or MagIC Net

6

Professional and click on [Next >].

13

7

During updating older MagIC Net versions to MagIC Net 3.0 the data­bases will be converted to the new version. 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 or Windows must not be restarted or shut down as long
as the conversion is running!

Complete the installation with [Finish].

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 suc­cessful installation is saved in the MagIC Net installation folder (default:
C:\Program Files\Metrohm\MagIC Net) under bin\InstallLog.

CAUTION

6 Program update with MagIC Net Multi

14

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 MagIC Net Multi.

8.102.8051EN

NOTE

The files in the database and backup directory will be retained when updat­ing the program.

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 MagIC Net Multi is closed on all clients.

1

NOTE

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

displayed.

Open MagIC Net Multi on the server and save the configuration data-

2

base into an external directory using the backup function of MagIC Net.
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 carried out automatically. It is rec­ommended to copy the backup file to CD/DVD afterwards.

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, select 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. It is recommended to copy the method files to CD/DVD afterwards.

Save all determination databases on the server into an external directory

4

using the backup function of MagIC Net. 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 car­ried out automatically. It is recommended to copy the backup file to CD/
DVD afterwards.

Save further files in the installation directory (e.g. export files) into an

5

external directory or to CD/DVD.

8.102.8051EN

15

6

Updating the server

Close MagIC Net Multi on the server and on all clients. Insert the instal­lation CD on the server and double-click the file setup.exe. Then select
Repair/Update and click on [Next >].

Enter the update license code for MagIC Net multi and click on [Next

7

>].

8

NOTE

16

The update of MagIC Net 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.

8.102.8051EN

9

During updating older MagIC Net versions to MagIC Net 3.0 the data­bases will be converted to the new version. 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 or Windows must not be restarted or shut down as long
as the conversion is running!

Complete the installation with [Finish].

An UpdateLog file with a list of all files that have been copied to the
server and with a confirmation of a successful installation is saved in the
MagIC Net server's installation folder (default: C:\Program Files\Metrohm
\MagIC Net) under bin\InstallLog.

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

10

or if further additional licenses are to be added, the Administrator can
enter them in MagIC Net (dialog: Configuration ▶ Tools ▶ Program

administration ▶ Licenses ▶ Add licenses).

CAUTION

11

Updating clients

For each client, insert the installation CD and double-click the file
setup.exe. 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
magic_init.ini can be modified. There, user-defined parameters
(license code, installation path, server name, etc.) for the installation
can be set in advance, which allows you to only have to click through
the installation.

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

7 Installation of drivers

In normal cases, the installation routine of MagIC Net 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

8.102.8051EN

17

systems displays a message when connecting a device to the computer, e.g.

Device driver software was not successfully installed. No driver
found. The message should also show the name of the corresponding device.

Note 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. Under Other devices the corre-

1

sponding device can be found.

Click on the device with the right mouse button. The context menu

2

opens.

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 MagIC Net (default: C:\Program

5

Files\Metrohm\MagIC Net).

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

6

the subfolder 889, in which you can find the driver for the 889 IC Sample
Center and the Combustion Module.

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

7

install the driver, click on [Install].

After the successful installation, close the Device Manager.

8

8 Adding additional licenses with Windows Vista

or newer

General

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

MagIC Net.

18

8.102.8051EN

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 (accessi­ble via menu item Tools ▶ Program administration..., tab Licenses).

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\MagIC Net\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\MagIC Net\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\MagIC Net\bin to the detail list of the direc­tory C:\Program Files\Metrohm\MagIC Net\bin.

For the client-server functionality of the database server, however, the file
license.mlic in the directory C:\Program Files\Metrohm\MagIC Net\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\MagIC Net\bin will contain both license codes.

8.102.8051EN

19

￭ For existing installations

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

\'User'\AppData\Local\VirtualStore\Program Files\Metrohm
\MagIC Net\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\MagIC Net\bin will contain both license codes.

9 User rights for MagIC Net

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

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\MagIC Net Read Execute User

*

*

*

*

*

*

*

*

20

*

User = name of the user who is logged in

**

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

8.102.8051EN