gno/verbatim/boot/README.install

86 lines
3.6 KiB
Plaintext
Raw Normal View History

$Id: README.install,v 1.3 1999/01/18 01:59:52 gdr-ftp Exp $
The install scripts assumes that your _new_ distribution will be installed
on to the two volumes /gno (ProDOS) and /gno-hfs (HFS). It also assumes
these volumes already exist and are _empty_. You may use other volume names,
but you will have to edit certain files before you run your distribution.
If your volumes are named something else, replace the names in the cd commands
below with the appropriate name.
You should now do the following steps:
1. Set your DOWNLOAD_DIR environment variable to the directory
into which you placed the above NuFX (*.shk) files. For example,
if the files gnohfs.shk, gno.01.shk, gno.02.shk (and so forth)
were in /download, you would type:
setenv DOWNLOAD_DIR /download
Ensure that you use slashes ( /) rather than colons ( :) as the
pathname delimiter. Do not use a trailing slash.
2. Install the majority of the GNO base distribution files by
changing directory into your destination directory and running
the installboot1 script. Assuming that you will be installing
to the partition /gno, the commands would be:
cd /gno
/gno.boot/installboot1
This step takes quite a while, even with an accelerated IIgs.
Have patience.
3. There are a small number of recommended files that do not follow
ProDOS naming conventions. If you wish to install these files,
make sure that you have an HFS or Appleshare disk online. Change
directories to that disk (or subdirectory) and run installboot2.
Assuming that the HFS disk is /gno-hfs, the commands are:
cd /gno-hfs
/gno.boot/installboot2
This step is optional. It is possible to use the GNO binary
distribution without an HFS partition, but some information
will be missing.
4. You should now edit the file /gno/etc/namespace. If your
files were extracted onto a volume other than /gno, you will
have to replace all the ":gno:" strings with the appropriate
path. Similarily, you will have to replace ":gno-hfs:" if
that is not the name of your HFS (or Appleshare) partition
where you ran the installboot2 script.
The gno.boot disk includes the vi utility to do these edits.
You can also edit the namespace file with any other text editor
of your choosing, as long as it is done before you try to run
your new GNO distribution.
A vi tutorial and quick reference guide may be found at
http://www.jaws.umn.edu/~tobkin/vi.
See the kernel reference manual for a description of the
namespace file.
5. If you are not short of disk space, you should create .so links
for your manual pages. (See the mkso(8) man page for an
explanation.) You can do this by executing the following
commands:
cd /gno/usr/man
mkso -v -H /gno-hfs/man mkso.data
If you installed GNO somewhere other than /gno and /gno-hfs, then
edit the above lines accordingly. If you did not install files
onto an HFS (or Appleshare) partition at all, then execute the
following commands instead:
cd /gno/usr/man
mkso -v mkso.data
6. You should now return to your program launcher (the Finder,
ProSEL-16, or whatever you used to start /gno.boot/kern) by
typing "exit" at the prompt. To startup up your new version
of GNO, you should then launch /gno/kern. You will then see
a "login:" prompt. Enter "root" as the user name; you will
not yet need a password.