Add an additional server to an existing junction point

Add an additional server to an existing junction point

Syntax:
add -h host-name options junction-point

...where...

-h host-name DNS host name or IP address of the target back-end server. Required
options junction-point
Name of the junction point. Required.

Junction types

Junction type Parameter Description
Standard -a address Local IP address that WebSEAL uses when communicating with the target back-end server. If not provided, WebSEAL uses the default address as determined by the operating system. If we supply an address for a particular junction, WebSEAL binds to this local address for all communication with the junctioned server.
Standard -i WebSEAL server treats URLs as case insensitive.
Standard -q url Relative path for query_contents script. By default, WebSEAL looks for query_contents in /cgi_bin/. If this directory is different or the query_contents file name is different, use this option to indicate to WebSEAL the new URL to the file. Required for back-end Windows servers.
Standard -w Windows filesystem support.
TCP and SSL -p port TCP port of the back-end third-party server. Default is 80 for TCP junctions; 443 for SSL junctions.
Mutual -p HTTP-port HTTP port of the back-end third-party server.
Mutual -P HTTPS-port HTTPS port of the back-end third-party server.
Stateful -u UUID UUID of a back-end server connected to WebSEAL via a stateful junction (-s).
Mutually authenticated SSL -D "DN" Distinguished name of back-end server certificate. This value, matched with an actual certificate DN, enhances authentication.
Proxy -H host-name DNS host name or IP address of the proxy server. Requires -t tcpproxy or -t sslproxy
Proxy -P port TCP port of the proxy server. Requires -t tcpproxy or -t sslproxy
Virtual host -v virt-host-name Virtual host name represented on the back-end server. This option supports a virtual host setup on the back-end server. For mutual junctions this value corresponds to the virtual host used for HTTP requests. We use -V when the back-end junction server expects a host name header because we are junctioning to one virtual instance of that server. The default HTTP header request from the browser does not know the back-end server has multiple names and multiple virtual servers. We must configure WebSEAL to supply that extra header information in requests destined for a back-end server set up as a virtual host.
Virtual host -V virt-host-name Virtual host name represented on the back-end server. This option supports a virtual host setup on the back-end server. The value corresponds to the virtual host used for HTTPS requests. Only used for mutual junctions. We use -V when the back-end junction server expects a host name header because we are junctioning to one virtual instance of that server. The default HTTPS header request from the browser does not know the back-end server has multiple names and multiple virtual servers. We must configure WebSEAL to supply that extra header information in requests destined for a back-end server set up as a virtual host.

Parent topic: Command option summary: standard junctions
Related concepts

Creation of a junction for an initial server
Use pdadmin server task to create junctions
Server task commands for junctions

-h host-name	DNS host name or IP address of the target back-end server. Required
options	junction-point Name of the junction point. Required.

Junction type	Parameter	Description
Standard	-a address	Local IP address that WebSEAL uses when communicating with the target back-end server. If not provided, WebSEAL uses the default address as determined by the operating system. If we supply an address for a particular junction, WebSEAL binds to this local address for all communication with the junctioned server.
Standard	-i	WebSEAL server treats URLs as case insensitive.
Standard	-q url	Relative path for query_contents script. By default, WebSEAL looks for query_contents in /cgi_bin/. If this directory is different or the query_contents file name is different, use this option to indicate to WebSEAL the new URL to the file. Required for back-end Windows servers.
Standard	-w	Windows filesystem support.
TCP and SSL	-p port	TCP port of the back-end third-party server. Default is 80 for TCP junctions; 443 for SSL junctions.
Mutual	-p HTTP-port	HTTP port of the back-end third-party server.
Mutual	-P HTTPS-port	HTTPS port of the back-end third-party server.
Stateful	-u UUID	UUID of a back-end server connected to WebSEAL via a stateful junction (-s).
Mutually authenticated SSL	-D "DN"	Distinguished name of back-end server certificate. This value, matched with an actual certificate DN, enhances authentication.
Proxy	-H host-name	DNS host name or IP address of the proxy server. Requires -t tcpproxy or -t sslproxy
Proxy	-P port	TCP port of the proxy server. Requires -t tcpproxy or -t sslproxy
Virtual host	-v virt-host-name	Virtual host name represented on the back-end server. This option supports a virtual host setup on the back-end server. For mutual junctions this value corresponds to the virtual host used for HTTP requests. We use -V when the back-end junction server expects a host name header because we are junctioning to one virtual instance of that server. The default HTTP header request from the browser does not know the back-end server has multiple names and multiple virtual servers. We must configure WebSEAL to supply that extra header information in requests destined for a back-end server set up as a virtual host.
Virtual host	-V virt-host-name	Virtual host name represented on the back-end server. This option supports a virtual host setup on the back-end server. The value corresponds to the virtual host used for HTTPS requests. Only used for mutual junctions. We use -V when the back-end junction server expects a host name header because we are junctioning to one virtual instance of that server. The default HTTPS header request from the browser does not know the back-end server has multiple names and multiple virtual servers. We must configure WebSEAL to supply that extra header information in requests destined for a back-end server set up as a virtual host.