UsaProxy 1.5 README file:


UsaProxy is composed in a jar file.


##### start UsaProxy 1.5 proxy #####


To start the UsaProxy proxy do the following:

Being in the UsaProxy1.5 folder open a terminal and type in:
java -jar UsaProxy1.5.jar <port> [<remote proxy IP>|<server address>] [<remote proxy port>|<server port>] [transparent|transparentremote|server|remote]

with <port>: choose a UsaProxy1.5 port (best between 1024 and 65535)

Examples:
java -jar UsaProxy1.5.jar 2727 // regular proxy
java -jar UsaProxy1.5.jar 2727 275.275.2.2 81 remote
java -jar UsaProxy1.5.jar 2727 275.275.2.2 81 transparentremote
java -jar UsaProxy1.5.jar 2727 275.275.2.2 2666 transparent

Deployment options:

optional in the case connections to the internet are routed through another proxy:
with <remote proxy IP>: IP address of the gateway proxy
with <remote proxy port>: port of the gateway proxy

optional if UsaProxy is set up as transparent proxy:
with <server IP>: IP address of the corrensponding webserver
with <server port>: port of the corresponding webserver

optional if UsaProxy is set up as transparent proxy with connections being routed through another proxy (e.g. gateway):
with <remote proxy IP>: IP address of the gateway proxy
with <remote proxy port>: port of the gateway proxy

optional: server-side deployment:
if UsaProxy is set up as server-side proxy:
with <server address>: web address of the corresponding webserver (such as www.google.de)
with <server port>: port the corresponding webserver is running on

in server mode UsaProxy typically set up on port 80 and forwarding to a specific web server port !=80
java -jar UsaProxy1.5.jar 80 www.google.de 2666 server

Scenarios of server-side deployment:

Scenario 1:
Imagine you (e.g. google) would like to put UsaProxy in front of your web server. You'll have to reconfigure the Apache so that it will be running on e.g. port 8000. You won't have to modify the references in your HTML pages. They may still implicitely refer to default port 80. And in fact - all requests shall further on go to port 80, so that UsaProxy may forward them to port 8000. In that case, UsaProxy would be started as follows:

java UsaProxy 80 www.google.de 8000 server

Scenario 2: a dedicated UsaProxy server:
You want to keep your web server running unchanged as www.google.de (IP 1.1.1.1) but nevertheless put UsaProxy in front. For this purpose, you'll have to modify the DNS entry in such a way that www.google.de will refer to IP 1.1.1.2 from now on. On the new computer 1.1.1.2 only UsaProxy will be running. In that case, UsaProxy would be started as follows:

java UsaProxy 80 1.1.1.1 80 server


##### connect to UsaProxy 1.5 proxy #####


To start a usability test using the UsaProxy 1.5 proxy do the following:

1. Go to the respective browser properties menu
2. Register UsaProxy 1.5 as proxy with the respective IP address and port
3. Surf the Web as usual...



##### view the log files #####


1. Log file

log.txt contains all UsaProxy traffic in the form:
<Client-IP> <datestamp> <serverdata ID> <event> [<attributes>]

serverdata ID: see also 2. HTTP traffic folder; for each requested page an individual ID is stored so that instead of a long URL only an ID is submitted.

Examples:
141.84.8.77 2005-10-25,11:5:58 2 load size=1280x867
141.84.8.77 2005-10-25,11:6:02 2 mousemove coord=672,7


2. HTTP traffic folder

Every HTTP request is stored to an individually named txt-file (increasing index as suffix).
All HTML-type server responses are stored to the file the respective request was written to.
In addition, for every HTML-type server response a log entry (in log.txt) with the respective individual
index is generated (serverdata log entry).

The individual txt-files are stored under "httpTraffic/log" and are named as follows:
httpTraffic<index>.txt

File httpTraffic.txt (directly under "httpTraffic") contains the current index and should not be altered. You can reset the index to "0" manually by changing the number in httpTraffic.txt - but attention: UsaProxy will start to store traffic to file httpTraffic0.txt (data will be appended in case file already exists)
File logHttpTraffic.txt (also directly under "httpTraffic") contains the information if this kind of HTTP traffic logging should take place. If you don't like to have UsaProxy store the HTTP traffic that is produced, change the value into "false".

