forked from gbtyy/pqchecker
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL
172 lines (115 loc) · 4.78 KB
/
INSTALL
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
This document describes how to install the pqChecker and pqMessenger modules from source files.
It's necessary to have previously installed the software construction tools: gcc, make, JDK, maven.
The installation must be done in order: first pqChecker, optionally then pqMessenger.
Note: The success of this procedure requires a minimum of knowledge about the software construction
on the GNU Linux system (pqchecker) and Java with Maven (pqmessenger).
-------------------------(I)-----------------------------
pqchecker.so shared library for OpneLDAP/pPolicy overlay
Allows checks of passwords content quality
version 2.0.0
---------------------------------------------------------
To build and install pqChecker from sources code:
--------------------------------
1/ Get the OpenLDAP source files
--------------------------------
Building and installing pqChecker require OpenLDAP server source files. You can download them from:
http://www.openldap.org/software/download
for current stable release, or
http://www.openldap.org/software/download/OpenLDAP/openldap-stable
for old stable version.
You can also install the source package of OpenLDAP server if exists. On the Debian for example:
Execute:
apt-get source openldap (without root privileges)
Download source files of server version installed on your target system or,
failing that, the nearest version.
Then unpack the archive file in a location of your choice,
Execute:
cd /tmp
tar xzvf ~/download/openldap-2.4.42.tgz
You obtain a root directory for OpenLDAP server source files
/tmp/openldap-2.4.42/
--------------------------------
2/ Prepare required header files
--------------------------------
The required header files portable.h and slap.h are not included, initially,
in downloaded OpenLDAP's source files. It must be created by executing "configure"
script who's provided in archive of source files.
Execute:
cd /tmp/openldap-2.4.42
./configure && make depend
Note: At least until version 2.4.42 of OpenLDAP, a dependency with the 'Berkeley BDB' header files
was found to complete this step
------------------------------------------------------
3/ Recover and configure the source files of pqChecker
------------------------------------------------------
Unpack pqchecker archive,
Execute:
cd /tmp
tar xzvf ~/download/pqchecker-2.0.0.tar.gz
cd pqchecker-2.0.0/
| Note Git users:
|----------------
| If you've cloned git source repository
| https://github.com/ameddeb/pqcheker.git
| You must launch
| ./adjustdate.bash
| before building pqchecker library because of the non-retention
| of files last modify timestamp by Git.
Then execute
./configure LDAPSRC=/tmp/openldap-2.4.42 \
JAVAHOME=/usr/lib/jvm/default-java \
libdir=/usr/lib/ldap \
PARAMDIR=/etc/ldap/pqchecker
LDAPSRC: OpenLDAP server source files root directory.
JAVAHOME: Java JDK root location.
libdir: location of pqchecker.so installation, must be the module load directory setting
of OpenLDAP server. /usr/lib/ldap is used for Debian compliants systems.
/usr/lib/openldap is used for Redhat compliants systems.
PARAMDIR: location of pqchecker data storage, this location must be writable by system user
who execute OpenLDAP server and, if pqMessenger used, system user who execute it.
Other parameters may be used, ./configure --help for complete list for those parameters.
------------------------------
4/ Build and install pqchecker
------------------------------
Execute:
make
sudo make install
After that, you can see the man page:
Execute:
man pqchecker
----------------------
5/ Uninstall pqchecker
----------------------
Execute:
sudo make uninstall
----------------------------(II)-----------------------------------------
pqmessenger-2.0.0.jar executable Java jar
Allows communication between pqChecker and a JMS-compliant application
version 2.0.0
-------------------------------------------------------------------------
Prerequisites: Active Internet connection.
---------------------
1/ pqMessenger build
---------------------
From the pqchecker folder:
Execute:
cd pqmessenger/
mvn clean package
----------------------
2/ Install pqMessenger
----------------------
Execute:
sudo ./pqmessenger-install.sh
------------------------
3/ Configure pqMessenger
------------------------
Fill in the configuration of the JMS server to use, in the file $PARAMDIR/config.xml
PARAMDIR is the parameter used to build pqChecker (cf. supra).
The 2 parameters to modify:
<Host>127.0.0.1</Host>
<Port>61616</Port>
------------------------
4/ Uninstall pqMessenger
------------------------
Execute:
sudo ./pqmessenger-install.sh --uninstall