export-http-lb-config

exports the load balancer configuration or load balancer to a file

Synopsis

export-http-lb-config [--help] --config config_name | --lbname load_balancer_name [--target target] [--retrieve=false] [file_name]

Description

The export-http-lb-config subcommand exports a load balancer configuration or load balancer into a file that the load balancer plug-in can use. The default file name is loadbalancer.xml, but you can specify a different name. Once exported, you manually copy the exported file to the load balancer plug-in location before configuration changes are applied. The --target option makes it possible to generate a loadbalancer.xml for clusters or standalone instances without having to manually create lb-config or load-balancer elements in the target's domain.xml.

To apply changes to the load balancer without manually copying the configuration file, configure the load balancer to automatically apply changes with create-http-lb. If you use the create-http-lb subcommand, you do not need to use export-http-lb-config.

Options

--help

-?

Displays the help text for the subcommand.

--config

Specifies which load balancer configuration to export.

Specify either a load balancer configuration or a load balancer. Specifying both results in an error.

--lbname

Specifies the load balancer to export.

Specify either a load balancer configuration or a load balancer. Specifying both results in an error.

--retrieve

If set to true, retrieves the loadbalancer.xml file from the remote machine. The default is false.

--target

Specifies the target to which the load balancer configuration will be exported. If a target is not specified, the load balancer configuration is exported to the location specified with file_name.

Operands

file_name

Specifies the file name and location of the exported configuration.

• If you specify a directory (relative or absolute) but not a file name, the file named loadbalancer.xml.load_balancer_config_name is created in the specified directory. On Microsoft Windows systems the path must be in quotes.

• If you specify a file name in a relative or absolute path, the file is created with the name you specify in the directory you specify.

• If you specify a file name but do not specify a directory, the file is created with that name in the current working directory.

• If you do not specify this operand, the default value is a file named loadbalancer.xml.load_balancer_config_name created in the domain-dir/generated directory.

target

Specifies the target to which the configuration will be exported.

Valid values are:

• cluster_name- Specifies a cluster and its server instances.

• stand-alone_instance_name- Specifies a specific server instance.

Examples

Example 1   Exporting a Load Balancer Configuration on UNIX

The following example exports a load balancing configuration named mycluster-http-lb-config to a file named loadbalancer.xml in the /Sun/AppServer directory .

asadmin> export-http-lb-config --config mycluster-http-lb-config /Sun/AppServer/loadbalancer.xml
Command export-http-lb-config executed successfully.

Example 2   Exporting a Load Balancer Configuration on Windows

The following example exports a load balancing configuration named mycluster-http-lb-config to a file named loadbalancer.xml in the C:\Sun\AppServer directory on a Microsoft Windows system.

asadmin> export-http-lb-config --config mycluster-http-lb-config "C:\Sun\AppServer\loadbalancer.xml"
Command export-http-lb-config executed successfully.

Exit Status

0

subcommand executed successfully

1

error in executing the subcommand

See Also

create-http-lb(1), create-http-lb-config(1), list-http-lb-configs(1)

asadmin(1M)