Installation

After the NMRViewJ installer has been downloaded to your computer's disk, you need to run the installer. The installer is itself a Java program and so, like NMRViewJ, needs to have Java installed on your computer. The exact protocol for doing the installation depends on what type of computer Operating System you are using. NMRViewJ should be run with Java version 1.5.0 or later. I have limited experience running it with Java 1.6, but so far it seems fine (and should be faster).

Mac OS X

Life is good! MacOS X always has Java, and knows what to do with Java "jar" files. Simply find the nvjinstall.jar file in the Finder and double-click on it. The installer will start up and prompt you through the various steps of installation. The default installation will place NMRViewJ in the /Applications folder. After installation open the /Applications/NMRViewJ folder and find the NMRViewJ application. It has an icon like this:

You might want to drag the application to the Dock or place an alias on the Desktop in order to make it convenient to startup NMRViewJ.

The Mac should recognize ".nv" files as belonging to NMRView. If you double click on one it should startup NMRView (if it's not already running) and then display the file in a window.

Linux, Windows, Solaris and Unix

If you don't already have Java installed on your computer you will need to install it. You can get Java for Linux, Windows and Solaris at the Java web site. Click on the button in the uper right corner (looks like the following).

Follow the instructions to download and install Java.

For other versions of Unix besides Solaris you'll have to go to the vendor's web site to find Java.

After Java is installed on your computer you should be able to simply use the file browser to find the nvjinstall6_x_x.jar file and double click on it. This should start up the installer. If it starts up simply follow the installer's prompts.

If double-clicking on the Installer jar file does not start it up, then you may have to issue the commands to run the installer manually. Open up a terminal (Linux, Solaris, or Unix) or a "cmd" window on Windows. To get the Windows "cmd" program choose "Run" from the "Start" menu. Type in "cmd" and click "OK".

In the terminal or command window you need to type a command similar to the following: java -jar nvjinstall6_2_7.jar The exact format of the command will depend on whether the appropriate version of Java is in your "path". That is, if the computer can find it without being told exactly where to look. You can check this by typing the following: java -version You should get a response similar to the following: java version "1.4.2_05" Java(TM) 2 Runtime Environment etc. The exact version number may differ, but should be at least 1.4.x.

If java wasn't found (that is, you get an error message instead of something like the above) you need to either put Java in your "path" or type the full path to java. On a Windows PC, for example, you may need to type something like: C:\jdk1.5.0\bin\java -jar nvjinstall6_2_7.jar The above also assumes that you are typing the Java command in the same directory in which the NMRViewJ installer is. If not you may need to type the full path to the installer. So the command may be something like: C:\jdk1.5.0\bin\java -jar "C:\Documents and Settings\Bruce\Desktop\nvjinstall6_2_7.jar"

After installation you're ready to run NMRView. On Windows the installer will place an NVJ icon on the desktop, and place an entry in the Start menu. On Linux and Unix, the installer should also install shortcuts. If it doesn't (and it didn't on my Linux computer) you can start NMRView by executing the "nvj" shell script from a terminal. You can also install shortcuts yourself. An icon "nvjrybt128.png" is present in the NMRViewJ directory. You can use this as the icon for your shortcuts.