aboutsummaryrefslogtreecommitdiff
path: root/Carpet/CarpetWeb/get-carpet-darcs.html
blob: 406d2b170daf67210b4f45775efd7fba06cfcdaa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
<?xml version="1.0" encoding="ISO-8859-15"?>
<!DOCTYPE html
     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15" />
    <title>Download Carpet</title>
    <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
    </script>
    <script type="text/javascript">
      _uacct = "UA-97002-1";
      urchinTracker();
    </script>
  </head>

  <body>
    <h1>Download Carpet</h1>



    <h2>Available Versions</h2>

    <p>Carpet is distributed under the <a
    href="http://www.gnu.org/licenses/licenses.html">GNU General
    Public License (GPL)</a>.  It might be released under the GNU
    Lesser General Public License (LGPL) in the future, to match the
    distribution terms of Cactus.</p>

    <p>There are currently three different versions of Carpet
    available:</p>

    <ul>
      <li>Version 1, the old stable version (via CVS)</li>
      <li>Version 2, the upcoming second stable version (via darcs;
          CVS mirror planned)</li>
      <li>Development version (via darcs)</li>
    </ul>

    <p>Version 1 has been unchanged for quite some time.  There are no
    plans to make any further changes to this version unless a
    catastrophic error is detected.</p>

    <p>Version 2 is the upcoming next stable version.  This version is
    almost feature complete, but we continue to improve its
    performance for parallel communication and I/O.  This version will
    probably be released in a few week.  After its release, we will
    only correct errors, so that its users have a stable platform to
    rely on.  We recommend this version for the casual user and for
    production runs.</p>

    <p>The development version will always see changes, some of which
    might surprise you.  You should not use it without keeping close
    contact to the developers.</p>



    <h2>Getting Carpet</h2>

    <p>Carpet is a driver for Cactus.  It works as a part of Cactus,
    and you will need to have the developers' version of Cactus
    installed before you can use Carpet.  Please look at the <a
    href="http://www.cactuscode.org/">Cactus web pages</a> for an
    introduction to Cactus and for installation instructions.</p>

    <p>Carpet consists of several arrangements, each living in a
    directory.  The arrangement <code>Carpet</code> contains the basic
    driver part that everybody needs.  The arrangement
    <code>CarpetExtra</code> contains useful add-ons and some example
    code.  Development of new thorns happens in the
    <code>CarpetDev</code> arrangement, which means that the code in
    there is not to be trusted.  And finally, there is a graveyard
    arrangement <code>CarpetAttic</code> of things that only used to
    be useful and are now in a state of decay.</p>

    <h3>Version 1</h3>

    <p>Version 1 of Carpet is available via anonymous <a
    href="http://www.cvshome.org/">CVS</a>:</p>
<pre>        cd Cactus/arrangements
        cvs -d :pserver:cvs_anon@cvs.carpetcode.org:/home/cvs/carpet login
        cvs -d :pserver:cvs_anon@cvs.carpetcode.org:/home/cvs/carpet checkout Carpet
        cvs -d :pserver:cvs_anon@cvs.carpetcode.org:/home/cvs/carpet checkout CarpetExtra
        cvs -d :pserver:cvs_anon@cvs.carpetcode.org:/home/cvs/carpet checkout CarpetDev</pre>
    <p>The password for anonymous CVS access is <code>anon</code>.
    Instructions for dealing with CVS are available everywhere on the
    web, e.g. also on the <a href="http://www.cactuscode.org/">Cactus
    pages</a>.</p>

    <h3>Version 2</h3>

    <p>Version 2 of Carpet is available via anonymous <a
    href="http://www.darcs.net/">darcs</a> (a CVS mirror is planned):</p>
<pre>        cd Cactus
        darcs get http://www.carpetcode.org/~darcs/carpet-stable-2
        cd arrangements
        ln -s ../carpet-stable-2/Carpet* .</pre>
    <p>(Don't miss the dot after the <code>Carpet*</code> in the last
    line.)  Instructions for using darcs are given <a
    href="#darcs">below</a>.  You can also have a look at <a
    href="http://www.carpetcode.org/~darcs/carpet-stable-2">Carpet's
    source tree</a> in your web browser.</p>

    <h3>Development Version</h3>

    <p>The development version of Carpet is not available anonymously.
    <a href="mailto:schnetter@aei.mpg.de">Ask me</a> if you would like
    an account.  Once you have an account, you get the development
    version via</p>
