Getting Started in Interlisp-D at Xerox (for Internal Xerox Use Only) [eris]Harmony>Doc>GettingStarted.tedit This document is intended as a supplement to the Interlisp Reference Manual, the Harmony Release Notes, and the 1108 Users Guide. It tells you how to configure local disks of Dorados, Dolphins, and Dandelions for Interlisp-D, and it says where to find various important files. This is not a guide to programming Interlisp-D. The first three sections apply to Dolphin/Dorado users; the remaining sections to Dandelion users. At Xerox, the Lisp files are generally kept on the directory [Eris]Releasename>, in various sub-directories. For the "Harmony" release, packages that can be loaded into Lisp are located on Harmony>Library> and . The packages on Harmony>Library> are supported by the Interlisp-D support group; those on are (sometimes) supported by their authors. Documentation for packages in the Library and LispUsers are generally found with the files they document. The "rules" for LispUsers packages are found on {ERIS}LispUsersRules.TEdit. New users should add themselves to the distribution list LispUsers^.PA to get announcements about new releases, workarounds for common problems, etc. Please send reports of bugs, anomalies or requests, questions about this document, installation procedures, or what have you to LispSupport.PA. There's another distribution list, LispFolklore^.x, for discussion about Interlisp-D features, opinion polls and the like -- add yourself if you like. Make sure you have an Interlisp Reference Manual, and a reasonably current list of Library and LispUsers package documentation -- look on {ERIS}Harmony>Doc>, and, after looking at {Eris}LispUsers.tty and {ERIS}Harmony>LIbrary>LispLibrary.tty, get the documentation for the LispUsers and Library packages that you think you might be interested in. Releases of Interlisp-D are named after musical terms, in the series Chorus, Fugue, Carol, Harmony, Intermezzo, Jazz, K--, L--, ..... This document is intended for the Harmony release, but (I hope) it will be appropriate for future releases by appropriate substitution of release names. (Dorado/Dolphin) The very first time -- Setting up the disk: If you are setting up on a Dolphin, you probably have to set up your disk for running Lisp. Interlisp-D currently runs with the Alto file system, at least on Dolphins and Dorados. If you have Pilot on your disk, you will need to reserve an Alto partition. Decide which partition(s) you want to use for Lisp. (The only asymmetry on Dolphins between the partitions is that when the machine is initially booted it will come up in partition 1. To boot Partition 2, hold down the 0 key while pressing the boot button.) The standard Dorado microcode obtained from the network starts you out in Partition 5 (on machines with T-80s) and Partition 19 on machines with 300 MB drives. You have to hold down the appropriate key to any other partition. On T-80 machines, keys 1,2,3,4,5 get you to partitions 1,2,3,4,5 respectively. On T-300s, keys 1,2,3,4,5 get you to partitions 1,2,3,4,5, while keys 6,7, 8, 9 get you to partitions 16,17,18 and 19.) You should now (re)initialize the disk partition. (This procedure will erase the disk partition. If there is something that you want to save on the partition, FTP it to your local file server and retrieve it after this procedure is finished. It is possible, though not usually desirable, to install Lisp without erasing the disk; see below.) First, get to the NetExec, by saying: > NetExec If you want partition 2, say: > Partition 2 Then, get a new operating system and install it (this dialog is approximately correct. Newer versions of NewOS ask about changing partitions): > NewOS.boot Do you want to install this OS? Yes Do you want the long installation dialogue? Yes Do you want to first erase a disk? Yes Type the name of a host from which Alto programs can be obtained: AltoIFS If this is Maxc or an IFS, this should probably be 'Alto', ...: Alto Include DP1 in the file system? Yes Use all 14 sectors of the Disk? Yes Type OK when ready: OK (There will be a pause for a minute or so while the partition gets erased.) Do you want to disable error logging? No Do you want to change the address for error logging? No Do you want to change memory error params? No User name? your name, or Public Disk name? Partition partition number Do you want a password? no, if Public The "AltoIFS" above is the source for programs. E.g., at PARC, use Indigo. All of this will give you a very clean partition with hardly any files at all. In order to get the files necessary for running Lisp, execute the following commands (where fileserver is currently ERIS and site is one of ISL, KSA; site adminstrators at other locations may have set up other command files): > Ftp fileserver directory/c Lisp>Harmony>cm retrieve/c NewUserDisk.site > @NewUserDisk.site@ This will bring all of the files that you need to run Lisp. (Dorado/Dolphin) The very first time -- Setting up the disk without erasing it: It is possible to install Lisp without erasing the disk, merely by performing the commands in NewUserDisk without first doing the erase. Note that performance is degraded if the file Lisp.VirtualMem is not contiguous, although the system should still work. (Dorado/Dolphin) Each time you want to run Lisp: Assume you have just booted your machine. You will be in partition 1. If you want to boot Partition 2 directly, hold down "0" (zero) while you push the boot button. Alternatively, when in Partition 1, type the command Partition 2. If your Lisp function files are on an IFS, you can load them from Lisp directly. Lisp will also talk directly to files on other partitions on the same disk, or to NS file servers. Maxc also runs a file server so that you can just LOAD or MAKEFILE directly to Maxc. Note, however, that Lisp prefers file servers which speak the "Leaf" protocol, because that allows direct random access to files. If your file server doesn't run LEAF, you won't be able to do LOADFROM, or use the "remake" option of MAKEFILE (which saves a lot of time in program development.) Interlisp-D will also work with NS servers (8030 series) and Unix and VMS using a variety of protocols, but details of installation, etc. will differ. You are now ready to run Lisp. > Lisp [yourfileserver]releaseName>Basics>lispsysout will bring over a fresh, clean version of Lisp from yourfileserver and start it up. lispsysout = LISP.SYSOUT will get you the standard lisp sysout; lispsysout = FULL.SYSOUT will get you the standard sysout enhanced by some Library and LispUsers packages such as the Interlisp text editor and mail system; and lispsysout = DEMO.SYSOUT will get you the full sysout enhanced by a lot of random packages used in the standard Interlisp demo. LOAD your files (from your disk or from the IFS), and you're on your way. You may want to make a command file to execute this, e.g., if you create {DSK}KEY1.CM;1 from inside Interlisp-D to contain the line starting with "Lisp", then pressing the right-blank key of the Dolphin/Dorado keyboard will execute that line. When you want to leave Lisp, if you type _(LOGOUT) it will save your "virtual memory" so that the next time you type > LISP it will resume from where you left off. (Dandelion) The Very First Time -- Setting up the Disk: On a new Dandelion, it is necessary to configure the disk and install the Interlisp-D software. You must first start by configuring your disk. There are a number of ways of doing this. The following notes describe the procedures used to install and run Interlisp using an ethernet. For users with "standalone" Dlions not connected to an ethernet, it is necessary to configure the Dlion disk and install Interlisp-D using floppy disks. This is described at the end of this document. VERY IMPORTANT WARNING FOR DLION USERS: The Harmony release of Interlisp-D is compatible with the Mesa 11.0 (Klamath) version of the Pilot DLion file system. This release of the Pilot file system is INCOMPATIBLE with older versions. The mesa environment provides tools for "scavenging-forward", to convert a Mesa 10.0 volume to a Mesa 11.0 volume, but Interlisp does not provide such a facility for upgrading Interlisp local file system volumes. Therefore, before upgrading to Mesa 11.0, be sure that any valuable information stored on the Dlion local file system has been saved on a file server, or on floppy disks. To configure the Dlion disk, you must run either the "Othello" or "Hello" utility program on your machine. Othello is the Mesa development environment utility for managing Pilot Volumes as documented in "Mesa User's Guide" from the Office Systems Division. Hello is a slightly modified version of Othello, maintained by the Interlisp-D support group, which has a few more commands. Unfortunately, there are many ways to get Othello running on your Dlion, not all of which will work in every case. Below are described a number of different procedures to try. In all cases, to boot (start) a Dandelion, locate the maintenance panel under the floppy drive. Next to the red numbers you will find two buttons, labelled "B Reset" and "Alt B". The phrase "Alt-Boot-N" means to hold down both buttons, and then release the left button (B Reset) while holding the right button (Alt B). When the panel reads 000N, let up on the right button. (There are 10 so-called boot options: the lights will cycle from 0001 to 0010 while holding Alt B after pressing both buttons and letting up on B reset.) Booting Othello from disk: Do an "Alt-Boot-1". If the Display reads "Othello 11.0", you win. If it reads Hello 11.0, you still win. Booting Othello from Ethernet: Try an"Alt-Boot-3". After a few minutes, you should be in Othello. If the display reads "Othello 11.0" at the top, you win. In some circumstances, you won't get Othello 11.0. Booting Othello from Floppy: If you cannot boot from the Ethernet you will need an Othello 11.0 bootable floppy. You can sometimes get one of these from your local Dandelion hardware support crew. To boot Othello 11.0 from floppy, insert it into your floppy drive, label side up, close the drive panel, and do an "Alt-Boot-2". The floppy drive should click for a minute or so, and then Othello should appear. Configuring the DLion Disk from Othello: When started, Othello/Hello will display a herald, e.g.: Othello 11.0 of 2-Aug-84 8:34:15 Processor = 0AA001EE1H = 25200017347B = 2-852-134-631 Memory size = 1536K bytes = 768K words > Online Drive name: RD0 Make sure it says Othello 11.0 or Hello 11.0 at the top. Note that the memory size will not show greater than 1.5 MB even though your machine has more memory than that. Pilot/Mesa doesn't know about the extended memory (yet).) Type a "carriage return" to the Online command after RD0. If you have never installed Lisp on this machine before, you will need to reconfigure the disk into logical volumes with a Lisp volume sufficient to hold Interlisp-D. Note: Othello network communications are currently based on PUP communcation over 10MB Ethernet, although NS protocol is under development. The Mesa/Othello software will only talk PUPs if a gateway or other server explicitly tells it its net number (otherwise, it will hang with a 981 in the maintenance panel.) A network adminstrator must register Dandelions in the gateway tables. Message NetSupport.wbst (or, at PARC, PTS.PA) for assistance if necessary. You can still run Interlisp-D if you aren't on a PUP-network, but you must follow different installation procedures than these. Use the "Login" command to log in with your name and password, e.g.: > Login User: Masinter Password: ****** How you partition the hard disk of the 1108 depends on what size disk you have. If you have a 10MB disk, the command: > @[eris]Harmony>cm>Partition10Lisp.othello will configure the disk into three logical volumes, one of 1000 pages called Hello, one of 3000 pages called LispFiles (for the lisp local file system), and the rest of the disk in the volume, Lisp. This command file will also install Hello into the first volume, since partitioning erases the disk. This is usually the right command file for the 10MByte disk 8010 Dandelion configuration. Users with bigger disks (either the two-cabinet 29MByte SA4000 or the newer 40MByte or 80 MByte Quantums) will probably want to reconfigure the disk in other ways, depending on what other programs one wants to run along with Lisp. Some other command files are: > @[eris]Harmony>cm>Partition29Lisp.othello The same as Partition10Lisp, except that 16200 pages are allocated for the Lisp volume (the max that Interlisp-D can use), and the rest for the LispFiles volume. Partition43Lisp.othello allocates four volumes, Hello (1000 pages), Lisp (16200), Lisp2 (16200), and LispFiles. Partition29or43LispTajo.othello allocates four volumes, Hello (1000 pages), Tajo (16000 pages), Lisp (16200), and LispFiles. It also installs Tajo on the Tajo volume; PartitionLispStarTajo.othello allocates six volumes, Hello (1000 pages), Tajo (10000 pages), System (7500), User (8000), Lisp (16200), and LispFiles. The System and User volumes can be used with Star with standard Star installation procedures. This command file does not install Star, however. If you want some other configuration of logical volumes, you can edit any of these othello command files with any editor, or type it in directly. These command files install "Hello" on the local disk to be what you get when you Alt-Boot-1. (Dandelion) Running Lisp: Once you have the basic system installed, you need to bring over a Lisp sysout into one of your virtual memory files. To do this, first, start Hello. Note: Previously, it was possible to install Interlisp using Othello. However, due to added functionality in Hello, it is no longer a recommended procedure. Typing the following in Hello: > @[eris]Harmony>CM>InstallLisp.hello will install [eris]Harmony>Basics>LISP.SYSOUT onto the Lisp volume and start it. (Users at other sites may find similar command files on their local file server.) The command file InstallFull.Hello is identical to InstallLisp.othello, except that it fetches FULL.SYSOUT instead of LISP.SYSOUT. Likewise, InstallDemo.othello brings over DEMO.SYSOUT. To fetch other SYSOUT files of your own making or from file servers other than Eris, you can edit the .hello command file using your favorite text editor as appropriate. It is possible to install Lisp directly from the Mesa development environment (Tajo 11.0) instead of Othello/Hello. Tajo-based tools InstallMu.bcd, LispTool.bcd are available which can install SYSOUTs over the Ethernet from Xerox NS 8000 series file servers. See {ERIS}Harmony>Doc>InstallLisp.doc for more details. (Dandelion) Returning to Mesa/Star: To boot Mesa/Star, provided it had been previously installed, do an "Alt-Boot-1" as described above. From inside Lisp, the (LOGOUT) function will automatically cause an "Alt-Boot-1" after saving your state, so that it is possible to switch back and forth between Mesa and Interlisp-D without touching the boot button. (LOGOUT T) will switch without saving state; a convenience if you are returning to Mesa merely to retrieve a new version of Lisp. (Dandelion) Each time you want to run Lisp: To return to a previously saved state (e.g., saved via a SAVEVM or LOGOUT), perform a simple machine boot (either by pressing B-reset, machine power on, or the "Quit" command inside Othello/Hello.). This returns you to the saved computation, similar to typing simply "Lisp" to the Alto Executive on Dolphins/Dorados. (Dandelion) To remove Lisp from your disk: (1) Use the Othello/Hello "Initial" command to reinstall normal initial microcode from [iris|rain]11.0>SAx000Initial.db (2) Use the Othello/Hello "Diagnostic Microcode Fetch" command to reinstall diagnostic microcode from [iris|rain]11.0>Moonboot.db (Dandelion) Installing/Running Interlisp-D without an Ethernet: A number of tools have been created to accomodate non-Xerox users of Interlisp-D, who don't have access to the Xerox ethernet. They may also be useful for Internal Xerox users who have stand-alone Dlions not connected to the ethernet. These tools are contained on two floppies, called the "SystemTools" floppy and the "InstallationUtility" floppy. These floppies provide tools for partitioning a Dlion disk and installing Interlisp-D (off of floppies). Floppy "image" files for these floppies are stored on the following files: (Floppies can be made from these files using the Interlisp FLOPPY.FROM.FILE function) {eris}Harmony>Mesa>SystemTools.floppy {eris}Harmony>Mesa>InstallationUtility.floppy Interlisp-D sysouts can be put on floppies by executing the function (SYSOUT '{FLOPPY}), or using the function (COPYFILE xxx '{FLOPPY}) to copy from an existing sysout file to the floppy. Documentation for using these floppies can be found in {eris}Harmony>Doc>SystemTools.doc (& .press). NILNILMODERN (MODERNNILNILMODERNNILNIL.MODERN NILNILMODERN NILNIL MODERN MODERN �MODERN NILNILIMODERN MODERN �MODERN NILNIL0MODERN NILNILMODERN NILNILMODERNNILNIL>MODERNNILNIL�MODERN NILNIL�MODERN NILNIL MODERN MODERN �NILNILMODERN NILNIL MODERN MODERN �NILNIL�MODERN NILNILMODERN MODERN �)MODERN MODERN �0MODERN MODERN �'MODERN MODERN �EMODERN MODERN �MODERN �GMODERN MODERN �'MODERN MODERN �*MODERN MODERN �MODERN MODERN �}MODERN MODERN �?MODERN MODERN �4MODERN MODERN �MODERN MODERN �MODERN �MODERN MODERN �MODERN �MODERN �MODERN MODERN �MODERN MODERN �FMODERN NILNILMODERN NILNIL�MODERN MODERN MODERN MODERN aMODERN NILNILMODERN MODERN 4MODERN MODERN MODERN MODERN MODERN NILNIL<MODERN NILNILMODERN NILNILPMODERNMODERN NILNILMODERN NILNILMODERN 1MODERNMODERN NILNIL�MODERN NILNIL�MODERN NILNIL MODERN NILNILMODERN MODERN MODERN MODERN MODERN MODERN MODERN NILNIL4MODERN MODERN MODERN MODERN 6MODERN MODERN �MODERN MODERN �MODERN NILNIL2MODERN MODERN �NMODERN MODERN �-MODERN :MODERN�MODERN NILNIL'MODERN FMODERN NILNIL�MODERN NILNIL�MODERN NILNILMODERN MODERN NILNILiMODERN NILNILMODERN MODERN NILNIL�MODERN MODERN MODERN )MODERN NILNIL�MODERN NILNILMMODERN NILNILFMODERN NILNIL(MODERN NILNILwMODERN NILNILMODERN 0MODERN �NILNIL�MODERN NILNILMODERN 0MODERN �NILNIL�MODERN NILNILAMODERN NILNIL�MODERN NILNIL^MODERN NILNILMODERNNILNIL�MODERN NILNIL�MODERN NILNILMODERN NILNILMODERN *MODERN �NILNIL�MODERN NILNILdMODERN NILNILAMODERN NILNIL%MODERNNILNIL�MODERN NILNIL-MODERNNILNILFMODERN NILNIL,MODERNNILNILMODERN NILNIL�MODERN NILNILAMODERNNILNIL�MODERN NILNIL�MODERN NILNIL`MODERN NILNIL�MODERN NILNILkMODERN NILNILMODERN C��z