[sr-dev] git:master: pkg/kamailio/(centos|fedora): Added instructions on using BoxGrinder appliances to build Kamailio RPMs

[Peter Dunkley]

Module: sip-router
Branch: master
Commit: 840d829149961d79fe9c84e59c14b8f72de4c44d
URL:    http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=840d829149961d79fe9c84e59c14b8f72de4c44d

Author: Peter Dunkley <peter.dunkley at crocodile-rcs.com>
Committer: Peter Dunkley <peter.dunkley at crocodile-rcs.com>
Date:   Wed Jul  4 23:46:46 2012 +0100

pkg/kamailio/(centos|fedora): Added instructions on using BoxGrinder appliances to build Kamailio RPMs

---

 pkg/kamailio/centos/6/README  |    1 +
 pkg/kamailio/fedora/16/README |   67 +++++++++++++++++++++++++++++++++++++++++
 pkg/kamailio/fedora/17/README |    1 +
 3 files changed, 69 insertions(+), 0 deletions(-)

diff --git a/pkg/kamailio/centos/6/README b/pkg/kamailio/centos/6/README
new file mode 120000
index 0000000..441b483
--- /dev/null
+++ b/pkg/kamailio/centos/6/README
@@ -0,0 +1 @@
+../../fedora/16/README
\ No newline at end of file
diff --git a/pkg/kamailio/fedora/16/README b/pkg/kamailio/fedora/16/README
new file mode 100644
index 0000000..95fed77
--- /dev/null
+++ b/pkg/kamailio/fedora/16/README
@@ -0,0 +1,67 @@
+Building Kamailio RPMs for Enterprise Linux and Fedora
+------------------------------------------------------
+
+This is a simple process:
+1) Create a clean appliance using BoxGrinder (always worth doing as it makes
+   sure your build appliance contains only standard versions of packages and
+   has all updates applied).
+2) Start the appliance and log in.
+3) Prepare the appliance for RPM builds
+4) Either:
+   a) Checkout the version of Kamailio you want to build from GIT (instructions
+      available on the Kamailio wiki at http://www.kamailio.org/wiki) and
+      create a release tar file, or
+   b) Download a release tar file from http://www.kamailio.org/pub/kamailio and
+      extract the correct kamailio.spec file from it
+5) Run "rpmbuild" to create the RPMs
+
+If you don't have BoxGrinder installed (http://boxgrinder.org/) you can do so in
+Fedora using the command:
+
+   # [sudo] yum install rubygem-boxgrinder-build
+
+Note: The host operating system you install BoxGrinder on does not have to be
+      same operating system flavour, architecture, or version as the appliance
+      you are creating.  It is entirely sensible to use an x86_64 Fedora host to
+      build an i386 CentOS appliance and i386 CentOS Kamailio RPMs.
+
+Example: Building Kamailio 3.4.x (master) x86_64 binary RPMs from GIT for
+         Fedora 17.
+
+This example assumes:
+- You have Internet connectivity
+- You have BoxGrinder, and libvirtd (and any management software required for
+  it) installed locally.
+- You have obtained the kamailio-build.appl file from pkg/kamailio/fedora/17
+  (either by download from http://git.sip-router.org/ or from a local
+  checkout of the code)
+- Your host operating system is x86_64.
+
+If you want to build a different version of Kamailio, a different set of RPMs
+(different rpmbuild options), or install and run the appliance on a remote
+(or different type of virtual) machine you should only need to make small
+changes to the commands in this example.
+
+1) Create a clean Fedora 17 x86_64 appliance using BoxGrinder:
+   # mkdir appliance
+   # cd appliance
+   # [sudo] boxgrinder-build \
+       [path to]/pkg/kamailio/fedora/17/kamailio-build.appl -d libvirt \
+       --delivery_config connection_uri:qemu:///system,\
+       image_delivery_uri:/var/lib/libvirt/images,overwrite:true,\
+       domain_type:kvm
+2) Start the appliance and log in:
+   - I prefer to use virt-manager for this.  The default username and password
+     for the appliance is "root" and "kamailio" respectively.
+3) Prepare the appliance for RPM builds:
+   # mkdir -p rpmbuild/SOURCES
+4) Checkout Kamailio 3.4.x (master) and create a release tar file:
+   # git clone --depth 1 git://git.sip-router.org/sip-router kamailio
+   # cd kamailio
+    Note: if not building master you want to do a "git checkout" after this
+   # git archive --output ../rpmbuild/SOURCES/kamailio-3.4.0_src.tar.gz \
+       --prefix=kamailio-3.4.0/ master
+5) Run "rpmbuild" to create the binary RPMs:
+   # rpmbuild -bb pkg/kamailio/fedora/17/kamailio.spec
+
+Once the build is complete the RPMs will be in ~/rpmbuild/RPMS/x86_64.
diff --git a/pkg/kamailio/fedora/17/README b/pkg/kamailio/fedora/17/README
new file mode 120000
index 0000000..950d35d
--- /dev/null
+++ b/pkg/kamailio/fedora/17/README
@@ -0,0 +1 @@
+../16/README
\ No newline at end of file