match it! dna v1.2 software installation software... · 2015. 2. 5. · page 3 of 42 lc1491.1...
TRANSCRIPT
MATCH IT! DNA v1.2
Software Installation
Table of Contents
1.0 Table of Contents…………………………………..…1
2.0 Revisions………………………………………………...2
3.0 Installation Checklist…………………………….….3
4.0 Installation Workflow & Installation Steps....6
5.0 Post-installation Steps………………………….…27
6.0 Appendix A Trouble Shooting…………………...31
7.0 Appendix B Database Configurations………...37
Page 2 of 42 LC1491.1 (02/15)
2.0 Revisions
Date Author Revision Description
11/20/14 J. Cherry-Woods 0 Creation
02/05/15 J. Cherry-Woods 1 CR11614, CR12077
Page 3 of 42 LC1491.1 (02/15)
3.0 Installation Checklist
Prior to installing MATCH IT! DNA v1.2 determine the following:
1. Verify the following:
Confirm the computer has 4GB of RAM.
Confirm user has full administrative rights on the computer.
2. Verify Installation Scenario – Check off the scenario that applies.
If the database is going on the local computer go to 2a (Local Installation).
If the database is going on a SQL server or a dedicated desktop computer go to 2b (Client Installation).
a. Local Installation (database on the local computer)
New Local Install Do you meet the scenario below? If yes, proceed to Section 4.0
Software Installation on page 6. MATCH IT! DNA is not installed
MATCH IT! Antibody is not installed MATCH IT! database does not exist
Upgrade Local Install
Do you meet the scenario below? If yes, proceed to step 3. MATCH IT! DNA is not installed MATCH IT! Antibody is installed
MATCH IT! database is on local PC
Upgrade Local Install Do you meet the scenario below? If yes, proceed to step 3.
MATCH IT! DNA 1.1 SP5 or higher is installed MATCH IT! Antibody is not installed
MATCH IT! database is on local PC
Upgrade Local Install
Do you meet the scenario below? If yes, proceed to step 3. MATCH IT! DNA 1.1 SP5 or higher is installed
MATCH IT! Antibody 1.2 is installed MATCH IT! database is on local PC
Page 4 of 42 LC1491.1 (02/15)
b. Client Installation (database on a dedicated desktop or a server)
New Client Install
Do you meet the scenario below? If yes, proceed to step 4. MATCH IT! DNA is not installed
MATCH IT! AB is not installed MATCH IT! database is on a server or a dedicated desktop
Upgrade Client Install Do you meet the scenario below? If yes, proceed to step 3.
MATCH IT! DNA is not installed MATCH IT! Antibody is installed
MATCH IT! database is on a server or a dedicated desktop
Upgrade Client Install Do you meet the scenario below? If yes, proceed to step 3. MATCH IT! DNA 1.1 SP5 or higher is installed
MATCH IT! AB is not installed MATCH IT! database is on a server or a dedicated desktop
Upgrade Client Install
Do you meet the scenario below? If yes, proceed to step 3. MATCH IT! DNA 1.1 SP5 or higher is installed
MATCH IT! Antibody is installed MATCH IT! database is on a server or a dedicated desktop
3. Upgrades Only: Verify minimum requirements are meet for upgrade installations:
Confirm existing DNA Allele Database is at 3.16.
To upgrade to 3.16, navigate to WWW.IMMUCOR.COM/LIFECODES
for download and instructions. If MATCH IT! Antibody is already installed on the target computer,
confirm MATCH IT! Antibody version v1.2 is installed. (Please see Instructions (LC1459.2) for details. Navigate to
WWW.IMMUCOR.COM/LIFECODES for download.
Confirm MATCH IT! DNA 1.1 SP5 or higher is installed. To upgrade, navigate to
WWW.IMMUCOR.COM/LIFECODES for download.
Page 5 of 42 LC1491.1 (02/15)
Remove all old MATCH IT! DNA short-cuts associated
with the previous MATCH IT! version prior to upgrading. Shortcuts should be manually deleted from the desktop
and Start menu.
If multiple client computers are connected to the same MATCH IT! database, make sure users on all clients computers close the MATCH IT! DNA software prior to doing any upgrades.
(Optional) Create a backup of the MATCH IT! DNA
database if this is an upgrade installation. This can be done through Database Management.
4. Decide which database configuration is required. Refer to Appendix B.
i. Server based – pg37 ii. Dedicated workstation – pg39 iii. Luminex system – pg41
5. Decide whether the Autobatch setup feature is going to be used in MATCH
IT!? If yes, please see instructions LC1509 LIFECODES Services Installation. Navigate to WWW.IMMUCOR.COM/LIFECODES for download.
Page 6 of 42 LC1491.1 (02/15)
DNA 1.2 Installation Workflow
Page 7 of 42 LC1491.1 (02/15)
4.0 Software Installation Steps
1. Insert the Installation CD into the CD Player on the target computer.
Open the CD from My Computer. Upgrades
Right click on Setup.exe and select Run as administrator. Please note: If using non-US regional settings, confirm database is at 3.16 and use DNA Setup.exe
New installs Right Click DNA Setup.exe and select Run as administrator.
Please note: There may be a delay for some computers.
During the installation process a Command Prompt window may display. Please ignore this window and complete the installation process.
2. Depending on the system, a User Account Control window may display. Click Yes
Page 8 of 42 LC1491.1 (02/15)
3. Allele Database Version Checks
Depending on the system configuration, one of the following “Allele Database Version Check” messages may display.
If this is an upgrade go to step 3a.
If this a new install go to step 3b. a. Upgrades
When DNA Allele database is at 3.16. Click Begin Installation.
Proceed to step 4.
Warning: If the DNA Allele database is not at 3.16, a warning message is displayed and installation will not continue. Click Cancel
Installation
To upgrade the Allele database to 3.16, navigate to
WWW.IMMUCOR.COM/LIFECODES for download and instructions. After a successful database update to 3.16, restart the installation process.
b. New Installs
Click Begin Installation. Proceed to step 5.
Page 9 of 42 LC1491.1 (02/15)
4. Uninstalling MATCH IT! DNA v1.1 SP5. (Upgrades Only)
If this is an upgrade install, a message may display requesting to remove previous versions of MATCH IT! DNA- Click Yes
If this message does not appear proceed to step 5.
Once the uninstall is complete- Click Finish
5. MATCH IT! DNA - InstallShield Wizard- Click Install
Please note: depending on the target computer configuration not all of
the requirements in the screen shot will be listed.
Note: Your computer may automatically reboot at this time.
Page 10 of 42 LC1491.1 (02/15)
a. After clicking Install, the installation process may ask if SQL Server 2008
should be installed.
i. Click Yes if this is a New install of MATCH IT! DNA v1.2 (Where
SQL Server 2008 R2 is not installed on the target computer)
ii. Click No if this is a Client install or an Upgrade (Where SQL
Server 2008 R2 is already installed on the target computer or if connecting to a server or dedicated desktop having SQL Server
2008.)
b. The installation may ask if Microsoft SQL Server System CLR Types should be installed. This is required. Click „Yes‟ for all install types.
c. The installation may ask if Microsoft SQL Server 2008 Management
Objects should be installed. This is required. Click „Yes‟ for all install types.
d. If any of the Microsoft SQL 2012 prerequisites fail installation, click Yes to continue.
Note: Your computer may automatically reboot at this time.
Page 11 of 42 LC1491.1 (02/15)
6. Begin the MATCH IT! System Installation – Click Next
7. Accept the license agreement- Click Next.
Page 12 of 42 LC1491.1 (02/15)
8. Database Server Connection:
Reconfirm which Install scenario was selected on the check list. If this is a New Local Install, proceed to step 8a.
If this is an Upgrade Local Install, Upgrade Client Install or New Client Install, proceed to step 8b.
a. New Local Install
i. Make sure “I do not want to configure the MatchIT database”
is not checked (unchecked). ii. Make sure “Server authentication using the Login ID and
password” under Connecting using is selected. iii. Enter Login credentials
Login ID: sa
Password: GenProbeS@L iv. Click Next
v. Proceed to step 9.
Page 13 of 42 LC1491.1 (02/15)
b. Upgrade Local Install, Upgrade Client Install or New Client Install
i. Check the “I do not want to configure the MATCHIT database”
– this will allow the installation to continue without creating a database on the system.
ii. Click Next
The below message may be displayed if the install is an Upgrade Client Install or New Client Install.
Click OK
iii. Proceed to step 9.
Page 14 of 42 LC1491.1 (02/15)
9. Begin Installation – Click Install.
Click Finish
Page 15 of 42 LC1491.1 (02/15)
Verify Network Configuration is enabled -
Start Menu | All Programs | Microsoft SQL Server 2008 |
Configuration Tools | SQL Server Configuration Manager
Once SQL Server Configuration Manager is open select SQL Server Network Configuration Protocols for Evolution
Confirm TCP/IP, Name Pipes and Shared Memory protocols are Enabled. If not, right click on the Protocol Name and select Enable.
Select SQL Server Services right click SQL Server (Evolution)
Select Restart.
Close SQL Server Configuration Manager
Proceed to step 10.
Page 16 of 42 LC1491.1 (02/15)
10. Database Management update (Applies to Upgrades Only):
From the Installation CD, copy (6 files) all files located in program files\ LIFECODES \Database Management
into the C:\Program Files or Program Files (86x) \LIFECODES\Database Management
11. If a SerologicalEquivalent.dat file exist, it is necessary for each individual user to delete this file prior to opening the software for the first time or
after a software upgrade has been performed. The file can be found in the following locations:
Windows 7: C:\Users\(user id)\AppData\Local
Windows XP: C:\Documents and Settings\(user id)\Local
Settings\Application Data
12. Installation Verification- Verify successful installation or upgrade to
MATCH IT! DNA 1.2. Reconfirm which Install scenario was selected on the check list.
If this is a Local installation go to step 12.a. If this is a Client (database on a server or dedicated desktop) installation
go to step 12.b.
a. Local Installation Verification (database on the local computer)
i. New Local Install Launch software:
Start Menu All Programs LifecodesMatch IT! DNAMATCH IT! DNA
Page 17 of 42 LC1491.1 (02/15)
Click I Agree
Note: On first launch of the MATCH IT! DNA software a message
box may display indicating successful database upgrade. Click OK.
Proceed to step 10.a.iii
ii. Upgrade Local Install
Verify the XMLServerList.xml & XMLLumServerList.xml exist in one of the following file directories:
Windows XP - C:\Documents and Settings\All Users\Application
Data\Lifecodes Windows 7 - C:\Program Data\Lifecodes
(Note: if the Program Data file is hidden do the following:
In Windows Explorer go to Tools | Folder Options. Select View tab. Under Advanced setting: toggle “Show hidden files, folders, or
drives. Select Apply and OK.)
Page 18 of 42 LC1491.1 (02/15)
Launch software:
Start Menu All Programs LifecodesMatch IT! DNAMATCH IT! DNA
End User License Agreement -Click I Agree
Note: On first launch of the MATCH IT! DNA Software a message
box may display indicating successful database upgrade. Click OK.
Proceed to step 10.a.iii
Page 19 of 42 LC1491.1 (02/15)
iii. All Local Installs using Autobatch Setup
If not using the Autobatch feature, proceed to step 13.
If using the Autobatch feature (Lifecodes Services), continue in this
section. When using Autobatch Setup and the Luminex instrument is attached to a different computer do the following:
Open the XMLServerList.xml in notepad (C:\ProgramData\Lifecodes.)
Replace “(local)” with the local computer name and save the file.
Open Database Management
Start Menu All Programs LifecodesMatch IT! DNADatabase Management
Select DNA from the dropdown. Login Name: supervisor Password: lifecodes
Click Login
Page 20 of 42 LC1491.1 (02/15)
Click Choose Server
Under Available Sql Instances, select the
<LocalComputerName>\Evolution instance. Click Connect. Click OK.
Select the appropriate database. Click Connect. Close Database Management
Open MATCH IT! DNA software and confirm successful connection.
Page 21 of 42 LC1491.1 (02/15)
iv. Proceed to step 13.
b. Client Installation Verification (database on a dedicated desktop or a server)
i. New Client Install
Verify the XMLServerList.xml & XMLLumServerList.xml exist in one of
the following file directories: Windows XP - C:\Documents and Settings\All Users\Application
Data\Lifecodes Windows 7 - C:\Program Data\Lifecodes
Verify the dedicated computer or server name is included in the XMLServerList.xml file located:
Windows 7 - C:\Program Data\Lifecodes Windows XP - C:\Documents and Settings\All Users\Application
Data\Lifecodes Open the file in Notepad.
Add the computer name or server name inside the Server tags within
the XMLServerList.xml file and save file.
The XMLServerList.xml file can be used on all client computers connecting to the same database.
(Note: if the Program Data file is hidden do the following:
In Windows Explorer go to Tools | Folder Options. Select View tab. Under Advanced setting: toggle “Show hidden files,
folders, or drives. Select Apply and OK.)
Proceed to step 10.b.iii
Page 22 of 42 LC1491.1 (02/15)
ii. Upgrade Client Install
Verify the XMLServerList.xml & XMLLumServerList exist in one of the following file directories:
Windows XP - C:\Documents and Settings\All Users\Application Data\Lifecodes Windows 7 - C:\Program Data\Lifecodes
Verify the dedicated computer or server name is included in the
XMLServerList.xml file located: Windows 7 - C:\Program Data\Lifecodes
Windows XP - C:\Documents and Settings\All Users\Application Data\Lifecodes
Open the file in Notepad. Add the computer/ server name inside the Server tags within the
XMLServerList.xml file and close and save file.
The XMLServerList.xml file can be used on all client computers
connecting to the same database.
(Note: if the Program Data file is hidden do the following: In Windows Explorer go to Tools | Folder Options. Select View tab.
Under Advanced setting: toggle “Show hidden files, folders, or drives. Select Apply and OK.)
Proceed to step 10.b.iii
Page 23 of 42 LC1491.1 (02/15)
iii. Connect to Database (all client installs)
Open Database Management from the Desktop or
Start Menu All Programs LifecodesMatch IT! DNADatabase Management
Select DNA from the “Select Application” dropdown.
Log in Database Management: Login id: dbadmin
Password: GenProbeS@L1 Click Login
Click on Choose Server
Note: If this is a new client install the window below will not display.
Page 24 of 42 LC1491.1 (02/15)
Choose a server name or desktop name from the drop down list of
Available Sql Instances and select Connect.
Highlight the database of interest from the list of Available Databases.
Select OK.
Highlight the database of interest on the Database Management home
screen. Click Connect.
Close Database Management .
Page 25 of 42 LC1491.1 (02/15)
iv. Launch software to verify software is connected to the database. Open
software from the desktop or Start Menu All Programs LifecodesMatch IT! DNAMATCH IT! DNA
End User License Agreement -Click I Agree
Note: On first launch of the MATCH IT! DNA Software a message box may display indicating successful database upgrade.
There should be a MATCH IT! DNA shortcut on the computer desktop.
iiv. Proceed to step 13.
Page 26 of 42 LC1491.1 (02/15)
13. It is critical that the DNA Database Update script is executed after opening
MATCHT IT! DNA software. To upgrade, navigate to WWW.IMMUCOR.COM/LIFECODES for download:
Select LIFECODES |Transplant and select any HLA Genotyping product.
Select SOFTWARE | MATCHIT! |MATCHIT-DNA | Software_Updates | Database Update | Select the DatabaseUpdate_DNA12v1.zip file:
Extract all files from the zip file. Right click on DatabaseUpdate_DNA12v1.exe and run as an administrator.
Select a server from the Server list. Select a database from the list of available databases.
Enter the following login credentials: User name: evosa
Password: lifematch#1 Click the Update Database button.
14. Software Release Notes will be sent to all customers if additional MATCH IT!
DNA v1.2 Service Packs are released. Service Packs are available for
download from WWW.IMMUCOR.COM/LIFECODES
Note: Please refer to Appendix A for commonly occurring errors.
15. LIFECODES Services- If Autobatch setup feature is going to be used with MATCH IT!, please see instructions LC1509 LIFECODES Services Installation.
Navigate to WWW.IMMUCOR.COM/LIFECODES for download.
Page 27 of 42 LC1491.1 (02/15)
5.0 Post-installation Steps
Several items are required to complete the installation process. Failure to complete these steps may result in problems when printing reports and using
Auto Batch processing.
1. Open software and login: Login Name: supervisor Password: lifecodes
2. Lab Information
a. Open the MATCH IT! DNA software b. From the toolbar open the Settings menu and chose Preferences.
c. The preferences window will open
Page 28 of 42 LC1491.1 (02/15)
d. Enter the pertinent lab information. This is used as the header
information in the system reports so it is important for this information to be available.
e. Click the Save Settings button – the system will indicate that the save has completed successfully.
f. If reports will be generated, upload a user Lab Logo to ensure reports are generated correctly.
3. DNA Format Settings a. Date Format Setting - From the Open Preferences window select the
Date Format Setting tab.
b. Chose the display date for the system, this will format all dates within the system as the “Selected Date Format”. Select Save Settings.
c. Next set the date format that your Luminex system uses. The Run Date from the CSV file is captured by the MATCH IT! System and thus upon importing of a CSV the system will ask the end user to specify the run
date. d. Typing - From the Preferences window select the DNA tab. Select the
Typing tab.
Page 29 of 42 LC1491.1 (02/15)
1. Set Auto-Assign Specimens and select a DNA Typing option per lab specifications.
2. In the Common Well-Defined Allele Typing Option, choose the option preferred by the lab.
3. In the Merge Options group set, select the Auto merge options as per the lab specifications. Caution: Both options for Auto Merge must be selected when either option is
needed. If Merge is not being used, both Auto Merge options should be un-checked.
4. Click the Save Settings button – the system will indicate that the save has completed successfully.
e. Auto Batch- From the Preferences window select the DNA tab. Select the Auto Batch tab.
Page 30 of 42 LC1491.1 (02/15)
1. Set the Auto-Convert to Eye Readable format if the lab uses
the eye readable format for its sample IDs.
2. Set the columns that will are used by the lab for the patient
list. 3. Set a default Luminex Machine.
f. Report Settings - From the Preferences window select the Report
Settings tab
1. Choose the paper size
2. Choose the address format
3. Set the DNA Report Preferences for fields to be included in the
reports.
g. Click the Save Settings button – the system will indicate that the save
has completed successfully.
h. Click the Close Window button to close this form.
Page 31 of 42 LC1491.1 (02/15)
6.0 Appendix A-Trouble Shooting Post Installation.
1. Software Connection error
If MATCH IT! DNA v1.2 displays a connection error to the database and
requests an „evosa‟ password upon opening the software follow the below instructions. (This can oocur after a system upgrade from MATCH IT! DNA v1.1 to v1.2)
a. Close MATCH IT! DNA software.
b. Delete all Old MATCH IT! shortcuts associated with the previous MATCH IT! version. Shortcuts should be manually deleted from desktop and
Start menu i. Select old MATCH IT! (Blue) shortcut.
ii. Right click on the shortcut iii. Click Delete. iv. Click yes on Delete Shortcut message.
Create a new new shortcut .
i. Navigate to C:\Program Files (x86)\LIFECODES\Match IT DNA or C:\Program Files\LIFECODES\Match IT DNA
ii. Right Click on MATCHITDNA.exe. iii. Select Send to | Desktop
c. Copy the External_matchit.config file from
Windows XP - C:\Documents and Settings\All Users\Application Data\
GenProbe Windows 7 - C:\ProgramData\GenProbe
To Windows XP - C:\Documents and Settings\All Users\Application
Data\Lifecodes Windows 7 - C:\ProgramData\Lifecodes
(Note: if the Program Data file is hidden do the following: In Windows Explorer go to Tools | Folder Options. Select View tab.
Under Advanced setting: toggle “Show hidden files, folders, or drives.)
2. Automated Batch Setup - Unhandled Exception error message
If an Unhandled Exception error message (" Conversion from string to type Boolean is not valid") is displayed upon selecting Automated Batch Setup
follow the below instructions.
a. Select 'Continue' on the Unhandled Exception message box.
Page 32 of 42 LC1491.1 (02/15)
b. In Automated Batch Setup, select the Automated Batch Preferences tab.
Select the columns needed for the batch under „Batch Import Column:‟ . Select the Update Batch preferences button.
Close Autobatch setup and reopen Automated Batch Setup to ensure
the error message does not reappear.
3. Automated Batch Wizard - Unhandled Exception error message
If an Unhandled Exception error message (" Conversion from string to type Boolean is not valid") is displayed upon selecting Automated Batch Wizard
follow the below instructions.
a. Navigate to the external.matchit.config file Windows XP - C:\Documents and Settings\All Users\Application
Data\Lifecodes Windows 7 - C:\ProgramData\Lifecodes
b. Add the following information to the External.matchit.config file: <add key="TestMode" value="False" />
Insert this key between <appSettings> and </appSettings>
tags in the config file.
Page 33 of 42 LC1491.1 (02/15)
c. Select File | Save.
d. Reopen software and then reopen Auto Batch setup Wizard.
4. Opening a Batch- Unhandled Exception error message When opening a batch from the home screen results in an unhandled exception. "Could not find file C:\Users\<users name>\AppData\
Local\Lifecodes\DockingLayout.xml” This error usually occurs if the user is a non-Admin user.
a. Close all Windows(including the DNA window)
Select Settings | Preferences | Page Layout and click Restore Layout. Select “Save Settings” and Close Preferences window.
b. If the error persists, copy the DockingLayout.xml file from the following directories:
Copy from : Windows XP - C:\Program Files\Lifecodes\Match IT DNA\ Lifecodes
Windows 7 - "C:\Program Files (x86)\ Lifecodes\Match IT DNA\ Lifecodes
Paste into:
Windows XP - C:\Documents and Settings\<Username>\Local Settings\Application Data\lifecodes Windows 7 - C:\Users\<Userame>\AppData\Local\Lifecodes
Page 34 of 42 LC1491.1 (02/15)
5. Lot Import (import EXP file ) failure Verify the software is connected to a 3.16 Allele database version in Database
Management.
If the Allele DB Version is not 3.16; upgrade to 3.16, navigate to WWW.IMMUCOR.COM/LIFECODES for download and instructions.
After upgrade verify in the Allele Count is 11154 in Database Management.
If the EXP import failure persist, please contact Technical Support at (203)-328-9597 or [email protected]
6. If csv files will not import because of file formatting:
Copy the NumFormat.xml file found in
Win7- C:\Users\<User Name>\AppData\Local\Lifecodes
or
XP- C:\Documents and Settings\<User Name>\Local Settings\Application Data\Lifecodes
To
C:\Program Files\LIFECODES\Match IT! DNA
Page 35 of 42 LC1491.1 (02/15)
7. Database Management- Choosing a SQL Instance fails
When attempting to choose a SQL Instance (server name or computer name), the instance does not appear in the dropdown do the following:
a. Database on Server (Client Install) 1. Type in the name of the SQL instance or machine name, if the
instance is valid and Match IT! can connect, the databases it
holds will be listed. 2. Select the appropriate database.
Click Connect to establish the connection to the database. Select OK.
3. If the SQL instance appears but Database Management can not connect:
Check to see if a port for the instance has been specified.
Ask the database administrator to check the port settings in SQL Server Configuration Manager. If a port has been specified then add the port number to the
SQL instance in the dropdown. Example:
<Computer name>, <port number>
MatchITserver,1500
b. Database on a Dedicated computer (Client Install)
Check setting on the dedicated computer that holds the database. Verify the following:
1. Checking the SQL Browser state: Open SQL Server Configuration Manager: Start menu | All
Programs | Microsoft SQL Server | Configuration Tools Click SQL Server Services.
Check that the SQL Server Browser is stopped. If it is not then, right click the service and choose stop.
2. Check TCP/IP protocol: Open SQL Server Configuration Manager: Start menu | All Programs | Microsoft SQL Server | Configuration Tools
Click SQL Server Network Configuration. Click the correct protocol. This will be the name of the
instance that holds the database. (usually Evolution) Verify the status of TCP/IP. It should be enabled. If it is not
then, right click on TCP/IP and choose Enable. 3. In Database Management, type in the name of the SQL
instance, if the instance is valid and Match IT! can connect, the databases it holds will be listed.
4. Select the appropriate database.
Page 36 of 42 LC1491.1 (02/15)
5. Click Connect to establish the connection to the database.
Select OK.
6. If the SQL instance appears but Database Management can not connect:
Check to see if a port for the instance has been specified. Open SQL Server Configuration Manager.
Click SQL Server Network Configuration. Click the correct protocol. This will be the name of the
instance that holds the database. Double click TCP/IP. Choose the IP Addresses tab.
Scroll to the bottom to find IPAll. Check the TCP Port field. If a port has been specified
then add the port number to the SQL instance in the dropdown.
Example:
<Computer name>, <port number>
MatchITserver,1500
Page 37 of 42 LC1491.1 (02/15)
7.0 Appendix B - Database Configuration Options
Immucor‟s MATCH IT! product supports a number of different network topologies allowing it to be configured to meet the needs of the network and IT
policies.
1. Server Based Installation - Recommended
The configuration assumes that the IT department has a dedicated server
running Microsoft SQL Server 2008 Standard edition or above.
Immucor will provide the database administrator a database as an .mdf file for attachment and instructions for setup of the database user.
Pros for this configuration Database Server will be more efficient in processing data compared to a
standard desktop database. IT typically backs up their database systems nightly.
More stable configuration for the system as a whole. Database size is only limited by the amount of space available on
hardware.
Cons for this configuration
Additional cost for Microsoft SQL Server if IT does not already have a dedicated Server.
Note: MATCH IT! requires a evosa login which is the dbowner for the
MATCH IT! database. MATCH IT! uses lifematch#1 as the default password for evosa.
The password can be changed and after connecting to Database Management, there will be a prompt to enter the evosa password.
Page 38 of 42 LC1491.1 (02/15)
Figure 1:
Server Based Installation – Recommended
Figure 1: Server Based Installation
Dedicated Database Server – MATCH IT! database is created on server using a script provided to IT department. Lab PC 1, 2, N - Only the MATCH IT! client is required on Lab PCs. Each
PC connects to the MATCH IT! database on dedicated server. Luminex System(s) – LIFECODES Services is required for auto batch
processing. The MATCH IT! client is optional on this machine.
Notes: Connection between Lab PC(s) and Luminex System is over TCP/IP.
If the Luminex System has a firewall running, port 7575 must be opened for communication between Lab PC(s) and the Luminex system(s).
Page 39 of 42 LC1491.1 (02/15)
2. Dedicated Desktop PC Installation
The configuration assumes the Lab has a dedicated Desktop machine that will be used as the main SQL Server 2008 Express server.
Pros for this configuration
Less cost than a dedicated database server (SQL Server 2008 R2 is free from Microsoft)
Better option than using Luminex system as the database server if a
dedicated database server is not available.
Cons for this configuration System does not function optimally when a database has grown to 6GB
Limited Database size of 10 GB. SQL Server 2008 R2 would require intervention to create nightly backups
System performance could degrade as the system is database dependent
Note: Software does not function optimally when a database has grown to 6GB. It is recommended that a new database is created.
Page 40 of 42 LC1491.1 (02/15)
Figure 2:
Dedicated Desktop PC Installation
Figure 2: Dedicated Workstation Database
Dedicated PC Workstation – Full database installation of MATCH IT! is required.
Lab PC 1, 2, N - Only the MATCH IT! client is required on Lab PCs. Each PC connects to the MATCH IT! database on dedicated PC workstation.
Luminex System(s) - LIFECODES Services is required for auto batch processing. The MATCH IT! client is optional on this machine.
Notes:
Connection between Lab PC(s) and Luminex System is over TCP/IP. If the Luminex System has a firewall running, port 7575 must be opened for communication between Lab PC(s) and the Luminex system(s).
Page 41 of 42 LC1491.1 (02/15)
3. Luminex System with MATCH IT! Database (Not recommended for
high volume)
The configuration assumes the Lab is using the Luminex System or another client system to house their main MATCH IT! database.
This installation requires the full MATCH IT! database for the Luminex system. This will be accomplished in Step 5 of Section 6.
Pros for this configuration
no cost as Luminex system is already available
Cons for this configuration System performance could degrade as now both the MATCH IT!
Database and the Luminex Database are both on the same system contend for resources. User intervention required for nightly backups.
Note: Software does not function optimally when a database has grown to
6GB. It is recommended that a new database is created.
Page 42 of 42 LC1491.1 (02/15)
Figure 3: Luminex System with MATCH IT! Database
(Not recommended for high volume)
Figure 3: Luminex or other client computer serving as Database Server.
Lab PC 1, 2, N – Only the MATCH IT! Client is required on Lab PCs. Each PC
connects to the MATCH IT! database on Luminex PC. Luminex System(s) – Full installation of MATCH IT! is required. LIFECODES
Services is required for auto batch processing.
Notes: Connection between Lab PC(s) and Luminex System is over TCP/IP
If Luminex System has a firewall running port 7575 must be opened for
communication between Lab PC(s) and the Luminex system(s).