You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@couchdb.apache.org by Noah Slater <ns...@apache.org> on 2009/08/05 23:38:12 UTC

Help required with Debian CouchDB package

Hey,

I've been maintaining the Debian package of CouchDB for a while now:

  http://packages.debian.org/sid/couchdb

I don't have the free time to devote to my work with Debian at the moment, and
I'm looking to hand my packages over for team maintenance in the interim. For
CouchDB, that means giving it to the Erlang team. I was wondering if there were
any folk on our lists who would be interested in helping out?

CouchDB 0.9.1 has not been package yet, so that would be the first task.

Thanks,

-- 
Noah Slater, http://tumbolia.org/nslater

Re: Help required with Debian CouchDB package

Posted by Sam Bisbee <sb...@computervip.com>.
Hey Noah - Feel free to count me in. My erlang has no fu, but I've packaged
before and know plenty of other relevant languages. I also run CouchDB on
several Debian and Ubuntu boxen (different archs), so testing shouldn't be a
problem.

Just let me know.

p.s. ravidgemole on IRC (freenode & oftc)

-- 
Sam Bisbee

Re: Help required with Debian CouchDB package

Posted by Noah Slater <ns...@apache.org>.
Hey,

I hadn't realised that the Debian Erlang team was just me and Sergei! I was
under the impression that there were at least a handful of other people. Oh
well, I guess it's about to grow in size a little.

Three of you have offered to help maintain the package:

  Jim Tarvid <ta...@ls.net>

  Sam Bisbee <sb...@computervip.com>

  Elliot Murphy <el...@canonical.com>

Thanks guys! I am overwhelmed by your response.

I think that Sam and Elliot both have packaging experience, which is great.

The other existing member of the Debian Erlang packaging team is:

  Sergei Golovan <sg...@debian.org>

Sergei is a Debian developer, and maintains the core Erlang packages. While he
is unable to help maintain the CouchDB package directly, he is happy to continue
checking and uploading new versions of it for you. This means that Sergei will
be your package sponsor. For this to work, you will need to prepare your changes
in the existing Subversion repository, and then ask Sergei to review them and
upload the new package version to Debian.

You will need to request membership for the project:

  http://developer.berlios.de/projects/erlang-pkg/

I think Sergei will have to confirm that you're allowed to join the project.

You can then check out the source via:

  http://developer.berlios.de/svn/?group_id=6649

The CouchDB package is under the couchdb directory:

  http://svn.berlios.de/svnroot/repos/erlang-pkg/couchdb/

Please also sign up to the Erlang team mailing list:

  https://lists.berlios.de/mailman/listinfo/erlang-pkg-devel

I will remain on this list for a while, and monitor for any problems you have.

Any more discussion should probably move to the Erlang list.

For those totally new to Debian packaging, you should read through:

  http://www.debian.org/doc/maint-guide/

  http://www.debian.org/doc/developers-reference/

  http://www.debian.org/doc/debian-policy/

Some of the Debian mentor documentation might also be enlightening:

  http://people.debian.org/~mpalmer/debian-mentors_FAQ.html

However, you're not going to be using the Debian mentors system.

This Debian mentors system traditionally provides a way for volunteers to
maintain packages with a group of experienced Debian developers available to
upload your changes after some peer-review. As Sergei has offered to do this for
you, you get to short-circuit the whole procedure. Thanks Sergei!

Sam Bisbee wrote:

> Do we have a task list, or are we focusing on getting 0.9.0 and then 0.9.1
> through the gauntlet and obeying the latest Debian Policy?

Elliot wrote:

> Does preparing the 0.9.1 release involve anything else other than the normal
> process for generating a source package for a new upstream release?

0.9.0-2 (any version with "-" in it is the Debian package version, in this case,
it is the second Debian version of CouchDB 0.9.0) contains a patch that was
merged into CouchDB 0.9.1 proper:

  http://svn.berlios.de/svnroot/repos/erlang-pkg/couchdb/trunk/debian/patches/pid.patch

You should remove this patch for the next upload.

Aside from updating the debian/changelog to 0.9.1-1 and checking that the
debian/copyright file is still valid, I don't think there's much else to do. You
should always build your package with pdebuild, because this builds and installs
the CouchDB package in a chroot, and allows you to test properly.

The Ubuntu instructions for pbuilder are more comprehensive than the Debian ones:

  https://wiki.ubuntu.com/PackagingGuide/Intro/Pbuilder

