salt.modules.modjk¶
Control Modjk via the Apache Tomcat "Status" worker (http://tomcat.apache.org/connectors-doc/reference/status.html)
Below is an example of the configuration needed for this module. This configuration data can be placed either in grains or pillar.
If using grains, this can be accomplished statically or via a grain module.
If using pillar, the yaml configuration can be placed directly into a pillar SLS file, making this both the easier and more dynamic method of configuring this module.
modjk:
default:
url: http://localhost/jkstatus
user: modjk
pass: secret
realm: authentication realm for digest passwords
timeout: 5
otherVhost:
url: http://otherVhost/jkstatus
user: modjk
pass: secret2
realm: authentication realm2 for digest passwords
timeout: 600
-
salt.modules.modjk.
bulk_activate
(workers, lbn, profile='default')¶ Activate all the given workers in the specific load balancer
CLI Examples:
salt '*' modjk.bulk_activate node1,node2,node3 loadbalancer1 salt '*' modjk.bulk_activate node1,node2,node3 loadbalancer1 other-profile salt '*' modjk.bulk_activate ["node1","node2","node3"] loadbalancer1 salt '*' modjk.bulk_activate ["node1","node2","node3"] loadbalancer1 other-profile
-
salt.modules.modjk.
bulk_disable
(workers, lbn, profile='default')¶ Disable all the given workers in the specific load balancer
CLI Examples:
salt '*' modjk.bulk_disable node1,node2,node3 loadbalancer1 salt '*' modjk.bulk_disable node1,node2,node3 loadbalancer1 other-profile salt '*' modjk.bulk_disable ["node1","node2","node3"] loadbalancer1 salt '*' modjk.bulk_disable ["node1","node2","node3"] loadbalancer1 other-profile
-
salt.modules.modjk.
bulk_recover
(workers, lbn, profile='default')¶ Recover all the given workers in the specific load balancer
CLI Examples:
salt '*' modjk.bulk_recover node1,node2,node3 loadbalancer1 salt '*' modjk.bulk_recover node1,node2,node3 loadbalancer1 other-profile salt '*' modjk.bulk_recover ["node1","node2","node3"] loadbalancer1 salt '*' modjk.bulk_recover ["node1","node2","node3"] loadbalancer1 other-profile
-
salt.modules.modjk.
bulk_stop
(workers, lbn, profile='default')¶ Stop all the given workers in the specific load balancer
CLI Examples:
salt '*' modjk.bulk_stop node1,node2,node3 loadbalancer1 salt '*' modjk.bulk_stop node1,node2,node3 loadbalancer1 other-profile salt '*' modjk.bulk_stop ["node1","node2","node3"] loadbalancer1 salt '*' modjk.bulk_stop ["node1","node2","node3"] loadbalancer1 other-profile
-
salt.modules.modjk.
dump_config
(profile='default')¶ Dump the original configuration that was loaded from disk
CLI Examples:
salt '*' modjk.dump_config salt '*' modjk.dump_config other-profile
-
salt.modules.modjk.
get_running
(profile='default')¶ Get the current running config (not from disk)
CLI Examples:
salt '*' modjk.get_running salt '*' modjk.get_running other-profile
-
salt.modules.modjk.
lb_edit
(lbn, settings, profile='default')¶ Edit the loadbalancer settings
Note: http://tomcat.apache.org/connectors-doc/reference/status.html Data Parameters for the standard Update Action
CLI Examples:
salt '*' modjk.lb_edit loadbalancer1 "{'vlr': 1, 'vlt': 60}" salt '*' modjk.lb_edit loadbalancer1 "{'vlr': 1, 'vlt': 60}" other-profile
-
salt.modules.modjk.
list_configured_members
(lbn, profile='default')¶ Return a list of member workers from the configuration files
CLI Examples:
salt '*' modjk.list_configured_members loadbalancer1 salt '*' modjk.list_configured_members loadbalancer1 other-profile
-
salt.modules.modjk.
recover_all
(lbn, profile='default')¶ Set the all the workers in lbn to recover and activate them if they are not
CLI Examples:
salt '*' modjk.recover_all loadbalancer1 salt '*' modjk.recover_all loadbalancer1 other-profile
-
salt.modules.modjk.
reset_stats
(lbn, profile='default')¶ Reset all runtime statistics for the load balancer
CLI Examples:
salt '*' modjk.reset_stats loadbalancer1 salt '*' modjk.reset_stats loadbalancer1 other-profile
-
salt.modules.modjk.
version
(profile='default')¶ Return the modjk version
CLI Examples:
salt '*' modjk.version salt '*' modjk.version other-profile
-
salt.modules.modjk.
worker_activate
(worker, lbn, profile='default')¶ Set the worker to activate state in the lbn load balancer
CLI Examples:
salt '*' modjk.worker_activate node1 loadbalancer1 salt '*' modjk.worker_activate node1 loadbalancer1 other-profile
-
salt.modules.modjk.
worker_disable
(worker, lbn, profile='default')¶ Set the worker to disable state in the lbn load balancer
CLI Examples:
salt '*' modjk.worker_disable node1 loadbalancer1 salt '*' modjk.worker_disable node1 loadbalancer1 other-profile
-
salt.modules.modjk.
worker_edit
(worker, lbn, settings, profile='default')¶ Edit the worker settings
Note: http://tomcat.apache.org/connectors-doc/reference/status.html Data Parameters for the standard Update Action
CLI Examples:
salt '*' modjk.worker_edit node1 loadbalancer1 "{'vwf': 500, 'vwd': 60}" salt '*' modjk.worker_edit node1 loadbalancer1 "{'vwf': 500, 'vwd': 60}" other-profile
-
salt.modules.modjk.
worker_recover
(worker, lbn, profile='default')¶ Set the worker to recover this module will fail if it is in OK state
CLI Examples:
salt '*' modjk.worker_recover node1 loadbalancer1 salt '*' modjk.worker_recover node1 loadbalancer1 other-profile
-
salt.modules.modjk.
worker_status
(worker, profile='default')¶ Return the state of the worker
CLI Examples:
salt '*' modjk.worker_status node1 salt '*' modjk.worker_status node1 other-profile
-
salt.modules.modjk.
worker_stop
(worker, lbn, profile='default')¶ Set the worker to stopped state in the lbn load balancer
CLI Examples:
salt '*' modjk.worker_activate node1 loadbalancer1 salt '*' modjk.worker_activate node1 loadbalancer1 other-profile
-
salt.modules.modjk.
workers
(profile='default')¶ Return a list of member workers and their status
CLI Examples:
salt '*' modjk.workers salt '*' modjk.workers other-profile