UPINGET

Introduction

TcpGate is a proxy server that proxies client request to backend server. It plays as a port forwarding server between client and server. It has the following features:

• Proxies TCP and UDP requests to backend server
• Act as a simple HTTP proxy server
• Maintains a whitelist and a blacklist for IP address pass through or blocking
• Offers a telnet console for user, port mapping, whitelist and blacklist administration
• Trace message contents between the clients and server
• Log message contents in a file

Installation  (Win32)

• Download the TcpGate zip file Win32 version here and Unix version here.
• Follow the steps below to install the software.
  • Extract all the files into directory c:\program files\tcpgate
  • Open Windows Command Prompt, enter the following commands to register the program as Windows Service
    • cd c:\program files\tcpgate
    • tcpgate -i
  • Open ODBC Setting, create System DSN called TCPGATECFG for Microsoft Access Driver and point to tcpgate.mdb which is located in the directory c:\program files\tcpgate
  • Start the Windows Service tcpgate
  • Telnet to localhost and port number 14001, enter username tcpgate and password tcpgate01 to access the program console
  • Enter the following command in the program console, you will receive debug information
    • trace on asc
  • Enter the following command in the program console, you will get the help message
    • help

Usage

• Proxies TCP request to backend server, type the command in the telnet console
  • add tcp 8000 10.10.10.10 8001
  • Hint: Listen port 8000, when traffics via 8000 will finally redirect to IP address 10.10.10.1o port 8001
• Proxies TCP request to backup server when first server failed
  • add tcp 8000 10.10.10.10 8001 bkup 10.10.10.11 8001 10.10.10.12 8001
  • Hint: Two backup servers defined, they are 10.10.10.11 and 10.10.10.12
• Act as a simple HTTP proxy server
  • add tcp 8080 * * http
• Allows white listed IP address connect to the server
  • add whitelist 10.10.11.11 ClientMachine11
  • Hint: IP address 10.10.11.11 CAN connect to the server ports that defined by the server
• Blocks black listed IP address
  • add blacklist 10.10.11.12 BadMachine12
  • Hint: IP address 10.10.11.12 CANNOT connect to the server ports that defined by the server
• Log client and server messages to a file
  • log on c:\debug.txt
  • Hint: The file will be using by the program until the following command is entered
  • log off

Uninstallation

• Stop the Window Service tcpgate
• Open Windows Command Prompt, enter the following commands to uninstall the program from Windows Service
  • cd c:\program files\tcpgate
  • tcpgate -u