Changeset 99

Show
Ignore:
Timestamp:
01/31/08 04:47:08 (17 years ago)
Author:
broder
Message:

Installation instructions (and some other real content) with some
editing from geofft. I'm probably going to spin the installation
instructions off to their own page shortly

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/site/index.html

    r98 r99  
    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    <h2>Goals</h2> 
     16     
     17    <p>Eventually, the MacAthena project would like to offer:</p> 
     18     
     19    <ul> 
     20    <li>Full command-line compatability with Linux Athena</li> 
     21    <li>Cocoa applications to provide easier to use interfaces to common Athena tasks</li> 
     22    <li>A package based system allowing MacAthena users to setup anything from a few utilities to a system with Kerberos-based logins and AFS home directories</li> 
     23    <li>Support in common lockers, providing MacAthena users with access to the wealth of software available in AFS</li> 
     24    </ul> 
     25     
    1526    <h2>Install Instructions</h2> 
    1627     
    17     <p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed eu mauris. Donec eget mauris. Nullam nulla justo, semper id, tristique id, posuere at, nunc. Etiam egestas commodo massa. Aenean vel nisi eget lacus aliquam tempor. Proin et magna non quam euismod hendrerit. Curabitur mattis. Curabitur commodo, mauris eget imperdiet feugiat, felis mauris tincidunt nunc, ut dapibus lacus lectus scelerisque nisi. Phasellus sem lacus, ultrices eget, scelerisque eu, posuere sit amet, urna. Sed ullamcorper, neque id facilisis cursus, diam nulla laoreet dui, non consequat nulla odio id lectus. Mauris tempor ligula sit amet diam. Curabitur et dui eu lacus mollis rhoncus. Proin ante enim, volutpat convallis, rutrum a, pretium non, urna. In hac habitasse platea dictumst. Cras blandit, orci quis bibendum pretium, risus urna egestas nulla, ut semper sem ligula nec mi. Nullam a est a nunc scelerisque porttitor.</p> 
     28    <h3 id="preinstall">Preparing Your System</h3> 
     29     
     30    <p>MacAthena takes advantage of several other software packages that are required to install MacAthena.</p> 
     31     
     32    <ol> 
     33     
     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> 
     35     
     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> 
     37     
     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> 
     39     
     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> 
     41     
     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> 
     43     
     44    <blockquote><pre>The Fink team maintains mirrors known as "Master" mirrors, which contain the 
     45sources for all fink packages. You can choose to use these mirrors first, last, 
     46never, or mixed in with regular mirrors. If you don't care, just select the 
     47default. 
    1848 
    19     <h2>Sed commodo molestie</h2> 
    20     <p>ante. Nam iaculis. In a nulla sit amet est luctus condimentum. Quisque consequat. Sed lacus augue, facilisis sed, sodales eu, varius sit amet, metus. Proin eget ligula et sapien porttitor tincidunt. Ut mollis, tellus a pretium volutpat, ipsum nisl elementum pede, at porta ipsum magna dignissim diam. Curabitur dapibus adipiscing diam. Maecenas nulla sem, volutpat non, facilisis ut, commodo vulputate, dolor. Mauris posuere justo id eros. Nam consectetuer mauris in nunc. Maecenas pretium molestie metus. Sed nisi est, semper a, tincidunt sed, euismod quis, tortor. Nulla eros. Maecenas malesuada rhoncus turpis. Nam tristique arcu eu odio. In hac habitasse platea dictumst. Vestibulum aliquet sollicitudin ligula.</p> 
     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) 
    2153 
    22     <p>Nulla nulla pede, euismod nec, commodo nec, iaculis at, dui. Duis dignissim, justo vel sollicitudin auctor, magna tellus bibendum nunc, a ultricies magna quam sit amet metus. Donec interdum porta mauris. Cras risus urna, molestie a, sollicitudin eget, pretium in, mi. Praesent at massa at diam mollis mollis. Quisque eros eros, aliquet a, accumsan et, malesuada dapibus, diam. Aenean tristique feugiat magna. Nam pede diam, rhoncus nec, porttitor vel, facilisis a, tortor. Donec ac dolor. Donec tincidunt turpis at orci. Donec urna tellus, rhoncus nec, venenatis sit amet, ultricies nec, diam. Morbi iaculis scelerisque velit. Mauris faucibus justo sit amet tortor. Fusce sapien.</p> 
     54What mirror order should fink use when downloading sources? [2] <kbd>2</kbd> 
     55    </pre></blockquote> 
     56     
     57    <p>Once you've finished installing Fink, you'll want to run:</p> 
     58     
     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 
     91deb http://macathena.mit.edu/fink stable main crypto 
     92deb 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> 
    23104</body> 
    24105</html> 

  • trunk/site/styles/layout.css

    r98 r99  
    77body { 
    88    position: relative; 
    9     max-width: 50em; 
     9    max-width: 55em; 
    1010    margin: 2em auto 2em; 
    1111    padding: 3em; 

  • trunk/site/styles/style.css

    r98 r99  
    8585    clear: both; 
    8686} 
     87.tooltip { 
     88    cursor: help; 
     89}