-
Notifications
You must be signed in to change notification settings - Fork 3
Releasing updates to Quirm
sburnett edited this page Apr 15, 2012
·
2 revisions
This page explains how to build and distribute package updates to routers running Quirm. These are packages that will be updated via bismark-updater
or installed via bismark-experiments-manager
.
We released Quirm on April 9, 2012. To enable reproducible builds, we tagged or branched many of the bismark repositories:
-
bismark-openwrt-overlay
andbismark-packages
have new branches2012-04-09-quirm
. -
bismark-data-transmit
,bmlua
,luci-bismark
,openflow-ucap
have tags2012-04-04-quirm
. (These tags were unchanged from a prior release candidate.)
These branches and tags must not change. Instead, if you need to create changes we suggest you do the following:
- Update your package on the
master
branch of all relevant repositories. For example, if you needed to apply a security fix tobismark-data-transmit
, apply your fix to themaster
branch ofbismark-data-transmit
and increment the package revision number in the package Makefile forbismark-data-transmit
inbismark-packages
. - Merge any changes to
bismark-packages
orbismark-openwrt-overlay
into the2012-04-09-quirm-updates
branch. Keep in mind that many of the package Makefiles inbismark-packages
are hard coded to check out sources from the2012-04-09
release tag; you may need to change these tags toHEAD
to force a checkout from master. For example, if you're updatingbismark-data-transmit
, you'll need to changePKG_VERSION
toHEAD
in the Makefile. - Find an openwrt build tree and make sure
bismark-openwrt-overlay
is on the latest version of the2012-04-09-quirm-updates
branch. The build atdp4:/data2/users/bismark/openwrt/src/quirm-2012-04-09
should work. - Build your updated package. For example, run
make package/bismark-data-transmit/compile
. - Add your package name to
scripts/special-packages.conf
. For example, add the linebismark-data-transmit updates
. Consider testing the release on a single router first (e.g.,bismark-data-transmit device-updates/OW0123456789AB
). - Run
scripts/experiments-to-www.sh /data/users/bismark/builds/quirm
. DO NOT runscripts/release-to-www.sh
! - Verify that your updated package appears in https://downloads.projectbismark.net/quirm/ar71xx. For example, an update to
bismark-data-transmit
will be in https://downloads.projectbismark.net/quirm/ar71xx/updates/. - Test the update by running
bismark-updater
on a router.