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-1.1.3 with an extension particular to the target platform:

  • ADTPro-1.1.3.tar.gz - Linux or Solaris
  • ADTPro-1.1.3.dmg - Mac OSX
  • ADTPro-1.1.3.zip - Windows or OS/2

(The "1.1.3" 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:

http://adtpro.sourceforge.net/forum.html

Good luck - and have fun!

Unix RXTX Considerations

For Unix variants other than Mac OSX, make sure the user that will be running ADTPro is in the group lock or uucp so that lockfiles can work.

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 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 work fine in OS/2.

Distribution contents

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

adtpro.bat
A Windows server startup batch file
adtpro.cmd
An OS/2 server startup command file
ADTPro-1.1.3.app
An OSX server application for OSX 10.3 and above
adtpro.command
An OSX server startup command file for OSX 10.2 and below
adtpro.sh
A Linux/Solaris server startup shell script
LICENSE
The GNU Public License file
README
The info you're looking at now, mostly
disks/ADTPRO-1.1.3.DSK
ADTPro client-side software (an Apple 140K disk image)
disks/ADTPRO-1.1.3.PO
ADTPro client-side software (an Apple 800K disk image)
disks/ADTvrm.DSK
An enhanced legacy Apple DOS ADT client, capable of running with Super Serial hardware, the IIgs modem port, a Laser 128, and the Apple /// (an Apple 140K disk image)
lib/ADTPro-1.1.3.jar
ADTPro server-side software (a Java .jar file)
lib/rxtx/...
Java serial library files