My local customisation is:

  nslater@tumbolia: ~ $ cat .pbuilderrc
  HOOKDIR=/home/nslater/.pbuilder-hooks
  nslater@tumbolia: ~ $ ls -l ~/.pbuilder-hooks
  total 4.0K
  lrwxrwxrwx 1 nslater nslater   8 2008-11-04 16:45 B10shell -> C10shell
  -rwxr-x--x 1 nslater nslater 135 2009-08-06 23:42 C10shell
  nslater@tumbolia: ~ $ cat .pbuilder-hooks/C10shell
  #!/bin/sh

  apt-get install -y --force-yes emacs22-nox less bash
  cd /tmp/buildd/*/debian/..
  /bin/bash < /dev/tty > /dev/tty 2> /dev/tty

I recommend you do the same. What this does is:

  * If the build fails, it gives you a shell in the chroot.

  * Once the package is installed, it gives you a shell in the chroot.

You should use the first to debug. You should use the second to start CouchDB
inside the chroot and run the unit tests via your browser. Doing this properly
will save Sergei a lot of time having to send emails about how the package is
broken for such and such a case.

Elliot wrote:

> Noah, I know that in Ubuntu we had made some permissions changes in the
> packaging for couchdb to enable per-user couchdb instances to be started in
> Ubuntu. Are there other changes that you know are pending for the package?

Nope.

For reference, the patch is:

  http://launchpadlibrarian.net/29425557/403575.debdiff

I think you should apply the changes to the debian/postinst file.

Elliot wrote:

> Once I have a source package that I have been able to build in a pbuilder and
> test, what is the process for getting a sponsor to upload to debian?

Ah, another pbuilder user! Great!

Sergei has offered to be the package sponsor, as explained above. You should
make sure it builds fine under pbuilder and then ask Sergei to take a look at
it. If he is happy with your changes, he'll do the upload for you.

Elliot wrote:

> I really really appreciate you handing over package maintenance in such an
> organized way, and I hope that this allows you more time to focus on your
> other valuable work.

You're more than welcome.

I'm still going to be around if you have questions about the packaging, and may
resume a more active role within the Erlang team at some point. For now though,
I need to refocus my work in other places.

Thanks to everyone who's offered to help.

Best,

-- 
Noah Slater, http://tumbolia.org/nslater

Re: Help required with Debian CouchDB package

Posted by Noah Slater <ns...@apache.org>.
Hey,

I hadn't realised that the Debian Erlang team was just me and Sergei! I was
under the impression that there were at least a handful of other people. Oh
well, I guess it's about to grow in size a little.

Three of you have offered to help maintain the package:

  Jim Tarvid <ta...@ls.net>

  Sam Bisbee <sb...@computervip.com>

  Elliot Murphy <el...@canonical.com>

Thanks guys! I am overwhelmed by your response.

I think that Sam and Elliot both have packaging experience, which is great.

The other existing member of the Debian Erlang packaging team is:

  Sergei Golovan <sg...@debian.org>

Sergei is a Debian developer, and maintains the core Erlang packages. While he
is unable to help maintain the CouchDB package directly, he is happy to continue
checking and uploading new versions of it for you. This means that Sergei will
be your package sponsor. For this to work, you will need to prepare your changes
in the existing Subversion repository, and then ask Sergei to review them and
upload the new package version to Debian.

You will need to request membership for the project:

  http://developer.berlios.de/projects/erlang-pkg/

I think Sergei will have to confirm that you're allowed to join the project.

You can then check out the source via:

  http://developer.berlios.de/svn/?group_id=6649

The CouchDB package is under the couchdb directory:

  http://svn.berlios.de/svnroot/repos/erlang-pkg/couchdb/

Please also sign up to the Erlang team mailing list:

  https://lists.berlios.de/mailman/listinfo/erlang-pkg-devel

I will remain on this list for a while, and monitor for any problems you have.

Any more discussion should probably move to the Erlang list.

For those totally new to Debian packaging, you should read through:

  http://www.debian.org/doc/maint-guide/

  http://www.debian.org/doc/developers-reference/

  http://www.debian.org/doc/debian-policy/

Some of the Debian mentor documentation might also be enlightening:

  http://people.debian.org/~mpalmer/debian-mentors_FAQ.html

However, you're not going to be using the Debian mentors system.

This Debian mentors system traditionally provides a way for volunteers to
maintain packages with a group of experienced Debian developers available to
upload your changes after some peer-review. As Sergei has offered to do this for
you, you get to short-circuit the whole procedure. Thanks Sergei!

Sam Bisbee wrote:

> Do we have a task list, or are we focusing on getting 0.9.0 and then 0.9.1
> through the gauntlet and obeying the latest Debian Policy?

Elliot wrote:

> Does preparing the 0.9.1 release involve anything else other than the normal
> process for generating a source package for a new upstream release?

0.9.0-2 (any version with "-" in it is the Debian package version, in this case,
it is the second Debian version of CouchDB 0.9.0) contains a patch that was
merged into CouchDB 0.9.1 proper:

  http://svn.berlios.de/svnroot/repos/erlang-pkg/couchdb/trunk/debian/patches/pid.patch

You should remove this patch for the next upload.

Aside from updating the debian/changelog to 0.9.1-1 and checking that the
debian/copyright file is still valid, I don't think there's much else to do. You
should always build your package with pdebuild, because this builds and installs
the CouchDB package in a chroot, and allows you to test properly.

The Ubuntu instructions for pbuilder are more comprehensive than the Debian ones:

  https://wiki.ubuntu.com/PackagingGuide/Intro/Pbuilder

My local customisation is:

  nslater@tumbolia: ~ $ cat .pbuilderrc
  HOOKDIR=/home/nslater/.pbuilder-hooks
  nslater@tumbolia: ~ $ ls -l ~/.pbuilder-hooks
  total 4.0K
  lrwxrwxrwx 1 nslater nslater   8 2008-11-04 16:45 B10shell -> C10shell
  -rwxr-x--x 1 nslater nslater 135 2009-08-06 23:42 C10shell
  nslater@tumbolia: ~ $ cat .pbuilder-hooks/C10shell
  #!/bin/sh

  apt-get install -y --force-yes emacs22-nox less bash
  cd /tmp/buildd/*/debian/..
  /bin/bash < /dev/tty > /dev/tty 2> /dev/tty

