Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/website.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,9 @@ jobs:
echo 'staging:' > .asf.yaml
echo ' profile: ~' >> .asf.yaml
echo ' whoami: asf-site' >> .asf.yaml
echo "" >> .asf.yaml
echo 'publish:' > .asf.yaml
echo ' whoami: asf-site' >> .asf.yaml
git add .asf.yaml
git commit -m '.asf.yaml'
git push origin asf-site
Expand Down
13 changes: 5 additions & 8 deletions docs/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,17 +29,14 @@ Ambari enables Application Developers and System Integrators to:

## Getting Started with Ambari

Follow the [installation guide for Ambari 2.7.6](https://cwiki.apache.org/confluence/display/AMBARI/Installation+Guide+for+Ambari+2.7.6).
Follow the [quick start guide for Ambari 3.0.0](quick-start/quick-start-guide.md).

Note: Ambari currently supports the 64-bit version of the following Operating Systems:

* RHEL (Redhat Enterprise Linux) 7.4, 7.3, 7.2
* CentOS 7.4, 7.3, 7.2
* OEL (Oracle Enterprise Linux) 7.4, 7.3, 7.2
* Amazon Linux 2
* SLES (SuSE Linux Enterprise Server) 12 SP3, 12 SP2
* Ubuntu 14 and 16
* Debian 9
* Rocky Linux 8
* Rocky Linux 9
* OpenEuler 22
* Other operating systems will be supported in future releases.

## Get Involved

Expand Down
213 changes: 144 additions & 69 deletions docs/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,75 @@ sidebar_position: 2

# Apache Ambari 3.0.0 Release Notes

## Download

Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://apache-ambari.com/download/).

## Overview

:::tip Major Release
Apache Ambari 3.0.0 represents a significant milestone in the project's development, bringing major improvements to cluster management capabilities, user experience, and platform support. This release focuses on modernizing the technology stack, enhancing security features, and improving overall stability and performance.
:::

## Acknowledgment and Important Notes

### A Message to Our Community

:::info Important Transition
We want to acknowledge that Ambari 3.0 represents a significant milestone as the first major release since the HDP project became closed source. Due to this transition, we have made some important decisions:

- The 2.7.x series has reached End-of-Life (EOL) and will no longer be maintained, as we no longer have access to the HDP packaging source code.
- Version 3.0 marks the beginning of our new mainline branch, which will receive primary maintenance and development focus.
:::

### From Our Hearts to the Community

:::note A Journey Together
The path to this release has been long and challenging. Our community has weathered significant changes and obstacles:

<div class="alert alert--secondary">

- 🔄 Community restructuring and transitions
- 👥 A significantly reduced contributor base
- 🛠 Critical infrastructure challenges, especially around RPM distribution
- 🔨 Profound organizational changes

</div>
:::

:::tip Thank You
To every user who has stood by Ambari through these times: your patience and understanding mean more to us than words can express. We know this release has been a long time coming, and we are truly sorry for keeping you waiting.
:::

:::info With Gratitude
Our hearts are filled with gratitude for:

<div class="alert alert--success">

- 🌟 The pioneers who laid Ambari's foundation
- ⭐️ The steadfast contributors who've stayed with us through the storms
- 💫 Every community member whose belief in open source has never wavered

</div>

This release exists because of your unwavering support and dedication to the open source spirit. Your commitment has been our guiding light through these challenging times.
:::

### Technical Changes

#### Apache Bigtop Integration
:::tip New Integration
We are pleased to announce that Ambari 3.0 now uses Apache Bigtop for component packaging:

<div class="alert alert--success">

- 📦 [Apache Bigtop](https://github.com/apache/bigtop/) is now our default packaging system
- 🔧 Bigtop Stack serves as the default project stack
- 🚀 This integration provides a more sustainable and community-driven approach to package management

</div>
:::

## Release Highlights

### Major Improvements
Expand All @@ -24,11 +87,15 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w

### Platform Support

- Added support for Rocky Linux 8 and 9 ([AMBARI-26133](https://issues.apache.org/jira/browse/AMBARI-26133))
- Added support for openEuler-22.03 ([AMBARI-26126](https://issues.apache.org/jira/browse/AMBARI-26126))
- Added Java 17 support ([AMBARI-26142](https://issues.apache.org/jira/browse/AMBARI-26142), [AMBARI-26186](https://issues.apache.org/jira/browse/AMBARI-26186))
- Added MySQL 8 support for Hive ([AMBARI-26130](https://issues.apache.org/jira/browse/AMBARI-26130))
- Enhanced Docker environment with bigtop/puppet:trunk-rockylinux-8 image
<div class="alert alert--info">

- ✅ Added support for Rocky Linux 8 and 9 ([AMBARI-26133](https://issues.apache.org/jira/browse/AMBARI-26133))
- ✅ Added support for openEuler-22.03 ([AMBARI-26126](https://issues.apache.org/jira/browse/AMBARI-26126))
- ☕️ Added Java 17 support ([AMBARI-26142](https://issues.apache.org/jira/browse/AMBARI-26142), [AMBARI-26186](https://issues.apache.org/jira/browse/AMBARI-26186))
- 🗄 Added MySQL 8 support for Hive ([AMBARI-26130](https://issues.apache.org/jira/browse/AMBARI-26130))
- 📈 Enhanced Docker environment with bigtop/puppet:trunk-rockylinux-8 image

</div>

### New Services and Components

Expand Down Expand Up @@ -159,7 +226,6 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w
- Fixed issue with 'supported-refresh-commands' element ([AMBARI-25863](https://issues.apache.org/jira/browse/AMBARI-25863))
- Reduced excess Zookeeper and Hadoop logging ([AMBARI-24140](https://issues.apache.org/jira/browse/AMBARI-24140))


- **Bug Fixes**:
- Fixed OceanBase support in Ambari MySQL DDL ([AMBARI-26273](https://issues.apache.org/jira/browse/AMBARI-26273))
- Fixed regex pattern flag position in ambari_jinja2 filters ([AMBARI-26269](https://issues.apache.org/jira/browse/AMBARI-26269))
Expand All @@ -179,6 +245,71 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w
- Fixed alter dispatcher ([AMBARI-26240](https://issues.apache.org/jira/browse/AMBARI-26240))
- Corrected spelling mistakes in documentation ([AMBARI-26104](https://issues.apache.org/jira/browse/AMBARI-26104))

## Known Issues

- Timeline Service Reader may fail to start if HBase is not installed ([AMBARI-26248](https://issues.apache.org/jira/browse/AMBARI-26248))
- Timeline Service v2 may fail to start due to issues with leveldb state store directory creation ([AMBARI-26249](https://issues.apache.org/jira/browse/AMBARI-26249))
- Some LDAP/AD authentication issues may occur with previously synced users ([AMBARI-26304](https://issues.apache.org/jira/browse/AMBARI-26304))
- DFSRouter command script path may not be correct ([AMBARI-26116](https://issues.apache.org/jira/browse/AMBARI-26116))
- Module 'status_params' may have no attribute 'router_pid_file' ([AMBARI-26141](https://issues.apache.org/jira/browse/AMBARI-26141))
- _threadlocal may have no uid because it is always None ([AMBARI-26241](https://issues.apache.org/jira/browse/AMBARI-26241))

## Roadmap

The Apache Ambari project has an ambitious roadmap for future releases. The following initiatives are planned for upcoming development cycles:

### Technology Stack Modernization

- **Spring Framework 6 Upgrade**: Migrate from current Spring version to Spring 6 to leverage the latest features, performance improvements, and security enhancements.
- **Ubuntu Support**: Extend platform compatibility to include Ubuntu, providing more deployment options for users.

### Deployment and Operations

- **Docker Automation**: Develop comprehensive Docker-based automation for cluster deployment, making it easier to provision and manage Ambari clusters in containerized environments.
- **Enhanced Containerization**: Improve container orchestration capabilities for both development and production environments.

### Frontend Modernization

- **jQuery Bug Fixes**: Continue to address and resolve UI issues resulting from the jQuery upgrade.
- **Micro-Frontend Architecture**: Implement a gradual transition from the current Ember.js framework to React using a micro-frontend approach, allowing for incremental modernization without disrupting existing functionality.
- **UI/UX Improvements**: Enhance the user interface with modern design patterns and improved user experience.

These roadmap items represent the project's commitment to continuous improvement and adaptation to evolving technologies in the big data ecosystem. Community contributions and feedback on these initiatives are welcome.

## Upgrading to Apache Ambari 3.0.0

:::note

TODO

:::

For detailed instructions on upgrading from previous versions, please refer to the Upgrade Guide.

## Compatibility Matrix

| Component | Supported Versions |
|-----------|-------------------|
| Operating Systems | Rocky Linux 8, Rocky Linux 9, openEuler-22.03, CentOS 7.x, RHEL 7.x, RHEL 8.x |
| Java | OpenJDK 8, OpenJDK 11, OpenJDK 17 |
| Database | PostgreSQL 10+, MySQL 5.7+, MySQL 8+, MariaDB 10.2+, OceanBase |
| Browser | Chrome 80+, Firefox 78+, Edge 80+ |


## Verification

It is essential that you verify the integrity of the downloaded files using the PGP signatures and SHA256 checksums.

```bash
# Verify the SHA256 checksum
sha256sum --check apache-ambari-3.0.0.tar.gz.sha256

# Verify the PGP signature
gpg --verify apache-ambari-3.0.0.tar.gz.asc apache-ambari-3.0.0.tar.gz
```

The PGP signatures can be verified using the public keys of the Apache Ambari Release Managers, which can be found on the [Apache Ambari Download Page](https://ambari.apache.org/download.html).

## Acknowledgments

:::tip Our Amazing Contributors 🌟
Expand All @@ -203,7 +334,6 @@ These dedicated individuals have made substantial contributions to this release:
- **timyuer** 🏆
- **yaruyng** 🏆
- **tongxiaojun** 🏆

### Community Champions 🌠
Their valuable contributions have helped drive the project forward:

Expand Down Expand Up @@ -250,69 +380,14 @@ A special note of appreciation goes to our Release Manager(s), whose tireless co
Every contribution, no matter how small, helps make Ambari better. We welcome new contributors to join our vibrant community!
:::

## Known Issues

- Timeline Service Reader may fail to start if HBase is not installed ([AMBARI-26248](https://issues.apache.org/jira/browse/AMBARI-26248))
- Timeline Service v2 may fail to start due to issues with leveldb state store directory creation ([AMBARI-26249](https://issues.apache.org/jira/browse/AMBARI-26249))
- Some LDAP/AD authentication issues may occur with previously synced users ([AMBARI-26304](https://issues.apache.org/jira/browse/AMBARI-26304))
- DFSRouter command script path may not be correct ([AMBARI-26116](https://issues.apache.org/jira/browse/AMBARI-26116))
- Module 'status_params' may have no attribute 'router_pid_file' ([AMBARI-26141](https://issues.apache.org/jira/browse/AMBARI-26141))
- _threadlocal may have no uid because it is always None ([AMBARI-26241](https://issues.apache.org/jira/browse/AMBARI-26241))

## Roadmap

The Apache Ambari project has an ambitious roadmap for future releases. The following initiatives are planned for upcoming development cycles:

### Technology Stack Modernization

- **Spring Framework 6 Upgrade**: Migrate from current Spring version to Spring 6 to leverage the latest features, performance improvements, and security enhancements.
- **Ubuntu Support**: Extend platform compatibility to include Ubuntu, providing more deployment options for users.

### Deployment and Operations

- **Docker Automation**: Develop comprehensive Docker-based automation for cluster deployment, making it easier to provision and manage Ambari clusters in containerized environments.
- **Enhanced Containerization**: Improve container orchestration capabilities for both development and production environments.

### Frontend Modernization

- **jQuery Bug Fixes**: Continue to address and resolve UI issues resulting from the jQuery upgrade.
- **Micro-Frontend Architecture**: Implement a gradual transition from the current Ember.js framework to React using a micro-frontend approach, allowing for incremental modernization without disrupting existing functionality.
- **UI/UX Improvements**: Enhance the user interface with modern design patterns and improved user experience.

These roadmap items represent the project's commitment to continuous improvement and adaptation to evolving technologies in the big data ecosystem. Community contributions and feedback on these initiatives are welcome.

## Upgrading to Apache Ambari 3.0.0

:::note

TODO

:::

For detailed instructions on upgrading from previous versions, please refer to the Upgrade Guide.

## Compatibility Matrix

| Component | Supported Versions |
|-----------|-------------------|
| Operating Systems | Rocky Linux 8, Rocky Linux 9, openEuler-22.03, CentOS 7.x, RHEL 7.x, RHEL 8.x |
| Java | OpenJDK 8, OpenJDK 11, OpenJDK 17 |
| Database | PostgreSQL 10+, MySQL 5.7+, MySQL 8+, MariaDB 10.2+, OceanBase |
| Browser | Chrome 80+, Firefox 78+, Edge 80+ |

## Download

Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://ambari.apache.org/download.html).
## Community

## Verification

It is essential that you verify the integrity of the downloaded files using the PGP signatures and SHA256 checksums.
We welcome your feedback and contributions to Apache Ambari:

```bash
# Verify the SHA256 checksum
sha256sum --check apache-ambari-3.0.0.tar.gz.sha256
- [Mailing Lists](https://ambari.apache.org/mail-lists.html)
- [Issue Tracker](https://issues.apache.org/jira/projects/AMBARI)
- [GitHub Repository](https://github.com/apache/ambari)

# Verify the PGP signature
gpg --verify apache-ambari-3.0.0.tar.gz.asc apache-ambari-3.0.0.tar.gz
## License

```
Apache Ambari is released under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
5 changes: 4 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,10 @@ const config = {
additionalLanguages: ['bash', 'diff', 'json'],
},
}),
plugins: ['docusaurus-plugin-less',],
plugins: [
'docusaurus-plugin-less',
require.resolve('./src/plugins/csp-plugin'),
],
};

export default config;
Loading
Loading