import from HEAD
[freeradius.git] / dialup_admin / doc / FAQ
1 > I was wondering if there is any more documentation about howto setup this 
2 > software other than what comes in the README? 
3
4 No, there isn't. It's easier for me to write code than to document it :-)
5 Anyway, I always try to make better documentation.
6 There's also this FAQ :-)
7
8 >
9 > When I try to access some page I see the php code instead of html
10 >
11
12 Make sure that you have configured php to handle files with .php3 extension
13
14
15 > What tables do I need to create in the MySQL database?
16
17 It depends.
18 If you are using ldap for user authentication/information then you only need
19 to create the freeradius sql tables (in order to create the radacct table,
20 the other tables will just sit around doing nothing) which can be created from a
21 sql script in the freeradius distribution. If you are runing mysql it is in
22 src/modules/rlm_sql/drivers/rlm_sql_mysql/db_mysql.sql
23
24 If you are using mysql for user authentication/information then you will again
25 need to create the freeradius sql tables and if you want you could also create
26 the userinfo table to store user information (name,telephone etc)
27
28 You could also create the badusers table if you want the functionality it provides.
29
30 sql scripts to create the badusers and userinfo tables can be found in the
31 directory sql (of dialup_admin distribution).
32
33 >
34 > Some attributes are missing from the user/group edit pages
35 >
36
37 First of all check conf/user_edit.atts and see if the attribute you are interested in is
38 commented out. If it is just enable it by uncommenting it. If the attribute is not
39 included in the file add it. If you use SQL check conf/sql.attrmap. If you use LDAP check
40 ${freeradius_install_dir}/etc/raddb/ldap.attrmap and check if the attribute is included in
41 the attribute mapping. If it is not then add it there also.
42 Everything should work ok after that.
43
44 >
45 > When an attribute contains double (") or single (') quotes something goes wrong.
46 >
47
48 Make sure that magic quotes in PHP are turned off
49
50 >
51 > The Online Users page does not show me anything
52 >
53
54 Check conf/admin.conf and especially the comments about general_finger_type. Make sure that bin/snmpfinger
55 uses the correct snmpwalk command and that it returns the correct results (snmfinger works on cisco access
56 servers). Try commenting out general_finger_type so that the Online Users page will just query the radacct
57 table and not try to do a finger on the NAS.
58
59 > Even though I have uncommented Dialup-Access in user_edits.attrs, when
60 > editing a user, that field is not available.  Is this because in sql.attrmap
61 > I have:
62 >
63 > checkItem     Dialup-Access                   none
64 >
65 > What should the attribute be?
66
67 Dialup-Access is an attribute used by the ldap module. It is not implemented in
68 the sql module, that's why the mapping is set to none.
69 You could set Auth-Type to Reject instead.
70
71 > Why do the personal information fields show multiple
72 > entries for attributes like name, department, etc in the user_admin page?
73 > Is there a way to remove the duplicate fields in the display?
74
75 Set general_prefered_lang to en
76
77
78 >
79 > After I make a few changes in one of the configuration files things only work like they worked before
80 >
81
82 If you are using sessions then remember to use the 'Clear Cache' page after making any changes
83
84 >
85 > It is still not working
86 >
87
88 Check that the register_globals in php.ini is set to on. As of PHP 4.2.0 this is set to off by default. The latest
89 versions of dialup_admin will work even if register_globals is set to off if the php version is > 4.1.0
90 (Thanks to Evren Yurtesen <eyurtese@turkuamk.fi> for the suggestion).
91
92 In latest versions you can also enable sql debug (sql_debug: true) and ldap debug (ldap_debug: true)
93
94 --
95 kkalev