OpenAFS Quick Beginnings

Version 1.4.2

Copyright © 2000-2007 IBM Corporation and other contributors. All Rights Reserved

This document describes the initial setup of an OpenAFS cell and an OpenAFS client. It is currently being updated for OpenAFS 1.4.4 and is still dated and incorrect in some details. This edition applies to OpenAFS for UNIX, Version 1.4.4, and to all subsequent releases and modifications until otherwise indicated in new editions.

This documentation is covered by the IBM Public License Version 1.0.

Table of Contents
About This Guide
Audience and Purpose
Organization of the Document
How to Use This Document
Related Documents
Typographical Conventions

1. Installation Overview
The Procedures Described in this Guide
Required Initial Procedures
As-needed Procedures

Recommended Reading List
Requirements
Login Identity
General Requirements
File Server Machine Requirements
Client Machine Requirements

Supported System Types
About Upgrading the Operating System
The OpenAFS Binary Distribution
How to Continue

2. Installing the First AFS Machine
Requirements and Configuration Decisions
Overview: Installing Server Functionality
Choosing the First AFS Machine
Creating AFS Directories
Performing Platform-Specific Procedures
Getting Started on AIX Systems
Loading AFS into the AIX Kernel
Configuring Server Partitions on AIX Systems
Replacing the fsck Program Helper on AIX Systems
Enabling AFS Login on AIX Systems

Getting Started on HP-UX Systems
Building AFS into the HP-UX Kernel
Configuring Server Partitions on HP-UX Systems
Configuring the AFS-modified fsck Program on HP-UX Systems
Enabling AFS Login on HP-UX Systems

Getting Started on IRIX Systems
Loading AFS into the IRIX Kernel
Building AFS into the IRIX Kernel
Configuring Server Partitions on IRIX Systems
Enabling AFS Login on IRIX Systems

Getting Started on Linux Systems
Loading AFS into the Linux Kernel
Configuring Server Partitions on Linux Systems
Enabling AFS Login on Linux Systems

Getting Started on Solaris Systems
Loading AFS into the Solaris Kernel
Configuring the AFS-modified fsck Program on Solaris Systems
Configuring Server Partitions on Solaris Systems
Enabling AFS Login on Solaris Systems
Editing the File Systems Clean-up Script on Solaris Systems

Starting the BOS Server
Defining Cell Name and Membership for Server Processes
Starting the Database Server Processes
Initializing Cell Security
Initializing the Protection Database
Starting the File Server, Volume Server, and Salvager
Starting the Server Portion of the Update Server
Starting the Controller for NTPD
Overview: Installing Client Functionality
Copying Client Files to the Local Disk
Defining Cell Membership for Client Processes
Creating the Client CellServDB File
Configuring the Cache
Configuring a Disk Cache
Configuring a Memory Cache

Configuring the Cache Manager
Overview: Completing the Installation of the First AFS Machine
Verifying the AFS Initialization Script
Activating the AFS Initialization Script
Activating the Script on AIX Systems
Activating the Script on HP-UX Systems
Activating the Script on IRIX Systems
Activating the Script on Linux Systems
Activating the Script on Solaris Systems

Configuring the Top Levels of the AFS Filespace
Storing AFS Binaries in AFS
Storing AFS Documents in AFS
Storing System Binaries in AFS
Enabling Access to Foreign Cells
Enabling a Synthetic AFS root
Adding foreign cells to a conventional root volume

Improving Cell Security
Controlling root Access
Controlling System Administrator Access
Protecting Sensitive AFS Directories

Removing Client Functionality

3. Installing Additional Server Machines
Installing an Additional File Server Machine
Creating AFS Directories and Performing Platform-Specific Procedures
Starting Server Programs
Installing Client Functionality
Completing the Installation

Installing Database Server Functionality
Summary of Procedures
Instructions

Removing Database Server Functionality
Summary of Procedures
Instructions


4. Installing Additional Client Machines
Summary of Procedures
Creating AFS Directories on the Local Disk
Performing Platform-Specific Procedures
Getting Started on AIX Systems
Loading AFS into the AIX Kernel
Enabling AFS Login on AIX Systems

Getting Started on HP-UX Systems
Building AFS into the HP-UX Kernel
Enabling AFS Login on HP-UX Systems

Getting Started on IRIX Systems
Loading AFS into the IRIX Kernel
Building AFS into the IRIX Kernel
Enabling AFS Login on IRIX Systems

Getting Started on Linux Systems
Loading AFS into the Linux Kernel
Enabling AFS Login on Linux Systems

Getting Started on Solaris Systems
Loading AFS into the Solaris Kernel
Enabling AFS Login on Solaris Systems
Editing the File Systems Clean-up Script on Solaris Systems

Loading and Creating Client Files
Configuring the Cache
Configuring a Disk Cache
Configuring a Memory Cache

Configuring the Cache Manager
Starting the Cache Manager and Installing the AFS Initialization Script
Running the Script on AIX Systems
Running the Script on HP-UX Systems
Running the Script on IRIX Systems
Running the Script on Fedora / RHEL Systems
Running the Script on other Linux Systems
Running the Script on Solaris Systems

Setting Up Volumes and Loading Binaries into AFS
Linking /usr/afsws on an Existing System Type
Creating Binary Volumes for a New System Type


A. Appendix A. Building AFS from Source Code
Loading the Source Files
Compiling AFS Binaries Using the washtool Program

B. Appendix B. Configuring Legacy Components
kaserver and Legacy Kerberos 4 Authentication
Background
Using this Appendix
Installing the First AFS machine
Installing Additional Server Machines
Enabling AFS login with kaserver
Enabling kaserver based AFS login
Enabling kaserver based AFS Login on HP-UX systems
Enabling kaserver based AFS Login on IRIX Systems
Enabling kaserver based AFS Login on Linux Systems
Enabling kaserver based AFS Login on Solaris Systems


Index

List of Examples
2-1. PAM session example
2-2. PAM auth example
2-3. PAM session example
  Next
  About This Guide