welcome: please sign in

Diff for "MemberManual/TransferringFiles/OpenAFS/Debian"

Differences between revisions 1 and 22 (spanning 21 versions)
Revision 1 as of 2007-11-11 20:30:23
Size: 1784
Comment: initial content, from /afs/hcoop.net/user/b/bp/bpt/public/afs-debian-install
Revision 22 as of 2013-02-09 05:13:05
Size: 1839
Comment: simplify and update for wheezy
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from MemberManual/TransferringFiles/OpenAFS/DebianClient
Line 5: Line 6:
[[TableOfContents]] These instructions have been tested on Debian wheezy.
Line 7: Line 8:
= Kernel Module Installation = <<TableOfContents>>
Line 9: Line 10:
OpenAFS requires a kernel module, and Debian does not provide third-party kernel modules as binary packages. Module-assistant can download, compile, and install kernel modules for you. Install that, then install the OpenAFS module: == OpenAFS Client Installation ==

To install the OpenAFS client and related programs, run `apt-get install openafs-client openafs-krb5 krb5-user` as root. Answer the configuration questions as follows:

 * AFS cell this workstation belongs to: `hcoop.net`
 * Default Kerberos version 5 realm: `HCOOP.NET`

You can accept the default values for other questions. If you're not prompted for these values, run `dpkg-reconfigure -phigh openafs-client krb5-user`.

== Using AFS ==

To gain access to your HCoop AFS share, run `kinit user@HCOOP.NET && aklog hcoop.net` on your local system.

The tickets gained will last up to 10 hours but can be renewed with `krenew` for up to 8 days. Here's a common use:
Line 12: Line 26:
sudo aptitude install module-assistant
sudo module-assistant prepare
sudo module-assistant install openafs
krenew -K 30 -t
Line 17: Line 29:
OpenAFS's cache is located at /var/cache/openafs, and it must be on an ext2 or ext3 filesystem. If /var/cache is not on an ext2 or ext3 filesystem, you'll need to mount an ext2 or ext3 filesystem at /var/cache/openafs. OpenAFS cache does not work well, if at all, on ReiserFS systems. See the `krenew` man page to learn what these options are doing.
Line 19: Line 31:
= OpenAFS Client Installation = == Konqueror Troubleshooting ==
Line 21: Line 33:
{{{
sudo aptitude install openafs-client
}}}
Konqueror simply hangs when trying to browse {{{/afs}}} with the default CellServerDB. This happens because it is trying to access AFS volumes it doesn't have access to or that are not accessible, and hangs indefinitely. There is a lot of cells pre-configured in the Debian package, and probably some of them are not valid or not accessible. Once the content of {{{/etc/openafs/CellServerDB}}} has been erased of everything except for the hcoop.net entry, browsing {{{/afs}}} with Konqueror should work.
Line 25: Line 35:
Answer the configuration questions as follows: ''Is this still a problem? -- BtTempleton''
Line 27: Line 37:
 * AFS cell this workstation belongs to: `hcoop.net`
 * The default value for "Size of AFS cache in kB" is okay. You can
  increase the cache size if you want.
 * Dynamically generate the contents of /afs? Yes
 * DB server host names for your home cell: `deleuze.hcoop.net`
 * Run Openafs client now and at boot? Yes

Now you should be able to see files in /afs/hcoop.net, but you won't
have any AFS tokens. So let's install some Kerberos packages.

= Kerberos Installation =
{{{
sudo aptitude install openafs-krb5 krb5-user
}}}

The default Kerberos version 5 realm can be HCOOP.NET, and
deleuze.hcoop.net will be both the Kerberos server for your realm and
the administrative server for your realm.
----
CategoryNeedsWork CategoryMemberManual

This is the chapter of the MemberManual that describes how to install and configure OpenAFS Client on Debian based systems. These instructions were adapted from HCoop user bpt's instructions.

These instructions have been tested on Debian wheezy.

OpenAFS Client Installation

To install the OpenAFS client and related programs, run apt-get install openafs-client openafs-krb5 krb5-user as root. Answer the configuration questions as follows:

  • AFS cell this workstation belongs to: hcoop.net

  • Default Kerberos version 5 realm: HCOOP.NET

You can accept the default values for other questions. If you're not prompted for these values, run dpkg-reconfigure -phigh openafs-client krb5-user.

Using AFS

To gain access to your HCoop AFS share, run kinit user@HCOOP.NET && aklog hcoop.net on your local system.

The tickets gained will last up to 10 hours but can be renewed with krenew for up to 8 days. Here's a common use:

krenew -K 30 -t

See the krenew man page to learn what these options are doing.

Konqueror Troubleshooting

Konqueror simply hangs when trying to browse /afs with the default CellServerDB. This happens because it is trying to access AFS volumes it doesn't have access to or that are not accessible, and hangs indefinitely. There is a lot of cells pre-configured in the Debian package, and probably some of them are not valid or not accessible. Once the content of /etc/openafs/CellServerDB has been erased of everything except for the hcoop.net entry, browsing /afs with Konqueror should work.

Is this still a problem? -- BtTempleton


CategoryNeedsWork CategoryMemberManual

MemberManual/TransferringFiles/OpenAFS/Debian (last edited 2019-01-07 13:36:57 by BjörnLindström)