import repository from arizona
[raven.git] / apps / ravenpublish / raven.x
1 [NAME]
2 raven \- Raven Client Tools
3 [DESCRIPTION]
4 .PP
5 Raven is a administration tool for installing packages and provisioning resources
6 on a collection of hosts.
7
8 [COMMANDS]
9 The following commands are understood by raven:
10
11 .I Create
12     Create a new experiment container in the current directory, or the directory
13 specified by the -D option.
14
15 .I Config
16     Configure experiment-related options.
17
18 .I Make
19     Build the current experiment. The packages directory is scanned for packages
20 and the users directory is scanned for public keys. These are combined to
21 create a tpfile in the tpfiles directory, and optionally a packages.pacman file
22 in the tempest directory. Files are signed and copied to the upload directory.
23
24 .I Publish
25     Publish executes both the
26 .I make
27 and
28 .I upload
29 commands.
30
31 .I Upload
32     Uploads the files in the upload directory to the repository.
33
34 [RAVEN CONFIGURATION FILE]
35 Each experiment container includes a configuration file. This configuration file
36 may be edited by using the command
37 .I raven config
38
39 [EXAMPLE USAGE]
40 .PP
41 .B Creating a new experiment
42
43     # creates a new experiment in the directory ~/myexperiment
44     mkdir ~/myexperiment
45     raven -D ~/myexperiment create
46
47 .B Installing and publishing a package
48
49     # copy and RPM to the packages directory, and invoke raven to cause
50     # that package to be published.
51     cp somepackage.rpm ~/myexperiment/packages
52     raven -D ~/myexperiment publish
53
54 [MORE INFORMATION]
55 For more information, see the raven webpage at
56 http://raven.cs.arizona.edu/projects/project/wiki/RavenPage
57