User: gallen Date: 2010/03/17 12:42 PM

Modified: /info/documentation/ index.php

Log: Updated first half of instructions

File Changes:

Directory: /info/documentation/ ===============================

File [modified]: index.php Delta lines: +23 -21 =================================================================== --- info/documentation/index.php 2010-03-17 17:33:15 UTC (rev 81) +++ info/documentation/index.php 2010-03-17 17:42:49 UTC (rev 82) @@ -6,51 +6,53 @@ <h3>For Cactus Experts</h3>

<p>The Einstein Toolkit can be checked out using GetCactus using the -<a href="https://svn.einsteintoolkit.org/cactus/thornlists/einsteintoolkit.th">Einstein Toolkit thornlist</a>. This thornlist should compile and -run on platforms supported by the Cactus team using the usual Cactus <a href="http://cactuscode.org/download/configfiles/">configuration files</a> available on the Cactus web page or with the <a href="http://www.cct.lsu.edu/~eschnett/SimFactory/">Simulation Factory</a>. +<a href="https://svn.einsteintoolkit.org/cactus/thornlists/einsteintoolkit.th">Einstein Toolkit</a> thornlist. This thornlist should compile and +run on platforms supported by the Cactus team using the usual Cactus <a href="http://www.cactuscode.org/download/configfiles/">configuration files</a> available on the Cactus web page or with the <a href="http://www.cct.lsu.edu/~eschnett/SimFactory/">Simulation Factory</a>. </p> <p> Example parameter files are provided in the Einstein Toolkit SVN repository.</p> -<p><tt>svn checkout https://svn.einsteintoolkit.org/examples/</tt></p> +<p><tt>svn checkout https://svn.einsteintoolkit.org/EinsteinExamples/</tt></p> <p> -Problems with compiling or running should be sent to <a href="mailto:users@einsteintoolkit.org">users@einsteintoolkit.org</a>. +Problems with compiling or running should be directed to <a href="mailto:users@einsteintoolkit.org">users@einsteintoolkit.org</a>. </p>

<h3>For Cactus Beginners</h3>

<p>This section provides a simple guide for compiling and running an example parameter file for the Einstein Toolkit.</p>

-<p>One of the complexities of high performance computing, particularly for new users, is the heterogeneous environments presented by different resources with different core software installations and local setups. For example, Einstein Toolkit codes necessitate compiling with MPI and then running the resulting application in batch queue. As much as possible of this complexity is hidden in Cactus and accompanying tools such as the Simulation Factory.</p> +<p>One of the complexities of high performance computing, particularly for new users, is the heterogeneous environments presented by different resources with different core software installations and local setups. For example, Einstein Toolkit codes necessitate compiling with MPI and then running the resulting application in a batch queue. As much as possible of this complexity is hidden in Cactus and accompanying tools such as the Simulation Factory.</p>

-<p>This example assumes that the NSF TeraGrid resource Queen Bee at the LONI/LSU site is being used to compile and run.</p> +<p>This example assumes that the NSF TeraGrid resource Queen Bee at the LONI/LSU site is being used.</p>

-<p><b>Customizing Local Environment:</b></p> +<p><b>Preparations:</b></p>

-<p>On Queen Bee, the <tt>git</tt> client is not in the path by default. To add this use + <p>On Queen Bee (qb.loni.org), the <tt>git</tt> client will not be in your path by default. To add this type </p> <p><tt>soft add +git-1.6.1.3-intel-11.1</tt></p>

-<p><b>Stuff you Need:</b></p> +<p>Download the <a href="http://cactuscode.org/download/GetCactus">GetCactus</a> script for assembling thorns from a thornlist:</p>

-<p>Download the following from the web and save in files of the same name:</p> +<p><tt>wget http://cactuscode.org/download/GetCactus</tt></p>

-<dl> + <p>You will need to make sure that GetCactus is executable</p>

-<dt>Cactus script for assembling thorns from a thornlist: -<dd><a href="http://cactuscode.org/download/GetCactus">GetCactus</a> - <dt>Thornlist for the Einstein Toolkit: -<dd><a href="https://svn.einsteintoolkit.org/cactus/thornlists/einsteintoolkit.th">einsteintoolkit.th</a> +<p><tt>chmod 755 GetCactus</tt></p> + +<p>Download the <a href="https://svn.einsteintoolkit.org/cactus/thornlists/einsteintoolkit.th">thornlist</a> for the Einstein Toolkit:</p> + +<p><tt>wget https://svn.einsteintoolkit.org/cactus/thornlists/einsteintoolkit.th</tt></p> -</dl>

<p><b>Download Software:</b></p>

-<p> In the location where you want to compile Cactus checkout the flesh and Einstein Toolkit thorns: +<p>In the location where you want to compile Cactus checkout the flesh and Einstein Toolkit thorns: </p>

-<p><tt>GetCactus -repository=development -defaults EinsteinToolkit.th </tt></p> +<p><tt>GetCactus -repository=development -defaults einsteintoolkit.th </tt></p>

+ <p>NOTE: It may be necessary to temporarily accept certificates as the thorns are checked out, we are working on resolving this issue.</p> + <p>Move into the Cactus directory and download the <a href="http://www.cct.lsu.edu/~eschnett/SimFactory/">Simulation Factory</a> (tool for configuring and running Cactus on particular machines.)<p>

@@ -66,13 +68,13 @@ <p><b>Compile Executable:</b></p>

-<p><tt>./simfactory/sim build --thornlist=EinsteinToolkit.th</tt></p> +<p><tt>./simfactory/sim build --thornlist=einsteintoolkit.th</tt></p>

<p><b>Submit a Simulation:</b>

<p>Create a batch queue script and submit it to queue the simulation:</p> -<p><tt>./simfactory/sim create-submit --parfile=examples/ks-mclachlan.par --procs=32 --walltime=8:0:0</tt></p> +<p><tt>./simfactory/sim create-submit --parfile=EinsteinExamples/par/ks-mclachlan.par --procs=32 --walltime=8:0:0</tt></p>

<p>To check the status of the simulation, use</p>

@@ -84,6 +86,6 @@

<p><b>Any Problems?</b></p>

-This example should work smoothly on the TeraGrid machines Queen Bee, Ranger, Kraken and Abe. If you have any problems, please send details to <tt>users@einsteintoolkit.org</tt> including a copy of the reported error at any point.</p> +This example should work smoothly on the TeraGrid machines Queen Bee, Ranger, Kraken and Abe. If you have any problems, please send details to <a href="mailto:users@einsteintoolkit.org">users@einsteintoolkit.org</a></tt>.</p>

<?php include_once($_SERVER['DOCUMENT_ROOT'].'/global/footer.php');?>