30/461

## create-http

sets HTTP parameters for a protocol

Synopsis

    create-http [--help]
    --default-virtual-server virtual-server
    [--request-timeout-seconds timeout]
    [--timeout-seconds timeout]
    [--max-connection max-keepalive]
    [--dns-lookup-enabled={false|true}]
    [--servername server-name]
    [--target target]
    protocol-name

Description

The `create-http` subcommand creates a set of HTTP parameters for a protocol, which in turn configures one or more network listeners. This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--default-virtual-server`

  The ID attribute of the default virtual server for the associated network listeners.

`--request-timeout-seconds`

  The time in seconds at which the request times out. If you do not set this option, the request times out in 30 seconds.

`--timeout-seconds`

  The maximum time in seconds for which a keep alive connection is kept open. A value of `0` or less means keep alive connections are kept open indefinitely. The default is `30`.

`--max-connection`

  The maximum number of HTTP requests that can be pipelined until the connection is closed by the server. Set this property to `1` to disable HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. The default is `256`.

`--dns-lookup-enabled`

  If set to `true`, looks up the DNS entry for the client. The default is `false`.

`--servername`

  Tells the server what to put in the host name section of any URLs it sends to the client. This affects URLs the server automatically generates; it doesn't affect the URLs for directories and files stored in the server. This name should be the alias name if your server uses an alias. If a colon and port number are appended, that port will be used in URLs that the server sends to the client.

`--target`

  Creates the set of HTTP parameters only on the specified target. Valid values are as follows:

  `server`

    Creates the set of HTTP parameters on the default server instance. This is the default value.

  configuration-name

    Creates the set of HTTP parameters in the specified configuration.

  cluster-name

    Creates the set of HTTP parameters on all server instances in the specified cluster.

  standalone-instance-name

    Creates the set of HTTP parameters on the specified standalone server instance.

Operands

protocol-name

  The name of the protocol to which this HTTP parameter set applies.

Examples

Example 1 Using the `create-http` Subcommand

  The following command creates an HTTP parameter set for the protocol named `http-1`:

      asadmin> create-http --timeout-seconds 60 --default-virtual-server server http-1
      Command create-http executed successfully.

Exit Status

0

  command executed successfully

1

  error in executing the command

See Also

delete-http(1), create-network-listener(1), create-protocol(1), create-virtual-server(1)

asadmin(1M)