1
0
mirror of https://github.com/RasppleII/a2server.git synced 2025-01-03 17:30:33 +00:00
AppleTalk server for Apple II computers
Go to file
T. Joseph Carter 8897610d95 Scripts: re-indent (tab indentation)
One of the reasons I held off on doing this before is that there are a
lot of complex one-line seds in here that I expect _will_ be broken by
this.  More than a few of these will assume, depend on, require, and
break if specific hardcoded whitespace is not found.  That's problematic
anyway--when whitespace isn't syntactic, you shouldn't do that.  So it's
time to fix these anyway.
2016-10-25 12:12:11 -07:00
files Scripts: re-indent (tab indentation) 2016-10-25 12:12:11 -07:00
fix Scripts: re-indent (tab indentation) 2016-10-25 12:12:11 -07:00
scripts Scripts: re-indent (tab indentation) 2016-10-25 12:12:11 -07:00
setup Scripts: re-indent (tab indentation) 2016-10-25 12:12:11 -07:00
update Scripts: re-indent (tab indentation) 2016-10-25 12:12:11 -07:00
LICENSE.md
README.md README.md: code spans to avoid _ errors 2016-02-15 03:52:32 -08:00

A2SERVER

AppleTalk server for Apple // computers developed by Ivan Drucker

Documentation here is sparse for the moment; see Ivan's site for information about A2SERVER and how it all works. There's a lot there and it's kind of evolved organically over the years just as the scripts themselves have, so it's going to be awhile before that information can be backfilled and perhaps organized into something you might call a user manual.

Such a manual should not be considered a replacement for Ivan's organic online documentation--those contents themselves represent Apple // history, if a relatively modern piece of it. As such they should be preserved as they are.

Developer note

To use the scripts on your own server, including your local machine:

export A2SERVER_SCRIPT_URL=http://yoururl.com/

To prevent needing to recompile various packages from source code during installation, a number of precompiled binary files are downloaded for Raspbian, Debian-x86, and Debian-amd64. If you wish to host these on your own server:

export A2SERVER_BINARY_URL=http://yoururl.com/files/

You do not need to use a subdirectory called "files", or the same server, but that's the normal arrangement. The precompiled packages are available here: http://ivanx.com/a2server/files/dist/a2serverbinaries.tar.gz

Several Apple II third-party binaries are downloaded during installation, as well as third-party source code if precompiled binaries are unavailable or you don't wish to use them. If you want these external dependencies locally during development, they need to go into a folder called "external" in the binaries URL, and that needs to contain folders called "appleii" and "source". To download all of these external packages, download and run the shell script at http://ivanx.com/a2server/files/dist/getexternal.sh.

Once you have those:

export A2SERVER_NO_EXTERNAL=1

You may want to put the above exports into ~/.bashrc or ~/.bash_profile.

If you want to host scripts locally installed on your own machine or another computer on your LAN, type the following, and export "http://localhost:8000/" or "http://lan.ip.address:8000/" for the above URL's.

python -m SimpleHTTPServer

Once you're set, you can then run the following snippet to install A2SERVER:

wget -O setup ${A2SERVER_SCRIPT_URL}setup/index.txt; source setup

Offline install:

Using locally hosted binaries and external dependencies, it's possible to install completely offline if dependent packages have been installed.

If precompiled binaries are available, on Wheezy:

sudo apt-get -y install unzip libgnustep-base1.22 libdb5.1 libgcrypt11 libssl1.0.0 attr fuse libglib2.0-0 libattr1 libfuse2

If precompiled binaries are available, on Jessie:

sudo apt-get -y install unzip unar libdb5.3 libgcrypt20 libssl1.0.0 attr fuse libglib2.0-0 libattr1 libfuse2

If precompiled binaries are not available, on Wheezy:

sudo apt-get -y install unzip build-essential zlib1g-dev libgnustep-base-dev libz-dev libbz2-dev libssl-dev libicu-dev libdb5.1-dev libgcrypt11-dev libglib2.0-dev libattr1-dev libfuse-dev

If precompiled binaries are not available, on Jessie:

sudo apt-get -y install unzip unar build-essential zlib1g-dev unzip libssl-dev libdb5.3-dev libgcrypt11-dev libglib2.0-dev libattr1-dev libfuse-dev