\begindata{text,538331704}
\textdsversion{12}
\template{default}
\define{symbola
menu:[Font~1,SymbolA~86]
attr:[FontFamily symbola Int 0]}
\define{realsmall
menu:[Font~1,RealSmall~88]
attr:[Script PreviousScriptMovement Point -4]
attr:[FontSize PreviousFontSize Point -4]}
\define{helv
menu:[Font~1,Sans Serif~82]
attr:[FontFamily AndySans Int 0]}
\define{definition
menu:[Region~4,Definition~85]
attr:[LeftMargin LeftMargin Cm 138717]
attr:[RightMargin RightMargin Cm 138717]
attr:[FontSize PreviousFontSize Point -2]}
Installation Instructions \


April, 1995


The binary distribution made available by the Andrew Consortium is 
separated \


into individual sections or "packages".  The following packages are 
available \


for each system type: \



	wp - for those wanting a basic word-processor

	doc - documentation only

		help files, documenation and various sample files

	src - for Source Code developers

	mail - for users wanting the MIME-compatible mail interface

	full - all of the above plus.  See the file pub/AUIS/bin-dist/full.list 
for a \


		listing of applications included in the full distribution.  \



Installation instructions for each package are the same, although some 
packages \


require that other components are installed first. The instructions are 
copied for \


each package instructions listed below. \



INTRODUCTION


The Andrew User Interface System is an integrated set of tools that allow 
you \


to create, use, and mail documents and applications containing 
typographically \


formatted text and embedded objects.  AUIS has three principal components:


    The Andrew User Environment (AUE) is an integrated set of applications \


    beginning with a 'generic object' editor (ez), a help system, a \


    system monitoring tool (console), an editor-based shell interface \


    (typescript), and support for printing multi-media documents. \



    The Andrew Toolkit (ATK) is a portable user-interface toolkit.  \


    It provides a dynamically-loadable, object-oriented environment \


    wherein objects can be embedded in one-another. Thus, one \


    could edit text that contains not only fonts and styles, but also \


    embedded raster images, spreadsheets, drawing editors, \


    equations, simple animations, etc. These embedded objects could

    themselves contain other objects, including text. ATK is an open \


    system so programmers can create new objects that can be

     embedded as easily as those system-defined objects. \



    The Andrew Message System (AMS) provides a multi-media \


    interface to mail and bulletin-boards.  AMS supports several \


    mail management strategies and implements many advanced \


    features including authentication, return receipts, automatic \


    sorting of mail, vote collection and tabulation, enclosures, \


    audit trails of related messages, and subscription management. \


    It also provides a variety of interfaces that support ttys and low-

    function personal computers in addition to the high-function \


    workstations. \



History: In 1982 Carnegie Mellon and IBM entered into a joint \


venture and formed the Information Technology Center to \


design a very powerful, advanced function workstation and \


distributed computing environment on campus.    This \


environment is known as the Andrew System, named for \


the university's two major benefactors, Andrew Carnegie \


and Andrew Mellon.  In 1992, the School of Computer Science \


formed the Andrew Consortium to extend, support and \


distribute the Andrew User Interface System  (AUIS).


INSTALLATION NOTES FOR THE WP PACKAGE


This packaged is distributed as a single gzip'd tar file of \


approximately 1.4 MB  which will expand to approximately \


4.5 MB of disk space.  To install this package, do the \


following as root:


        cd \{install_dir_path\}

        gunzip < \{path-to-file\}/auis63\{sys-abr\}\{level\}-wp.tgz | tar 
-xvf - \


        setenv ANDREWDIR \{install_dir_path\}/auis-6.3.1

        $ANDREWDIR/etc/complete-setup wp


This will create a hierarchy of files under $ANDREWDIR.  None of these

files require root authority.  A set of binaries is distributed in

$ANDREWDIR/bin.  Add this path to your PATH so they can be executed:


    	setenv PATH $\{PATH\}:$ANDREWDIR/bin


