~ubuntu-branches/ubuntu/hardy/freeradius/hardy-proposed

« back to all changes in this revision

Viewing changes to man/man8/radsqlrelay.8

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2006-12-16 20:45:11 UTC
  • mfrom: (3.1.10 feisty)
  • Revision ID: james.westby@ubuntu.com-20061216204511-3pbbsu4s8jtehsor
Tags: 1.1.3-3
Fix POSIX compliance problem in init script.  Closes: #403384. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH RADSQLRELAY 8 "19 June 2005" "" "FreeRADIUS helper program"
 
2
 
 
3
.SH NAME
 
4
radsqlrelay - relay SQL queries to a central database server
 
5
 
 
6
.SH SYNOPSIS
 
7
.B radsqlrelay
 
8
.RB [ \-d
 
9
.IR sql_driver ]
 
10
.RB [ \-b
 
11
.IR database ]
 
12
.RB [ \-h
 
13
.IR host ]
 
14
.RB [ \-u
 
15
.IR user ]
 
16
.RB [ \-p
 
17
.IR password ]
 
18
.RB [ \-1 ]
 
19
\fIfile_path\fP
 
20
 
 
21
.SH DESCRIPTION
 
22
\fBradsqlrelay\fP tails a SQL \fIlogfile\fP and forwards the queries
 
23
to a database server. Used to replicate accounting records to one
 
24
(central) database, even if the database has extended downtime.
 
25
.PP
 
26
The SQL logfile is created by the \fBrlm_sql_log\fP module. The module
 
27
must be configured in the \fBradiusd\fP server before you can use
 
28
\fBradsqlrelay\fP.
 
29
 
 
30
.SH OPTIONS
 
31
.IP "\-d \fIsql_driver\fP"
 
32
Driver to use: mysql, pg, oracle.
 
33
.IP "\-b \fIdatabase\fP"
 
34
Name of the database to use.
 
35
.IP "\-h \fIhost\fP"
 
36
Connect to host.
 
37
.IP "\-u \fIuser\fP"
 
38
User for login.
 
39
.IP "\-p \fIpassword\fP"
 
40
Password to use when connecting to server.
 
41
.IP "\-1"
 
42
One-shot mode: push the file to database and exit.
 
43
.IP "file_path"
 
44
The pathname of the SQL logfile to use.
 
45
 
 
46
.SH NOTES
 
47
.SS Oracle driver
 
48
The command "radsqlrelay -d oracle -b db.domain.tld sql-relay" reads the
 
49
database description stored in $TNS_ADMIN/tnsnames.ora:
 
50
.PP
 
51
.DS
 
52
db.domain.tld =
 
53
  (DESCRIPTION =
 
54
    (ADDRESS_LIST =
 
55
      (ADDRESS = (PROTOCOL = TCP)(HOST = db.domain.tld)(PORT = 1521))
 
56
    )
 
57
    (CONNECT_DATA =
 
58
      (SERVICE_NAME = <DB SID>)
 
59
    )
 
60
  )
 
61
.DE
 
62
 
 
63
.SH SEE ALSO
 
64
.BR rlm_sql_log (5)
 
65
 
 
66
.SH AUTHOR
 
67
Nicolas Baradakis <nicolas.baradakis@cegetel.net>