5. Using the proxy recorder
***************************

The recorder has three plugins: for HTTP, WebDAV and for PostgreSQL.

To start it, run **tsung-recorder -p <PLUGIN> start**, where
**PLUGIN** can be *http*, *webdav* or *pgsql* for PostgreSQL. The
default plugin is **http**.

The proxy is listening to port **8090**. You can change the port with
"-L portnumber".

To stop it, use **tsung-recorder stop**.

The recorded session is created as "~/.tsung/tsung_recorderYYYMMDD-
HH:MM.xml"; if it doesn’t work, take a look at "~/.tsung/log/tsung
.log-tsung_recorder@hostname"

During the recording, you can add custom tag in the XML file, this can
be useful to set transactions or comments: **tsung-recorder record_tag
"<transaction name='login'>''**

Once a session has been created, you can insert it in your main
configuration file, either by editing by hand the file, or by using an
ENTITY declaration, like:

   <!DOCTYPE tsung SYSTEM "/usr/share/tsung/tsung-1.0.dtd" [
     <!ENTITY mysession1 SYSTEM "/home/nniclausse/.tsung/tsung_recorder20051217-13:11.xml">
   ]>
   ...
   <sessions>
     &mysession1;
   </sessions>


5.1. PostgreSQL
===============

For PostgreSQL, the proxy will connect to the server at IP 127.0.0.1
and port 5432. Use **-I serverIP** to change the IP and **-P
portnumber** to change the port.


5.2. HTTP and WEBDAV
====================

For HTTPS recording, use **http://-** instead of **https://** in your
browser

**New in 1.2.2**: For HTTP, you can configure the recorder to use a
parent proxy (but this will not work for https). Add the "-u" option
to enable parent proxy, and use **-I serverIP** to set the IP and **-P
portnumber** to set the port of the parent.
