Introduction

In order to create packages of galaxium into the PPA repository for the public to take advantage of automatic updates, you must follow the following steps. We will walk you through creating your GPG key, registering with the proper services, setting up the tools necessary to upload, and teach you how to use the package creation scripts.

You will need to install the following tools in order to use the scripts in the dist folder:

sudo apt-get install subversion build-essential lintian devscripts dh-make fakeroot gnupg dput

NOTE: You will not be creating packages unless you are an administrator, and a member of the "Team Galaxium" group on the launchpad. Please speak to us about releases and packages if you need assistance.

Generating PPA Packages

Part 1: Setting up and using your PGP key

WARNING: When told to keep track of pieces of information, you will most likely want to store the information for future use. Keep a document that contains the information and save it somewhere.

• Type the following into a terminal window: gpg --gen-key

• Answer some questions about the key you are creating, simply choosing the defaults followed by a "y" confirmation.

• Using the identity format shown below, Identify yourself by name, email address and comment.

Name: First Last (Galaxium)

Email: email@address.com

Comment: Galaxium Developer

• The final result should look something like this: Larry King (Galaxium) (Galaxium Developer) <larry.king@gmail.com>

• Choose the passphrase you will have to type in when generating packages. You may have to randomly type on the keyboard to generate random data for the generator.

WARNING: You cannot forget your passphrase, otherwise the keys are no good and you have to start over.

• Type the following in a terminal window: gpg --list-keys

• Keep track of the information provided. Note the pub line, the text after the / contains the pub ID.

• Type the following in a terminal window: gpg --send-keys --keyserver keyserver.ubuntu.com _<PUB ID HERE!!>_

• Type the following in a terminal window: gpg --fingerprint

• Keep track of the fingerprint in the output, it looks something like: 0464 39CD 2486 190A 2C5A 0739 0E68 04DC 16E7 CB72

• Go to the OpenPGP Keys page.

• Paste the fingerprint you obtained earlier and press the "Import Key" button.

• Check your email for a confirmation, and click on the link provided.

WARNING: Launchpad encrypts the email using your PGP key. You will need to use Evolution and then provide it your passphrase for it to decode the message.

• Click the "Confirm" button once back into the website and your key should be imported.

• Go to the Code of Conduct page.

• Following the on-screen instructions to download the most recent Code of Conduct, then sign it using GPG.

Part 2: Generating package and details

• Open a terminal window to the dist folder in the svn.

• Type the following command in the terminal window:

sh gendebsrc.sh <set> <url> <dist> <version> <release> [-f]

Set: Should be "galaxium" or "galaxium-svn"

URL: Put in the URL of the folder in SVN that points to the code.

Dist: The distribution this package is targetted for.

Version: The version of the code in SVN you pointed to.

Release: A 1 value if its a release, or 0 value if its development.

The -f flag is used to force the building of new packages, even if the revision has not changed.

• The ~/.galaxium_dist folder will contain the data that is generated.

Part 3: Uploading and monitoring packages

• Create a new file ~/.dput.cf with the following contents:

[galaxium-ppa]
fqdn = ppa.launchpad.net
method = ftp
incoming = ~galaxium/ppa/ubuntu/
login = anonymous
allow_unsigned_uploads = 0

• Browse to the ~/.galaxium_dist/deb-src/.

• List the files in this folder to get the "changes" file name.

• Type the following command in the terminal window:

dput galaxium-ppa <filename>.changes

This wiki page is mostly complete, but can still use improvements.