Skip to content
sairuk edited this page Nov 25, 2022 · 7 revisions

Currently experimental and needs community testing

About

Apple Disk Transfer ProDOS (ADTPro) transfers physical/imaged disks between Apple //-era machines and RetroNAS. Additionally you are able to boot a machine from ADTPro. This is a java based tool, you may need to run the client as per the main project documentation.

Implementation

Our implementation of ADTPro provides menus to configure (serial over ip) localhost mode connection properties. All other functionality is by accessing the GUI available through VNC on :60000

A systemd instance is generated based on the mode at runtime, we install a generic type of systemd service unit that can be called with arguments to start the service, in the case of ADTPro we use this is to start a service in localhost mode. Due to the way linux operates with protected port ranges these services run as root.

During installation we pull the latest version from github and install it to /opt/adtpro at this time we drop a config template for ADTPro.properties into the same location. The config template may be edited directly or through the tui

Installation

  1. Install from the Experimental menu
  2. Once installed configure the VNC password through the normal Config->Password menu
  3. Configure the service, note in localhost mode ADTPro is considered to be a client
  4. Start the service
  5. Connect with a VNC client to retronas:60000

image

Troubleshooting

General systemd troubleshooting applies

Can't connect to VNC

Try the retronas device ip address for the connection as <retronas_ip>:60000

Trace logging

To enable trace logging

  1. stop the service
  2. edit the ADTPro.properties setting TraceEnabled=true
  3. start the service
  4. check the journals with journalctl -u adtpro@localhost.service

References

Home

Getting started:

Contributing

Multi-system protocols:

Specific system configurations:

Services:

Tools:

Physical Media:

On-Device Management:

Advanced storage options:

  • BtrFS RAID, Snapshots, Compression, Deduplication
  • FAT Advanced guide to using FAT loopback mounts for EtherDFS
  • TBA
    • SMR Shingled Magnetic Recording hard drives (TBA)
    • NTFS Advanced guide for NTFS formatted disks
    • SMB Loopback Mounting an existing SMB NAS
    • NFS Loopback Mounting an existing NFS NAS
    • MDRAID (TBA)
    • LVM (TBA)
    • iSCSI Configuring iSCSI

Other:

Clone this wiki locally