| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
|---|
| 2 |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|---|
| 3 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
|---|
| 4 |
<head> |
|---|
| 5 |
<title>MacAthena: Install Instructions</title> |
|---|
| 6 |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
|---|
| 7 |
<link rel="stylesheet" href="styles/style" type="text/css" /> |
|---|
| 8 |
<link rel="stylesheet" href="styles/layout" type="text/css" media="screen" /> |
|---|
| 9 |
</head> |
|---|
| 10 |
<body> |
|---|
| 11 |
<h1><a href="/">MacAthena</a>: Install Instructions</h1> |
|---|
| 12 |
|
|---|
| 13 |
<h2 id="preinstall">Preparing Your System</h2> |
|---|
| 14 |
|
|---|
| 15 |
<p>MacAthena takes advantage of several other software packages that are required to install MacAthena.</p> |
|---|
| 16 |
|
|---|
| 17 |
<ol> |
|---|
| 18 |
|
|---|
| 19 |
<li><p>First, you should install the <a href="http://web.mit.edu/macdev/KfM/Common/Documentation/osx-kerberos-extras.html">OS X Kerberos Extras</a>. These will configure your computer for the <tt>ATHENA.MIT.EDU</tt> Kerberos realm.</p></li> |
|---|
| 20 |
|
|---|
| 21 |
<li><p>Second, many components in MacAthena depend on <a href="http://www.openafs.org/macos.html">AFS</a>, the distributed network filesystem. MacAthena is tested on <a href="http://www.openafs.org/macos.html">version 1.4.6 </a>of OpenAFS.</p></li> |
|---|
| 22 |
|
|---|
| 23 |
<li><p>You'll also need the Mac OS X Developer Tools, which can be installed either from your Mac OS X install CD or DVD, or downloaded from the <a href="http://developer.apple.com/tools/xcode/">Apple Developer Connection</a>.</p></li> |
|---|
| 24 |
|
|---|
| 25 |
<li><p>Finally, MacAthena uses the <a href="http://www.finkproject.org/index.php">Fink</a> project for package management. If you are using Mac OS X Tiger, there is a <a href="http://www.finkproject.org/download/index.php?phpLang=en">binary distribution</a> available. If you're using Mac OS X Leopard, you'll need to download the <a href="http://www.finkproject.org/download/srcdist.php">source distribution</a> and bootstrap using the instructions on that page.</p> |
|---|
| 26 |
|
|---|
| 27 |
<p>When you install Fink, there are a few important settings to ensure the best compatibility with MacAthena. You should be sure to <strong>enable the unstable branch</strong>. Also, in the mirror selection section, you should be sure to ‘Search “Master” source mirrors last.’ If you've already installed fink, you can change these settings by running <tt>fink configure</tt>.</p> |
|---|
| 28 |
|
|---|
| 29 |
<blockquote><pre>The Fink team maintains mirrors known as "Master" mirrors, which contain the |
|---|
| 30 |
sources for all fink packages. You can choose to use these mirrors first, last, |
|---|
| 31 |
never, or mixed in with regular mirrors. If you don't care, just select the |
|---|
| 32 |
default. |
|---|
| 33 |
|
|---|
| 34 |
(1) Search "Master" source mirrors first. |
|---|
| 35 |
(2) Search "Master" source mirrors last. |
|---|
| 36 |
(3) Never use "Master" source mirrors. |
|---|
| 37 |
(4) Search closest source mirrors first. (combine all mirrors into one set) |
|---|
| 38 |
|
|---|
| 39 |
What mirror order should fink use when downloading sources? [2] <kbd>2</kbd> |
|---|
| 40 |
</pre></blockquote> |
|---|
| 41 |
|
|---|
| 42 |
<p>Once you've finished installing Fink, you'll want to run:</p> |
|---|
| 43 |
|
|---|
| 44 |
<pre>/sw/bin/pathsetup.sh</pre> |
|---|
| 45 |
|
|---|
| 46 |
<p>and click OK in the dialog that displays.</p></li> |
|---|
| 47 |
|
|---|
| 48 |
<li><p>If you have used Google's installer for MacFUSE, you may want to uninstall it. We will install our own version of FUSE as part of the MacAthena install process. Google maintains <a href="http://code.google.com/p/macfuse/wiki/FAQ#2._Install/Uninstall_Questions">instructions</a> on how to uninstall FUSE</p></li> |
|---|
| 49 |
|
|---|
| 50 |
</ol> |
|---|
| 51 |
|
|---|
| 52 |
<h2 id="checkout">Installing MacAthena</h2> |
|---|
| 53 |
|
|---|
| 54 |
<p>To install MacAthena, first run:</p> |
|---|
| 55 |
|
|---|
| 56 |
<pre><kbd>cd /svn/fink/dists</kbd> |
|---|
| 57 |
<kbd>sudo svn co https://macathena.mit.edu/svn/trunk/fink/ macathena</kbd></pre> |
|---|
| 58 |
|
|---|
| 59 |
<p>You'll get a warning about the SSL certificate. If you'd like, you can verify it against the fingerprint on <a href="https://macathena.mit.edu/" class="tooltip" title="This page is accessible from HTTPS, and your browser should be able to verify the server's authenticity becuase the certificate is signed by the MIT Certificate Authority">a secure page</a>: <tt>F8:C5:9C:10:22:23:2E:56:1D:8A:53:7C:FD:9C:3B:96:8A:A2:71:BA</tt></p> |
|---|
| 60 |
|
|---|
| 61 |
<p>Next, edit <tt>/sw/etc/fink.conf</tt> with whatever text editor you prefer, and edit the <tt>Trees:</tt> line to read:</p> |
|---|
| 62 |
|
|---|
| 63 |
<pre>Trees: local/main stable/main stable/crypto unstable/main unstable/crypto macathena/main</pre> |
|---|
| 64 |
|
|---|
| 65 |
<h2 id="binary">Using a Binary Distribution</h2> |
|---|
| 66 |
|
|---|
| 67 |
<p>If you are using an Intel Mac, we are testing a binary distributions. If you are not using an Intel Mac or wish to compile all packages from source, feel free to skip to the <a href="#package-install">Install the Packages</a> section.</p> |
|---|
| 68 |
|
|---|
| 69 |
<p>To use the binary distribution, first find the <tt>UseBinaryDist</tt> line in <tt>/sw/etc/fink.conf</tt> and set it to</p> |
|---|
| 70 |
|
|---|
| 71 |
<pre>UseBinaryDist: true</pre> |
|---|
| 72 |
|
|---|
| 73 |
<p>Next, edit <tt>/sw/etc/apt/sources.list</tt> and add the following lines to the very beginning of the file:</p> |
|---|
| 74 |
|
|---|
| 75 |
<pre>deb http://macathena.mit.edu/fink macathena main |
|---|
| 76 |
deb http://macathena.mit.edu/fink stable main crypto |
|---|
| 77 |
deb http://macathena.mit.edu/fink unstable main crypto</pre> |
|---|
| 78 |
|
|---|
| 79 |
<h2 id="package-install">Installing the Packages</h2> |
|---|
| 80 |
|
|---|
| 81 |
<p>Once you've setup the MacAthena trees in Fink, you can install the MacAthena software:</p> |
|---|
| 82 |
|
|---|
| 83 |
<pre><kbd>fink index</kbd> |
|---|
| 84 |
<kbd>fink install <var>macathena-standard</var></kbd></pre> |
|---|
| 85 |
|
|---|
| 86 |
<p>Finally, please subscribe to our announcement list, so that we can send updates about new development:</p> |
|---|
| 87 |
|
|---|
| 88 |
<pre><kbd>blanche macathena-announce -a $USER</kbd></pre> |
|---|
| 89 |
|
|---|
| 90 |
<h2 id="update">Updating MacAthena</h2> |
|---|
| 91 |
|
|---|
| 92 |
<p>MacAthena is under active development, and new changes to the packages are released frequently. To access these new changes, run the command:</p> |
|---|
| 93 |
|
|---|
| 94 |
<pre><kbd>macathena-update</kbd></pre> |
|---|
| 95 |
|
|---|
| 96 |
<p>which is installed by both <tt>macathena-standard</tt> and <tt>macathena-login</tt>. Once that finishes, run</p> |
|---|
| 97 |
|
|---|
| 98 |
<pre><kbd>fink update-all</kbd></pre> |
|---|
| 99 |
|
|---|
| 100 |
<p>to update the packages to their latest versions.</p> |
|---|
| 101 |
</body> |
|---|
| 102 |
</html> |
|---|
