HOB SSL Gateway NBIPGW08

Overview

The NBIPGW08 gateway runs under Sun Solaris. The NBIPGW08 gateway uses SSL encryption at one end (the client side) and converts to unencrypted format at the other end (the server side). The NBIPGW08 gateway can be used only on the server side. You can also use NBIPGW08 in the "demilitarized zone."

Prerequisites

The NBIPGW08 gateway runs as a 32-bit program. It runs only on Sun Ultra 64-bit processors and uses XTI. 

The NBIPGW08 gateway is started as a process in a Unix shell. For this reason, when there are a large number of connections, the process must be able to open a large number of sockets. For Solaris, the default configuration pre-defines only 256 file descriptors.

It is possible to check the number file descriptors with the command "ulimit -a". The value is returned and displayed under "nofiles(descriptors)". Before starting the redirector, the user has to set the number of descriptors based on the number of connections required. This is done using the command "ulimit -n xxxx".

Important! Please note that the file descriptors can only be increased up to a "hard" limit. The system administrator must set this limit system-wide in the file "/etc/system" using the following values:

set rlim_fd_max=32768 # system-wide hard limit for file descriptors (max. 65535)

set rlim_fd_cur=1024 # system-wide soft limit

Attention: Setting "set rlim_fd_cur" to a value higher than 1024 can lead to problems, e.g., the license daemon can no longer be started. For this reason, before starting the redirector, increase the number of file descriptors, e.g., using the command "ulimit -n 16000".

 

Usage

NBIPGW08 reads its configuration parameters from an .ini-file. The .ini-file can be edited with any usual ASCII-editor. Please note that this .ini file must observe the conventions for .ini files under Windows NT.

When NBIPGW08 is started, the first parameter specifies the name of the .ini-file.

Example:

NBIPGW08 xyz.ini

The .ini file can contain several sections whose name start with SSLGATE and specify the parameters of the connections to the clients and to the servers.

Each section contains the following parameters:

FUNCTION WTSGATE
special built-in function for usage on Windows terminal servers.
GATEPORT Port of the gateway.
SERVERINETA IP address of the server to be connected.
SERVERPORT Port of the server to be connected.
GATE_IN_INETA IP address for input to gateway that comes from the client side (for use on multihomed systems, i.e. on systems that have several IP addresses). This parameter is optional.
GATE_OUT_INETA IP address for output from gateway that is sent on the server side (for use on multihomed systems, i.e. on systems that have several IP addresses). This parameter is optional.
WTSINETAnnn URL (IP address and port) of Load Balancing function
WTS_BR_PORT Port for broadcast Load Balancing function
WTS_CHECK_NAME YES/NO, optional, check name SSL/WTS
TIMEOUT  Timeout (value 0 up to nnn seconds of inactivity). Note: As IP is a connectionless protocol, a timeout should be set. We recommend a timeout from one hour to one day. If the value 0 is used, the connection will not be monitored.
MAX_SESSION Maximum number of sessions, option
CONFIG-FILE Name of SSL configuration file.
CERTDB-FILE Name of SSL certificate database file.
PASSWORD-FILE Name of SSL password file (password encrypted).
 

The ini file may contain an additional section GENERAL that contains the following paramerter:

LISTEN_ERROR=IGNORE/WAIT/ABEND

 

Example1:

The first example shows the usage as gateway with SSL and without Load Balancing function.

[SSLGATE001]
GATEPORT=4097
SERVERINETA=hobz01f.hob.de
SERVERPORT=23
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd
[SSLGATE002]
GATEPORT=4098
SERVERINETA=hobz01g.hob.de
SERVERPORT=4098
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pw
[SSLGATE003]
GATEPORT=4099
SERVERINETA=hobz01h.hob.de
SERVERPORT=4099
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd
[SSLGATE004]
GATEPORT=4100
SERVERINETA=hobz01i.hob.de
SERVERPORT=4100
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd

[GENERAL]
LISTEN_ERROR=WAIT

Example2:

The second example shows the usage as gateway with SSL and Load Balancing function. The IP addresses of the servers may also be entered numeric.

[SSLGATE001]
FUNCTION=WTSGATE
GATEPORT=4029
WTSINETA001=127.22.0.11:4300
WTSINETA002=127.22.0.11:4300
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd

Example3:

The second example shows the usage as gateway with SSL and Load Balancing function. In this case the names of the servers are used as IP adresses.

[SSLGATE001]
FUNCTION=WTSGATE
GATEPORT=4029
WTSINETA001=hobz01f.hob.de
WTSINETA002=hobz01g.hob.de
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd

Example4:

The fourth example shows the usage as gateway with SSL function on a multi-homed system (that has several IP addresses), e.g. if more than one network adapter is used..

[SSLGATE001]
GATEPORT=4097
SERVERINETA=hobz01f.hob.de
SERVERPORT=23
GATE_IN_INETA=hobz01g.hob.de
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd

Example5:

This example shows the usage as gateway with SSL and Load Balancing function - broadcast. 

[SSLGATE001]
FUNCTION=WTSGATE
GATEPORT=4029
WTS_BR_PORT=4300
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd

Example6:

This example shows the usage as a "mixed" gateway with both functions (including and without load balancing)

[SSLGATE001]
FUNCTION=WTSGATE
GATEPORT=4029
WTSINETA001=127.22.0.11:4300
WTSINETA002=127.22.0.11:4300
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd
[SSLGATE002]
GATEPORT=4097
SERVERINETA=hob6000.hob.de
SERVERPORT=23
GATE_IN_INETA=hobz01g.hob.de
TIMEOUT=900
CONFIG-FILE=hserver.cfg
CERTDB-FILE=hserver.cdb
PASSWORD-FILE=hserver.pwd


 


| Home | News | Products | Software tests | Sitemap | Feedback |

Imprint