Show
Ignore:
Timestamp:
01/31/08 05:19:14 (17 years ago)
Author:
broder
Message:

Put install instructions on their own page

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/site/index.html

    r99 r100  
    1313    <p>The <strong>MacAthena</strong> project is working to bring the functionality of the <a href="http://web.mit.edu/is/topics/athena/">Athena system</a> to your <a href="http://www.apple.com/macosx/">Mac OS X</a> Tiger or Leopard system.</p> 
    1414     
     15    <p>MacAthena is a project of <a href="http://stuff.mit.edu/sipb/">SIPB</a>. If you have questions or comments, please contact the <a href="mailto:sipb-macathena@mit.edu">MacAthena maintainers</a>.</p> 
     16     
    1517    <h2>Goals</h2> 
    1618     
    …… 
    2426    </ul> 
    2527     
    26     <h2>Install Instructions</h2> 
     28    <h2><a href="/install">Installing MacAthena</a></h2> 
    2729     
    28     <h3 id="preinstall">Preparing Your System</h3> 
     30    <h2>What We Have</h2> 
    2931     
    30     <p>MacAthena takes advantage of several other software packages that are required to install MacAthena.</p> 
     32    <p>At this point, we have the following major features:</p> 
    3133     
    32     <ol> 
     34    <h3>Available By Installing <tt>macathena-basic</tt></h3> 
    3335     
    34     <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 ATHENA.MIT.EDU Kerberos realm.</p></li> 
     36    <ul> 
    3537     
    36     <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> 
     38    <li><tt>/mit</tt> automounter&mdash;Access AFS lockers simply accessing paths of the form <tt>/mit/<var>locker</var></tt>, eliminating the need to actually attach lockers.</li> 
     39    <li><tt>add</tt></li> 
     40    <li>Moira clients&mdash;including <tt>blanche</tt>, <tt>stella</tt>, and <tt>moira</tt></li> 
    3741     
    38     <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> 
     42    </ul> 
    3943     
    40     <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> 
     44    <h3>Available By Installing <tt>macathena-standard</tt> (in addition to the packages from <tt>macathena-basic</tt>)</h3> 
    4145     
    42     <p>When you install Fink, there are a few important settings to ensure the best compatibility with MacAthena. You should be sure to enable the unstable branch. Also, in the mirror selection section, you should be sure to &#8216;Search &#8220;Master&#8221; source mirrors last.&#8217;</p> 
     46    <p>Many of these commands are not frequently used, but some locker programs depend on their presence</p> 
    4347     
    44     <blockquote><pre>The Fink team maintains mirrors known as "Master" mirrors, which contain the 
    45 sources for all fink packages. You can choose to use these mirrors first, last, 
    46 never, or mixed in with regular mirrors. If you don't care, just select the 
    47 default. 
    48  
    49 (1)     Search "Master" source mirrors first. 
    50 (2)     Search "Master" source mirrors last. 
    51 (3)     Never use "Master" source mirrors. 
    52 (4)     Search closest source mirrors first. (combine all mirrors into one set) 
    53  
    54 What mirror order should fink use when downloading sources? [2] <kbd>2</kbd> 
    55     </pre></blockquote> 
     48    <ul> 
    5649     
    57     <p>Once you've finished installing Fink, you'll want to run:</p> 
     50    <li><tt>athinfo</tt></li> 
     51    <li><tt>delete</tt></li> 
     52    <li><tt>discuss</tt></li> 
     53    <li><tt>get-cluster</tt></li> 
     54    <li><tt>just</tt></li> 
     55    <li><tt>machtype</tt></li> 
    5856     
    59     <pre>/sw/bin/pathsetup.sh</pre> 
    60      
    61     <p>and click OK in the dialog that displays.</p></li> 
    62      
    63     <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> 
    64      
    65     </ol> 
    66      
    67     <h3 id="checkout">Installing MacAthena</h3> 
    68      
    69     <p>To install MacAthena, first run:</p> 
    70      
    71     <pre><kbd>cd /svn/fink/dists</kbd> 
    72 <kbd>sudo svn co https://macathena.mit.edu/svn/trunk/fink/ macathena</kbd></pre> 
    73      
    74     <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> 
    75      
    76     <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>    
    77      
    78     <pre>Trees: local/main stable/main stable/crypto unstable/main unstable/crypto macathena/main</pre> 
    79      
    80     <h3 id="binary">Using a Binary Distribution</h3> 
    81      
    82     <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> 
    83      
    84     <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> 
    85      
    86     <pre>UseBinaryDist: true</pre> 
    87      
    88     <p>Next, edit <tt>/sw/etc/apt/sources.list</tt> and add the following lines to the very beginning of the file:</p> 
    89      
    90     <pre>deb http://macathena.mit.edu/fink macathena main 
    91 deb http://macathena.mit.edu/fink stable main crypto 
    92 deb http://macathena.mit.edu/fink unstable main crypto</pre> 
    93      
    94     <h3 id="package-install">Installing the Packages</h3> 
    95      
    96     <p>Once you've setup the MacAthena trees in Fink, run:</p> 
    97      
    98     <pre><kbd>fink index</kbd> 
    99 <kbd>fink install <var>macathena-standard</var></kbd></pre> 
    100      
    101     <p>Finally, please subscribe to our announcement list, so that we can send updates about new development:</p> 
    102      
    103     <pre><kbd>blanche macathena-announce -a $USER</kbd></pre> 
     57    </ul> 
    10458</body> 
    10559</html>