User Tools

Site Tools


This is an old revision of the document!

Getting started with your account, Gerrit & Git

Linux Foundation ID

For access to OPNFV's infrastructure, you will need a LinuxFoundation account. (Please use your company email address for the Linux Foundation account)

Participating in a project

To participate, via contribution, in any project in OPNFV, you will need to contact the project manager for the project, listed in the "Key Project Facts" section of the project page requesting to be added as a contributor of the project. Send a mail to the project manager copying the helpdesk to have your role in the project set up.

Once the rights have been set-up you are ready to add your contributions to the project.

Common Tools

There are a number of tools used to communicate amongst OPNFV project teams. While many of these are listed on our www site that list is not 100% complete so we will replicate and update the list here.

Mailing List

The main mailing list is called Technical Discuss.

  • This list is for general technical discussion about OPNFV. It’s open for anyone to join.
  • If you are already a member you can click this link to send an email to the list:
  • Other mailing lists are available here:
  • Topic filters allows you to choose to only receive messages from the mailing list for particular topics (more info. can be found at For the Technical Discuss mailing list, the following topic filters are available:
    • vsperf: Discussion channel for the vswitchperf project
    • sfqm: Discussion channel for the Software Fastpath Service Quality Metrics project
    • doctor: Discussion channel for the Fault Management (Doctor) project
    • copper: Discussion channel for the Virtualized Infrastructure Deployment Policies (Copper) project
    • promise: Discussion channel for the Resource Management (promise) project
    • bgs: Discussion channel for the Bootstrap/Get started (Genesis) project
    • opendaylight: Discussion channel for OpenDaylight-OPNFV interlock
    • availability: Discussion channel for the High Availability for OPNFV (availability) project
    • vnfgraph: Discussion channel for the OpenStack Based VNF Forwarding Graph (vnf_forwarding_graph) project
    • octopus: Discussion channel for the Continuous Integration (Octopus) project
    • ipv6: Discussion channel for the IPv6-enabled OPNFV (ipv6) project
    • pharos: Discussion channel for the Testbed infrastructure (Pharos) project
    • functest: Discussion channel for the Base system functionality testing (functest) project
    • parser: Discussion channel for the Deployment Template Translation (Parser) project
    • announce: Discussion channel for general announcements
    • opnfv-sec: Discussion channel for the OPNFV Security group
    • infra: Discussion channel for the OPNFV hardware infrastructure
    • release: Discussion channel for OPNFV release discussions
    • (You can select topics you want to subscribe to in the configuration page at


There are a number of IRC channels used for various OPNFV purposes. We will list some here. If this list gets too long we should make a new page:

  • #opnfv-meeting ←- used for most weekly team meetings. It's recommended to not use a specific IRC meeting channel for your meetings. All project meetings should share the main IRC channel to avoid overlapping meetings. One should finish before the next scheduled one starts.
  • #opnfv-doctor ←- used by Doctor team project for day to day communication
  • #opnfv-ipv6 ←- used by IPv6 project for day to day communication
  • #opnfv-vswitchperf ←- used by vSwitch Performance Characterization project for day to day communication
  • #opnfv-bgs ←- Bootstrap/Get-started team
  • #opnfv-octopus ←- CI team
  • #opnfv-testperf ←- performance testing team
  • please add the rest here… we need help to fill in this list.


OPNFV uses Git repositories for our code, documentation, and test artifacts. Git is a common tool for open source collaborative projects and there are many resources to help you become a master at working with Git. A good place to start is the Git how to guide.

Our development processes will help guide you how to work with each project type. Once that material is ready we will provide links here for performing various tasks in OPNFV. For now you can get started by browsing the projects on Gerrit and setting up your security. Git-Review as listed below is a great tool for simplifying the basics when working with Git.


Gerrit is our code review and maintenance vehicle, this is where you will go to comment and review existing patches, this is where your patches will show up once you have pushed them to the Git repository. You can subscribe to be notified to any changes to projects you are interested in. Use your LinuxFoundation ID and log in to the opnfv Gerrit site.

General Workflow

Once your local repository is set up, the following workflow is recommended:

  • Get the latest changes from the repository:

$ git remote update $ git checkout master $ git pull –ff-only origin master

  • Create a topic branch in which you will work, and switch to it:


You can also use the shorter version:

$ git checkout -b NAME_OF_THE_TOPIC_BRANCH

The name of the topic branch should be something related to what's being changed, since it will show up in Gerrit.

When you submit your changes to gerrit, even though they will show the name of the topic branch, they will end up being merged to master. When crafting your commits, you might find Git Commit Good Practice useful.

For more information, you may find the OpenStack Developer's guide and MediaWiki Gerrit Tutorial useful.

How-to's on setting up git and getting started with Gerrit

Step-by-step instructions and screenshots for getting Gerrit access and working with git mediawiki's site for Git Gerritt

Opendaylight's Cheat Sheet and CLI git reference,_Hacking,_and_Pushing_the_Code_from_the_CLI

Once you have setup git and created your ssh key you can register your SSH public key in Gerrit here:

You can also get a password from Gerrit UI and use this instead of SSH key

Git-review is a command-line tool for Git / Gerrit. It makes it easier to configure git, to submit a change or to fetch an existing one. Opendaylight's page on working with git-review

Check out the OPNFV Git/Gerrit page for a collection of setup suggestions for the OPNFV Source Code Repositories.

developer/getting_started.1426193459.txt.gz · Last modified: 2015/03/12 20:50 by Ray Paik