|create pool <name>|
|create service <name>||
Creates a pool or a service.
Disables a service (stops listening).
Note that you can not disable management services.
Enables a service (starts listening).
|header <service> insert <header>:<value>|
|header <service> remove <header>||
Inserts or removes headers from the request before theyre passed on to the backend.
When adding headers you must state the value:
When removing headers you dont need the state any value, the header will be removed regardless of the value it holds:
Note: the usage of x- in the beginning of your header is not required, but the convention is that non-standard headers be prefixed with x-.
Loads a Perlbal plugin.
|pool <name> add <ip[:port]>|
|pool <name> remove <ip[:port]>||
Allows you to add or remove nodes from a service.
Note that adding a node that already exists or removing a non-existing node do not result in an error message.
Dumps the state of reproxy status.
|server <param> = <value>||
Sets a server parameter, where param is one of:
|set [<pool_name>] <param> = <value>||
Sets a property on a pool. If the pool was just created, specifying the pool name is optional.
Setting the file to autoload nodes from (Perlbal will periodically check the file for updates):
Unsetting the file to autoload nodes from (note that this does not remove current members):
undef, null, "" and are interpreted just like none.
Note that manually modifying the pool (via POOL ADD or POOL REMOVE) will disable the periodic checking of the nodefile.
Setting the load balancing method:
Yes, we do realize that random is the only method currently available, but hey.
|set [<service_name>] <param> = <value>||Sets a property on a service. If the service was just created, specifying the service name is optional.|
|show service [<service_name>]|
|show pool [<pool_name>]||
List all services:
Show details of a service:
Lists all pools, nodes and services using them:
Show the members of a pool:
Shuts down the server (youll also lose your telnet session).
Can be used instantly, killing all active connections:
Using the parameter graceful listening sockets are closed and perlbal stays alive until clients bleed off.
Unloads a plugin.
Sets the implied service or pool for future operations.
For instance, after:
You can just type:
Note that creating a service or pool also sets it as the implied service.
|xs [enable <module>]|
|xs [disable <module>]||
Show status of XS modules loaded:
Turn on an already-loaded XS module:
Turn off an already-loaded XS module:
|aio||Shows Perlbal::AIO stats.|
Lists the open connections to the backends.
Shows the current configuration for each service.
If a service uses a plugin that supports dumpconfig, that plugins configuration is also dumped (see dumpconfig under Perlbal::Manual::Plugins for more information).
Shows the maximum number of file descriptors and how many are currently in use.
Iterates Perls internal memory structures and can be used to enumerate all the currently live SVs.
This can be used to hunt leaks and to profile memory usage.
|help||Displays the list of available commands.|
Iterates over active objects.
If an argument is specified, it is treated as code with $_ being the reference to the object.
Shows objects that might have been leaked.
Lists known mime types.
Dumps information on a specific node.
Calling node with a parameter is the same as calling nodes.
Dumps information on all nodes.
Shows the amount of time left for each node marked as noverify.
If the verify_backend parameter is set to a true value, perlbal tries to send an OPTIONS command to a node before sending it the actual client request. If the node doesnt support the OPTIONS command, the node is added to an internal hash so that an OPTIONS command is not issued for new requests during the next 60 seconds.
In the above example, node 127.0.0.1:8081 is on that list and still has 42 seconds until an OPTIONS command is tried again.
If the time is a negative value it means that the OPTIONS command will be issued before the next request.
|obj||Shows objects count in scope.|
|pending||Shows pending backend connections by service, node, and age.|
|proc||Shows CPU usage, current time, pid, and total requests processed.|
|prof data||Enables/disables profiling or dumps profile data.|
Shows status of all queues (normal, high priority and low priority) for all enabled services.
|reload <plugin_name>||Reloads a plugin that supports reloading.|
Lists all sockets or shows a summary of the sockets (by default lists all sockets).
Lists recent state changes of requests.
For instance, while a request is being processed this command may issue something like:
And as soon as the request is processed:
Note: This functionality depends on the environment variable PERLBAL_TRACK_STATES being set to a true value.
Shows how many sockets of which type and in which state currently exist for all services.
If a service is specified, shows the information for that service only.
Dumps objects tracked, sorted by age.
For this to work you must have the environment variable DEBUG_OBJ set to a true value and the server option track_obj on:
|version||Shows the time the server was started, the current uptime and Perlbals version.|
Debug management command to track size of internal data structures.
Turns verbose mode on or off.
Yes, verbose mode only activates the printing of an OK message upon completion of some commands such as load. Errors are displayed regardless of verbose status.
Note that this functionality doesnt implement any sort of authentication. If you can telnet to the address you specify, you can access the information and change things on the fly.
Some alternatives to authentication are commonly employed:
o specifying the address as being 127.0.0.1 means that no one outside the machine can telnet to the management service; o setting the management address as a private IP available only through a VPN, for instance, will allow you to manage these accesses on the VPN instead.
|perl v5.20.3||PERLBAL::MANUAL::MANAGEMENT (3)||2011-01-23|