= MacAthena Install Instructions =

Currently, the project is in the process of being updated, and as such, MacAthena is not in a state where installation is worthwhile. The below instructions are for reference only, and there is no guarantee they will work on modern macOS systems. 

If you are interested in contributing to the project, please [mailto:sipb-macathena@mit.edu contact us]

== MacPorts instructions (OS X 10.7 Lion and up) ==

 * Install MacPorts using the instructions at http://www.macports.org/install.php
 * `cd /opt/local && git clone https://github.com/macathena/macathena macathena`
 * `sudo sed -i '1ifile:///opt/local/macathena/ports' /opt/local/etc/macports/sources.conf`
 * `port selfupdate`
 * `port install macathena-base`

== Fink instructions (DEPRECATED - OS X 10.5 Leopard and below ONLY) ==


{{{
#!html

    <h2 id="preinstall">Preparing Your System</h2>
    
    <p>MacAthena takes advantage of several other software packages that are required to install MacAthena.</p>
    
    <ol>
    
    <li><p>First, 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 <strong>1.4.7</strong></a>of OpenAFS. We currently require version 1.4.7 due to new features that were introduced in that version.</p></li>
    
    <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>
    
    <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>
    
    <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 &#8216;Search &#8220;Master&#8221; source mirrors last.&#8217; If you've already installed fink, you can change these settings by running <tt>fink configure</tt>.</p>
    
    <blockquote><pre>The Fink team maintains mirrors known as "Master" mirrors, which contain the
sources for all fink packages. You can choose to use these mirrors first, last,
never, or mixed in with regular mirrors. If you don't care, just select the
default.

(1)	Search "Master" source mirrors first.
(2)	Search "Master" source mirrors last.
(3)	Never use "Master" source mirrors.
(4)	Search closest source mirrors first. (combine all mirrors into one set)

What mirror order should fink use when downloading sources? [2] <kbd>2</kbd>
    </pre></blockquote>

    <p>After enabling the unstable branch, you should run</p>

    <pre>fink selfupdate-rsync</pre>

    <p>to be sure that you're seeing all available unstable packages</p>
    
    <p>Once you've finished installing Fink, you'll want to run:</p>
    
    <pre>/sw/bin/pathsetup.sh</pre>
    
    <p>and click OK in the dialog that displays.</p></li>
    
    <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>
    
    </ol>
    
    <h2 id="checkout">Installing MacAthena</h2>
    
    <p>To install MacAthena, first run:</p>
    
    <pre><kbd>cd /sw/fink/dists</kbd>
<kbd>sudo svn co https://macathena.mit.edu/svn/trunk/fink/ macathena</kbd></pre>
    
    <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/wiki/install" 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>82:0e:5f:b7:87:13:dd:b5:27:f2:fa:41:04:bc:25:cb:3c:2b:4b:b2</tt></p>
    
    <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>   
    
    <pre>Trees: local/main stable/main stable/crypto unstable/main unstable/crypto macathena/main</pre>
    
    <!--<h2 id="binary">Using a Binary Distribution</h2>
    
    <p>If you are using an Intel Mac with OS X 10.5 Leopard, we are testing a binary distributions. If you are not using an Intel Mac with Leopard or wish to compile all packages from source, feel free to skip to the <a href="#package-install">Install the Packages</a> section.</p>
    
    <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>
    
    <pre>UseBinaryDist: true</pre>
    
    <p>Next, edit <tt>/sw/etc/apt/sources.list</tt> and add the following lines to the very beginning of the file:</p>
    
    <pre>deb http://macathena.mit.edu/fink macathena main
deb http://macathena.mit.edu/fink stable main crypto
deb http://macathena.mit.edu/fink unstable main crypto</pre>-->
    
    <h2 id="package-install">Installing the Packages</h2>
    
    <p>Once you've setup the MacAthena trees in Fink, you can install the MacAthena software:</p>
    
    <pre><kbd>fink index</kbd>
<kbd>fink install macathena-standard</kbd></pre>
    
    <p>Finally, please subscribe to our announcement list, so that we can send updates about new development:</p>
    
    <pre><kbd>blanche macathena-announce -a $USER</kbd></pre>
    
    <h2 id="update">Updating MacAthena</h2>
    
    <p>MacAthena is under active development, and new changes to the packages are released frequently. To access these new changes, run the command:</p>
    
    <pre><kbd>macathena-update</kbd></pre>
    
    <p>which is installed by both <tt>macathena-standard</tt> and <tt>macathena-basic</tt>. Once that finishes, run</p>
    
    <pre><kbd>fink update-all</kbd></pre>
    
    <p>to update the packages to their latest versions.</p>

}}}