Skip to content

Cherry pick v5.0 -> 3.3 #2876

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 4 commits into
base: 3.3
Choose a base branch
from
Draft
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
142 changes: 131 additions & 11 deletions docs/getting_started/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The following server requirements cover both running the software on-premise and
For running on [Ibexa Cloud](https://www.ibexa.co/products/ibexa-cloud), where recommended configuration and support is provided out of the box, see separate [Ibexa Cloud section](#ibexa-cloud-requirements-and-setup) for further reading on its requirements.

The minimal setup requires PHP, MySQL/MariaDB, Apache/Nginx, Node.js and `yarn`.
Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached, NFS/EFS/S3 and Solr/Elasticsearch in a [clustered setup](clustering.md).
For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/EFS/S3 and Solr/Elasticsearch in a [clustered setup](clustering.md).

!!! caution "Recommended versions"

Expand All @@ -26,7 +26,18 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## Operating system

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

|Name|Version|
|---|---|
|Debian 11 "Bullseye"|11.0-11.7+|
|Ubuntu "Noble Numbat"| 24.04 |
|RHEL / CentOS / CentOS Stream | 8.1-9.5+ |

If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.

=== "[[= product_name =]] v4.6"

|Name|Version|
|---|---|
Expand All @@ -53,7 +64,16 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## Web server

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- Nginx 1.27+
- Apache 2.4 (with required modules `mod_rewrite`, `mod_env` and recommended: `mod_setenvif`, `mod_expires`;
event MPM is recommended, if you need to use prefork you also need the `mod_php` module)

If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.

=== "[[= product_name =]] v4.6"

- Nginx 1.18-1.25+
- Apache 2.4 (with required modules `mod_rewrite`, `mod_env` and recommended: `mod_setenvif`, `mod_expires`;
Expand All @@ -69,7 +89,16 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## DBMS

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- MariaDB 10.11+
- MySQL 8.4
- PostgreSQL 14

If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.

=== "[[= product_name =]] v4.6"

- MariaDB 10.3-10.11+
- MySQL 8.0, 8.4
Expand Down Expand Up @@ -106,7 +135,22 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

### PHP extensions

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- `php-cli`
- `php-fpm`
- `php-mysql` (`php-mysqlnd`) or `php-pgsql`
- `php-xml`
- `php-mbstring`
- `php-process` (on RHEL/CentOS)
- `php-intl`
- `php-curl`
- `php-pear` (optional, provides pecl)
- `php-gd` or `php-imagick` (via pecl on RHEL/CentOS)
- `php-sodium`
- `php-bcmath`

=== "[[= product_name =]] v4.6"

- `php-cli`
- `php-fpm`
Expand Down Expand Up @@ -139,7 +183,11 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

### Cluster PHP extensions

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- `php-redis`

=== "[[= product_name =]] v4.6"

- `php-redis` or `php-memcached`

Expand All @@ -149,7 +197,12 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## Search

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- For content search, Solr 8.11.1 or higher.
Alternatively, Elasticsearch 7.16.2 or higher 7.x version.

=== "[[= product_name =]] v4.6"

- For content search, Solr 7.7 LTS or Solr 8, recommended 8.11.1 or higher. Alternatively, Elasticsearch 7.16.2 or higher 7.x version.
- The above solutions require Oracle Java/Open JDK. The minimum requirement is 8 LTS, recommended 11 LTS. Newer versions are not supported.
Expand Down Expand Up @@ -194,7 +247,16 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## [Clustering](clustering.md)

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- Linux NFS or S3/EFS (for IO, aka binary files stored in content repository, not supported with legacy)
- Redis 7.2+ (separate instances for session and cache, both using a `volatile-*` [eviction policy](https://redis.io/docs/latest/develop/reference/eviction/), session instance configured for persistence)
- [Varnish](http://varnish-cache.org/) 6.0LTS or 7.1 with [varnish-modules](https://github.com/varnish/varnish-modules/blob/master/README.md) or [Fastly](https://www.fastly.com/) using [the provided bundle](http_cache.md) (for HTTP Cache)

If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.

=== "[[= product_name =]] v4.6"

- Linux NFS or S3/EFS (for IO, aka binary files stored in content repository, not supported with legacy)
- Redis 4.0+ or 5.0+ (separate instances for session and cache, both using a `volatile-*` [eviction policy](https://redis.io/docs/latest/develop/reference/eviction/), session instance configured for persistence) or [Memcached](https://memcached.org/) 1.5 or higher
Expand Down Expand Up @@ -222,7 +284,11 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## Package manager

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- Composer: recent 2.8 version

=== "[[= product_name =]] v4.6"

- Composer: recent 2.7 version

Expand All @@ -232,7 +298,15 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## Asset manager

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

- `Node.js` 22+
- `yarn` 1.15.2+

If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.

=== "[[= product_name =]] v4.6"

- `Node.js` 18+, 20+, 22+
- `yarn` 1.15.2+
Expand Down Expand Up @@ -268,7 +342,53 @@ Recommendation for production setups is to use Varnish/Fastly, Redis/Memcached,

## [[= product_name_cloud =]] requirements and setup

=== "Ibexa DXP v4.6"
=== "[[= product_name =]] v5.0"

### Cloud hosting with [[= product_name_cloud =]] and Platform.sh

In general, [[= product_name_cloud =]] supports all features and services of [Platform.sh](https://platform.sh/marketplace/ibexa/) that are compatible and supported by the [[= product_name =]] version you use.

For example:

- Platform.sh provides Redis support for versions 7.2, 7.0, and 6.2. [[= product_name =]] supports Redis version 7.2.
As a result, Redis is supported on [[= product_name_cloud =]] in versions 7.2.

Features or services supported by [[= product_name =]] but not covered by Platform.sh may be possible by means of a [custom integration](#custom-integrations).

### [[= product_name_cloud =]] Setup support matrix

All [[= product_name =]] features are supported in accordance with the example above.

!!! note

As Platform.sh doesn't support a configuration with multiple PostgreSQL databases, for [[= product_name_cloud =]] / Platform.sh it's impossible to have a DFS table in a separate database.

### Recommended [[= product_name_cloud =]] setup

For more details on recommended setup configuration see bundled `.platform.app.yaml` and `.platform/` configuration files.

These files are kept up-to-date with latest recommendations and can be improved through contributions.

### Supported [[= product_name_cloud =]] setup

Because of the large range of possible configurations of [[= product_name =]], there are many possibilities beyond what is provided in the default recommended configuration.

Make sure to set aside time and budget for:

- Verifying your requirements and ensuring they're supported by Platform.sh
- Additional time for adaptation and configuration work, and testing by your development team
- Additional consulting/onboarding time with Platform.sh, Ibexa technical services, and/or one of the many partners with prior experience in using Platform.sh with [[= product_name =]]

The cost and effort of this isn't included in [[= product_name_cloud =]] subscription and is vary depending on the project.

### Custom integrations

Features supported by [[= product_name =]], but not natively by Platform.sh, can in many cases be used by means of custom integrations with external services.

For example, you can create an integration with S3 by means of setting up your own S3 bucket and configuring the relevant parts of [[= product_name =]].
We recommend giving the development team working on the project access to the bucket to ensure work is done in a DevOps way without depending on external teams when changes are needed.

=== "[[= product_name =]] v4.6"

### Cloud hosting with Ibexa Cloud and Platform.sh

Expand Down
8 changes: 4 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,11 +73,11 @@
<div class="col-12">
<div class="notification" id="tile2">
<div class="notification__content">
<h2>The latest release is v4.6</h2>
<div>The <a href="release_notes/ibexa_dxp_v4.6/">latest version of Ibexa DXP is v4.6</a>. You can now update your application to the latest version.</div>
<h2>The latest release is v5.0 LTS</h2>
<div>The latest version of Ibexa DXP is 5.0.0. You can now update your application to the latest version.</div>
</div>
<div class="notification__cta">
<a href="update_and_migration/from_4.5/update_from_4.5/">Update your application</a>
<a href="https://doc.ibexa.co/en/5.0/release_notes/ibexa_dxp_v5.0/">Release notes</a>
</div>
<div class="notification__image">
<img src="images/notification-image.png" alt="The latest release" />
Expand Down Expand Up @@ -214,4 +214,4 @@
</div>
</div>
</div>
</div>
</div>
6 changes: 5 additions & 1 deletion docs/release_notes/ibexa_dxp_v4.6.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,16 @@ description: Ibexa DXP v4.6 brings improvements to Commerce, PIM and Personaliza

**Version number**: v4.6

**Release date**: February 13, 2024
**Initial release date**: February 13, 2024

**Release type**: [LTS](https://support.ibexa.co/Public/service-life)

**Update**: [v4.5.x to v4.6](https://doc.ibexa.co/en/latest/update_and_migration/from_4.5/update_from_4.5/)

## Latest changes

To learn more about the latest changes in v4.6, visit the [full release notes for 4.6](https://doc.ibexa.co/en/latest/release_notes/ibexa_dxp_v4.6/).

## Notable changes

### Ibexa Headless
Expand Down
Loading
Loading