From 9a781b9b4aa7552bf7ac16817df69cf43801c395 Mon Sep 17 00:00:00 2001 From: "T. Joseph Carter" Date: Thu, 22 Oct 2015 13:00:35 -0700 Subject: [PATCH] Add a2server_commands.md --- docs/ivanx/a2server_commands.md | 128 ++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 docs/ivanx/a2server_commands.md diff --git a/docs/ivanx/a2server_commands.md b/docs/ivanx/a2server_commands.md new file mode 100644 index 0000000..fe00127 --- /dev/null +++ b/docs/ivanx/a2server_commands.md @@ -0,0 +1,128 @@ +## A2SERVER + +Sometimes you need to access the A2SERVER command line to set up network boot +or do other stuff. A list of commands is below. + +If you are running A2SERVER on a Raspberry Pi without a screen and keyboard +attached, see how to +[log in to a Raspberry Pi](a2server_raspberrypi_login.md). + +Otherwise, log in on your local console or virtual machine window, or via SSH +on another computer. On Mac OS X, or Windows with [Bonjour Print Services][1] +installed, you can use \"raspberrypi.local\" for your SSH address, or +\"a2server.local\" if not on a Pi. If that doesn\'t work, try updating +A2SERVER by typing `a2server-setup`. + +If it still doesn\'t work, or you don\'t want to install Bonjour Print +services for Windows, you will need to use A2SERVER\'s IP address instead, +which you can see by typing `showip`. You can create a DHCP reservation in +your router to give A2SERVER the same IP address every time. To do this, +you\'ll need the MAC (Ethernet) address of the machine (or virtual machine) +running A2SERVER, which you can see by typing `showmac`. If you are using the +premade virtual machine, the MAC is 08:00:03:F2:FF:59 . + +The default username is either \"pi\" for Raspberry Pi, and otherwise +\"user1\". The password is \"apple2\". (The password is \"raspberry\" for an +standard installation of Raspbian; you can use the +[installer script](a2server_installer.md) to install A2SERVER.) + +Shared volumes can be found at /media/A2SHARED. Netatalk configuration files +are in /usr/local/etc/netatalk. + +Once logged in, you can enter the following commands. + +(If any of these yield \"command not found\", refresh the command list by +typing `a2server-setup`, answering \"no\" to all prompts if you like.) + + +``` +A2SERVER commands: + (note: new commands may be added; use a2server-setup to refresh) + +a2server-help: show this list of commands +a2server-setup: set up network boot, Windows access, Farallon fix, + refresh command list +a2server-version: see installed version of A2SERVER +a2server-update: check for update to A2SERVER + +system-shutdown: shut down the server +system-restart: shut down and restart the server + + Raspberry Pi commands, if you're using one: +raspi-config: utilize all space on RPi SD card & other options +raspbian-update : update Raspbian operating system +rasppleii-update : update Raspbian OS, A2CLOUD, A2SERVER, Apple II Pi + +welcome-message-edit: change the welcome message + +showip: show the current ethernet IP address of the server +showmac: show the MAC (Ethernet hardware) address of the server +showip-wifi: show the current wifi IP address of the server +showmac-wifi: show the MAC (wifi hardware) address of the server +ifreset: reset all network interfaces (requires restart) + +netatalk-stop: stop the netatalk service until reboot +netatalk-start: start the netatalk service +netatalk-restart: restart the netatalk service +netatalk-off: disable the netatalk service (even after reboot) +netatalk-on: enable the netatalk service + +bonjour-off: disable advertisement of shared folders to OS X +bonjour-on : enable advertisement of shared folders to OS X + (these are automatically set by the netatalk commands above) + +netatalk-router-on: use netatalk in router mode (default) +netatalk-router-off: use netatalk in node mode + (use if there is an AppleTalk router such as a GatorBox present) + +netatalk-eth: use wired ethernet interface for netatalk (default) +netatalk-wifi: use wifi interface for netatalk + note: if an interface isn't available, netatalk will be reset with + router mode off; use "netatalk-router-on" to correct this if needed + +appletalk-off: disable AppleTalk networking (even after reboot) +appletalk-on : enable AppleTalk networking + +environment variables: +$NETATALK: directory containing netatalk configuration files +$A2FILES : directory containing A2FILES shared volume +$GSFILES : directory containing GSFILES shared volume + +netboot-gsos: set the current user to netboot into GS/OS (default) +netboot-gsos-guest: set guests to netboot into GS/OS +netboot-p8: set the current user to netboot into ProDOS 8 +netboot-p8-guest: set guests to netboot into ProDOS 8 (default) + note: when a IIgs is set to network boot into GS/OS, using the Network + control panel or the NETBOOT.GSOS utility, guests will behave like + registered users, and ignore the netboot setting of the guest user + +guest-off: disallow guest access to A2SERVER +guest-on: allow guest access to A2SERVER (default) + note: by default, Guest access is the only way to network boot into + ProDOS 8. For registered user boot into ProDOS 8, type "netboot-p8" + +samba-off: disable Windows file sharing (even after reboot) +samba-on: enable Windows file Sharing +samba-stop: stop Windows file sharing until reboot +samba-start: start Windows file sharing +samba-restart: stop and restart Windows file sharing + +gsfiles-share: disable the GSFILES shared volume +gsfiles-unshare: enable the GSFILES shared volume +a2files-share: disable the A2FILES shared volume +a2files-unshare: enable the A2FILES shared volume + +nulib2: create, extract, and work with NuFX (ShrinkIt) archive files +unar: extract other archive files (multiformat) +lsar: list contents of other archive files (multiformat) + +afptype: set the ProDOS type/auxtype or Mac OS type/creator of a file +afpsync: register files introduced outside of AFP with netatalk +mkatinit: set up network boot configuration files +cppo: catalog and copy files from ProDOS image file (slow, but works) + (add -h to show help for the above four commands, e.g. "afptype -h") + +``` + + +[1]: http://support.apple.com/kb/dl999