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
cli       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.

Files for afsutil, version 0.6.5
Filename, size File type Python version Upload date Hashes
Filename, size afsutil-0.6.5.tar.gz (45.0 kB) File type Source Python version None Upload date Hashes View
Filename, size afsutil-0.6.5-py2-none-any.whl (56.3 kB) File type Wheel Python version 2.7 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page