Falcon Repository Manager

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.

Mirror configuration

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.
Generated by Falcon 2.0.5 ©2005-2008 Dennis Kaarsemaker