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 [|] [|] [transparent|transparentremote|server|remote] with : 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 : IP address of the gateway proxy with : port of the gateway proxy optional if UsaProxy is set up as transparent proxy: with : IP address of the corrensponding webserver with : 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 : IP address of the gateway proxy with : port of the gateway proxy optional: server-side deployment: if UsaProxy is set up as server-side proxy: with : web address of the corresponding webserver (such as www.google.de) with : 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: [] 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.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".