Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

2. Using a command line with administrative privileges, go to the folder in which the .msi file was downloaded. For example:

    • cd C:\Users\xxxxxx\Downloads (Replace xxxxx with your user name if the package got was downloaded to your Downloads folder.) 

NOTE: You'll know that cmd.exe has admin privileges if the console text is green.

3. Install Python:

    • msiexec /i python-2.7.10.msi (32-bits)
    • msiexec /i python-2.7.10.amd64.msi (64-bits)

4. Now, follow the instructions at the following URL:

...

5. When installation is complete, restart a new command line (admin privileges may be needed) and run:

    • pip install git-review

NOTE: By re- opening a new command line you'll benefit from the %PATH% update.

6. Add your reviewer name for all future reviews:

    • git config --global --add gitreview.username "your_LF_user_name"

NOTE: Ensure that your user.name and user.email are matching what was configured for the Linux Foundation credentials: user.name should equal gitreview.username and email address should match the email  address that was configured for the Linux Foundation.

...

<<TODO: Should we make the section above a sub section ? >>You also need to setup your git


7. Set up your Git user email address to the one defined in your

...

Linux Foundation account. The easiest way to do so is to run:

git

...

config

...

--global

...

user.email

...

your

...

LF

...

account

...

email

git config --global --add gitreview.username your_LF_user_name


For people If you are using VPN, you might have encounter a proxy problem while connecting to LF the Linux Foundation website. To avoid the problem, you should add the proxy setting in git config, using the following command:

git

...

config

...

--global

...

https.proxy

...

https://<proxy

...

username>:<proxy

...

password>@<proxy

...

url> 

git config --global http.proxy http://<proxy username>:<proxy password>@<proxy url>

NoteNOTE: while When entering the proxy username, sometimes it may require you might be required to add the domain name in front of the username.

Selecting a connection method (SSH or HTTPS)

Once Git/Gerrit is installed, you will need to select a connection method to the remote server.

We recommend using SSH in which case you need to register your public key in your account settings in gerritGerrit.

If you choose to use HTTP/HTTPS, you'll need to generate an access password. To do so:

In your gerrit Gerrit account settings, select HTTP Password:

...

This password may have a limited time to live, so if you might get errors like this one:

...

Regenerating a password will most likely solve the connectivity issue. Sometime, the gerrit Gerrit interface on HTTPS might be temporarily faulty, so retries might be needed.

...

Now clone the remote repository (because the repo already contains a commit from the LF Linux Foundation team that created it), since we clone in the current folder, it will create a sub folder with the remote copy

...

Now that everything is ready, you can sign off your commit, make sure that your git user matches the one set up on the LF Linux Foundation as this will be verified by the gerrit server

...

You may be prompted for your LF Linux Foundation account password

Now let's verify the commit hook work, this will show you the commit message and the sign off entry

...

Linux Foundation uses Gerrit to download and upload code into repository. Gerrit plugin could be downloaded and installed in IntelliJ, in order to work with the LF Linux Foundation code downloading/uploading procedure.

...

For people working with a proxy, you might have proxy issues connecting to LF Linux Foundation website. To avoid the connection issue, you shall define the proxy setting for both IntelliJ and Git.

...

Download with HTTP URL

Click http under the LF Linux Foundation Project page, it will display the url to use to clone the project.

...

Then open your IntelliJ, click File -> Settings -> Version Control -> Gerrit, enter the URL for the LF Linux Foundation Gerrit website, your LF Linux Foundation username and password and click OK. To test whether the connection is good, you can also click the Test button before clicking OK.

...

To download the project with ssh url, you need to add the ssh key into the LF Linux Foundation Gerrit website.

Click your account name on the top right corner of the website and click on Settings.

...

The steps to create the SSH Key could be found in the following page: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/

Click ssh under the LF Linux Foundation Project page, it will display the url to use to clone the project.

...

Then open your IntelliJ, click File -> Settings -> Version Control -> Gerrit, enter the URL for the LF Linux Foundation Gerrit website, your LF Linux Foundation username and password and click OK. To test whether the connection is good, you can also click the Test button before clicking OK.

...

Once installed, under root location of the project enter command git config --list, make sure the email address listed is exactly the same as the one you used in your LF Linux Foundation account.


If your address is not present or not the same as the one defined in LF Linux Foundation account, enter command git config --global user.email "jondoe@somewhere.com".

Then enter command git commit -as --amend to show the commit message and the sign off entry, as shown below. Make sure the email address is the exactly the same as the email you used in the LF Linux Foundation account. If not, update the address.

...

Then enter command git review to upload the changed code into the LF Linux Foundation for reviewing.


Go to Gerrit window and refresh, the committed changes will be shown in the window. Right click the commit, you can find the tab to Add Reviewers for reviewing or Abandon the changes if you don't want it any more.

...