Building and Uploading

Building is done on (originally, then, using the builder account. Do not forward your root tickets when ssh'ing to builder@magrathea.

Package Names

The build-system uses the submodule name, not the package name. For example, the getcluster software is provided by the debathena-getcluster package, but is in the getcluster submodule.

In the instructions below, <package> refers to the submodule name.


Non-native packages: Prior to building, non-native packages must also prepare an upstream tarball:

  • athena-upstream-tarball -p <package>

Native and non-native packages:

  • dasource -u <package>
    • builds source package
  • dapublish <package>
    • publish source package to repo, sign and tag
    • You may also pass all in place of the package name, but that might break.
  • dabuild all
    • builds any package for which there are source but no binary
      • You may also pass a package name in place of all, but it's good practice to ensure there's nothing unbuilt
    • _also_ uploads the package to codename-development for all releases we support.

At the end of this process, the packages will be in the -development APT repository. They can (and should) then be moved, as described below. Typically, packages sit in -development until they're tested at least once, then go to -proposed for 3 business days, and then production.

Moving between repositories

NOTE: Unlike the build process, moving packages does use the package's full name (e.g. debathena-getcluster instead of just getcluster). Yes, this is confusing.

Packages can be moved between repositories with damove. This is the normal way in which packages should migrate from -proposed to the production repository.

  • damove <destination> <source> <packagename>
    • <destination> is the repository you are moving the package to. (one of production, or proposed)
    • <source> is the repository you are moving the package from. (one of proposed or development)
    • <packagename> is the name of the package
    • damove will warn you if you accidentally swap arguments