AFSLore/InstallOpenAFSClient.mdwn

   1 ## <a name="How to Install the _OpenAFS Clie"></a> How to Install the [[OpenAFS]] Client
   2
   3 This documentation provides instructions for installing the [[OpenAFS]] client only. Documentation for installing a server belongs elsewhere.
   4
   5 This document is intended for users who are familiar enough with administrating their operating system of choice to not need hand holding, but unfamiliar enough with [[OpenAFS]] to need basic setup instructions.
   6
   7 ### <a name="Operation System specific instru"></a> Operation System specific instructions
   8
   9 #### <a name="Linux, Redhat 8"></a> Linux, Redhat 8
  10
  11 These are the steps I used to get [[OpenAFS]] working on a fairly standard Redhat 8 machine.
  12
  13 ##### <a name="Download RPMS"></a> Download RPMS
  14
  15 Download the most current versions of these RPMS from www.openafs.org:
  16
  17 - openafs (Utilities, Init scripts, and documentation)
  18 - openafs-client (AFS daemon, PAM modules, client configuration files)
  19 - openafs-kernel (AFS kernel module, for Redhat's kernel 2.4.18-14
  20 - openafs-krb5 (Utilities for using Kerberos 5 tickets to get AFS tokens)
  21
  22 You may also want:
  23
  24 - openafs-compat (Populate /usr/afsws with symlinks for legacy applications/users)
  25 - openafs-devel (AFS libraries and include files, for building AFS aware applications)
  26 - openafs-kpasswd (Compatibility package for use with a KA server)
  27 - openafs-kernel-source (AFS kernel module source, necessary if you aren't using Redhat's kernel)
  28
  29 You almost certainly don't want:
  30
  31 - openafs-server (AFS Server binaries)
  32
  33 If you don't already have Redhat's kerberos 5 RPMS installed, you may wish to download those as well. But they aren't strictly necessary, and only the openafs-krb5 package depends on them.
  34
  35 ##### <a name="Install RPMS"></a> Install RPMS
  36
  37 Install those RPMS. If you don't know how to do this, then this document isn't intended for you.
  38
  39 ##### <a name="Configure AFS"></a> Configure AFS
  40
  41 Follow the instructions that were output during the RPM install. In particular, edit /usr/vice/etc/ThisCell.
  42
  43 If you haven't already configured Kerberos on your system, do so now. Instructions for doing that are outside of the scope of this document.
  44
  45 ##### <a name="Start AFS"></a> Start AFS
  46
  47 Start the AFS client, either by rebooting, or by running '/etc/rc.d/init.d/afs start'
  48
  49 Verify that /afs/&lt;your-cell-here&gt; is readable.
  50
  51 Get AFS tokens with klog, or translate existing kerberos tickets with aklog, and verify that you can modify files in AFS.
  52
  53 -- [[DavidNolan]] - 29 Jul 2003