ADTPro Installation

Welcome to ADTPro!

To get started, you will need a Java installation you can call from the command line. This means that if you type the command "java -version" from a terminal window it ought to produce output other than complaints. One place to get a downloadable Java distribution is from Sun Microsystems: Sun JRE download. When you get there, look for a "Java Runtime Environment (JRE)" download for your platform and install it.

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

  • ADTPro-v.r.m.tar.gz - Linux/Solaris
  • ADTPro-v.r.m.dmg - OSX
  • ADTPro-v.r.m.zip - Windows/OS/2

(The "v.r.m" part signifies the Version, Release, and Modification numbers of the particular distribution 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.

Please report troubles, bugs, requests for help, etc. on the Help forum for ADTPro at SourceForge:

https://sourceforge.net/forum/forum.php?forum_id=582337

Good luck - and have fun!

Unix/Mac OSX RXTX Considerations

For Unix variants, make sure the user that will be running ADTPro is in the group lock or uucp so that lockfiles can work. This won't be necessary in OSX.

The adtpro.sh and adtpro.command files can be customized to suit your environment. The main thing to do is to choose your platform for RXTX support. You may need to tweak the check for what your operating system returns from the uname command, and connect that to the appropriate RXTX library directory.

If you don't specify the right one, or if your platform is unsupported by RXTX, you will get an error similar to the one below on startup:

java.lang.UnsatisfiedLinkError: Can't find library rxtxSerial (librxtxSerial.so)
  in sun.boot.library.path or java.library.path
sun.boot.library.path=/opt/IBMJava2-142/jre/bin
java.library.path=/opt/IBMJava2-142/jre/bin:
 /opt/IBMJava2-142/jre/bin/classic:/opt/IBMJava2-142/jre/bin:/usr/lib
 thrown while loading gnu.io.RXTXCommDriver

Keep working at your startup script or take a look at the RXTX install instructions in the rxtx directory. Remember, you can always ask for help.

OS/2 RXTX Considerations

OS/2 doesn't have a native RXTX library. It would be a relatively easy thing to snap in the original Sun/IBM serial library, but just hasn't been done yet. Holler if you want it. Otherwise, the audio and UDP/Ethernet versions will still work fine in OS/2.

Distribution contents

The distribution should contain:

  • adtpro.bat - A Windows server startup batch file
  • adtpro.cmd - An OS/2 server startup command file
  • adtpro.command - An OSX server startup command file
  • adtpro.sh - A Linux/Solaris server startup shell script
  • LICENSE - The GNU Public License file
  • README - The page you're looking at now, mostly
  • disks/ADTPRO-v.r.m.DSK - ADTPro client-side software (an Apple 140K disk image)
  • disks/ADTPRO-v.r.m.PO - ADTPro client-side software (an Apple 800K disk image)
  • disks/ADTvrm.DSK - An enhanced legacy Apple DOS ADT client, capable of running on both Super Serial hardware as well as on the IIgs modem port (an Apple 140K disk image)
  • lib/ADTPro-v.r.m.jar - ADTPro server-side software (a Java .jar file)
  • lib/rxtx/... - Java serial library files
  • lib/rxtx/fixperm.command - A command to help OSX users enable the RXTX library (no longer necessary as of version 1.0.6a)