~hrvojem/percona-pam-for-mysql/theme-makefile

« back to all changes in this revision

Viewing changes to doc/source/installation.rst

  • Committer: Laurynas Biveinis
  • Date: 2011-11-14 13:59:59 UTC
  • mfrom: (13.1.3 docs)
  • Revision ID: laurynas.biveinis@percona.com-20111114135959-4jxfjsd0yynvlyy6
MergeĀ lp:~stewart/percona-pam-for-mysql/basic-docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
5
5
.. toctree::
6
6
   :hidden:
7
7
 
8
 
Install instructions go here.
 
8
Compiling from Source
 
9
=====================
 
10
 
 
11
You will need both the PAM headers and the MySQL 5.5 headers and corresponding `mysql_config` binary available on your system.
 
12
 
 
13
If you are not using one of the pre-built binary packages, you will need to compile the plugin from source. You can either use a source tarball or the source repository.
 
14
 
 
15
For getting a copy of the latest development bzr tree: ::
 
16
 
 
17
  $ bzr branch lp:percona-pam-for-mysql
 
18
 
 
19
If you are building from bzr, you will need to generate the configure script: ::
 
20
 
 
21
  $ ./bootstrap
 
22
 
 
23
You do not need to run `bootstrap` if you are using a source tarball.
 
24
 
 
25
You then need to build the plugin: ::
 
26
 
 
27
  $ ./configure
 
28
  $ make
 
29
 
 
30
To install, you can simply run (as root or using sudo or similar): ::
 
31
 
 
32
  $ make install
 
33
 
 
34
Installing server-side plugin
 
35
=============================
 
36
 
 
37
The shared library that holds the plugin, auth_pam.so, needs to be stored in the plugindir directory of mysql. You can get this value via the command: ::
 
38
 
 
39
  $ mysql_config --plugindir
 
40
 
 
41
Make sure that after installed, the library has got the appropiate permissions (file execution is required).
 
42
 
 
43
Most packages should do this for you, so this is likely only required with the binary tarballs.
 
44
 
 
45
  In order to load the plugin into the working server, issue the following command: ::
 
46
 
 
47
 mysql> INSTALL PLUGIN auth_pam_server SONAME 'auth_pam.so';
 
48
 
 
49
 
 
50
You can now create a PAM configuration for the MySQL server and create users that are authenticated by PAM.