Skip to content

Commit 42e2a59

Browse files
Merge pull request #302 from ByteInternet/split-elig-checks
Split checks into hypernode and application specific
2 parents ccdacc7 + 05d1d27 commit 42e2a59

File tree

2 files changed

+48
-29
lines changed

2 files changed

+48
-29
lines changed

docs/best-practices/database/how-to-run-rabbitmq-on-hypernode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,3 +84,5 @@ You need to make some changes in Magento in order to use RabbitMQ. For example i
8484
),
8585
),
8686
```
87+
88+
Note: Hypernode provisions a non-default user called `hypernode-admin` but you are free to create new users.

docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md

Lines changed: 46 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -57,16 +57,19 @@ Horizontal autoscaling is available on all the Falcon cloud plans (OpenStack).
5757

5858
Next to the provider, horizontal autoscaling does have a couple of additional requirements.
5959

60-
### Supported CMS
60+
We will divide them between Hypernode-specific and Application-specific requirements
6161

62-
Horizontal autoscaling is available for Magento2.
63-
To make use of Horizontal autoscaling, there are a couple of other requirements the Hypernode and the application should meet:
62+
### Hypernode Specific Requirements
6463

65-
### Operating system
64+
#### Operating system
6665

67-
- The operating system of the Hypernode should be Debian Bookworm
66+
- 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/
6867

69-
### Enable and configure Varnish
68+
#### Make sure the Hypernode is a production plan
69+
70+
For now, we don't support horizontal autoscaling for development plans.
71+
72+
#### Enable and configure Varnish
7073

7174
To make use of Horizontal autoscaling, Varnish should be enabled and configured on the Hypernode.
7275
You can check if Varnish is enabled on your Hypernode by running
@@ -104,7 +107,34 @@ acl purge {
104107
}
105108
```
106109

107-
### Enable and configure Redis Persistent
110+
#### Make sure to use MySQL 5.7 or higher
111+
112+
The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command.
113+
114+
```console
115+
hypernode-systemctl settings mysql_version
116+
```
117+
118+
Example output if MySQL version is 8.0:
119+
120+
```console
121+
mysql_version is set to value 8.0
122+
```
123+
124+
If your MySQL version is still set to 5.6, you can consider [upgrading](../mysql/how-to-use-mysql-on-hypernode.md) the MySQL version to a supported version for autoscaling.
125+
126+
After the version validation, please verify the MySQL host is set to `mysqlmaster`. You can verify this by running `cat app/etc/env.php | grep -i mysql | grep -i host` from the magento root.
127+
128+
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 `<magento_root>/app/etc/env.php`.
129+
130+
### Application Specific Requirements - Magento2
131+
132+
#### Supported CMS
133+
134+
Horizontal autoscaling is available for Magento 2.4.7 and higher.
135+
To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet.
136+
137+
#### Enable and configure Redis Persistent
108138

109139
Redis persistent is another requirement before you can make use of Horizontal autoscaling.
110140
The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes.
@@ -130,39 +160,26 @@ hypernode-systemctl settings redis_persistent_instance --value True
130160
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
131161
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`.
132162

133-
### Make sure Elasticsearch/Opensearch configured properly
163+
#### Make sure Elasticsearch/Opensearch is configured properly
134164

135165
Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `<magento_root>/app/etc/env.php`
136-
More information about [Elasticsearch o Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md)
166+
More information about [Elasticsearch on Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md)
137167

138-
### Make sure RabbitMQ configured properly
168+
#### Make sure RabbitMQ configured properly
139169

140170
Please make sure RabbitMQ host is set to `rabbitmqmaster` in the Magento2 configuration file at `<magento_root>/app/etc/env.php`
141171
More information about [RabbitMQ o Hypernode](../../best-practices/database/how-to-run-rabbitmq-on-hypernode.md)
142172

143-
### Make sure to use MySQL 5.7 or higher
144-
145-
The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command.
146-
147-
```console
148-
hypernode-systemctl settings mysql_version
149-
```
150-
151-
Example output if MySQL version is 8.0:
152-
153-
```console
154-
mysql_version is set to value 8.0
155-
```
156-
157-
If your MySQL version is still set to 5.6, you can consider [upgrading](../mysql/how-to-use-mysql-on-hypernode.md) the MySQL version to a supported version for autoscaling.
173+
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.
174+
But please make sure to configure RabbitMQ without the default guest user.
158175

159-
After the version validation, please verify the MySQL host is set to `mysqlmaster`. You can verify this by running `cat app/etc/env.php | grep -i mysql | grep -i host` from the magento root.
176+
#### Make sure Database storage is disabled & Remote storage is enabled and configured.
160177

161-
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 `<magento_root>/app/etc/env.php`.
178+
Please make sure to enable remote storage for your application and configure it correctly as only AWS-s3 remote storage drivers are supported.
162179

163-
### Make sure the Hypernode is a production plan
180+
Make sure that the `remote_storage` key is present in the Magento2 configuration file at `<magento_root>/app/etc/env.php` with the correct config.
164181

165-
Unfortunately we don't support Horizontal autoscaling for development plans.
182+
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)
166183

167184
## Enabling Horizontal Autoscaling
168185

0 commit comments

Comments
 (0)