mirror of
https://github.com/RasppleII/a2server.git
synced 2025-04-10 13:36:59 +00:00
Cleanup of all markdown files produced so far
This commit is contained in:
T. Joseph Carter
parent
2704f7b71c
commit
d0ae16ecb4
@ -1,34 +1,34 @@
|
||||
## A2SERVER
|
||||
|
||||
A2SERVER\'s central capability, sharing files to an Apple II, is provided by [Netatalk][1] 2.2.4.
|
||||
A2SERVER\'s central capability, sharing files to an Apple II, is provided by
|
||||
[Netatalk][1] 2.2.4.
|
||||
|
||||
Here\'s the extra sauce that A2SERVER provides:
|
||||
* available as a ready-to-use [Raspberry Pi][2] operating system
|
||||
installer
|
||||
|
||||
* available as a ready-to-use [Raspberry Pi][2] operating system installer
|
||||
|
||||
(plus new [Pi Filler][3] and [Pi Copier][3] utilities for easy SD card
|
||||
creation and backup)
|
||||
|
||||
* available as a ready-to-use [VirtualBox][4] appliance for Mac OS X,
|
||||
Windows, Linux, and Solari
|
||||
* available as a ready-to-use [VirtualBox][4] appliance for Mac OS X, Windows,
|
||||
Linux, and Solari
|
||||
|
||||
* simple downloadable installation script for Ubuntu Linux or Raspbian
|
||||
takes care of setting up and configuring *everything*
|
||||
* simple downloadable installation script for Ubuntu Linux or Raspbian takes
|
||||
care of setting up and configuring *everything*
|
||||
|
||||
* enables reliable operation by Asante, Farallon and Dayna bridges on
|
||||
both IIe *and* IIgs \[fixes contributed by Steven Hirsch and Geoff
|
||||
Body\]
|
||||
* enables reliable operation by Asante, Farallon and Dayna bridges on both IIe
|
||||
*and* IIgs \[fixes contributed by Steven Hirsch and Geoff Body\]
|
||||
|
||||
* easy to configure for network boot, including ProDOS 8 and GS/OS
|
||||
download and installation
|
||||
* easy to configure for network boot, including ProDOS 8 and GS/OS download
|
||||
and installation
|
||||
|
||||
* can network boot both IIe and IIgs computers on the same network
|
||||
|
||||
* new ProDOS 8 tools (NETBOOT.P8 and NETBOOT.GSOS) for setting the IIg
|
||||
network boot default
|
||||
* new ProDOS 8 tools (NETBOOT.P8 and NETBOOT.GSOS) for setting the IIg network
|
||||
boot default
|
||||
|
||||
* temporary ProDOS 8 network boot without changing GS/OS default
|
||||
\[contributed by Geoff Body\]
|
||||
* temporary ProDOS 8 network boot without changing GS/OS default \[contributed
|
||||
by Geoff Body\]
|
||||
|
||||
* GS/OS installer that can be run from folders rather than disk
|
||||
|
||||
@ -38,41 +38,40 @@ Here\'s the extra sauce that A2SERVER provides:
|
||||
|
||||
* supports Wi-Fi when used with Apple AirPort or Time Capsul
|
||||
|
||||
* maintains correct dates during GS/OS folder copy \[fix contributed by
|
||||
Steven Hirsch\]
|
||||
* maintains correct dates during GS/OS folder copy \[fix contributed by Steven
|
||||
Hirsch\]
|
||||
|
||||
* uses randnum authentication for registered user sign-in (which alway
|
||||
works, unlike cleartext)
|
||||
* uses randnum authentication for registered user sign-in (which alway works,
|
||||
unlike cleartext)
|
||||
|
||||
* supports login to shared volumes from latest versions of OS X and
|
||||
Window
|
||||
* supports login to shared volumes from latest versions of OS X and Window
|
||||
|
||||
* new Linux tool ([afptype](scripts/tools/afptype.txt)) for setting
|
||||
ProDOS or classic Mac file types on shared volume
|
||||
* new Linux tool ([afptype](scripts/tools/afptype.txt)) for setting ProDOS or
|
||||
classic Mac file types on shared volume
|
||||
|
||||
* new Linux tool ([cppo](scripts/tools/cppo.txt)) for cataloging and
|
||||
copying files (with optional resource forks) out of ProDOS disk image
|
||||
* new Linux tool ([cppo](scripts/tools/cppo.txt)) for cataloging and copying
|
||||
files (with optional resource forks) out of ProDOS disk image
|
||||
|
||||
* [Linux commands](a2server_commands.md) to ease server maintenanc
|
||||
|
||||
* installs Linux tools for working with ShrinkIt and other old and new
|
||||
archive formats ([nulib2][8] and [unar/lsar][9])
|
||||
* installs Linux tools for working with ShrinkIt and other old and new archive
|
||||
formats ([nulib2][8] and [unar/lsar][9])
|
||||
|
||||
<!--
|
||||
* sets up Raspberry Pi for shell login from Apple II via USB-serial cable or Raspberry Pi console cable
|
||||
* sets up Raspberry Pi for shell login from Apple II via USB-serial cable or
|
||||
Raspberry Pi console cable
|
||||
-->
|
||||
|
||||
* blinks Raspberry Pi OK/ACT LED for ten seconds when netatalk has just
|
||||
started u
|
||||
started
|
||||
|
||||
* good documentation (or so I hope)
|
||||
|
||||
|
||||
Any content unique to A2SERVER and not covered under a specific license is licensed under the [WTFPL][10].
|
||||
Any content unique to A2SERVER and not covered under a specific license is
|
||||
licensed under the [WTFPL][10].
|
||||
|
||||
|
||||
[A2SERVER home page](index.md)
|
||||
|
||||
[1]: http://netatalk.sourceforge.net
|
||||
[2]: http://www.raspberrypi.org
|
||||
[3]: http://ivanx.com/raspberrypi/
|
||||
|
||||
@ -4,42 +4,58 @@ So you got a [Raspberry Pi][1]. Congratulations!
|
||||
Are you ready to turn it into a file server for your Apple II? Here\'s how.
|
||||
|
||||
<!--
|
||||
_Important: As of 11-Aug-14, A2SERVER 1.2.0 is now compatible with the latest version of Raspbian (NOOBS 1.3.9/2014-Jun-20), and the Raspberry Pi Model B+. Type `a2server-setup` to update. If you are already running A2SERVER, and it stopped working after a Raspbian update, see the [recovery page](a2server_recovery.html)._
|
||||
*Important: As of 11-Aug-14, A2SERVER 1.2.0 is now compatible with the latest
|
||||
version of Raspbian (NOOBS 1.3.9/2014-Jun-20), and the Raspberry Pi Model B+.
|
||||
Type `a2server-setup` to update. If you are already running A2SERVER, and it
|
||||
stopped working after a Raspbian update, see the
|
||||
[recovery page](a2server_recovery.md).*
|
||||
-->
|
||||
|
||||
|
||||
|
||||
_Starting fresh:_
|
||||
If you haven\'t already started working with a Raspberry Pi, then [download Raspple II][2], a distribution of the Raspbian operating system which includes A2SERVER, [A2CLOUD][3], and David Schmenk\'s [Apple II Pi][4].
|
||||
If you haven\'t already started working with a Raspberry Pi, then [download
|
||||
Raspple II][2], a distribution of the Raspbian operating system which includes
|
||||
A2SERVER, [A2CLOUD][3], and David Schmenk\'s [Apple II Pi][4].
|
||||
|
||||
Expand the RasppleII.zip file, and copy all of its files to a 4 GB or larger SD card. Then put the SD card in your Pi, and attach power. The operating system will automatically install, which will take about 20 minutes.
|
||||
Expand the RasppleII.zip file, and copy all of its files to a 4 GB or larger
|
||||
SD card. Then put the SD card in your Pi, and attach power. The operating
|
||||
system will automatically install, which will take about 20 minutes.
|
||||
|
||||
When it\'s done, your Pi will reboot into Raspbian. If you don\'t have a screen attached, you\'ll know when it\'s done when the ACT/OK lamp on the Raspberry Pi board stops flickering.
|
||||
When it\'s done, your Pi will reboot into Raspbian. If you don\'t have a
|
||||
screen attached, you\'ll know when it\'s done when the ACT/OK lamp on the
|
||||
Raspberry Pi board stops flickering.
|
||||
|
||||
(If you are starting over with the same SD card, or want to ensure the card is formatted correctly, you can use the official [SD Formatter][5] utility -- carefully! -- before copying the files.)
|
||||
(If you are starting over with the same SD card, or want to ensure the card is
|
||||
formatted correctly, you can use the official [SD Formatter][5] utility --
|
||||
carefully! -- before copying the files.)
|
||||
|
||||
If you wish to log in (you don\'t need to to use A2SERVER), the username is \"pi\" and password \"apple2\". (If you do not have a screen and keyboard attached to your Raspberry Pi, read about [logging into a Raspberry Pi from another computer](a2server_raspberrypi_login.html), including an Apple II.) If you wish to change any configuration options, type `raspi-config`.
|
||||
If you wish to log in (you don\'t need to to use A2SERVER), the username is
|
||||
\"pi\" and password \"apple2\". (If you do not have a screen and keyboard
|
||||
attached to your Raspberry Pi, read about [logging into a Raspberry Pi from
|
||||
another computer](a2server_raspberrypi_login.md), including an Apple II.) If
|
||||
you wish to change any configuration options, type `raspi-config`.
|
||||
|
||||
For next steps, check out the links on the [A2SERVER home page](index.html).
|
||||
For next steps, check out the links on the [A2SERVER home page](index.md).
|
||||
|
||||
|
||||
_Already using a Raspberry Pi?_
|
||||
If you\'re already using Raspbian, you can install A2SERVER by typing at a Linux prompt:
|
||||
_Already using a Raspberry Pi?_ If you\'re already using Raspbian, you can
|
||||
install A2SERVER by typing at a Linux prompt:
|
||||
|
||||
`wget appleii.ivanx.com/a2server/setup; source setup`
|
||||
|
||||
The process is straightforward -- just respond to the prompts.
|
||||
|
||||
For next steps, check out the links on the [A2SERVER home page](index.html).
|
||||
For next steps, check out the links on the [A2SERVER home page](index.md).
|
||||
|
||||
|
||||
<!--
|
||||
(If you wish, you can read detailed technical information about the [AppleTalk networking support on the Raspberry Pi](a2server_raspberrypi_kernel.html) that A2SERVER installs.)
|
||||
(If you wish, you can read detailed technical information about the [AppleTalk
|
||||
networking support on the Raspberry Pi](a2server_raspberrypi_kernel.md) that
|
||||
A2SERVER installs.)
|
||||
-->
|
||||
|
||||
|
||||
[A2SERVER home page](index.html)
|
||||
|
||||
[1]: http://www.raspberrypi.org
|
||||
[2]: http://appleii.ivanx.com/rasppleii/
|
||||
[3]: http://appleii.ivanx.com/a2cloud
|
||||
|
||||
@ -1,9 +1,7 @@
|
||||
## A2SERVER
|
||||
|
||||
|
||||
|
||||
You need to access the Raspberry Pi\'s command prompt in order set up A2SERVER
|
||||
for network boot, and [do other stuff](a2server_commands.html).
|
||||
for network boot, and [do other stuff](a2server_commands.md).
|
||||
|
||||
The default username is \"pi\" and default password is \"apple2\". If you
|
||||
don\'t have a screen and keyboard attached, you can:
|
||||
@ -47,11 +45,6 @@ There are a few different options for logging in from an Apple II. They are:
|
||||
figure it out again.
|
||||
|
||||
|
||||
|
||||
|
||||
[A2SERVER home page](index.html)
|
||||
|
||||
|
||||
[1]: http://support.apple.com/kb/dl999
|
||||
[2]: http://www.chiark.greenend.org.uk/~sgtatham/putty/
|
||||
[3]: http://ivanx.com/raspberrypi/files/PiFinder.zip
|
||||
|
||||
@ -1,23 +1,39 @@
|
||||
## A2SERVER
|
||||
|
||||
A2SERVER lets you use a [Raspberry Pi][1], or almost any other computer, to serve files to Apple IIgs and enhanced IIe computers on your network. You\'ll also be able to boot into GS/OS or ProDOS 8 directly from tne network (no drives needed). A2SERVER has been designed to be as easy to set up and use as possible, and it\'s free.
|
||||
|
||||
<!--A2SERVER is available as a Raspberry Pi installer, or a virtual machine which runs on Mac OS X, Windows, Linux, or Solaris computers, or as an easy-to-use installer for Ubuntu or Debian Linux.
|
||||
A2SERVER lets you use a [Raspberry Pi][1], or almost any other computer, to
|
||||
serve files to Apple IIgs and enhanced IIe computers on your network. You\'ll
|
||||
also be able to boot into GS/OS or ProDOS 8 directly from tne network (no
|
||||
drives needed). A2SERVER has been designed to be as easy to set up and use as
|
||||
possible, and it\'s free.
|
||||
|
||||
<!--
|
||||
A2SERVER is available as a Raspberry Pi installer, or a virtual machine which
|
||||
runs on Mac OS X, Windows, Linux, or Solaris computers, or as an easy-to-use
|
||||
installer for Ubuntu or Debian Linux.
|
||||
-->
|
||||
|
||||
A2SERVER is based on open-source software, primarily [Netatalk][2] 2.2.4, with [many utilities and enhancements](a2server_features.md) to make everything as easy as possible. (If you like A2SERVER, you might also want to check out [A2CLOUD][3].)
|
||||
|
||||
<!--If you haven't checked out A2SERVER in a while: it now runs on something small, cheap, and silent, and every common LocalTalk-to-Ethernet bridge now works easily with a IIgs (as opposed to none previously). And A2SERVER supports Wi-Fi, and can download and install GS/OS on your network drive for you. Cool stuff!
|
||||
A2SERVER is based on open-source software, primarily [Netatalk][2] 2.2.4,
|
||||
with [many utilities and enhancements](a2server_features.md) to make
|
||||
everything as easy as possible. (If you like A2SERVER, you might also want to
|
||||
check out [A2CLOUD][3].)
|
||||
|
||||
<!--
|
||||
If you haven't checked out A2SERVER in a while: it now runs on something
|
||||
small, cheap, and silent, and every common LocalTalk-to-Ethernet bridge now
|
||||
works easily with a IIgs (as opposed to none previously). And A2SERVER
|
||||
supports Wi-Fi, and can download and install GS/OS on your network drive for
|
||||
you. Cool stuff!
|
||||
-->
|
||||
|
||||
_Update 19-Mar-15: A2SERVER 1.2.2 is available. It has support for Raspberry Pi 2 Model B and every other Raspberry Pi, and new command line options for the installer script. To update, type `a2server-setup`._
|
||||
_Update 19-Mar-15: A2SERVER 1.2.2 is available. It has support for Raspberry
|
||||
Pi 2 Model B and every other Raspberry Pi, and new command line options for
|
||||
the installer script. To update, type `a2server-setup`._
|
||||
|
||||
Choose how you\'d like to use A2SERVER, and you\'ll be up and running shortly.
|
||||
|
||||
* [Raspberry Pi](a2server_raspberrypi.md)
|
||||
* [Virtual Machine](a2server_virtualbox.md) (for Mac OS X, Windows, Linux, Solaris)
|
||||
* [Virtual Machine](a2server_virtualbox.md) (for Mac OS X, Windows, Linux,
|
||||
Solaris)
|
||||
* [Installer for Ubuntu or Debian Linux](a2server_installer.md)
|
||||
|
||||
|
||||
@ -30,7 +46,8 @@ Once you\'ve got it set up, here are next steps:
|
||||
|
||||
[Boot into ProDOS 8 or GS/OS over the network](a2server_netboot.md)
|
||||
|
||||
[Log into, shut down, and do stuff in the A2SERVER console](a2server_commands.md)
|
||||
[Log into, shut down, and do stuff in the A2SERVER
|
||||
console](a2server_commands.md)
|
||||
|
||||
[Access A2SERVER files from a Mac or Windows computer](a2server_access.md)
|
||||
|
||||
@ -45,24 +62,29 @@ And some other stuff that might (or might not) be helpful or interesting:
|
||||
|
||||
[Recover from a crashed A2SERVER](a2server_recovery.md)
|
||||
|
||||
[Details of what the \"a2server-setup\" script does](a2server_scriptdetails.md)
|
||||
[Details of what the \"a2server-setup\" script
|
||||
does](a2server_scriptdetails.md)
|
||||
|
||||
[See the March 2013 cover of Juiced.GS][4], featuring A2SERVER
|
||||
|
||||
[Watch me introduce A2SERVER at KansasFest 2011][5]
|
||||
(note: this contains some outdated information)
|
||||
[Watch me introduce A2SERVER at KansasFest 2011][5] (note: this contains some
|
||||
outdated information)
|
||||
|
||||
[The A2SERVER odyssey](a2server_story.md) (warning: long)
|
||||
|
||||
|
||||
Buckets of thanks to Steven Hirsch and Geoff Body, whose invaluable assistance and contributions have made A2SERVER exist, along with Tony Diaz, Antoine Vignau, Peter Wong, Martin Haye, Ken Gagne, Peter Neubauer, Anthony Martino, James Littlejohn, and others at comp.sys.apple2 and KansasFest. (As well as the creators, past and present, of Netatalk and Raspberry Pi.) Apple II Forever!
|
||||
Buckets of thanks to Steven Hirsch and Geoff Body, whose invaluable assistance
|
||||
and contributions have made A2SERVER exist, along with Tony Diaz, Antoine
|
||||
Vignau, Peter Wong, Martin Haye, Ken Gagne, Peter Neubauer, Anthony Martino,
|
||||
James Littlejohn, and others at comp.sys.apple2 and KansasFest. (As well as
|
||||
the creators, past and present, of Netatalk and Raspberry Pi.) Apple II
|
||||
Forever!
|
||||
|
||||
Questions? Comments? email [ivan@ivanx.com](mailto:ivan@ivanx.com)
|
||||
|
||||
[Apple II Extravaganza home page](http://appleii.ivanx.com/)
|
||||
|
||||
|
||||
|
||||
[1]: http://www.raspberrypi.org
|
||||
[2]: http://netatalk.sourceforge.net
|
||||
[3]: http://ivanx.com/a2cloud
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user