File: proxy.rst

package info (click to toggle)
tsung 1.7.0-3.1
  • links: PTS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 4,868 kB
  • sloc: erlang: 25,104; sh: 3,109; perl: 1,023; makefile: 624; python: 372
file content (60 lines) | stat: -rw-r--r-- 1,858 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

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