Difference between revisions of "Ubuntu Packaging"

From GRASS-Wiki
Jump to: navigation, search
(in progress)
 
m
 
(38 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Organisation =
+
== News / Announcements ==
  
GRASS packages are provided by different repositories:
+
'''We need voluteers and support. Please see: [[Ubuntu_Packaging#Actions_where_help_is_needed | Actions needing helping hands]]!'''
  
== Offical Ubuntu Repors
+
== Organisation ==
 +
* GRASS packages are provided by different repositories.
 +
*  They are mostly distinguished by their level of up-to-dateness in respect to the GRASS source code.
  
=
+
== Overview and Sources ==
 +
 
 +
An overview is given in the following table:
 +
 
 +
{| class="wikitable"
 +
! Repository
 +
! Type
 +
! Update Frequency
 +
! Status
 +
! Current version
 +
! Source
 +
! Details
 +
! Link
 +
|-
 +
| Official Ubuntu Repositories
 +
| universe
 +
| Only updated before each Ubuntu release
 +
| Stable at time of import
 +
| 6.4.2-2
 +
| Imported from Debian repositories
 +
 +
| [http://packages.ubuntu.com/grass Overview]
 +
 
 +
|-
 +
| UbuntuGIS
 +
| stable
 +
| Upon request
 +
| Stable at time of packaging
 +
| 6.4.2
 +
| <ubuntu at lists.osgeo.org>
 +
|
 +
| [https://launchpad.net/~ubuntugis/+archive/ppa ubuntugis-stable]
 +
 
 +
|-
 +
| UbuntuGIS
 +
| unstable
 +
| Upon request
 +
| Unstable at time of packaging
 +
| 6.4.2~x
 +
| <ubuntu at lists.osgeo.org>
 +
|
 +
| [https://launchpad.net/~ubuntugis/+archive/ubuntugis-unstable ubuntugis-unstable]
 +
 
 +
|-
 +
| UbuntuGIS
 +
| testing
 +
| Upon request
 +
| Very unstable at time of packaging
 +
| 6.4.3-1~x<br>7.0-1~x
 +
| <ubuntu at lists.osgeo.org>
 +
|
 +
| [https://launchpad.net/~ubuntugis/+archive/ubuntugis-testing ubuntugis-testing]
 +
 
 +
|-
 +
| GRASS PPA
 +
| stable
 +
| Daily upon change of GRASS source code
 +
| Most recent fixes and backports to stable  series
 +
| 6.4.2+2
 +
| Imported from [http://svn.osgeo.org/grass/grass/branches/releasebranch_6_4 GRASS SVN of releasebranch_6_4]
 +
|
 +
| [https://code.launchpad.net/~grass/+archive/grass-stable GRASS Packages: Stable Series]
 +
 
 +
|-
 +
| GRASS PPA
 +
| unstable
 +
| Daily upon change of GRASS source code
 +
| Very unstable but latest development code
 +
| 7.0.x
 +
| Imported from [https://svn.osgeo.org/grass/grass/branches/releasebranch_7_0 GRASS SVN of releasebranch_7_0]
 +
|
 +
| [https://launchpad.net/~grass/+archive/grass-devel GRASS Packages: Development Series]
 +
 
 +
|-
 +
| Official Debian Repositories
 +
| stable/testing/unstable
 +
| Follows official GRASS releases
 +
| Upstream source of Ubuntu (and derivatives) packages
 +
| 6.4.2-2
 +
| The DebianGIS Team (mainly Frankie and Hamish)
 +
| http://packages.debian.org/grass
 +
| [http://wiki.debian.org/DebianGis DebianGIS]
 +
 
 +
|}
 +
 
 +
= GRASS on Launchpad (LP) =
 +
== Organisation ==
 +
*  [https://launchpad.net/~grass GRASS team]
 +
**  Individuals which are dedicated to work on GRASS packaging for Ubuntu
 +
**  Any user and developer is free and welcome to join!
 +
**  New active members are needed!
 +
**  Umbrella ''organisation'' for activities around GRASS on Launchpad
 +
**  Administers the [https://launchpad.net/grass GRASS GIS Project]
 +
*  [https://launchpad.net/grass GRASS GIS Project]
 +
**  The GRASS [https://help.launchpad.net/Projects LP project]
 +
**  Umbrella project for all activities related to the GRASS core such as
 +
***  code: [https://code.launchpad.net/grass Bazaar branches of GRASS GIS Project]
 +
***  the respecitive debian files for the build packages
 +
*  other future projects could be
 +
**  Automatic packaging of [http://grasswiki.osgeo.org/wiki/AddOns AddOns]
 +
**  Further integration of GRASS in Ubuntu
 +
**  Link to Live-CD projects such as [http://live.osgeo.org/ OSGeo-Live]
 +
 
 +
=== Others (UbuntuGIS) ===
 +
* [https://wiki.ubuntu.com/UbuntuGIS https://wiki.ubuntu.com/UbuntuGIS]
 +
* [http://trac.osgeo.org/ubuntugis/ http://trac.osgeo.org/ubuntugis/]
 +
* [https://launchpad.net/~ubuntugis https://launchpad.net/~ubuntugis]
 +
 
 +
== Source Code ==
 +
The source code is managed in a structure corresponding to the above organisation
 +
 
 +
*  Latest SVN imports
 +
**  [https://code.launchpad.net/~grass/grass/releasebranch_6_4 stable] from [http://svn.osgeo.org/grass/grass/branches/releasebranch_6_4 SVN releasebranch_6_4]
 +
**  [https://code.launchpad.net/~grass/grass/releasebranch_7_0 upcoming stable] from [http://svn.osgeo.org/grass/grass/branches/releasebranch_7_0 SVN releasebranch_7_0]
 +
**  [https://code.launchpad.net/~grass/grass/grass_trunk development] from [https://svn.osgeo.org/grass/grass/trunk SVN trunk]
 +
*  [https://code.launchpad.net/ubuntu/+source/grass Bazaar branches for “grass” package in Ubuntu]
 +
**  Used by Ubuntu packages for the official packages
 +
 
 +
= GRASS Packaging =
 +
== Offical Ubuntu Packages ==
 +
 
 +
These are based on the DebianGIS packages by Frankie and Hamish, packaging rules stored in DebianGIS's git repo -- see the [http://svn.osgeo.org/grass/grass/trunk/debian/README.debian debian/README.debian] file in the GRASS source code for details. The official Ubuntu packages are automatically rebuilt from the current Debian packages every six months. If a newer version shows up in the Debian archives before the upcoming Ubuntu release is frozen, it is possible to file a request for the Ubuntu maintainers to re-pull the newer version from Debian (if you can get their attention).
 +
 
 +
''Please base all downstream builds on these packaging rules'', with appropriate version number changes to the top entry of the debian/changelog file to add "ubuntu", +svn rev, and whatever else special identifier is needed to show the package's heritage and difference from the official ones.
 +
 
 +
Please pass up and bug fixes and wish to bugs.debian.org against the grass source package. Thanks.
 +
 
 +
== UbuntuGIS Packages ==
 +
To be added.
 +
 
 +
== GRASS PPA Packages ==
 +
* [https://help.launchpad.net/Packaging/SourceBuilds/Recipes Built by Launchpad] using [https://code.launchpad.net/~grass/+recipes GRASS build recipes]
 +
* Either built daily (stable code) or upon request (development code)
 +
* Browse the debian/ packaging files
 +
** [http://bazaar.launchpad.net/~grass/grass/grass64_release_debian/files grass64] (stable)
 +
** [http://bazaar.launchpad.net/~grass/grass/grass70_release_debian/files grass70] (upcoming stable)
 +
** [http://bazaar.launchpad.net/~grass/grass/grass_trunk_debian/files grass] (development)
 +
 
 +
=== Process ===
 +
#  GRASS source code is regularly imported upon change by LP (destination: see above)
 +
#  If source has changed, the package is build by
 +
##  nesting the debian package files (e.g. from [https://code.launchpad.net/~grass/grass/grass64_release_debian lp:~grass/grass/grass64_release_debian] for the 6.4.x stable series) in the original source (e.g. [https://code.launchpad.net/~grass/grass/releasebranch_6_4 lp:~grass/grass/releasebranch_6_4]  for the 6.4.x stable series)
 +
##  run the build process on LP for the chosen Ubuntu releases according to the instructions in the debian files (e.g. [http://bazaar.launchpad.net/~grass/grass/grass64_release_debian/files ~grass/grass/grass64_release_debian])
 +
##  Upload the package to the respective archive / PPA (e.g. [https://code.launchpad.net/~grass/+archive/grass-stable GRASS Packages: Stable Series] for  6.4.x stable series)
 +
 
 +
=== What do to on errors in the packaging process ===
 +
* If a package build fails, its most likely that there were changes in the upstream GRASS SVN
 +
* Then the debian files outlined above must be adapted:
 +
** branch the code of the debian files Bazaar (bzr) repository from launchpad
 +
** make the necessary changes locally
 +
** prepare the source running the recipe locally using
 +
*** bzr dailydeb
 +
*** bzr build
 +
** tests the build process on your machine using
 +
*** pbuilder (recommended), or
 +
*** dpkg-buildpackage (etc.)
 +
 
 +
=== Actions where help is needed ===
 +
Outstanding tasks are:
 +
 
 +
* Sync to the latest [http://wiki.debian.org/DebianGis DebianGIS] build rules
 +
* Check the correct update & daily builds for GRASS 6.4.x
 +
* Check if the upgrade to the next Ubuntu release (14.10) does not affect the packages
 +
* make the GRASS 7.0.x package failsave so that it can be activated for daily builds
 +
 
 +
=== Report bugs and issues ===
 +
 
 +
* Report bugs only related to packages installed from the GRASS PPA on he [https://bugs.launchpad.net/grass/+filebug Launchpad bug tracker].
 +
* Bugs related to GRASS functionality shall be reported directly to [http://trac.osgeo.org/grass/newticket GRASS trac]
 +
 
 +
'''Interested contributors, please come in here and give something back to the GRASS community!'''
 +
 
 +
== See also ==
 +
 
 +
 
 +
* [[GRASS in Debian]]
 +
* [[Compile and Install Ubuntu]]
 +
 
 +
 
 +
[[Category: Installation]]
 +
[[Category: Ubuntu]]
 +
[[Category: Debian]]
 +
[[Category: Voluteers]]

Latest revision as of 01:47, 26 December 2014

News / Announcements

We need voluteers and support. Please see: Actions needing helping hands!

Organisation

  • GRASS packages are provided by different repositories.
  • They are mostly distinguished by their level of up-to-dateness in respect to the GRASS source code.

Overview and Sources

An overview is given in the following table:

Repository Type Update Frequency Status Current version Source Details Link
Official Ubuntu Repositories universe Only updated before each Ubuntu release Stable at time of import 6.4.2-2 Imported from Debian repositories Overview
UbuntuGIS stable Upon request Stable at time of packaging 6.4.2 <ubuntu at lists.osgeo.org> ubuntugis-stable
UbuntuGIS unstable Upon request Unstable at time of packaging 6.4.2~x <ubuntu at lists.osgeo.org> ubuntugis-unstable
UbuntuGIS testing Upon request Very unstable at time of packaging 6.4.3-1~x
7.0-1~x
<ubuntu at lists.osgeo.org> ubuntugis-testing
GRASS PPA stable Daily upon change of GRASS source code Most recent fixes and backports to stable series 6.4.2+2 Imported from GRASS SVN of releasebranch_6_4 GRASS Packages: Stable Series
GRASS PPA unstable Daily upon change of GRASS source code Very unstable but latest development code 7.0.x Imported from GRASS SVN of releasebranch_7_0 GRASS Packages: Development Series
Official Debian Repositories stable/testing/unstable Follows official GRASS releases Upstream source of Ubuntu (and derivatives) packages 6.4.2-2 The DebianGIS Team (mainly Frankie and Hamish) http://packages.debian.org/grass DebianGIS

GRASS on Launchpad (LP)

Organisation

  • GRASS team
    • Individuals which are dedicated to work on GRASS packaging for Ubuntu
    • Any user and developer is free and welcome to join!
    • New active members are needed!
    • Umbrella organisation for activities around GRASS on Launchpad
    • Administers the GRASS GIS Project
  • GRASS GIS Project
  • other future projects could be
    • Automatic packaging of AddOns
    • Further integration of GRASS in Ubuntu
    • Link to Live-CD projects such as OSGeo-Live

Others (UbuntuGIS)

Source Code

The source code is managed in a structure corresponding to the above organisation

GRASS Packaging

Offical Ubuntu Packages

These are based on the DebianGIS packages by Frankie and Hamish, packaging rules stored in DebianGIS's git repo -- see the debian/README.debian file in the GRASS source code for details. The official Ubuntu packages are automatically rebuilt from the current Debian packages every six months. If a newer version shows up in the Debian archives before the upcoming Ubuntu release is frozen, it is possible to file a request for the Ubuntu maintainers to re-pull the newer version from Debian (if you can get their attention).

Please base all downstream builds on these packaging rules, with appropriate version number changes to the top entry of the debian/changelog file to add "ubuntu", +svn rev, and whatever else special identifier is needed to show the package's heritage and difference from the official ones.

Please pass up and bug fixes and wish to bugs.debian.org against the grass source package. Thanks.

UbuntuGIS Packages

To be added.

GRASS PPA Packages

Process

  1. GRASS source code is regularly imported upon change by LP (destination: see above)
  2. If source has changed, the package is build by
    1. nesting the debian package files (e.g. from lp:~grass/grass/grass64_release_debian for the 6.4.x stable series) in the original source (e.g. lp:~grass/grass/releasebranch_6_4 for the 6.4.x stable series)
    2. run the build process on LP for the chosen Ubuntu releases according to the instructions in the debian files (e.g. ~grass/grass/grass64_release_debian)
    3. Upload the package to the respective archive / PPA (e.g. GRASS Packages: Stable Series for 6.4.x stable series)

What do to on errors in the packaging process

  • If a package build fails, its most likely that there were changes in the upstream GRASS SVN
  • Then the debian files outlined above must be adapted:
    • branch the code of the debian files Bazaar (bzr) repository from launchpad
    • make the necessary changes locally
    • prepare the source running the recipe locally using
      • bzr dailydeb
      • bzr build
    • tests the build process on your machine using
      • pbuilder (recommended), or
      • dpkg-buildpackage (etc.)

Actions where help is needed

Outstanding tasks are:

  • Sync to the latest DebianGIS build rules
  • Check the correct update & daily builds for GRASS 6.4.x
  • Check if the upgrade to the next Ubuntu release (14.10) does not affect the packages
  • make the GRASS 7.0.x package failsave so that it can be activated for daily builds

Report bugs and issues

  • Report bugs only related to packages installed from the GRASS PPA on he Launchpad bug tracker.
  • Bugs related to GRASS functionality shall be reported directly to GRASS trac

Interested contributors, please come in here and give something back to the GRASS community!

See also