This chapter describes how to install the first AFS machine in your cell, configuring it as both a file server machine and a client machine. After completing all procedures in this chapter, you can remove the client functionality if you wish, as described in Removing Client Functionality.

To install additional file server machines after completing this chapter, see Installing Additional Server Machines.

To install additional client machines after completing this chapter, see Installing Additional Client Machines.

Requirements and Configuration Decisions

The instructions in this chapter assume that you meet the following requirements.

You are logged onto the machine's console as the local superuser root
A standard version of one of the operating systems supported by the current version of AFS is running on the machine
You have either installed the provided OpenAFS packages for your system, have access to a binary distribution tarball, or have successfully built OpenAFS from source
You have a Kerberos v5 realm running for your site. If you are working with an existing cell which uses legacy kaserver or Kerberos v4 for authentication, please see kaserver and Legacy Kerberos v4 Authentication for the modifications required to this installation procedure.
You have NTP or a similar time service deployed to ensure rough clock syncronistation between your clients and servers.

You must make the following configuration decisions while installing the first AFS machine. To speed the installation itself, it is best to make the decisions before beginning. See the chapter in the OpenAFS Administration Guide about issues in cell administration and configuration for detailed guidelines.

Select the first AFS machine
Select the cell name
Decide which partitions or logical volumes to configure as AFS server partitions, and choose the directory names on which to mount them
Decide how big to make the client cache
Decide how to configure the top levels of your cell's AFS filespace

This chapter is divided into three large sections corresponding to the three parts of installing the first AFS machine. Perform all of the steps in the order they appear. Each functional section begins with a summary of the procedures to perform. The sections are as follows:

Installing server functionality (begins in Overview: Installing Server Functionality)
Installing client functionality (begins in Overview: Installing Client Functionality)
Configuring your cell's filespace, establishing further security mechanisms, and enabling access to foreign cells (begins in Overview: Completing the Installation of the First AFS Machine)