README.md

Welcome to the Eclipse OpenJ9 repository

We're not sure which route you might have taken on your way here, but we're really pleased to see you! If you came directly from our website, you've probably already learned a lot about Eclipse OpenJ9 and how it fits in to the OpenJDK ecosystem. If you came via some other route, here are a few key links to get you started:

• Eclipse OpenJ9 website - Learn about this high performance, enterprise-grade Java Virtual Machine (JVM) and why we think you want to get involved in its development.
• AdoptOpenJDK website - Grab pre-built OpenJDK binaries that embed OpenJ9 and try it out.
• Build instructions - Here's how you can build an OpenJDK with OpenJ9 yourself.
• FAQ

If you're looking for ways to help out at the project (thanks!), we have:

• Beginner issues
• Help Wanted issues

If you're here to learn more about the project, read on ...

What is Eclipse OpenJ9?

Eclipse OpenJ9 is an independent implementation of a Java Virtual Machine. "Independent implementation" means it was built using the Java Virtual Machine specification without using any code from any other Java Virtual Machine.

The OpenJ9 JVM combines with the Java Class libraries from OpenJDK to create a complete JDK tuned for footprint, performance, and reliability that is well suited for cloud deployments.

The original source contribution to OpenJ9 came from the IBM "J9" JVM which has been used in production by thousands of Java applications for the last two decades. In September 2017, IBM completed open sourcing the J9 JVM as "Eclipse OpenJ9" at the Eclipse Foundation. Significant parts of J9 are also open source at the Eclipse OMR project. OpenJ9 has a permissive license (Apache License 2.0 or Eclipse Public License 2.0 with a secondary compatibility license for the OpenJDK project's GPLv2 license) that is designed to allow OpenJDK to be built with the OpenJ9 JVM. Please see our LICENSE file for more details.

Eclipse OpenJ9 is a source code project that can be built alongside Java class libraries. Cross platform nightly and release binaries and docker containers for OpenJDK with OpenJ9, targeting several JDK levels (like JDK8, JDK10, etc.) are built by the AdoptOpenJDK organization and can be downloaded from the AdoptOpenJDK download site or on DockerHub.

What is the goal of the project?

The long term goal of the Eclipse OpenJ9 project is to foster an open ecosystem of JVM developers that can collaborate and innovate with designers and developers of hardware platforms, operating systems, tools, and frameworks.

The project welcomes collaboration, embraces fresh innovation, and extends an opportunity to influence the development of OpenJ9 for the next generation of Java applications.

The Java community has benefited over its history from having multiple implementations of the JVM specification competing to provide the best runtime for your application. Whether adding compressed references, new Cloud features, AOT (ahead of time compilation), or straight up faster performance and lower memory use, the ecosystem has improved through that competition. Eclipse OpenJ9 aims to continue to spur innovation in the runtimes space.

How do I contribute?

Since we are an Eclipse Foundation project, each contributor needs to sign an Eclipse Contributor Agreement. The Eclipse Foundation operates under the Eclipse Code of Conduct to promote fairness, openness, and inclusion.

To get started, read our Contribution Guide.

If you think you want to contribute but you're not ready to sign the Eclipse Contributor Agreement, why not come along to our weekly Ask the OpenJ9 community calls to find out more about how we work. We talk about new ideas, answer any questions that get raised, and discuss project plans and status. We also do lightning talks on features and functions of the VM. Visit the #planning channel in our Slack workspace for information about upcoming community calls and minutes from previous meetings (Join here).

What repos are part of the project?

• https://github.com/eclipse/openj9 : OpenJ9 main code base
• https://github.com/eclipse/openj9-omr : Eclipse OMR clone to stage temporary OMR changes. (None so far!)
• https://github.com/eclipse/openj9-systemtest : OpenJ9-specific system tests
• https://github.com/eclipse/openj9-website : OpenJ9 website repo
• https://github.com/eclipse/openj9-docs : OpenJ9 documentation repo

Where can I learn more?

Videos and Presentations

• JavaOne 2017: John Duimovich and Mike Milinkovich having fun chatting about Eclipse OpenJ9 (and EE4J)
• JavaOne 2017: Holly Cummins interviewing Dan Heidinga and Mark Stoodley on Eclipse OpenJ9 and OMR
• JavaOne 2017: Open sourcing the IBM J9 Java Virtual Machine
• JavaOne 2017: Eclipse OpenJ9 Under the hood of the next open source JVM
• JavaOne 2017: Ask the OpenJ9 Architects

Also check out the Resources page on our website.

Copyright (c) 2017, 2018 IBM Corp. and others