Managing A Site In Launchpad

This tutorial will take you through the steps of managing a site via bazaar on Launchpad based on some customizations that you have already made to iHRIS Qualify on your Ubuntu machine.

We will assume that, for the purposes of this tutorial, that the existing customizations live under

/var/lib/iHRIS/sites/qualify

First Steps

We first need to setup a user account on launchpad and connect it to the account on your machine. We will also need to make sure the bazaar version control software is installed.

Creating a Launchpad Account

First you should create an account on Launchpad. If you not have already done so, you can find some help here.

We will refer to this account as LAUNCHPAD_USER.

Creating a Launchpad Team

Presumably, you will want to have several people be able to update the customizations you are storing on Launchpad. This is done by creating a team. To do so:

• Browse to the launchpad homepage
• Select "Register a Team"
  • For the Name I suggest something like "ihris-COUNTRY_NAME" or "ihris-ORGANIZATION_NAME"
  • For the Display Name you can use something like "iHRIS in COUNTRY_NAME"
  • For the Subscription policy, I suggest making it "Open"
• Once the team is created, you can choose view its home page at https://www.launchpad.net/~ihris-COUNTRY_NAME to change some of it's details. For example you can:
  • Add members to the team by the "Add Member" Link
  • Change the owner of the team by "Change Details," scroll to the bottom, "Change Owner"
  • Change the logo/icon for the team by "Change Details," scroll to the bottom, "Change Branding"

Adding Intrahealth Informatics

You may also wish to give the intrahealth-informatics team as a member of to the team you just created. This will enable the people in this team to edit the customizations

Linking your Launchpad Account to your Ubuntu Machine

Since we will want to contribute to the code, we need to let Launchpad know who are. To do this, we create a ssh public key on your Ubuntu machine to add to Launchpad:

sudo apt-get install openssh-client
ssh-keygen -t rsa

When prompted, press Enter to accept the default file name for your key. Next, enter then confirm a password to protect your SSH key.

Your key pair is now stored in ~/.ssh/id_rsa.pub (public key) and ~/.ssh/id_rsa (private key). Now you need to upload the public portion of your SSH key to Launchpad. To do this, open in your web browser:

https://www.launchpad.net/~LAUNCHPAD_USER

You will see a place that says SSH Keys with an exclamation point (!) in a yellow circle next to it. Click on the (!) scroll down until you see Add an SSH Key and a text box. We will paste our public key into this text box. To do so type in a terminal:

gedit ~/.ssh/id_rsa.pub

you can now copy the contents of gedit (the public key) into the text box in the web browser. Now simply click on the button Import Public Key

Note: For every computer/account that you use you will need to repeat these steps to create and import a public key.

Setting up Bazaar

First we need to make sure the Bazaaar (bzr) version control software is installed:

 sudo apt-get install bzr bzrtools

You may wish to read the five minute tutorial at this point. You should also let bzr know how you are:

 bzr whoami "Your Name <your@email.add.ress>"

Creating a Branch

The place we are going to store the customizations for our site is called a "branch." We will need to create this on Launchpad by clicking on the "Code" tab under the team's home page. This should take you to:

https://code.launchpad.net/~ihris-COUNTRY_NAME