5.5 KiB
Usage
Synopsis
libra
[GENERAL OPTIONS <libra-options>
] [COMMAND <libra-commands>
]
[COMMAND_OPTIONS]
Description
libra
is a
utility designed to communicate with Atlas API based Load Balancer as a
Service systems.
Global Options
libra
--help, -h
Show help message and exit
--debug
Turn on HTTP debugging for requests
--insecure
Don't validate SSL certs
--os_bypass_url <os_bypass-url>
URL to use as an endpoint instead of the one specified by the Service Catalog
--service_type <service-type>
Alternative service type to use for your cloud provider (default is 'hpext:lbaas')
--os_auth_url <auth-url>
The OpenStack authentication URL. Default is OS_AUTH_URL
or LIBRA_URL
environment variables
--os_username <auth-user-name>
The user name to use for authentication. Default is
OS_USERNAME
or LIBRA_USERNAME
environment
variables
--os_password <auth-password>
The password to use for authentication. Default is
OS_PASSWORD
or LIBRA_PASSWORD
environment
variables
--os_tenant_name <auth-tenant-name>
The tenant to authenticate to. Default is OS_TENANT_NAME
or LIBRA_PROJECT_ID
environment variables
--os_region_name <region-name>
The region the load balancer is located. Default is
OS_REGION_NAME
or LIBRA_REGION_NAME
environment variables
Client Commands
libra algorithms
algorithms
Gets a list of supported algorithms
libra create
create
Create a load balancer
--name <name>
The name of the node to be created
--port <port>
The port the load balancer will listen on
--protocol <protocol>
The protocol type for the load balancer (HTTP, TCP or GALERA). The Galera option adds support for deadlock avoidance in Galera clusters, see Serveral Nine's Blog on this.
--node <ip:port:option=value:...>
The IP and port for a load balancer node (can be used multiple times to add multiple nodes). Additional node options may be specified after the ip:port portion in a option=value format.
--vip <vip>
The virtual IP ID of an existing load balancer to attach to
libra delete
delete
Delete a load balancer
<id>
The ID of the load balancer
libra limits
limits
Show the API limits for the user
libra list
list
List all load balancers
--deleted
Show deleted load balancers
libra logs
logs
Send a snapshot of logs to an object store
<id>
The ID of the load balancer
--storage <store>
Storage type
--endpoint <endpoint>
Object store endpoint to use
--basepath <basepath>
Object store based directory
--token <token>
Object store authentication token
libra update
update
Update a load balancer's configuration
<id>
The ID of the load balancer
--name <name>
A new name for the load balancer
--algorithm <algorithm>
A new algorithm for the load balancer
libra monitor-list
monitor-list
List the health monitor for a load balancer
<id>
The ID of the load balancer
libra monitor-delete
monitor-delete
Delete the health monitor for a load balancer
<id>
The ID of the load balancer
libra monitor-update
monitor-update
Update the health monitor for a load balancer
<id>
The ID of the load balancer
libra node-add
node-add
Add a node to a load balancer
<id>
The ID of the load balancer
--node <ip:port:option=value:...>
The node address in ip:port format (can be used multiple times to add multiple nodes). Additional node options may be specified after the ip:port portion in a option=value format.
libra node-delete
node-delete
Delete a node from the load balancer
<id>
The ID of the load balancer
<nodeid>
The ID of the node to be removed
libra node-list
node-list
List the nodes in a load balancer
<id>
The ID of the load balancer
libra node-update
node-update
Update a node's state in a load balancer
<id>
The ID of the load balancer
<nodeid>
The ID of the node to be updated
--condition <condition>
The new state of the node (either ENABLED or DISABLED)
libra node-show
node-show
Get the status of a node in a load balancer
<id>
The ID of the load balancer
<nodeid>
The ID of the node in the load balancer
libra protocols
protocols
Gets a list of supported protocols
libra show
show
Get the status of a single load balancer
<id>
The ID of the load balancer
libra virtualips
virtualips
Get a list of virtual IPs
<id>
The ID of the load balancer