InstallationInstructionsForCedar10.tioga
Willie-sue Orr, January 24, 1992 11:13 am PST
InstallationInstructionsForPCedar
CEDAR 10.0 % FOR INTERNAL XEROX USE ONLY
InstallationInstructionsForCedar10
Ó Copyright 1992 Xerox Corporation. All rights reserved.
Created by: Nan Stumbo:Roch803:Xerox and extended by Willie Sue Orr:Parc:Xerox.
Maintained by: Willie Sue Orr:Parc:Xerox
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
1. Introduction
This document describes the procedure for installing Cedar10.0 and Printing10.0 on a Sun file server. It is assumed that the site is already running PCedar2.0.
2. Requirements
The following is a list of requirements for adding Cedar10.0 and Printing10.0.
8mm Video Tape Drive
Cedar10.0 and Printing10.0 require an additional 188Mb (Cedar10.0 will grow a lot soon):
/Cedar10.0 ~184Mb
/Printing10.0 ~4Mb
/xrhome ~21Mb (for 4𡤀.X)
/project/pcedar2.0 ~20Mb
3. Release Tape
The Cedar 10 Initial Release Tape contains the following directories:
xrhome/R←V.X (R←V - the current Release←Version number, i.e. 2�.X or 3𡤀.X)
/project/pcedar2.0
cedar10.0
printing10.0
There are two copies of the four on the tape; see accompanying listing with the tape.
The xrhome/R←V.X directory is the PCR code. /project/pcedar2.0 contains the fonts, scripts, and commands. The Cedar code / tools are in cedar10.0/release. Other useful unix tools are in cedar10.0/bin.
For a list of the contents of each of these directories see Appendix A.
A. Reading the tape
Reading the tape will take 1-2 hours (it took 30 minute to write one copy of the files).
NOTE: Due to the way the tape must be written it is necessary to first create the directories /fsrvr/project/pcedar2.0, and then change directory to it before reading this part of the tape. The problem is that the path names in the imagerfonts subdirectory get longer than tar will accept. The 'mt -f /dev/nrst1 fsf 1' commands are needed due to the program I use to generate the tape, which writes a block of EOFs after the file.
Login as root
# cd /fsrvr
# mkdir project
# mkdir project/pcedar2.0
# tar xvf /dev/nrst1  (extract directory xrhome/R←V.x)
# mt -f /dev/nrst1 fsf 1
# cd project/pcedar2.0
# tar xvf /dev/nrst1  (extract directory /project/pcedar2.0)
# mt -f /dev/nrst1 fsf 1
# cd /fsrvr
# tar xvf /dev/nrst1  (extract directory cedar10.0)
# mt -f /dev/nrst1 fsf 1
# tar xvf /dev/nrst1  (extract directory printing10.0)
# mt -f /dev/nrst1 rewind  (rewind the tape)
4. Setting up the Files on the File Server
There are a couple of modifications which need to be done to the files on the file server so that they are available to all workstations which will be running PCedar. The following sections describe these changes.
A. Establishing Links on the File Server
A link for the INSTALLED version of PCR needs to be established.
WARNING: Be very careful with the ln command. It will NOT give you an error message if the target directory/file does not exist!
# cd /fsrvr/xrhome
# ln -s R←V.x INSTALLED  (where R←V.x is the latest release of PCR)
5. Installing PCedar on a Workstation
There are two ways to set up (most of) the environment that the wordstation needs, to be able to run PCedar. If you have the Sun Yellow Pages running and are willing to create new automount maps, that is the easiest, especially if you have more than a couple machines. Otherwise, you need to install links on each of the machines.
YP maps
PCedar makes use of two yp maps. One, called project, needs only the entry pcedar2.0 (for PCedar's use). The second, called pseudo, needs to have entries for pcedar2.0, cedarcommon2.0, and xrhome. These entries need to reference to appropriate directories on your fileserver(s).
Cedar10.0 does not use the pseudo yp map; it uses project only. Cedar10.0 expects to find its .mesa (and other) files using the path /project/cedar10.0/release, so you must add cedar10.0 to your project yp map.
Links
Login as root
# cd /
# ln -s /fsrvr/project ./project
# mkdir pseudo
# cd pseudo
# ln -s /fsrvr/xrhome ./xrhome
Links needed on all Workstations
Login as root
# cd /usr/include
# ln -s /fsrvr/xrhome/INSTALLED/INCLUDE/xr ./xr
# ln -s /pseudo/pcedar2.0/links/include ./cedar
THE PCEDAR ENVIRONMENT IS NOW INSTALLED.
Appendix A
The following is either a list of files or a description of the contents for the various directories on the Cedar10 distribution tape.
xrhome/R←V.X/     (R - the current release number, i.e. 2, 3
V - the current version number, i.e. 12, 14, 0)
Code for the Portable Common Runtime (PCR)
/project/pcedar2.0/
X/
.twmrc      .xbitmap1       .xintirc   
.Xdefaults     .xbitmap2       .xmodmaprc
bin/
BecomeConsole    PCedarKill     StartXPen
CedarBasement    PCedarSetUp     TiogaToCRText
CedarCommander   PCedarTools     TiogaToInterpress
CedarCommanderNoOpt  PackageScript    TiogaToText
CedarNews     PressToInterpress   X11ViewersWorld
CommanderWorld   PrintTioga     XRDBX
FixPackage     PrintingWorld    ccc
GENcedar     RawViewersWorld   cedarrpcgen
GENdevcedar    RemoteDebugTool   kbd←mode
GenerateCedarScript   RemoteViewersHostWorld ldhide
GenerateCedarScript-Aux SetSticky      msScript
LocalShell     StartX       setupnewuser
imagerfonts/
xerox/
pressfonts    xc1        xc1-3-3
tiogafonts     xc1-2-2
In these diretories are the various font files
lang/
dbx
ld  (a version of ld that handles many more symbols)
lib/
cpp   cpp.c
scripts/
CedarBasement-Opt.pcr  CedarBasement.pcr   pcedar.login
src/
BecomeConsole.c    LocalShell.c      Makefile
cedar10.0/
release/
Code for the various Cedar Applications
bin/
GenerateCedarScript
GenerateCedarScript-Aux
printing10.0/
Code for the various Printing Applications