Amoeba

The Amoeba Reference Manual

System Administration Guide

AMOEBA

Amoeba is a registered trademark of the Vrije Universiteit in some countries.

AMOEBA

is a trademark of the Vrije Universiteit. Sun-3, Sun-4, NFS, SPARCclassic, SPARCstation, MicroSPARC, SunOS and Solaris® are trademarks of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC International, Inc. UNIX is atrademark of Unix International. Irix and Personal Iris are trademarks of Silicon Graphics Corporation. DEC, VAX, MicroVAX, Ultrix and DEQNA are registered trademarks of Digital Equipment Corporation. Intel 386, Pentium, Multibus and Intel are trademarks of Intel Corporation. Ethernet is a registered trademark of Xerox Corporation. IBM and PC AT are registered trademarks of International BusinessMachines Corporation. X Window System is a trademark of the Massachusetts Institute of Technology. WD, EtherCard PLUS and EtherCard PLUS16 are trademarks of Standard Microsystems Corporation. Logitech is a trademark of Logitech, Inc. Novell is a trademark of Novell, Inc. 3Com and Etherlink II are registered trademarks of 3Com Corporation. MS-DOS is a trademark of Microsoft Corporation. Amoebaincludes software developed by the University of California, Berkeley and its contributors.

Copyright © 1996 Vrije Universiteit te Amsterdam and Stichting Mathematisch Centrum, The Netherlands. All Rights Reserved.

Contents

Chapter 1. Using This Manual Chapter 2. Installing Amoeba 2.1. Introduction 2.2. Supported Hardware Configurations 2.2.1. General Requirements 2.2.2. Supported Hardware 2.3.Upgrading an Amoeba Distribution 2.3.1. Installing the Binaries 2.3.2. Installing the Source Code 2.3.3. Installing the Kernels 2.3.4. Installing the New Soap and Boot Servers 2.4. The Binary Distribution 2.4.1. Installing Amoeba on Intel 80386 Systems 2.4.2. Installing Amoeba on the SPARCstation 2.4.3. Installing Amoeba on the Sun 3/60 2.5. Setting The Time 2.6. Installing the Source Code 2.6.1.Installing the On-line Manuals 2.6.2. The /super Directory Graph Structure 2.6.3. Amoeba Distribution Directory Structure 2.7. Installing Third-party Software 2.7.1. Installing X Windows

1 2 2 4 4 6 8 8 8 9 9 11 12 18 21 24 25 25 26 27 36 36

Amoeba 5.3

iii

2.7.2. Installing MMDF II 2.7.3. Installing TEX Chapter 3. Configuring an Amoeba System 3.1. Introduction 3.2. Configuring AmoebaHosts 3.2.1. Adding New Hosts 3.2.2. Deleting a Host 3.2.3. Replacing a Host 3.3. Server Configuration 3.4. Adding New Users Chapter 4. Building Amoeba Configurations 4.1. Introduction 4.2. Building the Amoeba Utilities 4.2.1. Building X Windows 4.2.2. Building MMDF II 4.3. Building Amoeba Kernels 4.3.1. Configuring a Kernel 4.4. Building the Amoeba Documentation Chapter 5. Amoeba and UNIX 5.1.Loading the Source Tape 5.2. Building the UNIX Utilities 5.3. Building the Amoeba Utilities under UNIX 5.4. The Unix Amoeba Driver 5.4.1. Adding Amoeba RPC to a SunOS 5.x/Solaris 2.x kernel iv Amoeba 5.3

37 37 38 38 38 38 40 41 41 43 45 45 46 46 47 48 48 54 55 56 57 58 59 59

5.4.2. Adding Amoeba RPC to a SunOS 4.1.1 kernel 5.4.3. Adding Amoeba RPC to an Irix 3.3 Kernel 5.4.4. Adding AmoebaRPC to an Ultrix kernel Chapter 6. Routine Maintenance 6.1. Backup 6.2. Garbage Collection Chapter 7. Trouble-shooting 7.1. Installation Failure 7.2. Kernel Crashes 7.3. Amoeba — UNIX Communication Chapter 8. Manual Pages Chapter 9. Index

61 62 64 68 68 68 69 69 69 70 71 271

Amoeba 5.3

v

vi

Amoeba 5.3

1 Using This Manual
Intended Audience This manual is intended for use bysystem administrators. Scope It is assumed that the reader is familiar with the introductory material in the User Guide. This manual explains how to install, configure and maintain an Amoeba system. Security, hardware, resource management and user management are all described. Advice on Using this Manual The manual is divided into several major sections. The first chapter describes how to install...