Synchronization with mirrors
To reduce bandwidth demands on your server, you can use mirrors for your
repository. Falcon only supports mirrors that allow you to puch your changes to
them over ssh or rsync. To configure a mirror, start the interactive
configuration editor (
falcon configure) and go to the mirrors
menuitem.
Creating/editing a mirror
To edit a mirror, select it from the menu. To create a new one, select the
appropriate menu item.

The mirror name should consist of only alphanumeric characters or underscores.
It is used only internally, just like the sponsor name. The mirror root should
point to an http or ftp location which is the root of your repository on that
mirror. The rsync upload path can be of the form
host:path or
user@host:path for ssh mirrors, or
rsync://host/module for
rsync mirrors. See the rsync manpage for more information.
Complete and partial mirrors
Falcon supports both complete and partial mirrors, you can specify which
components should be mirrored using the interactive configuration error.
Downside is that whenever you create a new pocket or component, you need to
edit mirror configurations. To expand the selection tree, hit the space bar
after selecting a pocket.
Synchronizing with mirrors
After configuring the mirror(s), synchronization is very easy, simply run the
command
falcon sync This will generate HTML pages for all mirrors and
perform the synchronization. To sync only with one mirror, use
falcon sync
mirror_name where mirror_name is the name you gave the mirror in the
configuration editor.
Using an ssh agent
Since falcon makes 3 connections per server each time it synchronizes, it can
be a pain in the ass to type your SSH key passphrase all the time (please don't
use password-only ssh connections, for safety's sake). Normal people would
start an SSH agent themselves or connect to their master server with
ssh -A I myself don't do that though, so falcon now has a plugin that
will start and stop an SSH agent and load your key. You can enable it in the
plugins section of the configuration editor. For more info on ssh keys and
ssh agent, please read the ssh and ssh-agent manpages.