Difference between revisions of "BX:Mac OS X Personal AFS Installation"

From CCGB
Jump to: navigation, search
Line 1: Line 1:
 +
= Install the OpenAFS Client =
 
* Download the latest client from the OpenAFS websites, http://openafs.org
 
* Download the latest client from the OpenAFS websites, http://openafs.org
 
[[File:Openafs-macos-10.5-personal-1.png]]
 
[[File:Openafs-macos-10.5-personal-1.png]]
 
<hr />
 
<hr />
 
[[File:Openafs-macos-10.5-personal-2.png]]
 
[[File:Openafs-macos-10.5-personal-2.png]]
 
+
<hr />
 
[[File:Openafs-macos-10.5-personal-3.png]]
 
[[File:Openafs-macos-10.5-personal-3.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-4.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-5.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-6.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-7.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-8.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-9.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-10.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-11.png]]
 +
<hr />
 +
[[File:Openafs-macos-10.5-personal-13.png]]
  
[[File:Openafs-macos-10.5-personal-4.png]]
+
= Get tickets and tokens =
 +
From Terminal.app or your preferred terminal:
  
[[File:Openafs-macos-10.5-personal-5.png]]
+
(If you're using a BX password)
 +
<pre>$ kinit phalenor@BX.PSU.EDU -l 14d -r 30d
 +
$ aklog</pre>
  
[[File:Openafs-macos-10.5-personal-6.png]]
+
(If you're using your PSU Access Account Password)
 +
<pre>$ kinit atc135@dce.psu.edu -l 14d -r 28d
 +
$ aklog -c bx.psu.edu -r dce.psu.edu</pre>
  
[[File:Openafs-macos-10.5-personal-7.png]]
+
= Advanced Configuration =
 +
There are a few more steps that you can take to make your personal AFS experience slightly better. Explaining how to edit files through the command line as an admin user are beyond the scope of this howto. vi or vim through sudo should suffice in most cases, however.
  
[[File:Openafs-macos-10.5-personal-8.png]]
+
== Client tuning ==
 +
First we want to set the cache manager settings to make it "better". These are set in '''/var/db/openafs/etc/config/afs.conf''' Find the ''OPTIONS='' line, and set it to:
  
[[File:Openafs-macos-10.5-personal-9.png]]
+
<pre>OPTIONS="-dynroot -fakestat -fakestat-all -afsdb -nosettime -stat 9600 -daemons 12 -volumes 1024 -chunksize 18 -rxpck 2048"</pre>
  
[[File:Openafs-macos-10.5-personal-10.png]]
+
Next, we want to enable RealModes in '''/var/db/openafs/etc/config/settings.plist'''. Open the file in an editor, find ''<key>RealModes</key>'' and set it to ''<true/>''.
  
[[File:Openafs-macos-10.5-personal-11.png]]
+
These options will go into affect the next time you reboot or restart the client.
  
[[File:Openafs-macos-10.5-personal-13.png]]
+
== Kerberos settings ==
 +
By default, Kerberos on OS X will use DNS to locate the BX.PSU.EDU and dce.psu.edu realms. However, we can set it so you don't have to specify ticket lifetime (-l) and renew time (-r) at the command line. This can be accomplished by downloading a copy of our krb5.conf from http://admin.bx.psu.edu/install/krb5.conf and placing it in '''/etc/krb5.conf'''.

Revision as of 12:56, 28 October 2011

Install the OpenAFS Client

Openafs-macos-10.5-personal-1.png


Openafs-macos-10.5-personal-2.png


Openafs-macos-10.5-personal-3.png


Openafs-macos-10.5-personal-4.png


Openafs-macos-10.5-personal-5.png


Openafs-macos-10.5-personal-6.png


Openafs-macos-10.5-personal-7.png


Openafs-macos-10.5-personal-8.png


Openafs-macos-10.5-personal-9.png


Openafs-macos-10.5-personal-10.png


Openafs-macos-10.5-personal-11.png


Openafs-macos-10.5-personal-13.png

Get tickets and tokens

From Terminal.app or your preferred terminal:

(If you're using a BX password)

$ kinit phalenor@BX.PSU.EDU -l 14d -r 30d
$ aklog

(If you're using your PSU Access Account Password)

$ kinit atc135@dce.psu.edu -l 14d -r 28d
$ aklog -c bx.psu.edu -r dce.psu.edu

Advanced Configuration

There are a few more steps that you can take to make your personal AFS experience slightly better. Explaining how to edit files through the command line as an admin user are beyond the scope of this howto. vi or vim through sudo should suffice in most cases, however.

Client tuning

First we want to set the cache manager settings to make it "better". These are set in /var/db/openafs/etc/config/afs.conf Find the OPTIONS= line, and set it to:

OPTIONS="-dynroot -fakestat -fakestat-all -afsdb -nosettime -stat 9600 -daemons 12 -volumes 1024 -chunksize 18 -rxpck 2048"

Next, we want to enable RealModes in /var/db/openafs/etc/config/settings.plist. Open the file in an editor, find <key>RealModes</key> and set it to <true/>.

These options will go into affect the next time you reboot or restart the client.

Kerberos settings

By default, Kerberos on OS X will use DNS to locate the BX.PSU.EDU and dce.psu.edu realms. However, we can set it so you don't have to specify ticket lifetime (-l) and renew time (-r) at the command line. This can be accomplished by downloading a copy of our krb5.conf from http://admin.bx.psu.edu/install/krb5.conf and placing it in /etc/krb5.conf.