Skip to content

Commit f7d5123

Browse files
committed
docs/autoscaling: Polish up little details
1 parent 48f7dbc commit f7d5123

File tree

1 file changed

+49
-43
lines changed

1 file changed

+49
-43
lines changed

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

Lines changed: 49 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,9 @@ We will divide them between Hypernode-specific and Application-specific requirem
6363

6464
#### Operating system
6565

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/
66+
Horizontal autoscaling is only available on Hypernodes with the Debian Bookworm operating system.
67+
68+
If you would like to upgrade the operating system of your Hypernode, feel free to [contact our support team](https://www.hypernode.com/en/contact/) for help.
6769

6870
#### Make sure the Hypernode is a production plan
6971

@@ -75,32 +77,20 @@ To make use of Horizontal autoscaling, Varnish should be enabled and configured
7577
You can check if Varnish is enabled on your Hypernode by running
7678

7779
```console
78-
hypernode-systemctl settings varnish_enabled
79-
```
80-
81-
Example output if Varnish is enabled:
82-
83-
```console
80+
app@abcdef-hnclusterweb1-magweb-tbbm:~$ hypernode-systemctl settings varnish_enabled
8481
varnish_enabled is set to value True
8582
```
8683

8784
If Varnish is not enabled, you can [enable Varnish](../varnish/how-to-enable-varnish-on-hypernode.md) by following the documentation
88-
If varnish is enabled on your Hypernode, your Magento store should also be configured to make use of varnish.
89-
You can verify if the Varnish host is configured correctly by running the following command from the Magento root:
85+
If Varnish is enabled on your Hypernode, your Magento store should also be configured to make use of varnish.
9086

91-
```console
92-
php bin/magento config:show system/full_page_cache/varnish/backend_host
93-
```
87+
Verify that your VCL has the health probe disabled. While we do support the health probe, we do not recommend to use it in a basic setup.
88+
The health probe can be removed by removing the `.probe` from your `backend default` section in the VCL file.
89+
If you do, however, want to use the health probe, make sure that you set the backend host to `127.0.0.1` instead of `localhost`.
9490

95-
The output should show `varnish` as backend. If it is configured as something else (like `localhost` or `127.0.0.1`), you can update it by running which sets the backend host to `varnish` instead.
91+
Additionally, make sure the IP range `10.0.0.0/24` is allowed under the `acl purge` section in the Varnish VCL file. The `acl purge` section should look like the following:
9692

97-
```console
98-
php bin/magento config:set system/full_page_cache/varnish/backend_host varnish
99-
```
100-
101-
Additionally make sure the IP range `10.0.0.0/24` is set to the `acl_purge` section in the Varnish VCL file. The `acl_purge` section should look something similar:loaded Varnish VCL.
102-
103-
```console
93+
```vcl
10494
acl purge {
10595
"localhost";
10696
"10.0.0.0/24";
@@ -112,12 +102,7 @@ acl purge {
112102
The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command.
113103

114104
```console
115-
hypernode-systemctl settings mysql_version
116-
```
117-
118-
Example output if MySQL version is 8.0:
119-
120-
```console
105+
app@abcdef-hnclusterweb1-magweb-tbbm:~$ hypernode-systemctl settings mysql_version
121106
mysql_version is set to value 8.0
122107
```
123108

@@ -141,55 +126,76 @@ The database, cache, session and queue of the application must be configured wit
141126

142127
Make sure the env variables (db, cache, session, queue) are not using localhost.
143128

144-
### Application Specific Requirements - Magento2
129+
### Application Specific Requirements - Magento 2
145130

146131
#### Supported CMS
147132

148133
Horizontal autoscaling is available for Magento 2.4.7 and higher.
149134
To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet.
150135

151-
#### Enable and configure Redis Persistent
136+
#### Make sure Redis cache is configured properly
137+
138+
Please make sure Redis cache is configured properly in the Magento 2 configuration file at `<magento_root>/app/etc/env.php`.
139+
140+
For the Redis hostname, use `redismaster` instead of `localhost` or `127.0.0.1`.
141+
142+
More information about [Redis on Hypernode](../../ecommerce-applications/magento-2/how-to-configure-redis-for-magento-2.md).
143+
144+
#### Enable and configure Redis sessions
152145

153146
Redis persistent is another requirement before you can make use of Horizontal autoscaling.
154147
The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes.
155148

156149
You can check if Redis Persistent is enabled on your Hypernode by running
157150

158151
```console
159-
hypernode-systemctl settings redis_persistent_instance
160-
```
161-
162-
Example output if Redis Persistent is enabled:
163-
164-
```console
152+
app@abcdef-hnclusterweb1-magweb-tbbm:~$ hypernode-systemctl settings redis_persistent_instance
165153
redis_persistent_instance is set to value True
166154
```
167155

168156
If Redis Persistent instance is not enabled, you can enable the second Redis instance for sessions you run the command:
169157

170158
```console
171-
hypernode-systemctl settings redis_persistent_instance --value True
159+
app@abcdef-hnclusterweb1-magweb-tbbm:~$ hypernode-systemctl settings redis_persistent_instance True
172160
```
173161

174162
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
175163
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`.
176164

177165
#### Make sure Elasticsearch/Opensearch is configured properly
178166

179-
Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` in the Magento2 configuration file at `<magento_root>/app/etc/env.php`
180-
More information about [Elasticsearch on Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md)
167+
Please make sure Elasticsearch or Opensearch host is set to `elasticsearchmaster` your Magento 2 configuration.
168+
169+
To set the hostname, you can run the following command for OpenSearch:
170+
171+
```console
172+
app@abcdef-example-magweb-cmbl:~$ bin/magento config:set catalog/search/opensearch_server_hostname elasticsearchmaster
173+
```
174+
175+
For ElasticSearch:
176+
177+
```console
178+
app@abcdef-example-magweb-cmbl:~$ bin/magento config:set catalog/search/elasticsearch7_server_hostname elasticsearchmaster
179+
```
180+
181+
More information about [Elasticsearch on Hypernode](../../hypernode-platform/tools/how-to-use-elasticsearch-on-hypernode.md).
181182

182183
#### Make sure RabbitMQ configured properly
183184

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

187-
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.
188-
But please make sure to configure RabbitMQ without the default guest user.
188+
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.
189+
Please make sure to configure RabbitMQ without the default guest user.
189190

190-
#### Make sure Database storage is disabled & Remote storage is enabled and configured.
191+
For example, you can run the following command to change your RabbitMQ config in Magento 2:
191192

192-
Please make sure to enable remote storage for your application and configure it correctly as only AWS-s3 remote storage drivers are supported.
193+
```bash
194+
bin/magento setup:config:set \
195+
--amqp-host="rabbitmqmaster" \
196+
--amqp-user="my_rabbitmq_user" \
197+
--amqp-password="my_rabbitmq_password"
198+
```
193199

194200
#### Make sure database storage is disabled & remote storage is enabled and configured
195201

0 commit comments

Comments
 (0)