I recommend you do the same. What this does is:

  * If the build fails, it gives you a shell in the chroot.

  * Once the package is installed, it gives you a shell in the chroot.

You should use the first to debug. You should use the second to start CouchDB
inside the chroot and run the unit tests via your browser. Doing this properly
will save Sergei a lot of time having to send emails about how the package is
broken for such and such a case.

Elliot wrote:

> Noah, I know that in Ubuntu we had made some permissions changes in the
> packaging for couchdb to enable per-user couchdb instances to be started in
> Ubuntu. Are there other changes that you know are pending for the package?

Nope.

For reference, the patch is:

  http://launchpadlibrarian.net/29425557/403575.debdiff

I think you should apply the changes to the debian/postinst file.

Elliot wrote:

> Once I have a source package that I have been able to build in a pbuilder and
> test, what is the process for getting a sponsor to upload to debian?

Ah, another pbuilder user! Great!

Sergei has offered to be the package sponsor, as explained above. You should
make sure it builds fine under pbuilder and then ask Sergei to take a look at
it. If he is happy with your changes, he'll do the upload for you.

Elliot wrote:

> I really really appreciate you handing over package maintenance in such an
> organized way, and I hope that this allows you more time to focus on your
> other valuable work.

You're more than welcome.

I'm still going to be around if you have questions about the packaging, and may
resume a more active role within the Erlang team at some point. For now though,
I need to refocus my work in other places.

Thanks to everyone who's offered to help.

Best,

-- 
Noah Slater, http://tumbolia.org/nslater

Re: Help required with Debian CouchDB package

Posted by Elliot Murphy <el...@canonical.com>.
Hi Noah,

On 08/05/2009 10:38 PM, Noah Slater wrote:
> I've been maintaining the Debian package of CouchDB for a while now:
>
>    http://packages.debian.org/sid/couchdb

Many thanks for your work on Debian and CouchDB so far, it's been  a 
huge help in allowing me and others  (including the communities of all 
Debian derivatives) to make use of CouchDB easily.

> I don't have the free time to devote to my work with Debian at the moment, and
> I'm looking to hand my packages over for team maintenance in the interim. For
> CouchDB, that means giving it to the Erlang team. I was wondering if there were
> any folk on our lists who would be interested in helping out?

I see Jim and Sam have responded also, wonderful! I saw that the Debian 
Erlang packagers team was just you and one other persion, so I have just 
joined the Erlang team mailing list and volunteered to help with Erlang 
packages generally. I'm not yet a Debian Developer, but would like to 
earn that role.

> CouchDB 0.9.1 has not been package yet, so that would be the first task.
>

I will have time to work on this specific task tomorrow while I am in 
the airport. Sam, Jim, have you already started on this? If so I would 
be happy to review any work you have done. If not, I'm happy to prepare 
the package or to help test the package if you prefer to create it.

