sandbox/blog_vm_ndtools.rst

   1 :date: 2011-12-12 12:05:00
   2 :tags: debian, neuroscience, development, packages, virtualization
   3
   4 .. _chap_ndtools_build:
   5
   6 NeuroDebian nd* tools
   7 =====================
   8
   9 TODO
  10
  11 Procedure
  12 ---------
  13
  14 - [1-20 min] :ref:`Install NeuroDebian VM <chap_vm>`
  15
  16 - [<1 min] Install the neurodebian-dev package providing nd* tools::
  17
  18    sudo apt-get install neurodebian-dev
  19
  20 - [1-5 min] Adjust default configuration (``sudo vim
  21   /etc/neurodebian/cmdsettings.sh``) used by nd commands to
  22
  23   - point ``cowbuilderroot`` variable to some directory under
  24     ``brain`` account, e.g. ``~brain/debs`` (should be created by you)
  25
  26   - remove undesired releases (e.g. deprecated ``karmic``) from
  27     allnddist and alldist
  28
  29   - adjust ``mirror`` entries to use the `Debian mirror`_ and `Ubuntu
  30     mirror`_ of your choice or may be even point to your `approx
  31     <http://packages.debian.org/sid/approx>`_ apt-caching server
  32
  33 .. _`Debian mirror`: http://www.debian.org/mirror/list
  34 .. _`Ubuntu mirror`: https://launchpad.net/ubuntu/+archivemirrors
  35
  36 - [10-60 min] Create the COWs for all releases you left in the
  37   configuration file::
  38
  39         sudo nd_adddistall
  40
  41
  42 Building
  43 --------
  44
  45 At this point you would be all set to build packages for all
  46 distributions in a single command.  E.g.::
  47
  48    sudo nd_build4all blah_1-1.dsc
  49
  50 should take the .dsc file you provide, and build it for main Debian
  51 sid and all ND-supported releases of Debian and Ubuntu.
  52 nd_build4allnd would build only for the later omitting the vanilla
  53 Debian sid.  The highlevel summary either builds succeed or failed get
  54 reported in ``summary.log`` in the same directory, pointing to
  55 ``.build`` log files for the corresponding architecture/release.
  56
  57
  58 Troubleshooting Failing Build
  59 -----------------------------
  60
  61 Provide --hookdir cmdline pbuilder argument to point to a hook which
  62 would get kicked in by pbuilder upon failure, e.g.:
  63
  64    sudo apt-get install git
  65    git clone https://github.com/neurodebian/neurodebian
  66    sudo nd_build4debianmain *.dsc -- --hookdir $PWD/neurodebian/tools/hooks
  67
  68
  69 If you have any comments (typos, improvements, etc) -- feel welcome to
  70 leave a comment below, or just email `us@NeuroDebian`_ .
  71
  72 .. _us@NeuroDebian: http://neuro.debian.net/#contacts