1. You must have Java Runtime Environment on your system. If you do not already have it on your system go to the Java directory on the CD and double click the jre-6u31-windows-i586-s.exe file located there to start the installation.
2. You need to install the Hercules emulator. For Windows: Go to the Hercules directory on the CD and double click the 32 or 64 bit installer located there. For Linux: Extract the file hercules-3.07.tar.gz in the Hercules directory on the CD to a convenient location on your hard drive. You will need several packages in addition to the standard build packages. On Ubuntu these can be had with the following commands: sudo apt-get install gettext sudo apt-get install zlib1g-dev sudo apt-get install libbz2-dev From the source directory the commands to build are: ./configure --enable-external-gui --enable-cckd-bzip2 make sudo make install
3. The CD contains a directory called myDOSVS which holds all the files for myDOSVS. This directory needs to be copied to a convenient location on your hard drive. In general you should not place this directory in a path that has spaces in the name. The standard Windows location "Program Files" is acceptable as the program will reference it using the short name "PROGRA~1" which does not contain spaces. You should check the permissions after copying the directory. At least the owner needs full control access.
4. To start the program: Windows - Go to my computer and navigate to the myDOSVS directory. Double click on the myDOSVS.jar file. You may create a shortcut to this file on your desktop if you wish. Linux - Open a terminal and navigate to the myDOSVS directory. Start the program with: java -jar myDOSVS.jar
5. The first time the program starts you will be presented with a dialog box asking for the location of the Hercules executable file, the location of the myDOSVS directory, and the location of the java executable. When you click the Ok button the program will verify your response and wait for a correction if it cannot find the files.