From 0add07ed1fab1d6bfc6cc28c66c79ef0301e1b69 Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:25:20 +0100 Subject: [PATCH 1/7] Split checks into hypernode and application specific --- .../how-does-horizontal-autoscaling-work.md | 51 ++++++++++++------- 1 file changed, 32 insertions(+), 19 deletions(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index f02cdc25..db6da78b 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -57,16 +57,19 @@ Horizontal autoscaling is available on all the Falcon cloud plans (OpenStack). Next to the provider, horizontal autoscaling does have a couple of additional requirements. -### Supported CMS +We will divide them between Hypernode-specific and Application-specific requirements -Horizontal autoscaling is available for Magento2. -To make use of Horizontal autoscaling, there are a couple of other requirements the Hypernode and the application should meet: +### Hypernode Specific Requirements -### Operating system +#### Operating system - The operating system of the Hypernode should be Debian Bookworm -### Enable and configure Varnish +#### Make sure the Hypernode is a production plan + +Unfortunately we don't support Horizontal autoscaling for development plans. + +#### Enable and configure Varnish To make use of Horizontal autoscaling, Varnish should be enabled and configured on the Hypernode. You can check if Varnish is enabled on your Hypernode by running @@ -104,7 +107,7 @@ acl purge { } ``` -### Enable and configure Redis Persistent +#### Enable and configure Redis Persistent Redis persistent is another requirement before you can make use of Horizontal autoscaling. The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes. @@ -130,17 +133,7 @@ hypernode-systemctl settings redis_persistent_instance --value True Make sure Redis session is configured as [described](../../ecommerce-applications/magento-2/how-to-configure-redis-for-magento-2.md#configure-magento-2-to-use-redis-as-the-session-store) in our docs Please notice the Redis host in the setup documentation. The Redis host should be set to `redismaster` instead of `localhost` or `127.0.0.1`. -### Make sure Elasticsearch/Opensearch configured properly - -Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `/app/etc/env.php` -More information about [Elasticsearch o Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md) - -### Make sure RabbitMQ configured properly - -Please make sure RabbitMQ host is set to `rabbitmqmaster` in the Magento2 configuration file at `/app/etc/env.php` -More information about [RabbitMQ o Hypernode](../../best-practices/database/how-to-run-rabbitmq-on-hypernode.md) - -### Make sure to use MySQL 5.7 or higher +#### Make sure to use MySQL 5.7 or higher The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command. @@ -160,9 +153,29 @@ After the version validation, please verify the MySQL host is set to `mysqlmaste You should see something similar to `'host' => 'mysqlmaster',`. If this is not the case please make sure the database connection host is set to `mysqlmaster` instead of `localhost` or `127.0.0.1` in the magento configuration file at `/app/etc/env.php`. -### Make sure the Hypernode is a production plan +### Application Specific Requirements - Magento2 -Unfortunately we don't support Horizontal autoscaling for development plans. +#### Supported CMS + +Horizontal autoscaling is available for Magento2. +To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet. + +#### Make sure Elasticsearch/Opensearch configured properly + +Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `/app/etc/env.php` +More information about [Elasticsearch o Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md) + +#### Make sure RabbitMQ configured properly + +Please make sure RabbitMQ host is set to `rabbitmqmaster` in the Magento2 configuration file at `/app/etc/env.php` +More information about [RabbitMQ o Hypernode](../../best-practices/database/how-to-run-rabbitmq-on-hypernode.md) +Also make sure to configured RabbitMQ without guest user. + +#### Make sure Database storage is disabled & Remote storage is enabled and configured. + +Please make sure to enable remote storage for your application and configure it correctly as only AWS-s3 remote storage drivers are supported. + +Make sure that the `remote_storage` key is present in the Magento2 configuration file at `/app/etc/env.php` with the correct config. ## Enabling Horizontal Autoscaling From ca50eafb81a9e0b4e9f6597008bb8e538c9677a6 Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:36:06 +0100 Subject: [PATCH 2/7] Update docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md Co-authored-by: Timon de Groot --- .../autoscaling/how-does-horizontal-autoscaling-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index db6da78b..9e32cd7b 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -67,7 +67,7 @@ We will divide them between Hypernode-specific and Application-specific requirem #### Make sure the Hypernode is a production plan -Unfortunately we don't support Horizontal autoscaling for development plans. +For now, we don't support horizontal autoscaling for development plans. #### Enable and configure Varnish From 6a719b4762b330157a7988ce241becaf9e3ed779 Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:36:12 +0100 Subject: [PATCH 3/7] Update docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md Co-authored-by: Timon de Groot --- .../autoscaling/how-does-horizontal-autoscaling-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index 9e32cd7b..decd7fbb 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -157,7 +157,7 @@ You should see something similar to `'host' => 'mysqlmaster',`. If this is not t #### Supported CMS -Horizontal autoscaling is available for Magento2. +Horizontal autoscaling is available for Magento 2.4.7 and higher. To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet. #### Make sure Elasticsearch/Opensearch configured properly From 43ea4a55099e7b8ed569cbf801ef7cb7f5e50a9a Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:36:20 +0100 Subject: [PATCH 4/7] Update docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md Co-authored-by: Timon de Groot --- .../autoscaling/how-does-horizontal-autoscaling-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index decd7fbb..2a739acf 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -163,7 +163,7 @@ To make use of Horizontal autoscaling, there are a couple of other requirements #### Make sure Elasticsearch/Opensearch configured properly Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `/app/etc/env.php` -More information about [Elasticsearch o Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md) +More information about [Elasticsearch on Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md) #### Make sure RabbitMQ configured properly From 4cccc87541090ff1b046c0d44f7dabffda8e80dd Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:36:33 +0100 Subject: [PATCH 5/7] Update docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md Co-authored-by: Timon de Groot --- .../autoscaling/how-does-horizontal-autoscaling-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index 2a739acf..814f7def 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -160,7 +160,7 @@ You should see something similar to `'host' => 'mysqlmaster',`. If this is not t Horizontal autoscaling is available for Magento 2.4.7 and higher. To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet. -#### Make sure Elasticsearch/Opensearch configured properly +#### Make sure Elasticsearch/Opensearch is configured properly Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `/app/etc/env.php` More information about [Elasticsearch on Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md) From beddeb2de3cc0aaf91915e2d0a4934a0657dec3f Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Fri, 20 Dec 2024 11:57:46 +0100 Subject: [PATCH 6/7] add remote storage link and mention non-default rabbitmq user --- .../database/how-to-run-rabbitmq-on-hypernode.md | 2 ++ .../autoscaling/how-does-horizontal-autoscaling-work.md | 6 +++++- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/best-practices/database/how-to-run-rabbitmq-on-hypernode.md b/docs/best-practices/database/how-to-run-rabbitmq-on-hypernode.md index 0da41e19..011f1cc4 100644 --- a/docs/best-practices/database/how-to-run-rabbitmq-on-hypernode.md +++ b/docs/best-practices/database/how-to-run-rabbitmq-on-hypernode.md @@ -84,3 +84,5 @@ You need to make some changes in Magento in order to use RabbitMQ. For example i ), ), ``` + +Note: Hypernode provisions a non-default user called `hypernode-admin` but you are free to create new users. diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index 814f7def..575081d7 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -169,7 +169,9 @@ More information about [Elasticsearch on Hypernode](../../hypernode-platform/too Please make sure RabbitMQ host is set to `rabbitmqmaster` in the Magento2 configuration file at `/app/etc/env.php` More information about [RabbitMQ o Hypernode](../../best-practices/database/how-to-run-rabbitmq-on-hypernode.md) -Also make sure to configured RabbitMQ without guest user. + +There is a rabbitmq user provisioned by Hypernode called hypernode-admin as a non-default user. But you can also configure RabbitMQ with a new different user of your own. +But please make sure to configure RabbitMQ without the default guest user. #### Make sure Database storage is disabled & Remote storage is enabled and configured. @@ -177,6 +179,8 @@ Please make sure to enable remote storage for your application and configure it Make sure that the `remote_storage` key is present in the Magento2 configuration file at `/app/etc/env.php` with the correct config. +More information about [S3 Remote Storage with Magento2](https://experienceleague.adobe.com/en/docs/commerce-operations/configuration-guide/storage/remote-storage/remote-storage-aws-s3) + ## Enabling Horizontal Autoscaling For detailed steps on enabling horizontal Autoscaling, please refer to our documentation: [How to enable horizontal Autoscaling?](how-to-enable-horizontal-autoscaling.md) From 60a1860169c2d5c42692ac3c8cf759543705682b Mon Sep 17 00:00:00 2001 From: Hritik Kothari Date: Mon, 30 Dec 2024 12:30:02 +0100 Subject: [PATCH 7/7] point customer to support and move redis to application specific --- .../how-does-horizontal-autoscaling-work.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md index 575081d7..48e3b62f 100644 --- a/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md +++ b/docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md @@ -63,7 +63,7 @@ We will divide them between Hypernode-specific and Application-specific requirem #### Operating system -- The operating system of the Hypernode should be Debian Bookworm +- The operating system of the Hypernode should be Debian Bookworm. If you would like to upgrade the os of your Hypernode, feel free to contact our support team for help. https://www.hypernode.com/en/contact/ #### Make sure the Hypernode is a production plan @@ -107,32 +107,6 @@ acl purge { } ``` -#### Enable and configure Redis Persistent - -Redis persistent is another requirement before you can make use of Horizontal autoscaling. -The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes. - -You can check if Redis Persistent is enabled on your Hypernode by running - -```console -hypernode-systemctl settings redis_persistent_instance -``` - -Example output if Redis Persistent is enabled: - -```console -redis_persistent_instance is set to value True -``` - -If Redis Persistent instance is not enabled, you can enable the second Redis instance for sessions you run the command: - -```console -hypernode-systemctl settings redis_persistent_instance --value True -``` - -Make sure Redis session is configured as [described](../../ecommerce-applications/magento-2/how-to-configure-redis-for-magento-2.md#configure-magento-2-to-use-redis-as-the-session-store) in our docs -Please notice the Redis host in the setup documentation. The Redis host should be set to `redismaster` instead of `localhost` or `127.0.0.1`. - #### Make sure to use MySQL 5.7 or higher The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command. @@ -160,6 +134,32 @@ You should see something similar to `'host' => 'mysqlmaster',`. If this is not t Horizontal autoscaling is available for Magento 2.4.7 and higher. To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet. +#### Enable and configure Redis Persistent + +Redis persistent is another requirement before you can make use of Horizontal autoscaling. +The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes. + +You can check if Redis Persistent is enabled on your Hypernode by running + +```console +hypernode-systemctl settings redis_persistent_instance +``` + +Example output if Redis Persistent is enabled: + +```console +redis_persistent_instance is set to value True +``` + +If Redis Persistent instance is not enabled, you can enable the second Redis instance for sessions you run the command: + +```console +hypernode-systemctl settings redis_persistent_instance --value True +``` + +Make sure Redis session is configured as [described](../../ecommerce-applications/magento-2/how-to-configure-redis-for-magento-2.md#configure-magento-2-to-use-redis-as-the-session-store) in our docs +Please notice the Redis host in the setup documentation. The Redis host should be set to `redismaster` instead of `localhost` or `127.0.0.1`. + #### Make sure Elasticsearch/Opensearch is configured properly Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `/app/etc/env.php`