ADTPro Installation

Welcome to ADTPro!

To get started, you will need a Java installation you can call from the command line of your host computer. This means that if you type the command java -version from a terminal window it ought to produce a Java message and not complaints. One place to get a downloadable Java distribution is from Oracle: Java SE JRE download. When you get there, look for a Java SE JRE download button. Download for your platform and install it, paying careful attention on Windows to 32-bit or 64-bit versions; letting Oracle pick for you has been known to result in the incorrect version being installed.

If the the JRE you install results in a "java.lang.UnsupportedClassVersionError" error, first confirm you downloaded the correct JRE version, and not (for example) the 32-bit version of Java which would not be correct for a 64-bit OS. If the JRE still does not work for you, try try installing the latest JDK version of Java (which sometimes contains a newer version of Java, which hasn't yet made it to the JRE distribution. The main downside of using the JDK is a larger disk requirement on the host.

The ADTPro distribution comes as a single file named something similar to ADTPro-2.1.0 with an extension particular to the target platform:

  • ADTPro-2.1.0.tar.gz - Linux
  • ADTPro-2.1.0.dmg - Mac OSX
  • ADTPro-2.1.0.zip - Windows

(The "2.1.0" part signifies the Version, Release, and Modification numbers of the particular version of ADTPro you're looking at.)

Installation steps:

  1. Unpack the ADTPro distribution file using your operating system's native facilities.
  2. Start the ADTPro server from your host computer's command line or by clicking on the startup program for your host operating system.
  3. Bootstrap the client software on your Apple II via serial or cassette ports; or bootstrap it on your Apple /// via its serial port.

Please open an issue for any troubles, bugs, requests for help, etc. at GitHub:

https://github.com/ADTPro/adtpro/issues

Good luck - and have fun!

Distribution contents

The distribution should contain most of these files, depending on platform:

adtpro.bat - A Windows server startup batch file

ADTPro-2.1.0.app - An OSX server application for OSX 10.6 and above

ADTPro.command - An OSX server startup command file

adtpro.sh - A Linux server startup shell script

ac.bat - A Windows AppleCommander command line invoker batch file

ac.sh - A Linux AppleCommander command line invoker script

LICENSE - The GNU Public License file

README - The info you're looking at now, mostly

disks/ADTPRO-2.1.0.DSK - ADTPro Apple II client-side software (an Apple 140K disk image)

disks/ADTPROSOS-2.1.0.DSK - ADTPro Apple /// client-side software (an Apple 140K disk image)

disks/ADTPRO-2.1.0.PO - ADTPro Apple II client-side software (an Apple 800K disk image)

disks/VDRIVE-2.1.0.DSK - Virtual drive driver software (see the virtual drive section)

disks/Virtual.po - A blank example virtual disk that is served to virtual drive requests

disks/Virtual2.po - A blank example virtual disk that is served to virtual drive requests

lib/ADTPro-2.1.0.jar - ADTPro server-side software (a Java .jar file)

lib/AppleCommander/AppleCommander-2.1.0.p-ac.jar - AppleCommander support software (a Java .jar file)

lib/jssc/... - Java serial library files