This chapter describes how to create, view, modify, and delete TCP proxies. It contains the following topics:
You can create TCP proxies by using either Fusion Middleware Control or the WLST.
Note:
When you create a TCP Proxy, you are, in effect, modifying a configuration. So for the new TCP Proxy settings to take effect in the Oracle Traffic Director instances, you should redeploy the configuration as described in Activate Configuration Changes.Before You Begin
Before you begin creating a TCP Proxy, decide the following:
A unique name for the proxy. Choose the name carefully. After creating a proxy, you cannot change its name.
A unique IP address (or host name) and port number combinations for the listener.
You can define multiple TCP listeners with the same IP address combined with different port numbers, or with a single port number combined with different IP addresses. So each of the following IP address and port number combinations would be considered a unique listener:
10.10.10.1:80 10.10.10.1:81 10.10.10.2:80 10.10.10.2:81
The name of the origin-server pool to which the TCP Proxy should forward requests. For information about creating origin-server pools, see Managing Origin Server Pools.
Creating a TCP Proxy Using Fusion Middleware Control
To create a TCP Proxy by using the Fusion Middleware Control, do the following:
Creating a TCP Proxy Using WLST
To create a TCP proxy with a set of initial values, run the otd_createTcpProxy
command.
For example, the following command creates a TCP Proxy named bar
for the configuration foo
with the origin-server-pool as tcp-origin-server-pool-1
.
props = {} props['configuration'] = 'foo' props['tcp-proxy'] = 'bar' props['origin-server-pool-name'] = 'tcp-origin-server-pool-1' otd_createTcpProxy(props)
For example, the following command creates a TCP Proxy named bar
for the configuration foo
with the origin-server-pool as tcp-origin-server-pool-1
and protocol as ftp
.
props = {} props['configuration'] = 'foo' props['tcp-proxy'] = 'bar' props['protocol'] = 'ftp' props['origin-server-pool'] = 'tcp-origin-server-pool-1' otd_createTcpProxy(props)
The FTP configuration is enabled for the tcp proxy with properties ssl-termination
, origin-explicit-ftps
and client-explicit-ftps
being 'false', 'true' and 'true' respectively. These properties can be modified later using otd_setTcpProxyProperties
.
For more information, see otd_createTcpProxy command in the WebLogic Scripting Tool Command Reference for Oracle Traffic Director.
You can view a list of TCP proxies by using either Fusion Middleware Control or the WLST.
Viewing a List of TCP Proxies Using Fusion Middleware Control
To view a list of TCP proxies by using the Fusion Middleware Control, do the following:
You can view the properties of a proxy in detail by clicking on its name.
Viewing a List of TCP Proxies Using WLST
To view a list of TCP proxies, run the otd_listTcpProxies
command, as shown in the following example:
props = {} props['configuration'] = 'foo' otd_listTcpProxies(props) tcp_proxy1 tcp_proxy2
You can view the properties of a TCP Proxy in detail by running the otd_getTcpProxyProperties
command.
For more information, see the otd_listTcpProxies
and otd_getTcpProxyProperties
commands in the WebLogic Scripting Tool Command Reference for Oracle Traffic Director.
You can modify TCP proxies by using either Fusion Middleware Control or the WLST.
Modifying a TCP Proxy Using Fusion Middleware Control
To modify a TCP Proxy by using the Fusion Middleware Control, do the following:
Modifying a TCP Proxy Using WLST
To change the properties of a TCP proxy, run the otd_setTcpProxyProperties
command.
For example, the following command changes the session idle timeout of the proxy bar
in the configuration foo
to 1200
.
props = {} props['configuration'] = 'foo' props['tcp-proxy'] = 'bar' props['session-idle-timeout'] = '1200' otd_setTcpProxyProperties(props)
For example, the following command enables FTP configuration for the TCP proxy with properties 'ssl-termination', 'origin-explicit-ftps' and 'client-explicit-ftps' as 'false', 'true' and 'true' respectively.
props = {} props['configuration'] = 'foo' props['tcp-proxy'] = 'bar' props['client-explicit-ftps'] = 'true' otd_setTcpProxyProperties(props)
You can delete TCP proxies by using either Fusion Middleware Control or the WLST.
Deleting a TCP Proxy Using Fusion Middleware Control
To delete a TCP Proxy by using the Fusion Middleware Control, do the following:
To delete a TCP Proxy, run the otd_deleteTcpProxy
command, as shown in the following example:
props = {} props['configuration'] = 'foo' props['tcp-proxy'] = 'bar' otd_deleteTcpProxy(props)
For more information, see otd_deleteTcpProxy
command in the WebLogic Scripting Tool Command Reference for Oracle Traffic Director.