export-http-lb-config

DRAFT


Previous Next Contents

export-http-lb-config

exports the load balancer configuration or load balancer to a file

Synopsis

asadmin [asadmin-options] export-http-lb-config [--help]
--config config_name | --lbname load_balancer_name
[--target target] [--retrievefile=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.

Note

This subcommand is only applicable to Oracle GlassFish Server. This subcommand is not applicable to GlassFish Server Open Source Edition.

Options

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin(1M) help page.

--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.

--retrievefile

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


Previous Next Contents
Eclipse Foundation Logo  Copyright © 2019, Oracle and/or its affiliates. All rights reserved.

DRAFT