Note: this installation guide is undergoing continuing revisions in response to users' suggestions. The revision date of this version is October 2, 2003.
The latest version of the guide can always be found at the n-topus.com website. Please email to Alexander Nakhimovsky or Tom Myers if you have questions or need help. For instructions on use, see the User Guide, also accessible from the Help menu within the application. For more details on motivations and principles, see the conference paper in HTML format.
The guide contains a Quick Summary and a Detailed Procedure of 7 Steps, with Notes.
In order to use MannX you need three major applications: an up-to-date browser, a Java Runtime Engine (JRE) and QuickTime (including QuickTime for Java). We provide an installer for each, but you may have some or all of them already. You also need to install three Accented Cyrillic fonts. All the installers can be run from the CDROM. Once the applications are installed:
You are all done. Start using the program by opening xm\splash.htm.
1: Begin by opening the CD-ROM top-level directory, which for us is drive D:
2: Install the browser. (Most users - those who already have IE6.0 or Mozilla 1.3 - will skip this step.) To install, run mozilla-win32-1.3-installer.exe from the CDROM. Accept the license agreement. You will see a screen as below. MannX only needs the browser (not the email client, etc.):
As you go through the installation, accept all defaults. In particular, do not activate Quick Launch. In the end, Mozilla will try to connect to mozilla.org; if you are not connected, this will produce an error message which you can ignore.
You will be asked where you want to make Mozilla your default browser. This is not needed for MannX, so don't do that unless you want to do so anyway.
3: Next, go back to the CD-ROM top directory and open j2re-1_4_1_02-windows-i586-i.exe; again you can skip this if you already have an equivalent or later JRE installed. Accept all the defaults; use"typical" install.
NOTE: You may have more than one JRE on your system. That's not a problem, except you must know the location of the JRE that your browser will use. Check Start/Settings/Control Panel/Java Plug-In/Advanced:
The Control Panel's directory tells where the Quicktime code must go; in this case it's C:\Program Files\Java\j2re1.4.1_02.
Note: If the programs malfunctions in any way, please configure the Java Plug-in to show its Console: click the Basic tab in the screenshot above and choose Show Console. Run the program again and the Console window will appear. Most likely, the console text will provide a diagnostic text that you can copy and email to us.
4: Next run the QuickTimeInstaller.exe from the CDROM. (You can skip this step if you already have QuickTime 6.0 or better, but you must make sure that all the components needed by our program are also installed, as explained below.) Choose Custom installation. You will see a number of checkboxes. At the top, check Internet Extras, right below Quicktime Essentials that will already be checked. Scroll down to see more checkboxes and check QTJava and QuickTime diagnostics at the bottom. That's four (4) checkboxes altogether: two at the top, and the two at the bottom shown in the screenshot.
If you skipped the QuickTime installation because you already have QuickTime 6.0 or better, you must run the QuickTime control panel and check that these four are installed. Use Quicktime Updates within the control panel if needed. It may be easier to uninstall the Quicktime you have and re-install from our CDROM.
NOTE: If the installations have worked correctly, the JRE's lib\ext directory (in our case, C:\Program Files\Java\j2re1.4.1_02\lib\ext) will now contain a QTJava.zip file. Make sure it does. At this point, copy the D:\JSApplet.jar file from the CDROM to that same lib\ext directory. (It needs to work with QTJava.zip, which needs to be within the lib\ext created by the JRE installer.)
5: Next, install the fonts: use Start/Settings/Control Panel/Fonts/File/Install Fonts and browse to the CDROM's top-level directory to install the accented Cyrillic fonts.
The rest is easy, just copying.
6: Copy D:\xm anywhere on your hard drive.
Note: If you will be changing any files in the xm directory, you will need to change their read-only status. (Files copied from CDROMs will be Read-Only by default). Press Control-A to Select All files, then right-click and choose Properties, and uncheck the Read-Only attribute. If asked, make sure you are acting on subdirectories as well.
For Windows 98, you don't have the option to apply the change to subdirectories, but there is a workaround: do an empty search in the xm directory (Control-F, then click search with no data); this will give you the list of all the files in all subdirectories.. Now you can press Control-A to select all those files, right-click and change the properties as before.
7: If you have enough room (1.2GB) on drive C:, copy xmMovies from both CDROMs to the top level on that drive. (If you put xmMovies somewhere else or leave them on the CDROMs, you will have to enter the location into xm\Code\config.js; we'll tell you how to do that in a moment.) The first CD-ROM has the first 11 movies:
The second CD has the remaining 10 movies, and you can drag these into the same C:\xmMovies\12Chairs\ directory, just by dragging D:\xmMovies to C:\.
At this point the installation is complete. Restart your machine, and after that you should be able to open
C:\xm\splash.htm
(or wherever you actually put the xm directory) in your preferred browser. Open the User Guide from that screen and start using the textbook.
Note: If you moved D:\xmMovies to some place other than C:\ (or if you wish to run the movies from the CDROM), you will have to edit one line in the file xm\Code\config.js. The text to edit is highlighted in the screenshot below; the text that follows contains instructions. If you want to keep the movies on the CDROM, simply replace the drive letter with the drive letter of the CDROM. Otherwise, retype the entire directory path, but make sure that you keep double slashes intact.
In conclusion, a reminder: visit http://www.n-topus.com/mircDocs/InstallGuide.htm to see if there is a later version, and email to Alexander Nakhimovsky or Tom Myers if you have any problems or suggestions.