ABOUT THE OCTOPUS
----------------------
See http://lsub.org/ls/octopus.html for further information.
NOTE: If you use just the octopus binaries as distributed,
the version of the standard Inferno modules must match the one
we used (the one from google code as of 20080416).
Otherwise, you'll get typecheck errors when trying to load
some Inferno modules. If you are using the Inferno bundled
in the Octopus distribution there is no need to worry about it.
INSTALLATION INSTRUCTIONS FOR THE PC
---------------------------------
Download the .tgz file containing this INSTALL file to
the directory where you want to install a new Inferno with
the octopus. Unpack it, and execute the install script for your
system:
1. create a directory where to install all this, and change to it.
mkdir /n/src/octopus
cd /n/src/octopus
2. retrieve the distribution if you do not have it yet; unpack it.
hget http://lsub.org/export/o.zip >.zip
unzip o.zip
3. execute the install script for your system.
That, is run EITHER
; rc ./usr/octopus/lib/Install.Plan9.rc
OR
$ sh ./usr/octopus/lib/Install.Unix.sh
depending on the system you are using
4. you are done.
you may restart your Inferno and execute
o/pcrc
from a shell to bring up your octopus PC.
The last section in this file mentions some scripts
you may use to let the PC start automatically, without
requiring your intervention.
INSTALLATION INSTRUCTIONS FOR A TERMINAL
-------------------------------------
The easiest way is to copy the Inferno you have
installed for the PC, perhaps to a memory stick, and
use it at the terminal machine to run o/termrc
To install a fresh terminal:
1. create a directory where to install all this, and change to it.
mkdir /n/src/octopus
cd /n/src/octopus
2. retrieve the distribution if you do not have it yet; unpack it.
hget http://lsub.org/export/o.zip >.zip
unzip o.zip
3. execute the terminal install script for your system.
That, is run EITHER
./usr/octopus/lib/Installterm.Plan9.rc
OR
./usr/octopus/lib/Installterm.Unix.sh
4. you are done.
you may restart your Inferno and execute
o/termrc
on a shell window to start your octopus terminal.
The last section in this file mentions some scripts
you may use to let the PC start automatically, without
requiring your intervention.
INSTALLATION DETAILS FOR THE PC
----------------------------
Should the scripts fail for you, or should you use a different
system as your native OS, you might have to do by hand what the
installation script does. It's not hard:
1. create your home directory
mv usr/inferno usr/YOURLOGIN
2. configure the /lib/ndb/local
Editing the words written in UPPERCASE to match your
local configuration would suffice.
3. setup nvram
Write your secret to keydb/nvr (plaintext, sorry) so that
the PC may start unattended. Or don't do it if you don't want
risks, but you'll have to provide this secret each time the PC boots.
echo -n secret > keydb/nvr
chmod 600 keydb/nvr
cp /dev/null keydb/keys
4. Start inferno
Plan9/386/bin/emu -r /n/src/octopus
(or MacOSX/386/bin/emu, or whatever, depending on the system
you are using. Also, replace /n/src/octopus with the root directory
for the installation).
All remaining steps must be done using the Inferno shell.
5. Configure authentication and create your account
This creates a signer key for the machine
auth/createsignerkey YOURSYSNAME.YOUR.DOMAIN.NAME
Now start authentication services...
ndb/cs
svc/auth -n /keydb/nvr # or just svc/auth if you don't have nvr
...and create an account for you
auth/changelogin YOURUSERNAME
6. Obtain a ticket for your server account
This gives the processes in the PC your ticket, so they can auth without
requiring you to do this, so remember to save the ticket to a file.
getauthinfo default
7. You are done.
You may now kill the Inferno and start it again for normal operation.
To start the Octopus PC you must run
o/pc
from a shell.
To start the terminal you must run
o/termrc
instead. Note that the pc start script runs the termrc start
script as well, to let you use the pc as a terminal.
But you might what to customize your $home/lib/wmsetup let
the system start automatically.
COMPILING FROM SOURCE
--------------------
Within Inferno:
cd /usr/octopus
OCTOPUS=/usr/octopus
cd port
mk install
...
mk clean
(At a terminal, /usr/octopus would be /pc/user/octopus instead).
EXAMPLE SCRIPTS AND PROGRAMS
---------------------------
Read the scripts before using them. You may want to customize
some variables to your needs (eg., the install directory).
You may copy usr/octopus/lib/wmsetup to $home/lib/wmsetup
to let Inferno start the PC or the termiinal when you login, without
requiring your intervention. Edit the variable PC to be the address
of your PC.
A script for Plan 9 to start Inferno from the shell may be found at
usr/octopus/lib/octopus.rc
A script for UNIX to start Inferno from the shell may be found at
usr/octopus/lib/octopus.sh
Finally, 9octopus.tgz contains several Plan 9 programs for
use with the Octopus.