Launchpad usage

All code used in mice is hosted on launchpad in the mice project group

Setting up bzr and launchpad

  • You should install a recent version of bzr.
  • You can get your bzr version by doing bzr --version
  • You can get bzr from http://bazaar.canonical.com/en/ or usually apt-get or equivalent has a bzr version
  • You need to set up a launchpad login and ssh keys at the launchpad website (https://launchpad.net/).
  • Once you have a login, do
    bzr whoami "John Smith <john.smith@rl.ac.uk>"
  • At RAL, you will should make sure your proxy is set by doing
    export https_proxy=http://wwwcache.rl.ac.uk:8080   ### Only if you are at RAL
  • To use launchpad you will need to set your ssh rsa key. You can generate a ssh rsa public - private key pair from the linux command line using:
    ssh-keygen
    Make sure you set a good password when given the option (too weak and the process will fail). This then generates two files, id_rsa (your private key) and id_rsa.pub (your public key). Both files should be put in the (hidden) directory:
    ~/.ssh/
    You will need to set the permissions on the files too, using the following:
    chmod 600 id_rsa
    chmod 640 id_rsa.pub
    
    For the interested reader, there is a nice chmod tutorial available at http://catcode.com/teachmod/ .
    Upload the text of your public key to your launchpad account, and you are good to go.
  • Once you have set up your key, you will be able to connect bazaar to your launchpad ID with:
    bzr launchpad-login jsmith

Initialise a project as bzr

If you have an existing code project, say <my-project>, make it a bzr project by doing

cd <my-project>
bzr init
bzr push lp:~<user-name>/<my-project>/branch-name

Make the Launchpad Branch a Launchpad Project

First register the project
  • Go to the launchpad website
  • You may need to login (button in top right corner)
  • Click Register a Project (mid-right of screen) and fill in all fields
  • Click continue. Launchpad will ask you to verify there is no existing project covering the same work
  • Click continue. Fill in the rest of the fields
You have now made a project. Next you need to register your branch against the project
  • Click "trunk"
  • Click "link to branch" in the middle of the page or equivalently "Configure series branch" on the right hand side of the page
  • Enter branch details

Registering your Project with MICE Project group

Now make it a part of the MICE project group.

You can see all branches associated with all projects associated with mice by following

https://code.launchpad.net/mice

with options to sort by project/etc. You can create a new project in MICE by doing

https://launchpad.net/mice > Register a project in MICE Software

You should also ask to be added to mice-maintainers group.

Other things

If you think more than one person might want to maintain your project, you may want to make a project team.

  • From https://launchpad.net click register a team
  • Enter team details
  • Team is created. The user who created the team is always a member. You may want to add more members