import repository from arizona
[raven.git] / webpage / olddesign / lost+found.html
1   <a href="slice.html" target="main">Slice</a>
2   <a href="signup.html" target="main">Repository Signup</a>
3   <a href="rep_setup.html" target="main">Administrator Guide</a>
4   <a href="repository/index.html" target="main">Quadrus Status</a>
5   
6   <!-- REMOVE COMMENT AFTER THE PAGE HAS BEEN ADDED
7   <p>
8   If you are using Stork in an environment other than PlanetLab, please click
9   <a href="platform.html">here</a> for information.
10   </p>
11   -->
12   
13   <h3>Basic overview</h3>
14 \r
15   <p>
16   The basic function of Stork is to provide packages in a method similar to yum
17   or apt.   However, Stork saves disk space for shared packages and has security
18   features that aren't available with these other tools.
19   </p>
20   
21   \r  <h3>Creating custom packages</h3>
22 \r
23   <p>
24   You should package your custom software using
25   <a href="http://www.rpm.org/RPM-HOWTO/" target="_top">RPM to build packages</a>.
26   You should add the hash for these packages into your keyfile.   Other
27   PlanetLab users can then use your keyfile to authenticate the package without
28   having to always add the latest version/hash into their keyfile (once you
29   provide them your public key).
30   </p>
31 \r
32   <h3>Distributing your keyfile and custom packages</h3>
33 \r
34   <p>
35   The first step to distributing files is to get an account on the repository.
36   To obtain an account simply mail
37   <a href="mailto:stork-support@cs.arizona.edu">stork-support@cs.arizona.edu</a>
38   with a requested username.   You will receive a reply with a password that
39   you will be required to change on the first logon.   Then you may upload
40   keyfiles and packages.   The changes will be seen on all PlanetLab nodes in
41   a short period of time (it takes up to 10 minutes for changes to propagate in
42   some circumstances).
43   </p>
44 \r
45   <p>
46   Any files you upload will seem to disappear from your directory (this is
47   normal).   The package files are stored by hash off in the package repository
48   directory and keyfiles are assigned unique suffixes and put in a special
49   directory.   Any user may upload a keyfile or a package with any name, and your
50   publickey is used to determine which keyfile is valid (stork uses the most
51   recent keyfile with a valid signature).   Your keyfile contains hashes that
52   determine which packages are valid and references to other keyfiles (along with
53   public keys).   In this way the system is protected by two users who upload
54   keyfiles with the same username or different packages with the same name.
55   </p>
56 \r
57 \r
58 \r
59 \r
60
61