Running the omnidoctor verification utility, For more information – Ocean Optics OmniDriver Install User Manual
Page 6
OmniDriver Installation Instructions
6
000-20000-400-01-0109
If you have an earlier version of Java already installed on your PC, you do not need to uninstall that version,
although it might keep things simpler if you do. However, you must install the 1.6 version in order to develop
OmniDriver applications. Earlier versions of java will not work with OmniDriver.
After installing Java, you must add the Java bin directory to the system PATH.
►
Procedure
To add the Java bin directory to the system PATH:
1. Start the Control Panel.
2. Click on the System icon.
3. Click on the Advanced tab.
4. Click on the Environment Variables button.
5. In the System Variables list, find the PATH variable and prepend the pathname of the new Java bin
directory (for example, C:\Program Files\Java\jdk1.6.0_10\bin).
6. To verify that the system is using the new version of java, open a new Command Prompt window and type
java –version. It should indicate you are running java 1.6 or later.
Running the OmniDoctor Verification Utility
OmniDoctor is a small command-line utility that verifies OmniDriver has been properly installed. If you have
recently installed or upgraded OmniDriver and you are experiencing unexplained difficulties with your application
(or the OmniDriver samples do not run), it is highly recommended that you run this utility. OmniDoctor is available
for Windows only, not for Linux or MacOSX
OmniDoctor performs the following checks:
•
Verifies that the OOI_HOME environment variable has been defined and that it points to a valid directory.
•
Verifies that the OOI_HOME directory is in the system PATH.
•
Confirms that certain critical files are present in the OOI_HOME directory.
•
Verifies that the required version of Java has been installed on the user’s PC.
The OmniDoctor utility is located in OmniDriver\utilities\win32. You can run OmniDoctor from the command line,
or by double-clicking it from within Windows File Explorer. OmniDoctor will display several simple pass/fail
messages indicating the status of your OmniDriver installation. OmniDoctor also creates a log file, named
ooi_home_file.txt, in the current directory. The log file contains greater detail about the current installation of
OmniDriver. In some cases you may be asked to e-mail this log file back to Ocean Optics Tech Support for
diagnosis.
For More Information
You can access complete documentation for Ocean Optics products on the Software and Technical Resources CD or
by visiting our website at
Technical | Operating Instructions. Choose the
appropriate document from the drop-down lists or use the Search by Model Number field.