nanoTITAN, Inc.
 
Troubleshoot nanoXplorer IDE
 
 

Follow these steps to troubleshoot your installation of nanoXplorer™:

  1. Verify your system meets the platform requirements
  2. Review the installation instructions for your platform
  3. Verify your Java installation
  4. Update your graphics drivers
  5. Verify your graphics card is set to use OpenGL
  6. Verify your graphics card's depth buffer size
  7. Select a new workspace
  8. Report log output to nanoTITAN



Verify your system meets the platform requirements
nanoXplorer requires at least a 1.5 GHz processor, 512 MB of memory and a 3D graphics accelerator card (or chip). It also requires an operating system that can support the necessary Java optional extensions. Supported operating systems include Windows systems, Solaris, and Linux.

View the complete System Requirements.


Review the installation instructions for your platform
Make sure you have the required versions of libraries and make any necessary configuration changes for your platform. View the complete installation instructions.


Verify your Java installation
nanoXplorer IDE requires Java SE 6 (also known as 1.6) or later to run. In order to verify that you have properly installed Java, open a console window and type the command:

java -version

You should receive a reply such as:

java version "1.6.0_02"
Java(TM) SE Runtime Environment, Standard Edition (build 1.6.0_02-b06)
Java HotSpot(TM) Client VM (build 1.6.0_02-b06, mixed mode, sharing)

If instead you get a reply indicating a version earlier than 1.6 or it complains that it can't find the Java command at all, then you need to update your installation of Java. Go to Sun's download page for Java and follow the directions in the Installation Instructions document.


Update your graphics drivers
If nanoXplorer runs but you are experiencing problems with the graphics windows in the application you should try updating the graphics driver for your graphics 3D accelerator card (or chip). To do this you should visit the web site of the card's manufacturer and download their latest driver (follow their installation instructions). If you don't know what graphics accelerator you have, consult your operating system help for instructions on how to view and edit your display properties (in Windows, click on the Settings tab on the Display Control Panel).


Verify your graphics card is set to use OpenGL
Some graphics cards let you choose between Direct3D and OpenGL for its rendering engine. If so, make sure your graphics card is set to OpenGL. Reboot so the settings are sure to take effect.


Verify your graphics card's depth buffer size
Java 3D may exhibit problems with graphics hardware that has its depth buffer (a.k.a. Z-buffer) set to below 16 bits. Set the depth buffer to 32 bits, if available, or anything greater than or equal to 16 bits. For ATI Radeon cards, a Z-buffer depth of 16 bits seems to work best. Make sure Z-buffering is enabled.


Select a new workspace
Sometimes designating an old workspace for use in a new installation can cause problems. Try specifying a new workspace by creating a new folder and selecting it when nanoXplorer IDE queries you for the workspace you would like to use (or alternatively by choosing File > Switch Workspace from the main menu bar).


Report log output to nanoTITAN
When none of the above steps solves your problem it may be that nanoXplorer is throwing an exception (error), causing the application to stop functioning properly or crash. Problems may be captured in the log file that is created each time you run nanoXplorer.

To locate the log file you need to know where your workspace is. When you first used nanoXplorer you told it where to put your workspace. The default is a directory directly under the installation folder for nanoXplorer IDE. In the workspace directory you will find a subfolder named ".metadata". The log file is in that directory:



Sometimes the output in the .log file will give you a clue to the problem and you can fix it yourself. Otherwise you may have discovered a bug in the program. If you are unable to solve the problem, please copy and paste the log text into an e-mail and send it to support@nanotitan.com or use our On Line Support Form. We will work to eliminate the problem as soon as possible.

 

 



Copyright 2001-2005 nanoTITAN, Inc.