-
Notifications
You must be signed in to change notification settings - Fork 105
Change MQTT tuning procedure to a "custom-hiera"-based one #4262
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -3,32 +3,29 @@ | |||||
[id="Increasing_host_limit_for_pull_based_REX_transport_{context}"] | ||||||
= Increasing host limit for pull-based REX transport | ||||||
|
||||||
You can tune the `mosquitto` MQTT server and increase the number of hosts connected to it. | ||||||
You can tune the `mosquitto` MQTT server and increase the maximum number of hosts connected to it. | ||||||
By default, {SmartProxies} support a maximum of 1014 connected hosts. | ||||||
|
||||||
.Procedure | ||||||
. Enable pull-based remote execution on your {ProjectServer} or {SmartProxyServer}: | ||||||
+ | ||||||
[options="nowrap", subs="+quotes,verbatim,attributes"] | ||||||
---- | ||||||
# {foreman-installer} --foreman-proxy-plugin-remote-execution-script-mode pull-mqtt | ||||||
---- | ||||||
This example configures the `mosquitto` service on a {ProjectServer} or {SmartProxyServer} to handle up to 5000 hosts. | ||||||
|
||||||
.Prerequisites | ||||||
* You have enabled pull-based remove execution on your {SmartProxy}. | ||||||
+ | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
We don't need a line break between these sentences. Example: https://github.com/theforeman/foreman-documentation/blob/master/guides/common/modules/proc_installing-and-configuring-puppet-agent-during-host-provisioning.adoc?plain=1#L10 |
||||||
Note that your {ProjectServer} or {SmartProxyServer} can only use one transport mode, either SSH or MQTT. | ||||||
. Create a config file to increase the default number of hosts accepted by the MQTT service: | ||||||
For more information, see {InstallingSmartProxyDocURL}configuring-pull-based-transport-for-remote-execution_{smart-proxy-context}[Configuring pull-based transport for remote execution] in _{InstallingSmartProxyDocTitle}_. | ||||||
|
||||||
maximiliankolb marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
.Procedure | ||||||
. On your {SmartProxy}, set the upper limit of connected hosts for pull-based remote execution in `/etc/foreman-installer/custom-hiera.yaml`: | ||||||
+ | ||||||
[options="nowrap", subs="+quotes,verbatim,attributes"] | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
---- | ||||||
cat >/etc/systemd/system/mosquitto.service.d/limits.conf <<__EOF__ | ||||||
[Service] | ||||||
LimitNOFILE=5000 | ||||||
__EOF__ | ||||||
systemd::dropin_files: | ||||||
limits.conf: | ||||||
unit: mosquitto.service | ||||||
content: "[Service]\nLimitNOFILE=5000\n" | ||||||
---- | ||||||
+ | ||||||
This example sets the limit to allow the `mosquitto` service to handle 5000 hosts. | ||||||
. Apply your changes: | ||||||
. Re-run the installer for the changes to take effect: | ||||||
+ | ||||||
[options="nowrap", subs="+quotes,verbatim,attributes"] | ||||||
---- | ||||||
# systemctl daemon-reload | ||||||
# systemctl restart mosquitto.service | ||||||
---- | ||||||
# {foreman-installer} | ||||||
---- |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"{ProjectServer}" can resolve to "orcharhino Server", which would lead to "a orcharhino Server". I have two suggestions: Either ".. on your {SmartProxy}" or "on your {ProjectServer} or {SmartProxyServer}".