Mettler Toledo PipetteXThis document provides Installation guide

Category
Database software
Type
Installation guide
PipetteX
v3.0
Installation Instructions
2/23/2021 7:14 AM- Schema ST4 PDF engine -Layout by Victor Mahler
PipetteX
Table of Contents
1 Introduction 3
1.1 Audience..................................................................................................................... 3
1.2 Purpose of this Document............................................................................................. 3
1.3 Related Documents...................................................................................................... 3
1.4 End User License Agreement (EULA) and disclaimer ........................................................ 3
1.5 Use of third party licenses............................................................................................. 3
2 PipetteX System Overview 4
3 Preparing the System Installation 6
3.1 System Requirements................................................................................................... 6
3.1.1 Computer ..................................................................................................... 6
3.1.2 Supported Operating Systems ......................................................................... 7
3.1.3 Supported SQL Servers................................................................................... 7
3.1.4 Additional Requirements ................................................................................ 7
3.1.5 Additional Software installed........................................................................... 7
3.1.6 Readers ....................................................................................................... 7
3.1.7 Balances and Gateway .................................................................................. 8
3.1.8 Virtualized Environments................................................................................ 8
3.1.9 Supported Languages.................................................................................... 9
3.2 Pipettes ...................................................................................................................... 9
3.3 Pipette verification........................................................................................................ 10
3.3.1 Balances...................................................................................................... 10
3.3.2 SmartCheck.................................................................................................. 10
3.3.3 Smart tags ................................................................................................... 11
3.3.4 Method Cards ............................................................................................... 11
3.4 System Backup............................................................................................................ 11
4 Installation of PipetteX Software 12
4.1 Standalone system....................................................................................................... 14
4.1.1 Supporting Information .................................................................................. 18
4.1.2 Installation Checker ....................................................................................... 19
4.1.3 Installation on x86 Systems ........................................................................... 19
4.1.4 Troubleshooting ............................................................................................ 19
4.2 Distributed system ....................................................................................................... 20
4.2.1 SQL Server Instance Installation ...................................................................... 21
4.2.1.1 Supporting Information............................................................................. 23
4.2.2 Business Server Installation............................................................................ 23
4.2.2.1 Supporting Information............................................................................. 29
4.2.3 Database Maintenance Tool Installation in Database Server (Optional)................ 30
4.2.4 Client Component Installation ......................................................................... 34
4.2.4.1 Supporting Information............................................................................. 37
4.2.5 Installation Checker ....................................................................................... 37
4.3 Updating an existing EasyDirect PAM Installation (v1.0 / v1.1 to v3.0.x) ........................... 38
4.4 Updating EasyDirect PAM Installation (v2.x to v3.0.x) ..................................................... 38
4.5 Logging in for the first time............................................................................................ 38
5 Separate Driver Installations 40
5.1 USB Drivers................................................................................................................. 40
5.1.1 SmartStand .................................................................................................. 40
5.1.2 EasyScan Flex .............................................................................................. 40
5.1.3 BT Dongle .................................................................................................... 40
5.1.4 Silex Gateway............................................................................................... 40
5.1.5 SmartCheck.................................................................................................. 41
5.1.6 EasyScan USB .............................................................................................. 41
6 License activation and management 42
6.1 License management ................................................................................................... 42
6.2 License types .............................................................................................................. 42
6.2.1 License editions ............................................................................................ 42
Table of Contents 1PipetteX
6.2.2 First time vs renewal license........................................................................... 43
6.2.3 Distributed vs standalone............................................................................... 43
6.2.4 Upgrading or downgrading license editions...................................................... 43
6.2.5 Combining or reassigning licenses.................................................................. 45
6.3 How to access the (re)activation process?...................................................................... 45
6.4 License activation during first time installation................................................................. 46
6.4.1 Activating a License using Automatic method ................................................... 46
6.4.2 Activating a License using Manual method....................................................... 50
6.5 License renewal........................................................................................................... 55
6.5.1 License renewal using Automatic method......................................................... 55
6.5.2 License renewal using Manual method ............................................................ 59
6.6 Errors and solutions..................................................................................................... 65
7 Known behavior 67
7.1 RFID Reader not detected.............................................................................................. 67
7.2 EasyScan Flex Reader not detected ................................................................................ 67
7.3 SQL Server Installation Issues........................................................................................ 67
7.4 Font Style for Non-English Manual ................................................................................. 67
Table of Contents2 PipetteX
Introduction 3PipetteX
1 Introduction
1.1 Audience
This document is intended for users who are responsible for running system administration operations. We
recommend that only persons with the necessary knowledge and corresponding training perform the system
installation.
Please read this manual thoroughly and carefully before starting installation of PipetteX. Make sure, you are
familiar with all components within the system. It is particularly important that you are familiar with the
database tools and hardware components.
1.2 Purpose of this Document
This document provides installation and maintenance information for PipetteX. We recommend that prior to
installation, upgrade or maintenance of the software you read the related chapters in this document.
1.3 Related Documents
For more information please visit http://www.mt.com/rainin-sstanddocs. Here you will find more tutorials and
other documentation or videos.
https://www.mt.com/rainin-sstanddocs
https://www.mt.com/smartcheck
https://www.mt.com/dam/P5/labtec/13_Accessories/Pipette_calibration/03_Documentation/
INI_EasyScan_USB_en.pdf
https://www.mt.com/my/en/home/products/Laboratory_Weighing_Solutions/Accessories/weighing-
peripheral/30416173.html
https://www.mt.com/my/en/home/products/Laboratory_Weighing_Solutions/Accessories/weighing-
peripheral/30215407_EasyScan_Flex.html
1.4 End User License Agreement (EULA) and disclaimer
The applicable EULA agreement, which has to be accepted upon installing PipetteX, can be found on http://
www.mt.com/eula. The applicable disclaimer is part of the EULA and can be found under section 5 Warranties
and disclaimer.
http://www.mt.com/eula
1.5 Use of third party licenses
PipetteX does use standard components from third parties. An overview of third party licenses can be found on
http://www.mt.com/licenses.
http://www.mt.com/licenses
PipetteX System Overview4 PipetteX
2 PipetteX System Overview
PipetteX can be installed within your organization either as standalone or as a distributed system. When
installed as a distributed system, all the asset details are stored in a centralized location (database) and all the
PipetteX clients available in the network can view and share all the assets.
PipetteX software consists of four main components:
Client UI Application (User Interface Component)
Background Application (Windows Service Component)
Business Server (Windows Service Components for Business Server, SmartCheck, Silex Virtual Link Lite &
Audit Trail)
Database Server (Microsoft SQL Server)
PipetteX
Client application
The Client application is the main interface through which you can view the assets and other instruments
connected to your PC. You can configure the way PipetteX behaves using this application.
Background application
The background application resides with the client application on your PC and automatically runs even when
the PC is not logged in. The status will be indicated with an in the Windows taskbar. The background appli-
cation maintains the connection to the RFID readers and to the database through the Business Server. It logs
data received from the connected readers regardless of whether you are logged in or not.
PipetteX System Overview 5PipetteX
To view data stored in the database, Client application has to be started and depending on your user rights,
information can be looked at. The collected data are shown in different views and tables.
Dashboard
Assets
Balances - XSE/XPE balances & SmartChecks
Readers – Readers, Method Cards & Gateways
Method, Test Plan & Audit Trail
Address & User Management
Settings
Business Server
Business Server runs automatically in the background when the PC is running. This component runs either on
the same PC (Standalone) or on a different PC (Distributed system). Components of "PipetteX Audit service" &
"PipetteX SmartCheck Service" are installed along with the Business Server. Business Server acts as a broker/
bridge between the database server and the Client applications installed across the network.
Business Server periodically connects to the METTLER TOLEDO Rainin server and retrieves
new pipette models available in the market,
certificates of pipettes for which service/calibration is done through METTLER TOLEDO Rainin along with
other details.
Business Server also validates your license subscriptions.
Preparing the System Installation6 PipetteX
3 Preparing the System Installation
3.1 System Requirements
PipetteX can be installed either as a Standalone system, where all the components along with the database
are available on the same PC or as a Distributed system, where each components resides on a different PC.
PipetteX clients can be installed in multiple PCs connected to a Business Server.
3.1.1 Computer
The following tables show the minimal and the optimal hardware requirements for running PipetteX. However,
the hardware requirements depend heavily on the number of connected readers / type of readers and the
operating rate of the readers along with the network capabilities.
If the CPU supports Hyper Threading, you can double the available cores when calculating the hardware
requirements. A Dual Core CPU would therefore be counted as a Quad Core.
Database Server
Computer Minimum Optimum
CPU 2 GHz Dual Core 3 GHz Quad Core
RAM 16 GB 32 GB
Display Resolution 1280 × 800 1280 × 1024
Hard Disk 50 GB free space 100 GB free space
Operating System Windows Server 2016 Windows Server 2019
SQL Server MS SQL Server 2012 SP4 MS SQL Server 2019
PipetteX Business Server
Computer Minimum Optimum
CPU 2 GHz - Active users / Core 3 GHz - Active users / Core
RAM 16 GB 32 GB
Display Resolution 1280 × 800 1280 × 1024
Hard Disk 10 GB free space 20 GB free space
Operating System Windows Server 2016 Windows Server 2019
Installed Components Business Service, Audit Service,
SmartCheck Service
Business Service, Audit Service,
SmartCheck Service
PipetteX Client
Computer Minimum Optimum
CPU 2 GHz Dual Core 3 GHz Quad Core
RAM 8 GB 16 GB
Display Resolution 1280 × 800 1920 × 1080
Hard Disk 20 GB free space 40 GB free space
Operating System Windows 10 Windows 10
Installed Components PC Client, Instrument Service PC Client, Instrument Service
For Distributed systems, we recommend installing the Business Server on a PC/Server hardware that is always
on, as it will be constantly polling the METTLER TOLEDO Rainin server to synchronize asset and service data.
Preparing the System Installation 7PipetteX
3.1.2 Supported Operating Systems
The following list shows the supported operating systems of PipetteX.
Operating systems
Service Pack Editions 32bit 64bit
Windows 10* 1909 Customer, Business, Education
Windows 10* 1809 Long Term Service Channel LTSB
Windows Server 2016 Essential, Datacenter, Standard
Windows Server 2019 Essential, Datacenter, Standard
*Windows 7 and 8.1 are not officially supported.
3.1.3 Supported SQL Servers
PipetteX will install an instance of Microsoft SQL Server 2019 Express Edition to create database if your PC
does not contain an Instance "PipetteX".
The users can also connect to an already existing Microsoft SQL Server. Details on how to connect to an
existing database server is listed under the Distributed system section.
The following list shows the supported SQL Servers of PipetteX.
SQL Servers
Service Pack Editions 32bit 64bit
SQL Server 2012 SP4 Standard, Enterprise & Express
SQL Server 2014 SP3 Standard, Enterprise & Express
SQL Server 2016 SP2 Standard, Enterprise & Express
SQL Server 2017 Standard, Enterprise & Express
SQL Server 2019 Standard, Enterprise & Express
3.1.4 Additional Requirements
You need to disable "Hibernate" and or "Standby" option of your PC running Business server, as PipetteX does
not support "Hibernate" and "Standby" mode. You will find more information, on how to deactivate the
"Hibernate" and "Standby" mode under: http://support.microsoft.com/kb/920730/en
3.1.5 Additional Software installed
The following third party software is required by PipetteX to run. The installation will install the necessary
components automatically.
Additional Software
Name Version Installed by PipetteX
.Net Framework 4.7.2
SQL Server Express 2019 2019
Note
The MSMQ feature will be turned on by the PipetteX installer.
3.1.6 Readers
PipetteX supports the following RFID Readers with the corresponding configuration. The Readers have to fulfill
the requirements to operate with PipetteX.
RFID Reader Devices
Firmware USB Serial Ethernet Bluetooth
SmartStand 1.0.0.13 •*)
EasyScan USB 1.1.0.1 0.0.0.0.0 •*)
RFID Reader (Legacy) --
FlexScan Reader 1.01 0.0.0.0.0
Preparing the System Installation8 PipetteX
*) Driver installation required (Creating Virtual COM)
3.1.7 Balances and Gateway
PipetteX supports the following instruments with the corresponding configuration. The instruments have to fulfill
the requirements to operate with PipetteX.
Devices
Firmware USB Serial Ethernet Bluetooth
XPE Balance 2.20
XSE Balance 2.21
SmartCheck 2.0.3
+
Silex Gateway 1.4.0
+
Communication via USB as well as through Gateway
3.1.8 Virtualized Environments
Readers supported by PipetteX are not tested in virtualized environments. However, if rules are followed on how
to connect/redirect USB/Bluetooth devices in such an environment PipetteX is supposed to run. Please note that
if the Business server is installed on a virtual environment, then unless it runs, Business server will not be able
to connect to METTLER TOLEDO Rainin Server and retrieve any asset details.
Virtualization
Software
PipetteX Installation Device Connection
& Data Transfer
Comments
Standalone Distributed
Oracle : Virtual Box Verified Verified Verified Use the built-in port forward
option in VBox. Refer short
setup instructions below,
Microsoft : Hyper-V
Manager
Verified Verified Not verified Use of 3rd Party tools like the
one specified below will allow
us to connect with supported
devices in virtualized
environments, https://
www.virtual-serial-port.org/
articles/com-port-in-virtual-
machine/
VMWare :
Workstation
Not verified Not verified Not verified Use of 3rd Party tools like the
one specified below will allow
us to connect with supported
devices in virtualized
environments, https://
www.virtual-serial-port.org/
articles/com-port-in-virtual-
machine/
Oracle Virtual Box Settings – COM Port Forward
Make sure Virtual Box extension pack is installed/enabled
1 Plug in the devices, EasyScan USB or SmartCheck in the Host Server, where Virtual Box was installed.
System will list the ports in the device manager of Host Server
2 Launch the virtual environment with supported operating system.
Preparing the System Installation 9PipetteX
3 From Settings tab, Navigate to USB section and add the relevant port.
When tray service is running in the virtual environment. Pipette system will display the auto detect popup to
add the devices to the application.
3.1.9 Supported Languages
PipetteX and SmartStands support their individual list of languages. Mixed languages do not harm the overall
system from its intended operation. The following languages are supported:
Languages
Language PipetteX SmartStand XPE/XSE
English
German
French
Spanish
Portuguese
Japanese
Korean
Chinese (simplified)
Chinese (traditional)
3.2 Pipettes
PipetteX supports Rainin RFID pipettes (manual, electronic, single/multichannel, repeaters) as well as non-RFID
pipettes (any brand).
Preparing the System Installation10 PipetteX
3.3 Pipette verification
3.3.1 Balances
PipetteX supports retrieving routine test reports from XPE and XSE balances connected through network. Support
for a RS232/Serial connection directly from the balance is not available. Please refer to the table below to set
yourself up for a QuickCheck verification station.
XPE analytical balance XPR analytical balance*
Balance**
≤10ul 30105893 XPE26 (0.0015mg)
30105897 XPE26DR
(0.01-0.005mg)
30355476 XPR26 (0.001mg)
30355530 XPR26DR
(0.01-0.001mg)
>10-10’000ul 30087653 XPE205 (0.01mg)
30087700 XPE205DR
(0.1-0.01mg)
30355411 XPR205 (0.01mg)
30355415 XPR205DR
(0.1-0.01mg)
Cables and accessories
USB-RS232 Converter cable
incl f/f converter
30364315 N/A
Optional LAN port for balance 11132515 N/A
Evaporation trap
SmartCheck trap 50 mL
(for XPE/R205)
30215436 30215436
Evaporation trap 10mL
(for XPE/R26)
11140041 11140041
RFID reader (desktop model)
EasyScan Flex Reader RS232 30215407 N/A
EasyScan Flex Reader USB N/A 30416173
RFID tags / cards
Smart Tag RFID labels 50pcs 30101517 30101517
Smart Tag RFID labels 200pcs 30101518 30101518
Method Card 5pcs 30300929 30300929
Method Card 25pcs 30300930 30300930
* Available from 2021 onwards. Please check on feature availability in your country. No rights can be obtained
from this document.
** Balance recommendation according to ISO8655-6 2002(E), section 4.1
3.3.2 SmartCheck
The SmartCheck is an easy to use pipette verification instrument. Per default, it will measure to 5% tolerance.
Hooking it up to PipetteX allows you to do several things.
Connected via USB (standalone case):
You connect a SmartCheck to perform any of the 2 actions below. Afterwards, you place the SmartCheck back
on the bench without it being connected to PipetteX.
Update the tolerance of the SmartCheck (change it to any value between 3-10%).
Update the firmware of the SmartCheck.
Connected via USB (connected case):
You connect a SmartCheck to a PC that has PipetteX on it and leave it connected via USB. Apart from the above
mentioned cases, you now are able to:
Start the Pipette Verification from PipetteX and measure against pipette specific tolerances. Get the verifi-
cation report automatically assigned to the document history of the pipette (only for the paid license)
Preparing the System Installation 11PipetteX
Together with an EasyScan Flex USB reader turn any PC into an automated pipette verification station. Hold
an RFID enabled pipette over the reader, have the SmartCheck set itself to the correct tolerance for the
pipette, check the pipette and have the report automatically captured in the Software (without having to
touch the software)
Connected via a USB-LAN gateway (autonomous case):
Automate your pipette verification process w/o the need for a PC at the bench. Hookup a SmartCheck and an
EasyScan LAN reader to your network and verify any pipette w/o the need for touching the PipetteX software. For
this you will need to install the Silex Gateway in your network environment.
3.3.3 Smart tags
PipetteX supports Smart tags to be affixed to non-RFID pipettes (both Rainin and non-Rainin) to simulate the
pipette to behave like a RFID pipette.
3.3.4 Method Cards
PipetteX supports Rainin Method Cards for the usage in conjunction with non-RFID pipettes to store Routine test
method parameters.
3.4 System Backup
You are solely responsible for an adequate backup mechanism of all aspects of PipetteX. Important is to have a
backup of the SQL database.
PipetteX does have a simple database utility that comes pre-installed. Read more about this in the manual,
which can be found on
http://www.mt.com/rainin-sstanddocs
Installation of PipetteX Software12 PipetteX
4 Installation of PipetteX Software
PipetteX can be installed as a Standalone System where all the components are installed and made available
in the same PC or as a Distributed System where every component can be installed in different PC based on
your requirement.
You need to run the PipetteX installation PipetteX Setup.exe as an administrator.
Installation will first check for pre-requisites and try to install all the required and missing 3
rd
-party components
and Windows services which are necessary for PipetteX to run. The wizard will inform you about system
restart(s) if any of the mandatory pre-requisite is not available and ask user confirmation (refer screenshot
below) to proceed with the installation.
No pre-requisites are available MSMQ not enabled
* Similarly message content will list only .Net component, if .Net version alone not available.
If the PC hardware or Server does not have .Net 4.7.2 installed, then PipetteX will install the component and
ask the user to do the PC restart to proceed. Make a note of it while installing .Net 4.7.2 in an active server
which also handles other software applications.
After the pre-requisites have been installed, the installation starts automatically. In case of the installation does
not start automatically (after a restart), please run the setup again.
Installation of PipetteX Software 13PipetteX
You will be welcomed with the following wizard to start installing PipetteX.
And then with the EULA information which you need to go through and accept in order to install PipetteX.
Installation of PipetteX Software14 PipetteX
Once accepted, you can select the type of system (Standalone or Distributed) you wish to have.
Where choosing Standalone system, lets you install all the components on to the same PC and make you self-
sustained and choosing Distributed system, lets you spawn across the network.
4.1 Standalone system
Standalone system lets you install all the components on to the same PC. On clicking next, installation will then
proceed to install the SQL Server and other components including drivers as shown below:
Installation of PipetteX Software 15PipetteX
If your PC has "PipetteX" SQL Server instance already installed, then the installation will not create an instance
for PipetteX. All the components (Business Server, Client…) are installed on to the same PC.
On installation, associated data and log files will be created and updated in C:\Program Files (x86)\METTLER
TOLEDO\PipetteX.
Installation starts with enabling MSMQ (if not enabled already). The wizard starts with Installation of SQL
Instance, PipetteX.
Installation of PipetteX Software16 PipetteX
After SQL instance creation MSMQ (Microsoft message queuing) feature in the PC hardware will be enabled by
the installation wizard, if not enabled already.
Installation of PipetteX Software 17PipetteX
Continue with new database creation.
Once all components got installed, PipetteX services will get started.
Installation of PipetteX Software18 PipetteX
After successful installation, please restart your PC (if prompted). If this is not possible you can skip this step.
4.1.1 Supporting Information
Make sure the listed components below are available after successful installation. You can find services by
typing in “services” in the windows search bar.
Services
PipetteX Business Service
PipetteX SmartCheck Service
PipetteX Audit Service
PipetteX Instrument Service
SQL Server (PIPETTEX)
*Services run using Logon As user, Network Service.
Firewall Ports
Control Panel\All Control Panel Items\Windows Firewall --> Advanced Settings
Inbound Rule
PipetteX Business Service Discovery_IN (UDP) - 3702
PipetteX Business Service_IN (TCP) - 58889
PipetteX SmartCheck Service_IN (TCP) - 58890
PipetteX Instrument Service_IN (TCP) - 58888
Outbound Rule
PipetteX Business Service Discovery_OUT (UDP) - 3702
PipetteX Business Service_OUT (TCP) - 58889
PipetteX SmartCheck Service_OUT (TCP) - 58890
PipetteX Instrument Service_OUT (TCP) - 58888
*Default firewall ports are added during the installation.
Message Queue
Control Panel\System and Security\Administrative Tools --> Computer Management --> Services and Appli-
cations --> Mes-sage Queuing --> Private Queues --> pamactivitylog
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72

Mettler Toledo PipetteXThis document provides Installation guide

Category
Database software
Type
Installation guide

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI