match it! dna v1.2 software installation software... · 2015. 2. 5. · page 3 of 42 lc1491.1...

42
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

Upload: others

Post on 30-Sep-2020

3 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

Page 6 of 42 LC1491.1 (02/15)

DNA 1.2 Installation Workflow

Page 7: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

Page 14 of 42 LC1491.1 (02/15)

9. Begin Installation – Click Install.

Click Finish

Page 15: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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: MATCH IT! DNA v1.2 Software Installation Software... · 2015. 2. 5. · Page 3 of 42 LC1491.1 (02/15) 3.0 Installation Checklist Prior to installing MATCH IT! DNA v1.2 determine the

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).