Installation Guide VisionCATS
Installation Guide VisionCATS
VISIONCATS
visionCATS
Content
1 Introduction ................................................................................................... 2
2 Content of the visionCATS installation disc/file ................................................ 3
3 Installation of visionCATS ................................................................................ 3
3.1 Architecture of visionCATS ............................................................................. 3
3.2 PC minimal specification ................................................................................ 4
3.3 Installation procedure ..................................................................................... 4
3.4 Licensing ....................................................................................................... 9
3.5 Backup ........................................................................................................ 14
3.6 Restore procedure ........................................................................................ 26
4 Installation of HPTLC PRO Module driver ...................................................... 26
5 Installation of USB – to RS232 adapter .......................................................... 26
5.1 Troubleshooting ........................................................................................... 28
6 Installation of TLC Visualizer and TLC Visualizer 2 camera ................................. 28
6.1 USB3 Camera for TLC Visualizer 2 .................................................................. 28
6.2 FireWire Camera for TLC Visualizer ................................................................. 28
7 Update of instrument firmware..................................................................... 29
7.1 For instruments with USB connection (HPTLC PRO) ......................................... 29
7.2 For instruments with RS232 connection.......................................................... 30
7.3 For the FireWire camera of TLC Visualizer ........................................................ 31
8 End user license information ......................................................................... 32
1
visionCATS
1 Introduction
visionCATS is the CAMAG software to control and operate
CAMAG sophisticated High Performance Thin Layer
Chromatography (HPTLC) instruments such as ADC 2, Linomat 5, ATS
4, Scanner 3/4 or TLC Visualizer (2). Furthermore it allows one to
gather data from instruments like the TLC Visualizer (2) and to
facilitate and conduct qualitative analysis of (HP)TLC plates or
individual sample data. On images captured with the TLC Visualizer (2)
it is possible to perform a fully integrated image-based evaluation.
With the TLC Scanner featuring scanning densitometry (single- and
multi-wavelength detection), it is also possible to quantify your
analytes.
2
visionCATS
2 Content of the visionCATS installation disc/file
Section Content
• Root • visionCATS installation file
directory • This installation guide
• visionCATS backup guide (chapter 3.5)
• Release Notes
• Service information files
• Declaration of software validation
Drivers • Driver HPTLC PRO Modules
• Driver for TLC Visualizer camera (USB and FireWire;
chapter 6)
• Driver for USB to RS232 adapter (chapter 4)
3 Installation of visionCATS
visionCATS architecture
5
visionCATS
6
visionCATS
• Choose the location of the program, the images and other data
The data will be accessed with the Local System account. Network
drive will not be accessible. Please check that this account has access
to the specified folder
• Install the client(s). For each succeeding installation in the same cluster
choose Client and search for the respective machine the server is installed
on. A client can be installed with or without an instrument service (you
need an instrument service if you want to connect one or more
instrument on the computer). If you want to install several visionCATS
clients in office places, where you will never connect any instrument,
these clients can be installed without instrument service, so that only
needed instrument services would be registered in the system.
In order for your visionCATS server to appear, the client and server
hosts should be on the same network and have File Sharing enabled
(available in Network and Sharing Center).
Troubleshooting:
At any momement, if some error occurs, you can get all log files related
to the visionCATS installation, by clicking on the below left button.
8
visionCATS
3.4 Licensing
As most of the professional software programs, visionCATS uses an
activation system to control the accessibility to its features. The license
defines:
• How much clients can be bound to the visionCATS installation,
• The available edition/options (each edition contains a set of options)
• The available additional options,
• The available instruments.
Consequently, the whole installation is controlled with a single license.
The visionCATS registration procedure consists in three main steps:
• The generation of a license request directly from visionCATS,
• The validation the license request, performed by your local
visionCATS distributor, producing a license key,
• The activation of the visionCATS installation, by entering the serial
number and license key in visionCATS.
During this steps, your visionCATS installation will/can be in the
9
visionCATS
following states:
• Evaluation: When performing a brand new installation of
visionCATS, you get an evaluation period of 60 days. During the
evaluation period, you can use all visionCATS features except the
Method Library and the 21CFR Part 11 compliance, you can use
all CAMAG instruments and you can connect up to 10 visionCATS
clients.
• Waiting for approval: this state is reached when the license request
is generated. In this state, the requested options/additional
options are granted during 5 days.
• Licensed: This state is reached after having successfully activated
the visionCATS installation, which grants the requested clients,
edition, options, additional options and instruments permanently.
• Not licensed: This state is reached when the evaluation period or
the waiting for approval period is expired. In this state, all the
features of visionCATS are disabled except the licensing part.
Activation
To activate your visionCATS installation:
• Open <Options> <Request License Key (new installation)> or <View
License> (in case of an upgrade) <Introduction> and read the
instructions if you don’t know them.
• Go to the <Registration> tab and fill or update the corresponding
fields.
10
visionCATS
Your local CAMAG distributor will either scan the QR code or validate
the license directly. If you have to send him/her the validation link,
simply click on the <Copy link to clipboard button> and paste the link
in your preferred email or messaging software.
• Your CAMAG distributor will validate the request and give the
serial number and license key to you. Go to the <License key
validation> tab, fill the serial number and the license key, and
click on the <Activate> button.
Upgrades
When upgrading the visionCATS Server (by reinstalling visionCATS in a
newer version), you keep the granted features/instruments (or the
equivalent ones if editions/options have changed between the versions).
But you need to re-activate your existing license. However, you will need
a new license key if:
• You want to connect more visionCATS clients than the amount of
clients granted by your current license,
• You want to use new CAMAG instruments, options and/or
additional options,
• You have restored a backup on another machine.
12
visionCATS
Generate validation link button and confirm. This generates the
validation link.
Contrary to the normal activation, for the upgrade, the activation can
be done directly by the customer (the distributor is not involved).
You can validate the license directly or use the QR code to access
Internet via a cell phone if needed.
• The validation button or the QR code will send you to a to special page
of the CAMAG Licensing website (no login needed):
• Click on the <Validate license request> button, and you will see your
new license key:
13
visionCATS
• In visionCATS, go to the <License key validation> tab, fill the license key
(the serial number remains the same), and click on the <Activate>
button.
3.5 Backup
Your visionCATS data is stored in a database and in a set of folders (for
example for pictures taken with a TLC Visualizer/TLC Visualizer 2, TLC
Scanner 3/4 profiles and spectrum data), under the image location path
configured during the installation procedure. A backup strategy needs
to be chosen in order to prevent any unwanted data loss. Depending
on your situation, you may want or be required to rely on a global
backup solution provided by your IT department, such as automatic
backups of entire machines. Or, you may want to perform specific
backups of visionCATS data, in which case you can use the visionCATS
Backup Tool located in the server’s installation directory. The backup
process generates a dump file (or folder) of all data (database and
image folder). With the manual restore process, it is possible to restore
the whole data. The backup data file has to be stored in a safe place
14
visionCATS
15
visionCATS
The backups will be done by using the Local System account. Network
drives won’t be accessible. Please check that this account has access to
the specified folder.
• Close the tool or go back to start screen when the status bar has
reached 100%. All your visionCATS data is now safe.
Scheduling backup
• Start the [Link] in the visionCATS folder.
16
visionCATS
• Choose <Schedule Assistant>
Automatic backup
17
visionCATS
The backups will be done by using the Local System account (account
user by the visionCATS server by default). Your current user account
often doesn’t have the same rights, that’s why a check of the folder is
automatically done by the server itself to indicate whether the desired
destination folder is valid or not.
Go to “Computer Management”
18
visionCATS
19
visionCATS
Specify the path were the backup has to be stored
Note:
As network share drive mapping (mapped network drive letter) is user
specific, it will not work for the backup, therefore the UNC (Universal
Naming Convention) address should be used instead!
The UNC syntax for Windows systems has the following generic form:
\\ComputerName\ShardedFolder\Resource
20
visionCATS
21
visionCATS
22
visionCATS
Enter the machine where the backup is performed (in this example
CMVISIONTEST01)
23
visionCATS
Click “OK“
After the restart of the backup tool, the backup should be possible:
25
visionCATS
3.6 Restore procedure
It’s now possible to restore backups coming from previous versions of
visionCATS. In this case the Backup Tool will display the same messages
as the one during the migration when installing.
• Start the backup program “[Link]” in the
visionCATS installation folder
• Choose “Restore Assistant”
• Click on “Next”
• Choose the last backup file (or the backup folder when using
plain folder backup)
27
visionCATS
5.1 Troubleshooting
Cables are the most common sources of trouble with external devices.
Check the following:
• USB cable is properly inserted at both ends?
• Computer and instrument power is ON?
• Computer is not in Sleep or Standby?
• If a USB Hub is used, be sure it is set for “Self-Powered” operation
• If a USB Hub is used, be sure all cables are properly inserted
• If all the above are OK, the Yellow LED should be lit, indicating
the device has been recognized by the USB subsystem
Installation procedure:
• In the Baumer Camera Directory choose the sub directory
appropriate to the instrument and current operation system.
Double click the “bdriver_usbxx.msi” file and follow the
instructions on screen
6.2 FireWire Camera for TLC Visualizer
If a TLC Visualizer is connected to the computer, the Baumer-specific
driver for the FireWire card (OHCI driver) has to be installed as well
as the Camera driver.
If the drivers are not the correct versions, CAMAG cannot guarantee
correct function of the camera.
28
visionCATS
• Choose “ choose from a list of driver”
• Make sure the compatible hardware checkbox is active
• Use “have Disc” to search the visionCATS disc
• Choose your format (x64 for 64 bit, x86 for 32bit)
• Choose OHCI
• Choose the respective chip set
If the chip set used in the FireWire card is not listed, do not try to
install another driver. Change the FireWire card to a product with a
supported chip set
29
visionCATS
You can find the relevant firmware version and update program on
the visionCATS installation disc under “Instrument Firmware”
• To update the firmware of a CAMAG instrument:
• Shut down visionCATS
• Put the visionCATS DVD into the DVD drive of the computer
• Start the file [Link]
• Press the reset button on your instrument keypad and observe the
30
visionCATS
LCD display. During the first few seconds of the initialization the
instrument display will show the actual firmware version. Check
if the new firmware version is displayed
31
visionCATS
8 End user license information
Please read the terms and conditions of this license agreement carefully before
continuing with the installation of this program.
32
visionCATS
EULA.
(e) Compliance with Applicable Laws
You must comply with all applicable laws regarding use of the CAMAG TLC Software
visionCATS.
3. TERMINATION
Without prejudice to any other rights, CAMAG Muttenz/Switzerland may
terminate this EULA if you fail to comply with the terms and conditions of this EULA.
In such event, you must destroy all copies of the CAMAG TLC Software visionCATS
in your possession.
4. COPYRIGHT
All title, including but not limited to copyrights, in and to the CAMAG TLC Software
visionCATS and any copies thereof are owned by CAMAG Muttenz/Switzerland or
its suppliers. All title and intellectual property rights in and to the content which
may be accessed through use of the CAMAG TLC Software visionCATS is the
property of the respective content owner and may be protected by applicable
copyright or other intellectual property laws and treaties. This EULA grants you no
rights to use such content. All rights not expressly granted are reserved by CAMAG
Muttenz/Switzerland.
5. WARRANTIES
The CAMAG TLC Software visionCATS is provided 'As Is' without any express or
implied warranty of any kind, including but not limited to any warranties of
merchantability, noninfringement, or fitness of a particular purpose. CAMAG
Muttenz/Switzerland does not warrant or assume responsibility for the accuracy or
completeness of any information, text, graphics, links or other items contained
within the CAMAG TLC Software visionCATS. CAMAG Muttenz/Switzerland
makes no warranties respecting any harm that may be caused by the transmission
of a computer virus, worm, time bomb, logic bomb, or other such computer
program. CAMAG will grant the corresponding warranty services as outlined in the
Warranty Statement for the warranty period free of charge. On expiration of this
warranty period you may purchase any new revisions of the software for a reduced
price including a new warranty period.
6. LIMITATION OF LIABILITY
In no event shall CAMAG be liable for any damages (including, without limitation, lost
profits, business interruption, or lost information) rising out of 'Authorized Users'
use of or inability to use the CAMAG TLC Software visionCATS, even if CAMAG
has been advised of the possibility of such damages. In no event will CAMAG be
liable for loss of data or for indirect, special, incidental, consequential (including lost
profit), or other damages based in contract, tort or otherwise. CAMAG shall have
no liability with respect to the content of the CAMAG TLC Software visionCATS or
any part thereof, including but not limited to errors or omissions contained therein,
libel, infringements of rights of publicity, privacy, trademark rights, business
interruption, personal injury, loss of privacy, moral rights or the disclosure of
confidential information.
33
visionCATS
CAMAG Scientific Inc. (USA) · 515 Cornelius Harnett Drive · Wilmington, NC 28401
Telephone 800 334 3909 · Fax 910 343 1834 · E-Mail: tlc@[Link]
[Link]
34