set-origin-server-prop

Syntax

tadm set-origin-server-prop common_options --config=config_name --origin-server-pool=origin_server_pool_name --origin-server=host:port (property_name=property_value)+

Description

Use this command to set the properties of an origin-server.

Options

For information about common_options, run the help command.

--config|-c: Specify the configuration for which you want to set origin-server properties.
--origin-server-pool|-o: Specify the name of the origin-server pool for which you want to set the origin-server properties.

--origin-server|-O: Specify an origin server in the format host:port

Operands

property-name=property-value

Specify name=value pairs for one or more properties that you want to define. The name=value pairs should be separated by spaces.

You can set the following origin server properties:

enabled: Specifies whether the requests can be routed to this origin server.
Values: true, false. Default: true.

host: Specifies the host name or the IP address of the origin server.
Values: String.

port: Specifies the port number of the origin server.
Values: Integer. 80 is the default port if the origin server pool type is HTTP. 443 is the default port if the origin server pool type is HTTPS.

weight: Specifies the load distribution weight for the origin server.
Values: 0 to 1000. Default: 1.

backup: Specifies whether the origin sever is a backup server. Requests will be sent to the backup origin server only when none of the primary (non-backup) origin servers is available.
Values: true, false. Default: false.

max-connections: Specifies the maximum number of concurrent connections to the server.
Values: 0 or a positive integer. Maximum allowable value is 20480. Default: 0.

ramp-up-time: The time (in seconds) that Oracle Traffic Director should take to ramp up the request sending rate to the full capacity of this origin server.
Values: Positive integer. If max-connections is set to 0, ramp-up-time is ignored.

To reset a property to its default value, do not provide a property value.
For example, property-name=<empty_string>

Example

tadm set-origin-server-prop --user=admin --host=admin.example.com --password-file=./admin.passwd --port=8989 
--no-prompt --config=www.example.org --origin-server-pool=test-pool --origin-server=www.email.com:8080 weight=998 max-connections=234

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.