LocalCedarDoc.tioga
Copyright Ó 1992 by Xerox Corporation. All rights reserved.
Ken Pier, June 29, 1993 6:55 pm PDT
LocalCedarDoc
CEDAR 10.1 FOR INTERNAL XEROX USE ONLY
Local Cedar
Running Cedar from your Local Machine
Ken Pier
Ó Copyright 1993 Xerox Corporation. All rights reserved.
Abstract: This document is a cookbook for transferring Cedar attachments and files to a Local SPARCStation, thus freeing the frustrated user from most of the vagaries of the local area network by executing Cedar from the local disk. The instructions herein use files and commands created by Michael Plass; Ken Pier only records the procedure, passed down, as part of our oral tradition, from Eric Bier.
Created by: Ken Pier
Maintained by: Ken Pier, Michael Plass
Keywords: Cedar, network, disk, !@#$%
XEROX Xerox Corporation
Palo Alto Research Center
3333 Coyote Hill Road
Palo Alto, California 94304
For Internal Xerox Use Only
1. Introduction
What
Loading up a local SPARCStation disk with Cedar packages and executing mostly from the local disk.
Why
To reduce start-up time. To remove dependencies on the local network. To reduce frustration.
Caution
This procedure creates a snapshot of the current Cedar release on your local disk. You will have to repeat part of the procedure each time you want to update your Cedar world.
2. How
In the following, "yourHOSTname" should be replaced by your SPARCStation name, and "yourUSERname" should be replaced by your UNIX user name.
1. Make space
You will need about 50 Megabytes of free space on /yourHOSTname. To check:
In a UNIX shell:
% cd /yourHOSTname
% df .
Will show something like:
Filesystem kbytes used avail capacity Mounted on
/dev/sd0h 309557 153988 124614 55% /yourHOSTname
This shows 124 MBytes available space.
2. Make directories
If they don't already exist, create directories /yourHOSTname/yourUSERname/bin and /yourHOSTname/cedar10.1/release:
In a UNIX shell:
% cd /yourHOSTname/yourUSERname
% mkdir bin
% cd /yourHOSTname
% mkdir cedar10.1
% cd cedar10.1
% mkdir release
3. Bringover /Cedar/Top/LocalCedar.df
LocalCedar.df contains various files you will tailor to your own workstation and user name. Bringover LocalCedar.df into /yourHOSTname/yourUSERname/bin; you will modify files there.
In a CedarCommander
% cd /yourHOSTname/yourUSERname/bin
% bringover /Cedar/Top/LocalCedar.df
4. .login-entry
Modify the file /yourHOSTname/yourUSERname/bin/.login-entry with the appropriate substitution for yourHOSTname and yourUSERname, then copy the entry into your .login file after any PATH setup. Be careful to add no Tioga formatting to .login. If you are unsure, use the Cedar utility writeplain to remove all formatting from .login, or use InstallTiogaPlain to get a "Plain" button in your Tioga viewers.
5. CacheCedarFiles.cm, LocalCedarCommander, LocalCedar.pma, RVL, XVL, CleanLocalCedar
Open each of these files and do the appropriate substitution for yourHOSTname and yourUSERname in each file. Save each modified file back onto directory /yourHOSTname/yourUSERname/bin/. Be careful to add no Tioga formatting. If you are unsure, use the Cedar utility writeplain to remove all formatting from these files, or use InstallTiogaPlain to get a "Plain" button in your Tioga viewers.
6. Execute CacheCedarFiles.cm
CacheCedarFiles.cm contains commands for making attachments and moving Cedar files to the local disk. Execute it and expect it to take a very long time to complete, since it makes heavy use of the Cedar release directory, which is exactly what you are trying to avoid.
In a CedarCommander:
% source /yourHOSTname/yourUSERname/bin/CacheCedarFiles.cm
Go have lunch.
7. Execute LocalCedarCommander
At this point, you want to get a "fresh" Cedar world. Go out to your UNIX prompt, and:
% cd /yourHOSTname/yourUSERname/bin
If you want to use RawViewers, execute:
% ./LocalCedarCommander RawViewers
If you want to use X11Viewers, execute:
% ./LocalCedarCommander X11Viewers
You will then get a new Cedar world.
8. Create a packaged world
Load any packages you would normally like to have in a "ckeckpoint." Then,
In a CedarCommander:
% cd /yourHOSTname/yourUSERname/bin/
If you want to package RawViewers, execute:
% PackageIt RV RawViewers
% sh1 ./RV.ld
If you want to package X11Viewers, execute:
% PackageIt XV X11Viewers
% sh1 ./XV.ld
These commands take a while. Don't worry. They create packaged worlds in the local directory.
9. Run Nearly Net Free !!!
Optional: Say Bye to your Cedar world. ExitWorld.
When you get to your UNIX prompt:
Logout and login, or do
% source .login
When you want to run your RawViewers packaged world:
% RVL
When you want to run your X11Viewers packaged world
% XVL
10. Enjoy.
To get an updated LocalCedar world, repeat from Step 6. Be sure that you DO NOT REPEAT THE BRINGOVER of LocalCedar, or you will overwrite your modified files!!
11. To keep your disk from filling up ....
To keep your disk from filling up, every now and then you should do execute
In a CedarCommander:
% cd /yourHOSTname/yourUSERname/bin/
% CleanLocalCedar.cm