Configuring proxy servers

To configure a proxy server, the target application server must be installed on the same machine as the proxy server. For both the Client and Server Editions, verify the Java environment variables, then run the configure command for your application server. The Client Edition may require additional configuration:

Open set-java-home.bat, and verify that the Java environment variable—either DJC_JAVA_HOME_14 or DJC_JAVA_HOME_15—refers to the home directory of the JDK you plan to use. The location of set-java-home.bat depends on the proxy server edition:

Client Edition – %PB_SERVER_HOME%\..\EBJProxy\bin
Server Edition – %PB_SERVER_HOME%\bin

Use a JDK version that your application-server vendor recommends for creating standalone EJB client applications.

To use the proxy server with IBM WebSphere, use an IBM JDK.

Run the configure command, specifying the application server installation directory. You can also specify the options defined in Table 4-1.

**Table 4-1: Configuration options**
Property name	Default value	Syntax example
proxy.name	ejb-proxy	`-Dproxy.name=my-proxy`
proxy.host	host name	`-Dproxy.host=my-host` Can be either a host name or an IP address. Ignored in the Client Edition, which always listens on the local loopback address 127.0.0.1.
proxy.port	2000	`-Dproxy.port=1000`
jboss.host	host name	`-Djboss.host=my-host`
jboss.port	1099	`-Djboss.port=2099`
wls.host	host name	`-Dwls.host=my-host`
wls.port	7001	`-Dwls.port=7501`
was.host	host name	`-Dwas.host=my-host`
was.port	2809	`-Dwas.port=3809`

For each supported application server, the configure command calls an Ant configuration script, which you can customize. The Ant scripts are located in %PB_SERVER_HOME%\config:

ejb-proxy-jboss.xml
ejb-proxy-weblogic.xml
ejb-proxy-websphere.xml

Client Edition only. If developers will be connecting to the client proxy server using the PowerBuilder IDE:

Set the administrative password. Change to the bin subdirectory of the client proxy server installation, and run:
```
 set-admin-password.bat
```
The system prompts you to enter a password, which must contain at least six characters, and one of those characters must be a digit.
Ping the client proxy port (by default, 2000).

If only client applications will be connecting to the client proxy server, these steps are not required.

Configuring a proxy server on JBoss

Change to the %PB_SERVER_HOME%\bin directory, and run:

configure.bat ejb-proxy-jboss “-Djboss.home=jboss-home-dir” [“-D<property-name>=<property-value>”]

where:

jboss-home-dir is the JBoss installation directory
property-name is one of the optional properties listed in Table 4-1
property-value is the property value

For example, to set the name of the proxy server to “myProxy”:

configure.bat ejb-proxy-jboss “-Djboss.home=jboss-home-dir” “-Dproxy-name=myProxy” “-Dproxy.port=1000”

If the application server installation directory path contains spaces, enclose the -D options in double quotes; otherwise, quotes are not required.

Configuring a proxy server on WebLogic

Change to the %PB_SERVER_HOME%\bin directory, and run:

configure.bat ejb-proxy-weblogic “-Dwls.home=wls-home-dir”
[“-D<property-name>=<property-value>”]

where wls-home-dir is the WebLogic installation directory, and property-name and property-value are optional property name/value pairs.

Configuring a proxy server on WebSphere

Change to the %PB_SERVER_HOME%\bin directory, and run:

configure.bat ejb-proxy-websphere “-Dwas.home=was-home-dir” [“-D<property-name>=<property-value>”]

where was-home-dir is the WebSphere installation directory, and property-name and property-value are optional property name/value pairs.