aboutsummaryrefslogtreecommitdiffstats
path: root/extras/README
blob: 8bb98c56cf17a43faa2a5e270510bf74c51958b6 (plain)
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
Configure polkit
----------------

Please copy extras/org.mageia.policykit.pkexec.adminpanel.policy to /usr/share/polkit-1/actions/org.mageia.policykit.pkexec.adminpanel.policy
to make apanel be usable through policykit (mcc is currently using pam, a bit more complicated compared to polkit).

After that you have to make a symbolic link to apanel.pl into /usr/bin/  (i.e. /usr/bin/apanel.pl) and make your local apanel.pl script executable (chmod +x apanel.pl).

This settings will be automatically handled at rpm installation time in future/production.

Configure pam
-------------

1. symlink /usr/bin/consolehelper -> /usr/bin/apanel
2. create /etc/pam.d/apanel and populate it with the code below:
#%PAM-1.0
auth       sufficient   pam_rootok.so
auth       required     pam_console.so
auth       sufficient   pam_timestamp.so
auth       include      system-auth
account    required     pam_permit.so
session    optional     pam_timestamp.so
session    optional     pam_xauth.so

auth    required        pam_succeed_if.so       quiet user != xguest

3. create /etc/security/console.apps/apanel and populate it with the code below:
USER=root
PROGRAM=<absolute/path/to/apanel.pl>

4. authorize apanel to use the display
xhost local:root

5. setup apanel.pl to use consolehelper backend ($USE_CHLP)

Add AdminPanel to the include path (for developers)
---------------------------------------------------

symlink trunk/AdminPanel to /usr/lib/perl5/<currentversion>/AdminPanel
where currentversion could be for example 5.16.2

Additional notes:
1. if you have installed old org.mageia.policykit.pkexec.policy remove it from /usr/share/polkit-1/actions/
2. you can use at your own risk our script from this directory create_link.sh