Skip to main content

vserver http-proxy create

Contributors
Suggest changes
PDFs

Create a HTTP Proxy configuration

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver http-proxy create command creates an HTTP proxy configuration for a Vserver.

Parameters

{ -vserver <vserver> - Vserver

Use this parameter to specify the Vserver on which the HTTP proxy configuration is to be created.

Note that -vserver and -ipspace are mutually exclusive options.

| [-ipspace <text>] - Ipspace }

Use this parameter to specify the IPspace on which the HTTP proxy configuration is to be created. The proxy is created on the system Vserver of that IPspace.

Note that -vserver and -ipspace are mutually exclusive options.

-server <text> - Proxy Server

Use this parameter to specify the Fully Qualified Domain Name or IP address of the proxy server.

-port <integer> - Port

Use this parameter to specify the port number on which the HTTP proxy service is configured on the proxy server.

-is-auth-enabled {true|false} - Authentication Enabled

Use this parameter to specify if authentication is enabled to connect to the HTTP proxy server. By default it is set to false. When set to true, username and password will be prompted.

[-skip-config-validation <true>] - Skip the config validation

Use this parameter to skip the HTTP proxy configuration validation.

The proxy configuration is validated to verify that the specified server is reachable and is providing an HTTP proxy service on the specified port.

The validation fails in the following cases:

  • The server is not reachable.

  • The specified port is invalid.

  • HTTP proxy service is not configured on the specified server and port.

  • Route or LIF does not exist.

Examples

The following example creates an HTTP proxy configuration for the Vserver vs0 with Fully Qualified Domain Name as input for the -server parameter:

cluster1::*> vserver http-proxy create -vserver vs0 -server example.com -port 222

The following example creates an HTTP proxy configuration with the IP address as input for the -server parameter:

cluster1::*> vserver http-proxy create -vserver vs0 -server 192.168.0.0 -port 222

The following example creates an HTTP proxy configuration with -skip-config-validation set to true:

cluster1::*> vserver http-proxy create -vserver vs0 -server 192.168.0.0 -port 222 -skip-config-validation

The following example creates an HTTP proxy configuration with the IPspace specified and not the Vserver name:

cluster1::*> vserver http-proxy create -ipspace default -server 192.168.0.0 -port 222

The following example creates an HTTP proxy configuration with authentication enabled:

cluster1::*> vserver http-proxy create -ipspace default -server 192.168.0.0 -port 222 -is-auth-enabled true

Enter the user name: test

Enter the password: