Skip to content

Installation and deployment

What's EMQ X suggested OS?

EMQ X supports deployment on at Linux, Windows, MacOS, ARM system, and suggest to deploy product environment at issued Linux version, such as CentOS, Ubuntu and Debian.

How to estimate resource usage of EMQ X?

Tags: Resource estimation

Following factors will have an impact on EMQ X resource consumption, mainly on CPU and memory usage.

  • Connection number: EMQ X creates 2 Erlang process for every MQTT connection, and every Erlang process consumes some resource. The more connections, the more resource is required.

  • Average throughput: Throughput means (pub message number + sub message number) processed by EMQ X per second. With higher throughput value, more resource will be used for handling route and message delivery in EMQ X.

  • Payload size: With bigger size of payload, more memory and CPU are required for message cache and processing.

  • Topic number: With more topics, the route table in EMQ X will increase, and more resource is required.

  • QoS:With higher message QoS level, more resource will be used for message handling.

If client devices connect to EMQ X through TLS, more CPU resource is required for encryption and decryption. Our suggested solution is to add a load balancer before EMQ X nodes, the TLS is offloaded at load balance node, connections between load balancer and backend EMQ X nodes use plain TCP connections.

You can use our online calculation tool TODO to estimate the resource consumption.

When I was executing stress test, the connection number and throughput are lower than expected. How can I tune the system to make full use of it?

Tags: Debug Performance

When executing a stress test, besides ensuring the necessary hardware resource, it is also necessary to tune the OS and the Erlang VM to make the maximum use of the resource. The most common tuning is to modify the global limitation of file handles, the user limitation of file handles, the TCP backlog and buffer, the limitation fo process number of Erlang VM and so on. You will also need to tune the client machine to ensure it has the ability and resource to handle all the subs and pubs.

Different use scenario requires diferent tuning。 In the EMQ X document there is a chapter about tuning the system for general purpose. TODO

My connections number is small, do I still need to deploy multiple nodes in production?

Tags: Performance

Even when the connction number is small, or message rate is low, it is still very meaningfulto deploy a cluster with multiple nodes in production. A cluster improves the availability of system, when a single node is down, the rest nodes in cluster ensures the service is not interrupted.