Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updates to improve tools descriptions

Intel Whamcloud is committed to providing and supporting high quality Lustre releases. Intel Whamcloud hosts the current Lustre source code and welcome contributions from all parties.

Downloading Lustre Code

The main Lustre repository is browsable at Lustre Git Web or via Git clone from git://git.whamcloud.com/fs/lustre-release.git.

...

Lustre RPM are available from Whamcloud's build server. However, if you need to build Lustre from source, you may find the Building Lustre from Source pages helpful.

Code contribution

Intel Lustre has an open code submission policy that does not require copyright sign-over.
Patch submission is similar to the Linux kernel and is detailed in the Submitting Changes page.

...

Lustre code is written according to the the Coding Guidelines.

Community tools

Intel Whamcloud provide technical expertise and development tools to enable well tested releases to be achieved in a open and convenient manner. The most common tools are listed below.

...

  • Auster test suite: page coming soon.

Whamcloud Development Tools Overview

Intel HPDD Tools Overview

...

Tools Overview Tutorial

An overview of how to effectively use the development tools is available in Lustre Autotest-Maloo-Gerrit presentation from the LAD'22 Developer Summit.

Jira - Bug tracking

We're using Jira to track bugs and issues. You use the same account for both Jira and this Wiki. If you would like your account to be marked as a developer account then open a ticket in the Jira LU project to request this. New accounts can be requested from JIRA adminstrators.

Gerrit

...

- code review

...

review.whamcloud.com

We are using Gerrit for our code inspections. You will need an OpenID to login to Gerrit, however we currently have not created our own do not have a public OpenID service. For now, please use a regular Gmail or Yahoo account, or another OpenID account if you have one. Once you have registered on Gerrit, you can add your email address(es) and SSH key(s) to your Gerrit account.

Further reading:

Jenkins

...

- build

...

farm

build.whamcloud.com

Our build server is based on the Jenkins (formally Hudson) continuous integration platform, and it is currently creating CentOS/RHEL RPMs and Ubuntu Debs when changes are pushed to 1. 8, 2.1, and master. It is also building packages when patches are submitted for inspection requests. Every patch that passes the Jenkins build process is automatically tested submitted for testing on our test cluster for at least 8-12 hours clusters with a full range of Lustre regression tests.  This takes at least 6 hours elapsed and 125 hours system time running dozens of different distro, CPU architecture, and configuration combinations.  A link to the currently-running test sessions is posted as a comment on the patch in Gerrit when testing starts. Please be respectful of testing resources when pushing patches.

Further reading:

Maloo - test results database

testing.whamcloud.com 

Once During test execution and after tests have been run, the test results are uploaded to the Maloo test database.  A link to the test results from each patch is posted as a comment on the patch in Gerrit when testing starts.  This includes basic PASS/FAIL/TIMEOUT/SKIP results for the dozens of test sessions, hundreds of tests test scripts, and thousands of subtests that were run, as well as the test environment, test script output, and runtimes.  In case of test failures, the console and test logs are also available, along with client and server debug logs and stack traces.  The Maloo results database is searchable in a variety of ways, by date, branch, test script name, build number, architecture, etc.

Mailing lists and community

...

Organizations, mailing lists and IRC Slack Channel are available from the the Community Resources page.

Wiki

...