# 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.