-- InstallLispTool.doc
--last edited by
-- JFung.pasa 27-Jan-84
Filed: [Rose]<Lisp>Current>InstallLispTool.doc
[Phylum]<Lisp>Current>InstallLispTool.doc
POINTS OF INTEREST:
A.LOADING INTERLISP-D ON THE 1108
B.LOADING INTERLISP-D SOFTWARE.
C.YOUR USER.CM FILE
D.SOME DEFAULT SETTING
A.LOADING INTERLISP-D ON THE 1108 SIP
The 1108 comes with three different disk configurations: the 10 Megabyte SA1000, the 29 Megabyte SA4000, and the 43 Megabyte Q2000. Some software must be pre-loaded onto your 1108 system before you can use it.
PRE-LOADING WITH DIAGNOSTICS FILES.
The following floppies are required: (1) The Installation Utility; (2) Diagnostics File.
1. Load the Installation Utility in the floppy drive and do a 2-boot. (A 2-boot is done by press both the B RESET and ALT B buttons on the front panel and release the B RESET button immediately. Release the ALT B button when the font panel reads 0002.) After about two minutes a list of utility options will be displayed.
2. Select menu item "Install Diagnostics".
3. Unload the floppy drive and load the "Diagnostics File" floppy.
4. Respond to the prompt on the display with Y.
5. When the Installation menu reappears, perform a 1-boot.
6. In about 2 minutes, the Tajo environment will be running. Activate the Exec window in the bottom left hand corner. The screen will be configured to accept typein. Press any mouse button to activate the input cursor. You are now ready to begin typing.
7. Unload the floppy drive and insert the Installation Utility floppy.
8. Type in "floppy read InstallLispTool.bcd ". You should be able to hear the floppy drive, as the file InstallLispTool.bcd is transferred from the floppy disk to the rigid disk.
9. Type InstallLispTool <CR> at your exec window.
10. Do a 1-boot. This should get you to the bouncing square on your display.
B. LOADING INTERLISP-D SOFTWARE.
There are two ways to load your Interlisp-D software. The first way is to load from floppy disketts that are distributted to you the second way is to load from your file server.
Loading Interlisp-D from your floppies:
1. Place the "Installation Utility" disk in you floppy disk drive and do a 2-boot.
2. When the Installation menu comes up, select the item labelled "Install Interlisp on Lisp/x volume". Note for the 29MB and 43MB disks, you have three lisp volumes, the Lisp, Lisp2 and Lisp3. For the 10MB disk you only have Lisp volume.
3. Follow through the dialog to load your Interlisp-D floppies. For different Lisp sysout files you can have from three to five floppies.
4. After Interlisp is loaded, you may select "Start Interlisp from Lisp/x volume" option or you may exit by doing a 1-boot.
Loading Interlisp-D from your file server.
There is a window tool that allows one to install Interlisp-D software from NS or IFS file server. If you have net acess to a file server you can use this tool.
The tool is invoked when you have a DMT bouncing square on your CRT. If you dont have the bouncing square, then make sure you have done the pre-loading software correctly.
To activate the tool, click the left button of your mouse.
The tool window is a rectangular region and is composed of 1) a herald name, 2) a message sub-window, 3) a parameter sub-window, 4) a command sub-window and 5)a file sub-window.
The top line is the herald name, and consists of a) the tool’s name, b) the operating system’s version which the tool was bounded and c) the tool’s creation time.
The message sub-window is a two-line form window which displays the error messages if any.
The parameter sub-window is a form sub-window and contains the following paramters:
Doc.:{General, ErroMsg} File Server: {IFS, NS}
File: [Server]<Directory><Subdirectories>FileName.sysout
Volume: VMem Size = 0
User: Password:
Domain: Organization:
The command sub-window is a form sub-window and contains the following commands:
Install File! Start Volume! Set VMem Size! Floppy! Help!
Erase volume! Scavenge Volume! Remote Boot! Quit!
The file sub-window displays the event messages relevant to that command.
PARAMETER ITEMS:
Doc.: The document parameter is an enumerated item which is used in conjunction with the Help command. It selects which document is to be displayed on the file subwindow for a quick reference. The ’General’ displays the general writeup of the tool, while the ’ErrorMsg’ displays the error message and its meaning on the file subwindow.
File Server.: An enumerated item which shows the selection of the File Server protocol type to be used for the Install File command.
File: specifies the the file pathname of Lisp sysout file to be retrieved from the file server. The complete file pathname on an IFS looks like [Server]<Directory>SubDirectories>FileName.Sysout. An example will be [Rose]<Lisp>Fugue>Lisp.sysout.
The complete file name on a NS file server looks like [Server:Domain:Organization]<Directory>SubDirectories>FileName.Sysout. An example will be [Phylex:XSIS North:Xerox]<Demos>Demo.sysout
An equivalent but shorter way will be [Phylex:]<Demos>Demo.sysout
Note: The server, domain and Organization name are restricted to Alphanumerics plus the following character "-, :, #, SP". (SP: space character). The first character needs to be a letter, else an error message of "scan error on Server:Domain:Organization" will be posted.
Volume Menu: is a "string menu" which gets displayed by chording (presing both mouse buttons for a 2-button mouse or the middle button for a 3-button mouse) the mouse buttons. The menu contains the exact volume names as configured in that machine. If Lisp volume is presnet in the machine, it gets seleceted else nothing gets selected as default. To change the volume selection, simply move the mouse and select the volume desired in the menu.
VMem Size: shows the size of the Interlisp’s virtual memory file in pages.
User: is your Pup/NS registered user name.
Password: is your associated password for login.
Domain: is your domain name as defined in your Clearinghouse database.
Organization: is your organization name as defined in your Clearinghouse database.
The tool fetches from user.cm file under [system] setction for the user, password, domain and organization fields. If they are present, their values will be displayed.
COMMAND ITEMS
Install File!: fetches the file name specified in the File parameter and installs it into the Lisp volume selected. The file transfer can be aborted by depressing the STOP key.
Start Volume!: boots the Lisp volume selected.
Set VMem Size!: extends the vitual memory size to the size specified at "VMem Size data parameter".
Floppy!: gives an additional window which contains the floppy related commands.
Erase Volume!: erases the contents of the volume.
Scavenge Volume!: performs a file-scavenage on the volume selected.
Scavenge produces the MSScavenge.log file in that volume.
.
Remote Boot!: performs a cross-volume copy of boot file from one logical volume to another logical volume and then boots up the destination volume.
Quit!: returns the tool to the bouncing square state
C. YOUR USER.CM FILE
The tool parses your user.cm file for some default setting. In specific, "User", "Password", "Domain", "Organization" "File Server" and "File" parameters will be set if present in the user.cm file. Below is a sample user.cm, you should modify the appropriate fileds for your convenience.
[User.cm]
[System]
User: UserName
Password: YourPassword
Domain: DomainName
Organization: OrganizationName
FileServer: NS
NSFile: [Server:Domain:Organization]<Directory>SubDirectories>FileName.Sysout
PUPFile: [Server]<Directory>SubDirectories>FileName.Sysout
Screen: White
Debug: FALSE
[Diagnostics:System]
InitialCommand: InstallLispTool
D. SOME DEFAULT SETTING
File Server: Your file server type is defaulted to be NS, unless specified at user.cm
The Virtual memory image size of your logical volume is defaulted to be 2000 pages less of your logical volume size.
The volume parameter is defaulted to be "Lisp" if it is present in your physical volume else it is nil.
E. PROFILE-TOOL
The profile tool is designed for users to easily change default settings on the user.cm file. It is very useful to set your desired file-path name, your user name, and domain, organization and not typing them in on the window. You may enter your password in the profile-tool at your own judgement. CAUTION: do not use this tool, if you have your own user.cm file, it is intended to be used by sites that run Lisp applications only.