Skip to main content

Utilities to setup OpenAFS clients and servers

Project description

Utility classes and command-line tool to build, install, and setup OpenAFS.


build     build and package OpenAFS from source
cell      setup a new OpenAFS cell
cmd       basic OpenAFS command wrappers
install   interface to install and remove OpenAFS binaries
keytab    import Kerberos 5 keytabs and create fake keytabs for testing
rpm       install and remove OpenAFS rpm packages
service   interface to start and stop OpenAFS services
system    misc system utilities
transarc  install and remove legacy Transarc-style OpenAFS binaries

Command line interface

usage: afsutil <command> ...
where command is:
    version   print version information
    getdeps   install build dependencies
    check     check system
    build     build binaries
    reload    reload the kernel module after a build
    package   build packages
    install   install binaries
    remove    remove binaries
    start     start afs services
    stop      stop afs services
    fakekey   generate a keytab file for testing
    setkey    add a service key from a keytab file
    newcell   setup a new cell
    addfs     add a new fileserver to the cell
    login     obtain token with a keytab


To build OpenAFS from sources:

afsutil build

To install legacy “Transarc-style” binaries:

sudo afsutil install \
  --force \
  --dist transarc \
  --components server client \
  --dir /usr/local/src/openafs-test/amd64_linux26/dest \
  --cell \
  --realm EXAMPLE.COM \
  --hosts myhost1 myhost2 myhost3 \
  --csdb /root/CellServDB.dist \
  -o "afsd=-dynroot -fakestat -afsdb" \
  -o "bosserver=-pidfiles"

To setup the OpenAFS service key from a Kerberos 5 keytab file:

sudo afsutil setkey
  --cell \
  --realm EXAMPLE.COM \
  --keytab /root/fake.keytab

To start the OpenAFS servers and client:

sudo afsutil start server
sudo afsutil start client

To setup a new OpenAFS cell on 3 servers (after ‘afsutil install’ has been run on each):

sudo afsutil newcell \
  --cell \
  --realm EXAMPLE.COM \
  --admin example.admin \
  --top test \
  --akimpersonate \
  --keytab /root/fake.keytab \
  --fs myhost1 myhost2 myhost3 \
  --db myhost1 myhost2 myhost3 \
  --aklog /usr/local/bin/aklog-1.6 \
  -o "dafs=yes" \
  -o "afsd=-dynroot -fakestat -afsdb" \
  -o "bosserver=-pidfiles" \
  -o "dafileserver=L"

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
afsutil-0.8.0-py2-none-any.whl (73.6 kB) Copy SHA256 hash SHA256 Wheel py2 Aug 1, 2018
afsutil-0.8.0.tar.gz (59.1 kB) Copy SHA256 hash SHA256 Source None Aug 1, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page