GitHub and the MPI Forum: The Short Version December 9, 2015 San Jose, CA.

GitHub and the MPI Forum:The Short Version

December 9, 2015San Jose, CA

RTFW (Read the Fine Wiki)Getting started with GitGetting started with GitHubWorkflows

Filing an issue (“ticket”)Filing a pull request

Migrating from SVN / Trac

https://github.com/mpi-forum/mpi-issues/wiki

How do I get access?Read and agree to the terms (on the wiki)

Don’t post unofficial copies, don’t post the source publiclySet up a GitHub account

Enable 2-factor authentication on your GitHub account!All the cool kids are doing it

Send an email to Wesley (wesley.bland@intel.com) or Jeff (jsquyres@cisco.com) with your username

General MPI Forum GitHub schemeIssue#28

Describe proposal

Attach PDFs

Refer to its corresponding

PR (#107)

...etc.(Public)

Pull Request #107

Easily see text / LaTeX diff

Should refer to its

corresponding issue (#28)

(Private)

Git repo for LaTeX source code(Private)

Wiki(Public)

mpi-forum /mpi-issues(public)

mpi-forum /mpi-standard(private)

Working Group workflows: general

mpi-forumGithub organization

Chapter authors, editors have write access to

private repos

mpi-standardGit repo[Private]

mpi-issuesGit repo[Public]

mpiwg-toolsGithub organization

Working group members have write access to

private repos

jdinanuser

Pull Request

tools-issuesGit repo[Public] Pull

Request

Typical proposal workflow

Create an issue:

describe the proposal

Create a pull request:

implement proposal in text

Link the issue and pull request

MPI Forum votes to

approve the proposal

Get chapter committee to approve the pull request

Author

Editor

Chapter Committees

Pull request is merged

Chapter Committees / Authors help

resolve merge issues (if any)

RTFW (Read the Fine Wiki)https://github.com/mpi-forum/mpi-issues/wiki

Getting started with GitGetting started with GitHubWorkflows

Filing an issue (“ticket”)Filing a pull request

Migrating from SVN / Trac

Git / GitHub terminologyGit: Distributed version control system

Subversion has a single “upstream”Git can have multiple “upstreams”

GitHub(.com): hosting serviceRepositories: Git repositories and associated toolsOrganizations: Groups of GitHub repositories and users

General MPI Forum GitHub schemeOrganization:

mpi-forum

Repositories:mpi-issues (public)mpi-standard (private)

You must be a member of the mpi-fourm org to see the private mpi-standard repo

“Absolute” repo names:mpi-forum/mpi-issuesmpi-forum/mpi-standard

Who can access the source repo?Anyone on the Forum

Just like previous access to SVNNew: Anyone who agrees to our rules

Don’t publish bogus copies of the StandardDon’t publish the source publicly...etc.https://github.com/mpi-forum/mpi-issues/wiki

Branch scheme

3.x branch

4.x branch

MPI 4.0 MPI 4.1

MPI 3.2

Git tags

MPI 3.0 MPI 3.1

https://github.com/mpi-forum/mpi-issues/wiki/Branch-Management

Errata WorkflowAuthors make a pull request on the appropriate branch

with:Addition(s) to errata document (if there is one)Corresponding change(s) in main document

When new version of MPI standard document released, errata document is cleared out

Errata Workflow (2)

3.x branch

MPI 3.2

Git tags

MPI 3.0 MPI 3.1

Pull request:Clarify MPI_CANCEL for send requests (errata)

Create a new issue on the main repository (not WG)Create a new pull request from WG or user repository

Target desired branch (3.x, 4.x, etc.)Reference Issue in pull request description

Get pull request reviewed by appropriate chapter committee(s) before first vote

After passing votes, Editor clicks “merge” button (hopefully)

https://github.com/mpi-forum/mpi-issues/wiki/Working-Group-Guidelines

Proposal Workflow

Proposal Workflow: current branch

3.x branch

MPI 3.0 MPI 3.1 MPI 3.2

Pull request (for 3.2):MPI_TYPE_GET_EXTENT is defined via deprecated features

Proposal Workflow: next branch

3.x branch

4.x branch

MPI 3.0 MPI 3.1

Pull request:Fault Tolerance (for MPI-4)

Branch does not exist yet

Where to base the pull request?

3.x branch

4.x branch

MPI 3.0 MPI 3.1

Branch does not exist yet

Until 4.x branch exists,base it against 3.x branch

3.x branch

4.x branch

MPI 3.0 MPI 3.1

When 4.x branch is created,rebase the pull request to 4.x branch

Proposal Workflow: current branch, when next branch already exists

3.x branch

4.x branch

MPI 3.0 MPI 3.1 MPI 3.2

Pull request:Datatype support functionality (for MPI-3.2)

Merge down to 4.x branchwhen PR merged to 3.x branch

Working Group workflow: option 1

mpi-standardGit repo

mpiwg-ftGithub organization

Pull Request

mpi-3.xbranch

ticketbranch

Sync from Forum to WG

Working Group workflow: option 2

mpiwg-toolsGithub organization

Pull Request

integrationbranch

ticketbranch

mpi-3.xbranch

mpi-3.x branch

Sync from Forum to WG

Preserved SVN history for MPI-3.0 / MPI-3.1Did not preserve SVN commit history for prior versions -- just saved the

final state of each documentTickets will be moved manually (by authors) from Trac

Use this opportunity to purge old tickets that are not activeTrac will remain available in read-only state for historical

reference

Other Notes

Demonstration: Simple pull requestHigh level steps for a pull request:

1. Create an mpi-forum/mpi-issues issue2. Fork the mpi-forum/mpi-standard repo

(once) 3. Clone your repo to your work machine

(once)4. Make a branch in your clone5. Make and commit your edits to the

branch6. Push your branch to your GitHub fork7. Create the pull request

mpi-forum / mpi-issues repo

mpi-forum / mpi-standard repo

Public issue

(once)3. Clone your repo to your work machine

jsquyres / mpi-standard repo

mpi-standard repo

Pull request

Demonstration

GitHub and the MPI Forum: The Short Version December 9, 2015 San Jose, CA.

Documents

Transcript of GitHub and the MPI Forum: The Short Version December 9, 2015 San Jose, CA.

GitHub Enterprise Introduction To GitHub

Multigrid Method using OpenMP/MPI Hybrid Parallel ... · • Flat MPI vs. Hybrid (OpenMP+MPI) • Expectations for Hybrid Parallel Programming Model – Number of MPI processes (and

What is [Open] MPI?open]-mpi-2up.pdf2 May 2008 Screencast: What is [Open] MPI? 3 MPI Forum • Published MPI-1 spec in 1994 • Published MPI-2 spec in 1996 Additions to MPI-1 •

Advanced Message Passing in MPI - Using MPI Datatypes with ...

China MCP 1 Open MPI. Agenda MPI Overview Open MPI Architecture Open MPI TI Implementation Open MPI Run-time Parameters Open MPI Usage Example Getting.

Learning Fair Classiﬁers - arXiv · Muhammad Bilal Zafar MPI-SWS, Germany mzafar@mpi-sws.org Isabel Valera MPI-SWS, Germany ivalera@mpi-sws.org Manuel Gomez Rogriguez MPI-SWS, Germany

Introduction to MPI MPI programming Running MPI program Architecture of MPICH Lecture 2: Part II Message Passing Programming: MPI.

MPI-3.0 and MPI-3.1 Overviewcaxapa.ru/thumbs/692677/MPI.pdf · MPI-3.0 & 3.1 Overview MPI-3.0 and MPI-3.1 Overview Rolf Rabenseifner Lecture at “Recent Advances in Parallel Programming

The MPI+MPI programming model and why we need shared ... · The MPI+MPI programming model and why we need shared-memory MPI libraries Je Hammond Extreme Scalability Group & Parallel

MPI Bechmarking Tool Questions - mpi-group.commpi-group.com/.../2013/10/MPI-Bechmarking-Tool-Questions-Sheet1… · MPI Manufacturers Benchmarking Toolkit ... Not important Minor

What is MPI? Where Did MPI Come From?

What is [Open] MPI?open]-mpi-1up.pdfMay 2008 Screencast: What is [Open] MPI? 3 MPI Forum • Published MPI-1 spec in 1994 • Published MPI-2 spec in 1996 Additions to MPI-1 • Recently

Github github-github

lecture24 MPI FirstPage - GitHub Pages

EXHIBIT LIST FOR 2020 INSURANCE RATES€¦ · mpi-1: ex. # mpi-2 ex. # mpi-3 ex. # mpi-4 ex. # mpi-5-1 ex. # mpi-5-2 ex. # mpi-6 ex. # mpi-7

CONTROLS Programming adapter MPI-200 · Product Information MPI-200 Programming adapter MPI-200 MPI-200 user interface Programming adapter MPI-200 1. Changing the user interface language

Kirsten Heinrich, Library MPI Biogeochemistry & MPI ......Kirsten Heinrich, Library MPI Biogeochemistry & MPI Chemical Ecology Further library services Open licensing: CC licences

MPI-2: Extensions to the Message-Passing Interface · Abstract This document describes the MPI-1.2 and MPI-2 standards. They are both extensions to the MPI-1.1 standard. The MPI-1.2

MPI MELT PRESSURE PRODUCTS MPI

Preparing to Program Aurora at Exascale - IWOCL · 14 MPI on Aurora • Intel MPI & Cray MPI • MPI 3.0 standard comoliant • The MPI library will be thread safe • Allow aoolications