Use cases

This section shows common actions on a channel server and what to do then.

The idea and initial cases have been taken from Jean-Lou Dupont's "PEAR Channel on Google Code" presentation.

Adding a new category

When creating a fresh category on your channel server, the following steps are necessary:

  1. Create c/${CategoryName} directory.

  2. Create the following files:

  3. Update c/categories.xml .

Adding a new package

A new package shall be published on the server, and here are the steps you need to do:

  1. Check if the package category already exists, or a new category needs to be created.

  2. Create the package directory p/${packagename}/.

  3. Create those files:

  4. Update the category files:

Adding a release

The time has come to release a new version of an existing package. Those are the steps to do:

  1. Publish the release's package.xml as r/${packagename}/package.0.1.2.xml .

  2. Create the version specific r/${packagename}/0.1.2.xml .

  3. Update state files if appropriate: r/${packagename}/latest.txt , stable.txt , beta.txt , alpha.txt , devel.txt .

  4. Generate r/${packagename}/deps.0.1.2.xml .

  5. Update r/${packagename}/allreleases.xml and r/${packagename}/allreleases2.xml .

  6. Place package archives (tar and tgz) at the place specified in r/${packagename}/0.1.2.xml .

Changes between PEAR REST interface versions (Previous) Channel server software (Next)
Last updated: Tue, 02 Jun 2009 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.