Troubleshooting GeneMapper ID-X Software for HID Laboratories AFDAA Meeting Austin, TX Feb, 2013
Introduction and Installation 2/8/2013 2
Software Topics GeneMapper ID-X Software Overview and Background Database Communication Slow/Broken from a client Within the Full install Log Files Improving response time with documentation Installation Avoiding Oracle Database Problems Error Messages Steps Causing It 2/8/2013 3
Software Topics What is GeneMapper ID-X Software? Two parts: Oracle Database Graphic User Interface (GUI) GUI exists on Full install and Client Database only on Full install Communication between GUI and Database occurs via TCP/IP (internet protocol) Connection dictated by the rules of Oracle Database (Oracle Services) 2/8/2013 4
TCP/IP (The Internet Protocol) - A Short Lesson The GUI you use communicates with Oracle software via a protocol called TCP/IP Same protocol used when you use the internet Why do we care? Your computer uses TCP/IP to connect to the internet our your lab network, but GeneMapper ID-X Software uses TCP/IP to connect the GUI to the Oracle database Weak internet connections are acceptable for surfing the web, but cause a disconnection with Oracle Database 2/8/2013 5
Clarification of Terms Can I use a Server? In computing, the term server is used to refer to one of the following:. a physical computer Generally acceptable a System Operating Software Must use validated OS 2/8/2013 6
64 bit vs 32 bit Review install requirements before selecting computers Some newer computers default with 64 bit 64 bit operating systems would not see performance increases with data analysis software May use a 64 bit computer, but not 64 bit Operating System GeneMapper ID-X Software uses 32 bit operating systems 2/8/2013 7
Installation Recommendations GeneMapper ID-X Software v1.4 User Bulletin contains more details that applies to all versions 2/8/2013 8
Install - Local Computer vs. Network login Have Administrator rights to your computer in the system ora_dba Log into the Domain that matched the computer name. 2/8/2013 9
Customer Requests Modifying Oracle Software Customer Requests Running command line operations or third party software to access Oracle to perform functions like data mining or printing that bypass the IDX software. Updating Oracle database based on various patches that Oracle Software (not AB) has released. Not allowed by the EULA (Oracle License) Licensee is not permitted to modify the Oracle Programs, and Licensee may not require Oracle Corporation to perform any obligations not previously agreed to between Applied Biosystems and Oracle Corporation. 2/8/2013 10
Database 2/8/2013 11
Client vs. Full (Server) Useful for Troubleshooting! Full install = Oracle Database AND a Client Client = Client only, no database 2/8/2013 12
Failure Modes No client connection Test Lab Network Problem Oracle Database Problem Full install functions normally but Client connection is slow/fails X Full install functions slow/fail and Client is slow/fails X If the problem is Lab Network, then Lab IT will be needed to assist slow network performance If the problem is with the Oracle Database, could be due to excessive audit records or too much used space 2/8/2013 13
Database Dashboard - Password To access: Select Start > All programs > Applied Biosystems > Database Dashboard > Dashboard Click Yes when asked to if you want to set a password Cannot recover this password if you lose it! 2/8/2013 14
Dashboard 2/8/2013 15
Communication Occurs on Port 1521 In computer networking, a port is an application-specific or process-specific software construct serving as a communications endpoint.. GeneMapper ID-X Software uses port 1521 Allow this port in network firewalls or virus software 2/8/2013 16
Avoiding Database Connection Drops Rules set by Oracle, not GeneMapper ID-X Software specifically Use hardwired (not wireless) networks, wireless laptops are risky Make sure network are reliable Do not pull out the network cable while in use Third party applications that affect TCP/IP stability are a risk Single Sign On (SSO) Virus Scanning software VPN 2/8/2013 17
Restarting Oracle Services GeneMapper ID-X Software v1.4 User Bulletin contains more details that applies to all versions http://tools.invitrogen.com/content/sfs/manuals/4477684b.pdf 2/8/2013 18
Audit Records Check them often (depending on usage) Audit records build even with default install Audit records multiply if you import projects (.ser files) Clean them out before they reach about 40,000 Export working projects before deleting audit records 2/8/2013 19
Increasing Chances of Success in Software Troubleshooting 2/8/2013 20
Step by Step Summary of Process What were you trying to do when there was a problem? Did anything pop up on the screen? Error messages Random Java Error from non-validated install Any updates to your computer recently? Java updates Any differences from our recommended run environment? Improper Virtual Memory 2/8/2013 21
Useful Files and Information Log Files GeneMapper_Log.txt Records user actions. GMIDXInstall.log Install information Depends on version, GMIDX_MSI.log Install information 2/8/2013 22
Useful Files and Information Log Files Communication Errors listener.log. may be slightly different location depending on versions of software Monitors communication between the GUI and Oracle 2/8/2013 23
Report Dashboard and System Info Contains the Oracle Dashboard Report Reports can be saved or exported and sent in to technical support if there are Oracle database issues 2/8/2013 24
Thank You 2013 Life Technologies Corporation. All rights reserved. The trademarks mentioned herein are the property of Life Technologies Corporation and/or its affiliate(s) or their respective owners. Microsoft is a registered trademark of Microsoft Corporation. Oracle is a registered trademark of Oracle. The content provided herein may relate to products that have not been officially released and is subject to change without notice. 2/8/2013 25