InstallationInstructionsForCedar10i.tioga
Willie-sue Orr, October 21, 1992 3:49 pm PDT
InstallationInstructionsForCedar10i
CEDAR 10.1 %
InstallationInstructionsForCedar10i
Ó 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

1. Introduction
This document describes the procedure for installing Cedar10.1 and Printing10.1 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.1 and Printing10.1.
8mm Video Tape Drive
Cedar10.1 and Printing10.1 require an additional 500Mb (Cedar10.1 is still growing so be warned):
/Cedar10.1 ~448Mb
/Printing10.1 ~37Mb
/xrhome ~21Mb (for 4𡤄.X)
/project/imagerfonts ~72Mb
3. Release Tape
The Cedar 10.1 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)
cedar10.1
/project/imagerfonts/xerox
(printing10.1)
There are two copies of the four (three if no printing10.1) on the tape; see accompanying listing with the tape.
The xrhome/R←V.X directory is the PCR code. /project/imagerfonts/xerox contains the fonts. The Cedar code/tools are in cedar10.1/release. Other useful unix tools are in cedar10.1/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/imagerfonts, 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.
Login as root
# cd /fsrvr
# tar xvf /dev/nrst1  (extract directory xrhome/R←V.x)
# tar xvf /dev/nrst1  (extract directory cedar10.1)
# mkdir project
# mkdir project/imagerfonts
# cd project/imagerfonts
# tar xvf /dev/nrst1  (extract directory /project/imagerfonts/xerox)
# cd /fsrvr
# tar xvf /dev/nrst1  (extract directory printing10.1 if present)
# 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 Cedar. 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 Cedar on a Workstation
There are two ways to set up (most of) the environment that the wordstation needs, to be able to run Cedar. 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
Cedar makes use of two yp maps. One, called project, needs only the entry cedar10.1 (for Cedar's use). The second, called pseudo, needs to have an entry for xrhome. These entries need to reference to appropriate directories on your fileserver(s).
Cedar10.1 does not use the pseudo yp map; it uses project only. Cedar10.1 expects to find its .mesa (and other) files using the path /project/cedar10.1/release, so you must add cedar10.1 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 /project/cedar10.1/include ./cedar
THE CEDAR 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/imagerfonts/
xerox/
diagnostic    pressfonts     xc1-1-1
graphics     ps        xc1-2-2
internal     tiogafonts      xc1-3-3
In these directories are the various font files
cedar10.1/
bin/
BasicViewersWorld    kbd←mode     tiogaxopen
ccc        ldhide      ToolsWorld
CedarCommander    LocalShell     withdrawxviewers
cedarrpcgen      migrationtool     X11ViewersWorld
CedarSetUp      msScript      xadobe
cedarxcommander    PackageScript    XCedar10.1Commander
cedarxscanner     peekcedar     XCedar10.1DynamicViewers
cedarxviewers     pseudokeyboard    XCedar10.1HostWorld
cliphack       quitxcedar     XCedar10.1PackagedViewers
CommanderWorld    RawViewersWorld   XCedar10.1ReOpen
do-cedar-command    RemoteDebugTool   XCedar10.1ServerViewers
ensure-cedar-server    RemoteViewersHostWorld XCedar10.1Withdraw
FixPackage      SetSticky      xcredentials
GENcedar      setupnewuser    xmaintain
GENdevcedar     slate       XRDBX
GenerateCedarScript    StartX
GenerateCedarScript-Aux  StartXPen
bin/sun4/
cedarrpcgen
doc/
CedarPrimer.interpress
CedarPrimer.ps
README
include/
CedarExtra.h
InstallationSupport.h
mesa.h
lang/
ld  (a version of ld that handles many more symbols)
lib/
cpp
cpp.c
cpp.MakeIt
newaccount/
.cshrc
.login
release/
Code for the various Cedar Applications
scripts/
cedar.login
src/
,LocalShell.c     LocalShell.c     Mx.Local.1
,Makefile      LocalShellOld.c
BecomeConsole.c    Makefile
src/SCCS
s.LocalShell.c     s.Makefile
top/
bringover
disable
enable
README
X/
.openwin-menu    .xbitmap2      .Xmodmap   
.twmrc      .Xdefaults     .xmodmaprc   
.xbitmap1      .xinitrc
printing10.1/
Code for the various Printing Applications