import repository from arizona
[raven.git] / apps / ravenpublish / raven.man
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2 .TH RAVEN "8" "August 2009" "raven 1.0-RAVENVERSION" "System Administration Utilities"
3 .SH NAME
4 raven \- Raven Client Tools
5 .SH SYNOPSIS
6 .B raven
7 [\fIoptions\fR] \fIcommand \fR[\fIcommand_options\fR] [\fIcommand_args\fR]
8 .SH DESCRIPTION
9 .PP
10 Raven is a administration tool for installing packages and provisioning resources
11 on a collection of hosts.
12 .PP
13 Commands: create, config, make, publish, upload
14 .SH OPTIONS
15 .TP
16 \fB\-\-version\fR
17 show program's version number and exit
18 .TP
19 \fB\-h\fR, \fB\-\-help\fR
20 show this help message and exit
21 .TP
22 \fB\-D\fR DIR, \fB\-\-directory\fR=\fIDIR\fR
23 directory of raven experiment
24 .SH COMMANDS
25 The following commands are understood by raven:
26
27 .I Create
28     Create a new experiment container in the current directory, or the directory
29 specified by the -D option.
30
31 .I Config
32     Configure experiment-related options.
33
34 .I Make
35     Build the current experiment. The packages directory is scanned for packages
36 and the users directory is scanned for public keys. These are combined to
37 create a tpfile in the tpfiles directory, and optionally a packages.pacman file
38 in the tempest directory. Files are signed and copied to the upload directory.
39
40 .I Publish
41     Publish executes both the
42 .I make
43 and
44 .I upload
45 commands.
46
47 .I Upload
48     Uploads the files in the upload directory to the repository.
49 .SH "RAVEN CONFIGURATION FILE"
50 Each experiment container includes a configuration file. This configuration file
51 may be edited by using the command
52 .I raven config
53 .SH "EXAMPLE USAGE"
54 .PP
55 .B Creating a new experiment
56
57     # creates a new experiment in the directory ~/myexperiment
58     mkdir ~/myexperiment
59     raven -D ~/myexperiment create
60
61 .B Installing and publishing a package
62
63     # copy and RPM to the packages directory, and invoke raven to cause
64     # that package to be published.
65     cp somepackage.rpm ~/myexperiment/packages
66     raven -D ~/myexperiment publish
67 .SH "MORE INFORMATION"
68 For more information, see the raven webpage at
69 http://raven.cs.arizona.edu/projects/project/wiki/RavenPage