Noah, I know that in Ubuntu we had made some permissions changes in the 
packaging for couchdb to enable per-user couchdb instances to be started 
in Ubuntu. Are there other changes that you know are pending for the 
package? Does preparing the 0.9.1 release involve anything else other 
than the normal process for generating a source package for a new 
upstream release? Once I have a source package that I have been able to 
build in a pbuilder and test, what is the process for getting a sponsor 
to upload to debian?

I really really appreciate you handing over package maintenance in such 
an organized way, and I hope that this allows you more time to focus on 
your other valuable work.

cheers,
-elliot

Re: Help required with Debian CouchDB package

Posted by Sam Bisbee <sb...@computervip.com>.
Hey Noah - Feel free to count me in. My erlang has no fu, but I've packaged
before and know plenty of other relevant languages. I also run CouchDB on
several Debian and Ubuntu boxen (different archs), so testing shouldn't be a
problem.

Just let me know.

p.s. ravidgemole on IRC (freenode & oftc)

-- 
Sam Bisbee

Re: Help required with Debian CouchDB package

Posted by Jim Tarvid <ta...@ls.net>.
It would take me awhile to be userful (few days, weeks) but count me in.

On Wed, Aug 5, 2009 at 5:38 PM, Noah Slater <ns...@apache.org> wrote:

> Hey,
>
> I've been maintaining the Debian package of CouchDB for a while now:
>
>  http://packages.debian.org/sid/couchdb
>
> I don't have the free time to devote to my work with Debian at the moment,
> and
> I'm looking to hand my packages over for team maintenance in the interim.
> For
> CouchDB, that means giving it to the Erlang team. I was wondering if there
> were
> any folk on our lists who would be interested in helping out?
>
> CouchDB 0.9.1 has not been package yet, so that would be the first task.
>
> Thanks,
>
> --
> Noah Slater, http://tumbolia.org/nslater
>



-- 
http://ls.net
http://drupal.ls.net

The path to God starts with a simple act of kindness.

Re: Help required with Debian CouchDB package

Posted by Elliot Murphy <el...@canonical.com>.
Hi Noah,

On 08/05/2009 10:38 PM, Noah Slater wrote:
> I've been maintaining the Debian package of CouchDB for a while now:
>
>    http://packages.debian.org/sid/couchdb

Many thanks for your work on Debian and CouchDB so far, it's been  a 
huge help in allowing me and others  (including the communities of all 
Debian derivatives) to make use of CouchDB easily.

> I don't have the free time to devote to my work with Debian at the moment, and
> I'm looking to hand my packages over for team maintenance in the interim. For
> CouchDB, that means giving it to the Erlang team. I was wondering if there were
> any folk on our lists who would be interested in helping out?

I see Jim and Sam have responded also, wonderful! I saw that the Debian 
Erlang packagers team was just you and one other persion, so I have just 
joined the Erlang team mailing list and volunteered to help with Erlang 
packages generally. I'm not yet a Debian Developer, but would like to 
earn that role.

> CouchDB 0.9.1 has not been package yet, so that would be the first task.
>

I will have time to work on this specific task tomorrow while I am in 
the airport. Sam, Jim, have you already started on this? If so I would 
be happy to review any work you have done. If not, I'm happy to prepare 
the package or to help test the package if you prefer to create it.

Noah, I know that in Ubuntu we had made some permissions changes in the 
packaging for couchdb to enable per-user couchdb instances to be started 
in Ubuntu. Are there other changes that you know are pending for the 
package? Does preparing the 0.9.1 release involve anything else other 
than the normal process for generating a source package for a new 
upstream release? Once I have a source package that I have been able to 
build in a pbuilder and test, what is the process for getting a sponsor 
to upload to debian?

I really really appreciate you handing over package maintenance in such 
an organized way, and I hope that this allows you more time to focus on 
your other valuable work.

cheers,
-elliot

Re: Help required with Debian CouchDB package

Posted by Jim Tarvid <ta...@ls.net>.
It would take me awhile to be userful (few days, weeks) but count me in.

On Wed, Aug 5, 2009 at 5:38 PM, Noah Slater <ns...@apache.org> wrote:

> Hey,
>
> I've been maintaining the Debian package of CouchDB for a while now:
>
>  http://packages.debian.org/sid/couchdb
>
> I don't have the free time to devote to my work with Debian at the moment,
> and
> I'm looking to hand my packages over for team maintenance in the interim.
> For
> CouchDB, that means giving it to the Erlang team. I was wondering if there
> were
> any folk on our lists who would be interested in helping out?
>
> CouchDB 0.9.1 has not been package yet, so that would be the first task.
>
> Thanks,
>
> --
> Noah Slater, http://tumbolia.org/nslater
>



-- 
http://ls.net
http://drupal.ls.net

The path to God starts with a simple act of kindness.