<pre>        cd Cactus
        darcs get darcs@cvs.carpetcode.org:/home/darcs/carpet
        cd arrangements
        ln -s ../carpet-stable-2/Carpet* .</pre>
    <p>(Don't miss the dot after the <code>Carpet*</code> in the last
    line.)  Instructions for using darcs are given <a
    href="#darcs">below</a>.</p>

    <p>We thank the <a
    href="http://www.tat.physik.uni-tuebingen.de/">Institut f�r
    Astronomie und Astrophysik</a> of the Universit�t T�bingen for
    hosting the CVS and darcs server.</p>



    <hr />

    <h2 id="darcs">Using Darcs</h2>

    <p>Carpet is managed in a <a href="http://darcs.net/">darcs</a>
    repository instead of a CVS repository.  Darcs has a number of
    advantages over CVS for us developers, such as:</p>

    <ul>
      <li>You have a local copy of the repository, and can therefore
          work offline</li>
      <li>You can decide which changes you want to import and export,
          so that you can omit dangerous changes, or keep changes to
          yourself until you are ready to publish them</li>
      <li>You can undo most changes</li>
      <li>You can easily rename files and directories</li>
      <li>Darcs does not need its own server, which makes it both more
          convenient and more secure</li>
    </ul>

    <p>and then some more, as described in the <a
    href="http://darcs.net/manual/">darcs manual</a>.</p>

    <p>If darcs is not already installed on your system, you need to
    do so.  This is described on the <a href="http://darcs.net/">darcs
    home page</a>, and some links to binaries are given in the darcs
    wiki.  If you have problems installing or using darcs in general,
    then you should ask on the darcs mailing list, which I (Erik
    Schnetter) read regularly.</p>

    <h3>Convenient SSH key management</h3>

    <p>Ssh has two mechanisms for authentication, typing a password,
    or using ssh keys.  When you use ssh keys, your private key is
    (<em>should</em>) usually be protected by a password.  That means
    that you have to type this password every time you log into a
    different machine.  Some people protect their private ssh key with
    an empty password --- this way, they don't have to type a
    password, but this is not very secure.  If somebody is able to
    copy the private ssh key, they have access to your remote
    accounts.  In this way, intruders can hop from one machine to the
    next.  This is not just a theoretical risk.</p>

    <p>Ssh-agent is a convenient way to make things safe yet
    convenient.  It is an agent that starts automatically when you log
    in, and asks you for your ssh key password.  It remembers this
    password in memory, and whenever you use ssh to log into a remote
    account, ssh contacts the ssh-agent for the password to the key.
    If that password works, you don't have to type anything.</p>

    <p>I use the following lines in my <code>.bash_profile</code> to
    make this happen:</p>
    <pre>keychain id_dsa
test -f $HOME/.keychain/$(hostname)-sh &amp;&amp; source $HOME/.keychain/$(hostname)-sh > /dev/null
</pre>
    <p>Keychain starts the ssh-agent.  Keychain can also handle gpg
    key passwords for your encrypted and/or signed emails.</p>


    <h3>Updating the Repository from the Master</h3>

    <p>At some time you will want to update your version of Carpet and
    incorporate some changes from the main Carpet repository.  You do
    this with the command</p>
<pre>cd Cactus/carpet-stable-2
darcs pull</pre>
      <p>which will look for new changes, and then ask you which of these
      you want to obtain.  Normally, you will want all changes.</p>

    <h3>Working with Darcs</h3>

    <p>We also have some instructions on how to <a
    href="work-with-darcs.html">develop Carpet with darcs</a>.</p>



    <hr />

    <p>Go back to the <a href=".">Carpet home page</a>.</p>

    <hr />

    <p>
      <a href="http://validator.w3.org/check?uri=referer"><img
          src="http://www.w3.org/Icons/valid-xhtml10"
          alt="Valid XHTML 1.0!" height="31" width="88" /></a>
    </p>

    <hr />
    <address><a href="mailto:schnetter@uni-tuebingen.de">Erik Schnetter</a></address>
<!-- Created: Tue Sep 28 16:52:20 CEST 2004 -->
<!-- hhmts start -->
Last modified: Tue Aug 08 2006
<!-- hhmts end -->
  </body>
</html>