.. index:: proxy
 .. index:: tsung-recorder
 .. _tsung-recorder:
 
 ========================
 Using the proxy recorder
 ========================
 
 The recorder has three plugins: for HTTP, WebDAV and for PostgreSQL.
 
 To start it, run :command:`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
 :option:`-L portnumber`.
 
 To stop it, use :command:`tsung-recorder stop`.
 
 The recorded session is created as
 :file:`~/.tsung/tsung_recorderYYYMMDD-HH:MM.xml`; if it doesn't work,
 take a look at :file:`~/.tsung/log/tsung.log-tsung_recorder@hostname`
 
 .. index:: record_tag
 
 During the recording, you can add custom tag in the XML file, this can
 be useful to set transactions or comments:
 :command:`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:
 
 .. code-block:: xml
 
    <!DOCTYPE tsung SYSTEM "/usr/share/tsung/tsung-1.0.dtd" [
      <!ENTITY mysession1 SYSTEM "/home/nniclausse/.tsung/tsung_recorder20051217-13:11.xml">
    ]>
    ...
    <sessions>
      &mysession1;
    </sessions>
 
 
 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.
 
 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 :option:`-u`
 option to enable parent proxy, and use **-I serverIP** to set the IP and **-P portnumber** to set the port of the parent.