AUIS is highly tailorable for your personal needs and preferences.  \


Some might say there is too much.  To get you started, create a file \


called "preferences" in your home directory for AUIS:


    	cp $ANDREWDIR/sample.preferences $HOME/preferences


This sample preferences is aimed at folks with color displays.  If \


your system only supports monochrome, you'll want to remove \


the color settings in "preferences" right away.  Edit your preferences

file and follow the comments.


INSTALLATION NOTES FOR THE DOC PACKAGE


This package requires that you have already installed the AUIS Word

Processing package, auis63??-wp.tgz.  This consists simply of the AUIS

help files, documentation and various sample files.


This packaged is distributed as a single tar file of approximately 5.2

MB which will expand to approximately 8 MB of ADDITIONAL disk space over \


whatever you might already have installed.   To install this package, do 
the \


following as root:

	cd \{install_dir_path\}  	\


	gunzip < \{path-to-file\}/auis63\{sys-abr\}\{level\}-doc.tgz | tar -xvf - 	

	setenv ANDREWDIR \{install_dir_path\}/auis-6.3.1  	\


	setenv PATH $ANDREWDIR/bin:$PATH  	\


	$ANDREWDIR/etc/complete-setup doc


This will add files to auis-6.3.1 that you created earlier with -wp package.

After installing, look at the files in

$ANDREWDIR/\{doc,help,lib/rasters,lib/samples\}.  You will also  find the

application "launch" of interest.  It will start you on a tour of AUIS.

Exactly what will work for you will depend on which AUIS packages you

have installed, but they should fail gracefully with messages generated

to your xterm.



INSTALLATION NOTES FOR THE FULL PACKAGE


This is one of the several planned versions.   AUIS can be difficult to

describe fully since it encompasses such a large variety of applications

and uses.  In an effort to break this into something more manageable,

both in size and scope, we have created specific packages which are

aimed at people interested in either the mail package, source, doc or

word processing.  This "full" package contains all of the above along

with other niceties that don't fit into any of the above categories.  \



This packaged is distributed as a single gzip'd tar file of

approximately 10-15 MB which will expand to approximately 40-50 MB of

disk space. To install this package, do the following as root:


	cd \{install_dir_path\}

	gunzip < \{path-to-file\}/auis63\{sys-abr\}\{level\}-full.tgz | tar -xvf - 

	setenv ANDREWDIR \{install_dir_path\}/auis-6.3.1

	setenv PATH $ANDREWDIR/bin:$PATH


AUIS is highly tailorable for your personal needs and preferences.  To

get you started, we've done a great deal for you in this area.  We have

created a sample preferences in $ANDREWDIR. If you made no changes to

this for the word processing package, just do the following copy. \



    cp $ANDREWDIR/sample.preferences $HOME/preferences


If you made changes, you will need to "merge" (by hand) your changes

into this new preferences.  This would be a good time to learn about

ezdiff (enter "auishelp ezdiff" in your xterm).  This sample preferences

is aimed at folks with color displays.  If your system only supports

monochrome, you'll want to remove the color settings in "preferences"

right away.  Edit your preferences file and follow the comments.


INSTALLATION NOTES FOR THE MAIL PACKAGE


This particular package is aimed principally at people who are seeking \


a MULTI-MEDIA and BETTER MAIL INTERFACE.  Messages was the \


one of the very first MIME-compliant mailers.


This package requires that you have already installed the AUIS Word \


Processing package, auis63??-wp.tgz.  \



This document assumes you already have a working mail system.  We assume \


you already can send mail and have something to receive and display mail \


sent to you.  This software will do nothing for you until that works. \


Think of  this software as a better version of "elm" (for instance).


Messages is also a MIME mailer.  It was written by the originator of the \


MIME rfc, Nathaniel Borenstein.  With messages you can mail pictures and

text with fonts to others who have MIME-compliant mailers.  \



Be forewarned.  The messages program is NOT fully compatible with other \


