http://openjdk.java.net/jeps/175
Oracle Contact: Azeem Jiva (azeem.jiva@oracle.com)
IBM Contact:
SAP Contact: Volker Simonis (volker.simonis@sap.com)
Mailing list: ppc-aix-port-dev
This document covers Oracle's effort in supporting the integration of IBM and SAP's PowerPC/AIX port into the OpenJDK master repository. Oracle engineers are needed to participate in this effort since there are a significant number of proposed changes in shared code, which will directly affect all JREs on the current list of supported platforms.
The goal of the PPC/AIX Project is to have a working AIX and Linux PPC 64bit port of OpenJDK. Project completion is marked by no unresolved regressions, either performance or functional on any platform that OpenJDK supports. A complete fix isn't required for each regressions discovered during the porting project, but a plan must be in place to track each regression via Oracle's bug tracking system.
Oracle will create a staging repository which is owned by the PPC/AIX Project and will contain the fixes that have been reviewed and approved. The PPC/AIX Project is responsible for ensuring that the forest is up-to-date with the latest changes from Master. Oracle will create a private Hudson instance for the staging repository, which will build and test the changes. Oracle will periodically test the changes in the staging repository and give feedback to the PPC/AIX Project as appropriate. Oracle, SAP and IBM will jointly determine when the staging forest is ready for integration. All discussions related to this Project should cross-post to the mailing list.
The PPC specific portions of the port will have been properly tested on systems where the results are satisfactory to SAP and IBM. The assumption is that IBM and SAP have workloads that properly test the PPC/AIX port, including the PPC code generation portions for which expertise at Oracle is limited.
SAP and IBM are responsible for running JCK, JTReg, and any other public appropriate test suites. A summary of results should be provided when a changeset is submitted for review.
Results from additional non-public test suites may be required before a changeset is pushed. In cases where Oracle tests are not public, it is Oracle's responsibility to run tests while a changeset is being reviewed. In the case of failed tests, or unacceptable performance Oracle will provide sufficient information to debug the problem possibly as a targeted test case, suggested fix, or general resolution advice.
An overview of the steps for integration:
If a test or performance regression is found by Oracle, the PPC/AIX Project will be notified via an E-mail sent to the mailing list with the following pieces of information:
All communication will be done via the mailing list along with the appropriate OpenJDK mailing list for each subcomponent (compiler, runtime, gc, libraries, etc).
The following provides additional details for each of the test suites.
Oracle recommends that SAP or IBM will test on at least one supported platform.
Testing criteria are measured and compared against the previous staging repository. The fixed baseline is based on the staging repository when the changes from mainline are merged with the staging repository. Once a baseline has been established, any failure as reported by Oracle that are new are tracked and sent to the ppcaix mailing list for discussion and fixing.
The following provides details for the performance aspects of this document, There must be no regression in performance on supported platforms with any change made by SAP or IBM.
An Oracle BugID is required for all changesets, which will be provided by Oracle. Once all testing has been satisfied and changes have been approved, the changeset can be pushed into the staging repository.
Once all changes have been integrated into the staging repository, a final round of testing will be performed. This testing will include a run of all tests specified in this document as well as other tests that Oracle will deem necessary. The testing will cover functional as well performance with the goal of the PPC/AIX project being that no regressions will be unresolved before merging into the main project.
A complete architectural review is required to ensure that the changes SAP and IBM propose fit into the overal architecture of HotSpot. Other areas of concern include coding style, overall code quality, ease of extensibility and other code metrics.
Updates and reviews to the architecture should be made by members of the PPC/AIX Porting Project at Architecture of the OpenJDK PPC Port .
| Issue | Current Status | Resolution | Date Resolved |
|---|---|---|---|
| Waiting on SQE resources | Waiting on SQE manager response |
These dates are calendar weeks. There are significant requirements in terms of resources required as such this plan cannot start until those resources are available.
Confidence level maps to the following:
= Low effort or high confidence in meeting the expected effort schedule
= Medium effort or medium confidence in meeting the expected effort schedule
= High effort or low confidence in meeting the expected effort schedule
| Milestone | Task | Who | Effort (expected) | Effort (pessimistic) | Dependency | Target Date | Confidence Level (, , ) | Completed | Comments |
|---|---|---|---|---|---|---|---|---|---|
| M1 | Setup | ~1 day (M1.1 + 1.2 + 1.3) | ~1 week (M1.1 + 1.2 + 1.3) | When JEP is Funded | | Funded: 2013/06/10 notification
| |||
| M1.1 | Staging repository setup | Oracle | Few hours | 1 day | At request of Lead | When JEP is Funded | | 2013/06/10 | |
| M1.2 | JIRA CPU and OS updates | Oracle | Few hours | 1 day | After M1.1 | July 2013 | | 2013/07/12 | OS value "aix" added. New CPU field unnecessary. The following fields should be updated. OS would have a new field 'aix' with optionally adding version post fix such as 'aix_7.1' or 'aix_6'. The CPU would have a new field 'ppc64'. |
| M1.3 | Hudson instance on staging server | Oracle | Few hours | 1 day | After M1.1 | July 2013 | | 2013/08/01 | |
| M2 | Review and approve initial set of changes | ~4 weeks | ~6 weeks | After M1 | | 2013/11/28 | The work can happen mostly in parallel, with M2.1 and M2.2 taking roughly the same time to complete as M2.3. | ||
| M2.1 | Review changes for a working linux_ppc64 hotspot port | Oracle, SAP, IBM | ~2 weeks | ~3 weeks | After M1.3 | Mid-Late August | | 2013/08/20 | The initial 8 changes (1-8) that get a working linux_ppc64 port |
| M2.2 | Review changes for a working aix_ppc64 hotspot port | Oracle, SAP, IBM | ~2 weeks | ~3 weeks | After M1.3 | Mid-Late August | | 2013/09/06 | The next set of patches (9-13) to get a working aix_ppc64 port |
| M2.3 | Basic libraries porting effort | Oracle, SAP, IBM | ~2 weeks | ~4 weeks | After M1.3 | Early-October | | 2013/11/28 | Enabling the build and basic functionality of the complete JDK on Linux and AIX. |
| M3 | Review and integrate PPC64/C2 and advanced HotSot changes and the remaining AIX class library changes. | ~34 weeks (M3.1 + 3.2 + 3.3 + 3.4) | ~43 weeks (M3.1 + 3.2 + 3.3 + 3.4) | After M2 | | None of the sub milestones are dependent on each other, they can happen in any order as the PPC/AIX project members see fit. While the milestones are not dependent on each other, there are resource constraints that will not allow them to happen in parallel. | |||
| M3.1 | HotSpot changes for the PPC64 C2 Port | Oracle, SAP, IBM | ~6 weeks | ~7 weeks | After M2.2 | December | | 2013/12/13 | Basic changes for a running C2 Port on PPC64 (~10 changes). |
| M3.2 | Remaining HotSpot changes for PPC64. | Oracle, SAP, IBM | ~12 weeks | ~15 weeks | After M2.2 | February 2014 | | 2014/01/22 | Additional C2 and runtime/GC changes which fix remaining problems and improve the performance. |
| M3.3 | Complete and stabilize class library port. | Oracle, SAP, IBM | ~12 weeks | ~15 weeks | After M2.2 | February 2014 | | 2014/01/24 | Add class library functionality which is missing on AIX and improve the implementation. |
| M3.4 | Performance evaluation | Oracle, SAP, IBM | ~4 weeks | ~6 weeks | After M3.3 | March 2014 | | All performance criteria resolved | |
| M4 | Stabilization/post integration bug fixing | Oracle, SAP, IBM | ~4 weeks | ~8 weeks | After all milestones | March 2014 | | Extended testing on the completed integration will testing and performance regressions resolved | |
| M5 | Final integration | Oracle, SAP, IBM | < 1 week | 1 week | After stabilization period | March 2014 | | Verification of all integrated changes, including a functional satisfaction report by SAP and IBM |
These checkpoints are meant as a way to review the current status of the port, adjusting the schedule or adding resources as needed.
| Milestone | Note |
|---|---|
| After completion of M2.2 or M2.3 | |
| After completion of M3.2 | |
| After completion of M3.4 | |
| After final integration |