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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
|
<?xml version="1.0" encoding="ISO-8859-15"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/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 second stable version (via darcs; CVS and svn
mirrors planned)</li>
<li>Version 3, the upcoming third stable version (via darcs; CVS
and svn mirrors 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 current stable version. We do not plan to
make further changes to this version unless a serious error is
detected.</p>
<p>Version 3 is the upcoming next stable version. 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 (outdated)</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 (outdated)</h3>
<p>Version 2 of Carpet is available via anonymous <a
href="http://www.darcs.net/">darcs</a>:</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
the <a
href="http://www.carpetcode.org/~darcs/carpet-stable-2/">version 2
source tree</a> in your web browser.</p>
<h3>Version 3</h3>
<p>Version 3 of Carpet is available via anonymous <a
href="http://www.darcs.net/">darcs</a>:</p>
<pre> cd Cactus
darcs get http://www.carpetcode.org/~darcs/carpet-stable-3/
cd arrangements
ln -s ../carpet-stable-3/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
the <a
href="http://www.carpetcode.org/~darcs/carpet-stable-3/">version 3
source tree</a> in your web browser.</p>
<h3>Development Version</h3>
<p>The development version of Carpet is available via
anonymous <a href="http://www.darcs.net/">darcs</a>:</p>
<pre> cd Cactus
darcs get http://www.carpetcode.org/~darcs/carpet/
cd arrangements
ln -s ../carpet/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
the <a href="http://www.carpetcode.org/~darcs/carpet/">development
source tree</a> in your web browser.</p>
<p>You can also obtain the darcs repository using <tt>wget</tt>
instead of <tt>darcs</tt>. For this, use the command</p>
<pre> wget -r -nH -np --cut-dirs=1 -R "index.html*" http://www.carpetcode.org/\~darcs/carpet/</pre>
<p>This copies the darcs repository into a subdirectory
called <tt>carpet</tt>, in much the same way as the <tt>darcs
get</tt> command above would. That is, you also end up with a
fully functional local repository.</p>
<h3>Write Access</h3>
<p>Write access to Carpet is via ssh. Once you have an account,
you get e.g. the development version via</p>
<pre> cd Cactus
darcs get darcs@cvs.carpetcode.org:/home/darcs/carpet
cd arrangements
ln -s ../carpet/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>You can also obtain the darcs repository using <tt>rsync</tt>
instead of <tt>darcs</tt>. For this, use the command</p>
<pre> rsync -Paz darcs@cvs.carpetcode.org:carpet .</pre>
<p>This copies the darcs repository into a subdirectory
called <tt>carpet</tt>, in much the same way as the <tt>darcs
get</tt> command above would. That is, you also end up with a
fully functional local repository.</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 servers.</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>Another prime source of information about darcs is
the <a href="http://darcs.net/DarcsWiki">darcs wiki</a>,
especially
its <a href="http://darcs.net/DarcsWiki/GettingStarted">Getting
Started</a> pages, and the
<a
href="http://darcs.net/DarcsWiki/FrequentlyAskedQuestions">Frequently
Asked Questions</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 && 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: Sun Feb 04 2007
<!-- hhmts end -->
</body>
</html>
|