mailers.  It saves mail you receive as separate (and indexed) files in \


$HOME/Mailbox, rather than in a single file in $HOME/Mail (more on this \


elsewhere in the document).


This packaged is distributed as a single tar file of approximately 2.0

MB which will expand to approximately 4.8 MB of ADDITIONAL disk space over 
that \


required for the word processing package.  To install this package, do the

following as root:


	cd \{install_dir_path\}

	gunzip < \{path-to-file\}/auis63\{sys-abr\}\{level\}-ez.tgz | tar -xvf - \


	setenv ANDREWDIR \{install_dir_path\}/auis-6.3.1

	setenv PATH $ANDREWDIR/bin:$PATH

	$ANDREWDIR/etc/complete-setup mail


This will add files to $ANDREWDIR that you created earlier with the -wp

package.



INSTALLATION NOTES FOR THE SRC PACKAGE


This particular package is aimed principally at people interested

in SOURCE CODE DEVELOPMENT.


This package requires that you have already installed the AUIS Word 
Processing \


package, auis63??-wp.tgz.   This document assumes you have installed and 
are \


reasonably familiar with the word processing incantation of ez.  This is 
just \


another "personality" of ez - geared for the programmer.


This packaged is distributed as a single gzip'd tar file of approximately 
0.8 MB

which will expand to approximately 1.3 MB of ADDITIONAL disk space over 
that \


required for the word processing package.  To install this package, do

the following as root:


    	cd \{install_dir_path\}

        gunzip < \{path-to-file\}/auis63\{sys-abr\}\{level\}-src.tgz | tar 
-xvf - \


        setenv ANDREWDIR \{install_dir_path\}/auis-6.3.1

        setenv PATH $ANDREWDIR/bin:$PATH

        $ANDREWDIR/etc/complete-setup src


This will add files to $ANDREWDIR that you created earlier with the -wp

package.


NOTE FOR SUNOS USERS:  \



If you are not using the standard user account setup,  you may need to set 
LD_LIBRARY_PATH.  Issue the following command before bringing up any Andrew 
application: \



setenv LD_LIBRARY_PATH 
$\{ANDREWDIR\}/lib:$\{XLIBDIR\}:/lib:/usr/lib:/usr/ccs/lib


This will ensure that all the shared libraries needed for Andrew can be 
found.  \



NOTE FOR ALL PACKAGE INSTALLATIONS:  Your site may not have resolver code 
built into its internals.  If not, you will see the error: \



	ld.so: Undefined symbol: _dn_skipname


when trying to bring up an Andrew application.  If this happens, pick up 
the file pub/AUIS/bin-dist/sun4_41/resolv.tgz from the ftp site 
ftp.andrew.cmu.edu.  Issue the following command: \



	gunzip < resolv.tgz | tar -xvf - \



There will be three new files: \


	doindex.resolv

	runapp.resolv

	whichdo.resolv


Then do the following to install the new files: \



% gunzip < resolv.tgz | tar -xvf -

% foreach i (doindex runapp whichdo)

? mv $ANDREWDIR/bin/$i $ANDREWDIR/bin/$i.orig

? cp $i.resolv $ANDREWDIR/bin/$i

end




--------------------------------------------------------

CONTACT INFORMATION


Susan Straub

System Manager


Andrew Consortium

School of Computer Science

Carnegie Mellon University

5000 Forbes Avenue

Pittsburgh, PA  15213-3890						\



Phone:	(412) 268-6710

Fax:		(412) 268-5571

Email:	info-andrew-requests@andrew.cmu.edu.		\


Bugs:	info-andrew-bugs@andrew.cmu.edu

News:	info-andrew@cmu.edu

Web:	
http://www.cs.cmu.edu/afs/cs.cmu.edu/project/atk-ftp/web/andrew-home.html

Demo:	finger @atk.itc.cmu.edu

Access:	ftp.andrew.cmu.edu: pub/AUIS/README

\enddata{text,538331704}
