| myst |
|
||||||
|---|---|---|---|---|---|---|---|
| redirect_from |
|
The hypernode-systemctl tool allows you to set certain values for your Hypernode via the command line interface. In the past we asked you to contact support or to go to your Service Panel or Control Panel to change a setting. The hypernode-systemctl tool saves valuable time and makes developing and maintaining a Magento shop even more easier.
To see which values you can set and which values they are allowed to have take a look at our API docs. You can list all available options and the values that can be set by running:
hypernode-systemctl settings --help
| Field | Default Value | Possible Values |
|---|---|---|
| blackfire_enabled A great tool to find performance bottlenecks in Magento |
False | True, False |
| composer_version Change the Composer version |
2.x | 1.x, 2.2, 2.6, 2.7, 2.x |
| datadog_enabled Enable Datadog |
False | True, False |
| disable_optimizer_switch Disable the optimizer switch |
False | True, False |
| elasticsearch_enabled Enable Elasticsearch |
False | True, False |
| elasticsearch_version Change the Elasticsearch version |
7.x | 5.2, 6.x, 7.x |
| enable_ioncube Only enable this if you really have to, as Ioncube is a performance killer |
False | True, False |
| firewall_block_ftp_enabled Indicates whether FTP (which is unsafe) is completely blocked or not |
False | True, False |
| magerun2_version Change the N98 Magerun version |
latest | 3.x, 4.x, 5.x, 6.x, 7.x, latest |
| mailhog_enabled Enable the Mailhog feature |
False | True, False |
| managed_vhosts_enabled Enable the managed_vhosts nginx configuration |
True | True, False |
| modern_ssh_config_enabled Enable modern SSH configuration |
False | True, False |
| modern_ssl_config_enabled Safer SSL and SSH configuration: you can configure Mozilla Modern SSL and enable stricter SSH encryption |
False | True, False |
| mysql_disable_stopwords Disable MySQL stopwords |
False | True, False |
| mysql_enable_explicit_defaults_for_timestamp |
False | True, False |
| mysql_enable_large_thread_stack Enable large thread stacks in MySQL |
False | True, False |
| mysql_ft_min_word_len Set minimum word length for MySQL full-text searches |
4 | 4, 2 |
| mysql_long_query_time |
2 | 2, 5, 10, 15, 30 |
| mysql_tmp_on_data_enabled Enable temporary data directory on MySQL |
False | True, False |
| mysql_version Change the MySQL version (note: once set to 5.7 this can't be reverted) |
8.0 | 5.6, 5.7, 8.0 |
| new_relic_browser_monitoring_auto_instrument_enabled |
True | True, False |
| new_relic_distributed_tracing_enabled |
True | True, False |
| new_relic_enabled |
False | True, False |
| nodejs_version Change the Node version |
22 | 6, 10, 16, 18, 20, 22 |
| opensearch_auto_create_index |
True | True, False |
| opensearch_enabled Enable OpenSearch |
True | True, False |
| opensearch_version Change the OpenSearch version |
2.12 | 1.x, 2.6, 2.12 |
| openvpn_enabled Enables OpenVPN for secure database connections |
False | True, False |
| password_auth Indicates whether password authentication for the Hypernode is allowed instead of only SSH keys |
True | True, False |
| permissive_memory_management Configure memory management policy (OOM kills) |
False | True, False |
| php_amqp_enabled Enable the php-amqp module |
False | True, False |
| php_apcu_enabled Enable the php-apcu module |
True | True, False |
| php_legacy_serialize_precision_enabled |
True | True, False |
| php_version Change the PHP version |
8.3 | 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 |
| php_xdebug_enabled Enable Xdebug for remote debugging |
False | True, False |
| rabbitmq_delayed_message_exchange_enabled |
False | True, False |
| rabbitmq_enabled A popular open source message broker |
False | True, False |
| redis_eviction_policy |
volatile-lru | noeviction allkeys-lru allkeys-lfu volatile-lru volatile-lfu allkeys-random volatile-random volatile-ttl |
| redis_persistent_eviction_policy |
allkeys-lru | noeviction allkeys-lru allkeys-lfu volatile-lru volatile-lfu allkeys-random volatile-random volatile-ttl |
| redis_persistent_instance Enable Redis persistent instance |
False | True, False |
| redis_version Change the Redis version |
7.x | 5.0, 6.x, 7.x |
| supervisor_enabled Enable Supervisor |
False | True, False |
| support_insecure_legacy_tls |
False | True, False |
| tideways_enabled Enable Tideways |
False | True, False |
| unixodbc_enabled Enable UnixODBC |
False | True, False |
| varnish_enabled Enable Varnish |
False | True, False |
| varnish_esi_ignore_https Ignore HTTPS for Varnish ESI |
True | True, False |
| varnish_http_resp_hdr_len |
None | 4k, 8k, 16k, 32k, 64k, 128k, 256k |
| varnish_http_resp_size |
None | 4k, 8k, 16k, 32k, 64k, 128k, 256k |
| varnish_workspace_backend |
None | 4k, 8k, 16k, 32k, 64k, 128k, 256k |
| varnish_large_thread_pool_stack |
False | True, False |
| varnish_version Change the Varnish version |
7.x | 4.0, 6.0, 7.x |
To see which value a setting has you can run the following:
hypernode-systemctl settings php_version
To set a setting to a certain value you can run the following:
hypernode-systemctl settings php_version 8.4
If an invalid value is provided you will be notified of this during the setting procedure.
blackfire_enabledIndicates whether Blackfire is enabled. Check out this article on how to set up Blackfire.blackfire_server_tokenThe BlackFire server token for your Blackfire setup.blackfire_server_idThe BlackFire server ID for your Blackfire setup.
Indicates whether use_index_extensions and mrr are turned off. If turned off this can improve performance due to an issue in PHP 5.6 related to Multi-Range Read Optimization. For more information about this setting see this changelog.
elasticsearch_enabled: Enable Elasticsearchelasticsearch_version: Change the Elasticsearch version
opensearch_enabled: Enable OpenSearchopensearch_version: Change the OpenSearch version
This options allows you to enable IonCube if needed. Note: IonCube is a huge performance killer, so only enable it if you really need it!
Indicates whether FTP is completely blocked or not in favour of SFTP. For more information about this setting see this changelog.
This options enables Mailhog. Mailhog is an email testing tool for developers. Check our documentation for a more detailed explanation about Mailhog on Hypernode.
Eanble the Hypernode Managed Vhosts option to setup the Hypernode with a specific Nginx config which allows you to setup multiple domain names with their own independent Nginx configuration. See our documentation for more information.
Indicates whether this node will have a stricter set of SSH encryption algorithms enabled. See this changelog for more information about this setting.
Indicates whether this node will have the Mozilla Modern SSL configuration configured. This provides a higher level of security but loses compatibility with some browsers. For more information about this setting see this changelog.
mysql_version: Change the MySQL version (note, once set to 5.7 this can't be reverted)mysql_disable_stopwords
This setting makes it possible to disable the built-in stopword file for MyISAM search indexes. Read the changelog for more information.
mysql_ft_min_word_len
This setting will make it possible to configure the ft_min_word_len for MySQL. The ft_min_word_len is the minimum length of the word to be included in a MyISAM FULLTEXT index. So, if you sell things in your Magento shop like wol or a sok, you can now change this setting from the default value of 4 to the smaller value 2.
mysql_tmp_on_data_enabled
Indicates whether the MySQL tmp directory is located in the /data/ directory of the app user or in the /tmp/ directory of the root user. The root user does not have the same amount of space available as the app user, so enabling this might prevent MySQL from taking up all disk space at the cost of taking of the space of the app user. Mostly useful for large shops who create a lot of temporary tables with MySQL. For more information about this settings see this changelog.
mysql_enable_large_thread_stack
This option allows you to use a larger MySQL thread_stack from 192K to 512K. Check our changelog for more information.
Our Hypernode-vpn solution implements a standard OpenVPN TLS tunnel to the Hypernode. Which can be used to talk to the MySQL database securely. You simply enable OpenVPN on your Hypernode and all the required packages and configuration are installed automatically. The automation will generate a default user configuration which you can use to connect to the Hypernode.
Indicates if this node has a return-path set. When you send emails from your Magento shop with no return-path set, the return-path will default to noreply@hypernode.io. This email address may be recognised as a spam address by spam filters, as it is a very generic email used on all Hypernodes without same email configuration.
Check out this article for more information.
Indicates whether password authentication for the node is allowed instead of only SSH keys. By default this option is True. Set this option to False if you prefer to login with SSH-keys
Configure the OOM-killer to be permissive of short term memory usage, allowing memory hungry processes to run without executing overly drastic measures. For more information see our documentation.
php_version: Change the PHP versionphp_apcu_enabled: Enable the PHP-apcu.
Enable this feature to start another Redis instance for sessions instead of caching. Please note that this might require some changes on your end. For more information about this setting see this changelog.
This options enables RabbitMQ which allows you to run tasks in the background. RabbitMQ is message-queueing software where queues can be defined. Applications can connect to the queue and transfer a message onto it. This way you can (for example) import many products into Magento without having to wait a substantial time until the process is finished. The import takes place in the background. Check our documentation for more information.
This option allows you to use Supervisor. Supervisor allows you to use programs that need to run all the time on your Hypernode. These (usually long running) programs should not fail if there is an error. To accomplish this Supervisor watches your programs and restarts them if they might fail. Supervisor works great for use cases where a web hook or metrics always needs to run. See the changelog for more information on Supervisor.
Enable this option to install the necessary drivers for unixODBC to be able to run.
varnish_enabled: Enable Varnishvarnish_version: Allows you to change the versionvarnish_secretvarnish_esi_ignore_https
By setting the +esi_ignore_https flag, Varnish will treat HTTPS as HTTP in <esi:include /> blocks, thereby allowing ESI calls to pass through. However, because these calls are unencrypted and ESI is commonly used to cache information pertaining to authenticated users, it is recommended to only use ESI includes with resources on localhost. If you also want to enable this setting for an already existing Hypernode, please contact support.
Please refer to the issue on the official Magento 2 GitHub repository for more information related to ESI on Magento 2 with Varnish caching enabled.
Besides changing settings, the hypernode-systemctl tool also allows you to whitelist certain IP's for certain purposes. To find out which values are allowed to be set see our API documentation. Or run the following command:
hypernode-systemctl whitelist --help
This tool works with the same whitelists (FTP, WAF and external database) as the Service and Control Panel. So if you would whitelist a certain IP through the hypernode-systemctl tool, it would then also show in the Service and Control Panel and vice versa. You can use the two tools interchangeably.
To see which whitelists are currently set you can run the following:
hypernode-systemctl whitelist get
You will see all IP's whitelisted per type (external database access, FTP and WAF).
If you want to specify a specific whitelist you can run the following:
hypernode-systemctl whitelist get database
To add more values to your whitelists you can run the following. Please note that descriptions are optional:
hypernode-systemctl whitelist add "database, waf or ftp" 1.2.3.4 --description "my description"
To remove values from your whitelists you can run the following:
hypernode-systemctl whitelist remove database 1.2.3.4
The command hypernode-systemctl supports bash-completion for easier navigation through the many options this command offers. Simply type the command and press tab to see the available subcommands you can use.