installdeb.html 11.4 KB
Newer Older
Clément OUDOT's avatar
Clément OUDOT committed
1 2 3 4 5 6
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
  <meta charset="utf-8" />
  <title>documentation:2.0:installdeb</title>
<meta name="generator" content="DokuWiki"/>
Xavier Guimard's avatar
Xavier Guimard committed
7
<meta name="robots" content="noindex,nofollow"/>
Clément OUDOT's avatar
Clément OUDOT committed
8 9 10 11 12
<meta name="keywords" content="documentation,2.0,installdeb"/>
<link rel="search" type="application/opensearchdescription+xml" href="lib/exe/opensearch.html" title="LemonLDAP::NG"/>
<link rel="start" href="installdeb.html"/>
<link rel="contents" href="installdeb.html" title="Sitemap"/>
<link rel="stylesheet" type="text/css" href="lib/exe/css.php.t.bootstrap3.css"/>
Xavier Guimard's avatar
Xavier Guimard committed
13 14 15 16 17 18 19 20 21
<!-- //if:usedebianlibs
  <link rel="stylesheet" type="text/css" href="/javascript/bootstrap/css/bootstrap.min.css" />
//elsif:useexternallibs
  <link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"></script>
//elsif:cssminified
  <link rel="stylesheet" type="text/css" href="/static/bwr/bootstrap/dist/css/bootstrap.min.css" />
//else -->
  <link rel="stylesheet" type="text/css" href="/static/bwr/bootstrap/dist/css/bootstrap.css" />
<!-- //endif -->
Clément OUDOT's avatar
Clément OUDOT committed
22 23 24
<script type="text/javascript">/*<![CDATA[*/var NS='documentation:2.0';var JSINFO = {"id":"documentation:2.0:installdeb","namespace":"documentation:2.0"};
/*!]]>*/</script>
<script type="text/javascript" charset="utf-8" src="lib/exe/js.php.t.bootstrap3.js"></script>
Xavier Guimard's avatar
Xavier Guimard committed
25 26 27 28 29 30 31 32 33 34 35 36 37 38
<!-- //if:usedebianlibs
<script type="text/javascript" src="/javascript/jquery/jquery.min.js"></script>
//elsif:useexternallibs
<script type="text/javascript" src="http://code.jquery.com/jquery-2.2.0.min.js"></script>
//elsif:jsminified
<script type="text/javascript" src="/static/bwr/jquery/dist/jquery.min.js"></script>
//else -->
<script type="text/javascript" src="/static/bwr/jquery/dist/jquery.js"></script>
<!-- //endif -->
<!-- //if:usedebianlibs
  <script type="text/javascript" src="/javascript/jquery-ui/jquery-ui.min.js"></script>
//elsif:useexternallibs
  <script type="text/javascript" src="http://code.jquery.com/ui/1.10.4/jquery-ui.min.js"></script>
//elsif:jsminified
Xavier Guimard's avatar
Xavier Guimard committed
39
  <script type="text/javascript" src="/static/bwr/jquery-ui/jquery-ui.min.js"></script>
Xavier Guimard's avatar
Xavier Guimard committed
40
//else -->
Xavier Guimard's avatar
Xavier Guimard committed
41
  <script type="text/javascript" src="/static/bwr/jquery-ui/jquery-ui.js"></script>
Xavier Guimard's avatar
Xavier Guimard committed
42
<!-- //endif -->
Clément OUDOT's avatar
Clément OUDOT committed
43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
</head>
<body>
<div class="dokuwiki export container">
<!-- TOC START -->
<div id="dw__toc">
<h3 class="toggle">Table of Contents</h3>
<div>

<ul class="toc">
<li class="level1"><div class="li"><a href="#organization">Organization</a></div></li>
<li class="level1"><div class="li"><a href="#get_the_packages">Get the packages</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="#official_repository">Official repository</a></div></li>
<li class="level2"><div class="li"><a href="#llng_repository">LL::NG repository</a></div></li>
<li class="level2"><div class="li"><a href="#manual_download">Manual download</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="#package_gpg_signature">Package GPG signature</a></div></li>
<li class="level1"><div class="li"><a href="#install_packages">Install packages</a></div>
<ul class="toc">
Xavier Guimard's avatar
Xavier Guimard committed
63
<li class="level2"><div class="li"><a href="#with_apt">With apt</a></div></li>
Clément OUDOT's avatar
Clément OUDOT committed
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
<li class="level2"><div class="li"><a href="#with_dpkg">With dpkg</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="#first_configuration_steps">First configuration steps</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="#change_default_dns_domain">Change default DNS domain</a></div></li>
<li class="level2"><div class="li"><a href="#upgrade">Upgrade</a></div></li>
<li class="level2"><div class="li"><a href="#dns">DNS</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="#file_location">File location</a></div></li>
<li class="level1"><div class="li"><a href="#build_your_packages">Build your packages</a></div></li>
</ul>
</div>
</div>
<!-- TOC END -->

<h1 class="sectionedit1" id="installation_on_debianubuntu_with_packages">Installation on Debian/Ubuntu with packages</h1>
<div class="level1">

</div>
<!-- EDIT1 SECTION "Installation on Debian/Ubuntu with packages" [1-59] -->
<h2 class="sectionedit2" id="organization">Organization</h2>
<div class="level2">

<p>
LemonLDAP::NG provides these packages:
</p>
<ul>
Xavier Guimard's avatar
Xavier Guimard committed
93
<li class="level1"><div class="li"> lemonldap-ng: metapackage, contains no file but dependencies on other packages</div>
Clément OUDOT's avatar
Clément OUDOT committed
94 95 96 97 98
</li>
<li class="level1"><div class="li"> lemonldap-ng-doc: contains <abbr title="HyperText Markup Language">HTML</abbr> documentation and project docs (README, etc.)</div>
</li>
<li class="level1"><div class="li"> lemonldap-ng-fastcgi-server: <abbr title="LemonLDAP::NG">LL::NG</abbr> FastCGI server (for Nginx)</div>
</li>
Clément OUDOT's avatar
Clément OUDOT committed
99 100
<li class="level1"><div class="li"> lemonldap-ng-handler: Handler files</div>
</li>
Clément OUDOT's avatar
Clément OUDOT committed
101 102
<li class="level1"><div class="li"> liblemonldap-ng-common-perl: configuration and common files</div>
</li>
Clément OUDOT's avatar
Clément OUDOT committed
103
<li class="level1"><div class="li"> liblemonldap-ng-handler-perl: Handler common libraries</div>
Clément OUDOT's avatar
Clément OUDOT committed
104 105 106 107 108 109 110 111
</li>
<li class="level1"><div class="li"> liblemonldap-ng-manager-perl: Manager files</div>
</li>
<li class="level1"><div class="li"> liblemonldap-ng-portal-perl: Portal files</div>
</li>
</ul>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
112
<!-- EDIT2 SECTION "Organization" [60-614] -->
Clément OUDOT's avatar
Clément OUDOT committed
113 114 115 116
<h2 class="sectionedit3" id="get_the_packages">Get the packages</h2>
<div class="level2">

</div>
Xavier Guimard's avatar
Xavier Guimard committed
117
<!-- EDIT3 SECTION "Get the packages" [615-644] -->
Clément OUDOT's avatar
Clément OUDOT committed
118 119 120 121 122 123 124 125 126 127
<h3 class="sectionedit4" id="official_repository">Official repository</h3>
<div class="level3">

<p>
If you run Debian testing or unstable, the packages are directly installable:
</p>
<pre class="code">apt-cache search lemonldap-ng</pre>
<div class="noteimportant">Packages from <a href="http://packages.debian.org/search?keywords=lemonldap-ng" class="urlextern" title="http://packages.debian.org/search?keywords=lemonldap-ng"  rel="nofollow">Debian repository</a> may not be up to date. Prefer then the other solutions (see below).
</div>
</div>
Xavier Guimard's avatar
Xavier Guimard committed
128
<!-- EDIT4 SECTION "Official repository" [645-983] -->
Clément OUDOT's avatar
Clément OUDOT committed
129 130 131 132 133 134 135 136
<h3 class="sectionedit5" id="llng_repository">LL::NG repository</h3>
<div class="level3">

<p>
You can add this repository to have recent packages:
</p>
<pre class="code">vi /etc/apt/sources.list.d/lemonldap-ng.list</pre>
<pre class="file"># LemonLDAP::NG repository
Clément OUDOT's avatar
Clément OUDOT committed
137 138 139 140 141 142 143 144 145 146
deb     https://lemonldap-ng.org/deb stable main
deb-src https://lemonldap-ng.org/deb stable main</pre>
<div class="notetip"><ul>
<li class="level1"><div class="li"> Use the <code>oldstable</code> repository to get packages from previous major version</div>
</li>
<li class="level1"><div class="li"> Use the <code>testing</code> repository to get packages from next major version</div>
</li>
<li class="level1"><div class="li"> Use the <code>2.0</code> repository to avoid upgrade to next major version</div>
</li>
</ul>
Clément OUDOT's avatar
Clément OUDOT committed
147 148 149

</div>
<p>
Xavier Guimard's avatar
Xavier Guimard committed
150
You may need to install this package to access HTTPS repositories:
Clément OUDOT's avatar
Clément OUDOT committed
151
</p>
Xavier Guimard's avatar
Xavier Guimard committed
152
<pre class="code">apt install apt-transport-https</pre>
Clément OUDOT's avatar
Clément OUDOT committed
153 154

</div>
Xavier Guimard's avatar
Xavier Guimard committed
155
<!-- EDIT5 SECTION "LL::NG repository" [984-1628] -->
Clément OUDOT's avatar
Clément OUDOT committed
156 157 158 159 160 161 162 163
<h3 class="sectionedit6" id="manual_download">Manual download</h3>
<div class="level3">

<p>
Packages are available on the <a href="download.html" class="wikilink1" title="download">Download page</a>.
</p>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
164
<!-- EDIT6 SECTION "Manual download" [1629-1715] -->
Clément OUDOT's avatar
Clément OUDOT committed
165 166 167 168 169 170 171 172 173 174
<h2 class="sectionedit7" id="package_gpg_signature">Package GPG signature</h2>
<div class="level2">

<p>
The GPG key can be downloaded here: <a href="rpm-gpg-key-ow2" class="media mediafile mf_" title="rpm-gpg-key-ow2 (1.7 KB)">rpm-gpg-key-ow2</a>
</p>

<p>
Install it to trust packages:
</p>
Xavier Guimard's avatar
Xavier Guimard committed
175 176 177 178 179 180
<pre class="code">wget -O - https://lemonldap-ng.org/_media/rpm-gpg-key-ow2 | apt-key add -</pre>

<p>
Update cache:
</p>
<pre class="code">apt update</pre>
Clément OUDOT's avatar
Clément OUDOT committed
181 182

</div>
Xavier Guimard's avatar
Xavier Guimard committed
183
<!-- EDIT7 SECTION "Package GPG signature" [1716-1970] -->
Clément OUDOT's avatar
Clément OUDOT committed
184 185 186 187
<h2 class="sectionedit8" id="install_packages">Install packages</h2>
<div class="level2">

</div>
Xavier Guimard's avatar
Xavier Guimard committed
188
<!-- EDIT8 SECTION "Install packages" [1971-2000] -->
Xavier Guimard's avatar
Xavier Guimard committed
189
<h3 class="sectionedit9" id="with_apt">With apt</h3>
Clément OUDOT's avatar
Clément OUDOT committed
190
<div class="level3">
Xavier Guimard's avatar
Xavier Guimard committed
191
<pre class="code">apt install lemonldap-ng</pre>
Clément OUDOT's avatar
Clément OUDOT committed
192 193

</div>
Xavier Guimard's avatar
Xavier Guimard committed
194
<!-- EDIT9 SECTION "With apt" [2001-2061] -->
Clément OUDOT's avatar
Clément OUDOT committed
195 196 197 198 199 200 201 202 203 204 205 206 207
<h3 class="sectionedit10" id="with_dpkg">With dpkg</h3>
<div class="level3">

<p>
Before installing the packages, install <a href="prereq.html" class="wikilink1" title="documentation:2.0:prereq">dependencies</a>.
</p>

<p>
Then:
</p>
<pre class="code">dpkg -i liblemonldap-ng-* lemonldap-ng*</pre>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
208
<!-- EDIT10 SECTION "With dpkg" [2062-2210] -->
Clément OUDOT's avatar
Clément OUDOT committed
209 210 211 212
<h2 class="sectionedit11" id="first_configuration_steps">First configuration steps</h2>
<div class="level2">

</div>
Xavier Guimard's avatar
Xavier Guimard committed
213
<!-- EDIT11 SECTION "First configuration steps" [2211-2249] -->
Clément OUDOT's avatar
Clément OUDOT committed
214 215 216 217 218 219
<h3 class="sectionedit12" id="change_default_dns_domain">Change default DNS domain</h3>
<div class="level3">

<p>
By default, <abbr title="Domain Name System">DNS</abbr> domain is <code>example.com</code>. You can change it quick with a sed command. For example, we change it to <code>ow2.org</code>:
</p>
Clément OUDOT's avatar
Clément OUDOT committed
220
<pre class="code shell">sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/* /var/lib/lemonldap-ng/conf/lmConf-1.json /var/lib/lemonldap-ng/test/index.pl</pre>
Clément OUDOT's avatar
Clément OUDOT committed
221 222

</div>
Xavier Guimard's avatar
Xavier Guimard committed
223
<!-- EDIT12 SECTION "Change default DNS domain" [2250-2569] -->
Xavier Guimard's avatar
Xavier Guimard committed
224
<h3 class="sectionedit13" id="upgrade">Upgrade</h3>
Clément OUDOT's avatar
Clément OUDOT committed
225 226 227 228 229 230 231
<div class="level3">

<p>
If you upgraded <abbr title="LemonLDAP::NG">LL::NG</abbr>, check all <a href="upgrade.html" class="wikilink1" title="documentation:2.0:upgrade">upgrade notes</a>.
</p>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
232 233
<!-- EDIT13 SECTION "Upgrade" [2570-2650] -->
<h3 class="sectionedit14" id="dns">DNS</h3>
Clément OUDOT's avatar
Clément OUDOT committed
234 235 236
<div class="level3">

<p>
Xavier Guimard's avatar
Xavier Guimard committed
237
Configure your <abbr title="Domain Name System">DNS</abbr> server to resolve names with your server <abbr title="Internet Protocol">IP</abbr>:
Clément OUDOT's avatar
Clément OUDOT committed
238
</p>
Xavier Guimard's avatar
Xavier Guimard committed
239 240 241 242 243 244 245 246
<ul>
<li class="level1"><div class="li"> auth.&lt;your domain&gt;: main portal, must be public</div>
</li>
<li class="level1"><div class="li"> manager.&lt;your domain&gt;: manager, only for adminsitrators</div>
</li>
<li class="level1"><div class="li"> test1.&lt;your domain&gt;, test2.&lt;your domain&gt;: sample applications</div>
</li>
</ul>
Clément OUDOT's avatar
Clément OUDOT committed
247 248 249 250 251 252

<p>
Follow the <a href="start.html#configuration" class="wikilink1" title="documentation:2.0:start">next steps</a>
</p>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
253 254
<!-- EDIT14 SECTION "DNS" [2651-2955] -->
<h2 class="sectionedit15" id="file_location">File location</h2>
Clément OUDOT's avatar
Clément OUDOT committed
255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273
<div class="level2">
<ul>
<li class="level1"><div class="li"> Configuration is in /etc/lemonldap-ng</div>
</li>
<li class="level1"><div class="li"> LemonLDAP::NG configuration (edited by the Manager) is in /var/lib/lemonldap-ng/conf/</div>
</li>
<li class="level1"><div class="li"> All Perl modules are in the VENDOR perl directory (/usr/share/perl5/)</div>
</li>
<li class="level1"><div class="li"> All Perl scripts/pages are in /var/lib/lemonldap-ng/</div>
</li>
<li class="level1"><div class="li"> All lemonldap-ng tools are in /usr/share/lemonldap-ng/bin/</div>
</li>
<li class="level1"><div class="li"> All static content (examples, <abbr title="Cascading Style Sheets">CSS</abbr>, images, etc.) is in /usr/share/lemonldap-ng/</div>
</li>
<li class="level1"><div class="li"> Apache configuration files are in /etc/lemonldap-ng and linked in /etc/apache2/sites-available</div>
</li>
</ul>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
274 275
<!-- EDIT15 SECTION "File location" [2956-3492] -->
<h2 class="sectionedit16" id="build_your_packages">Build your packages</h2>
Clément OUDOT's avatar
Clément OUDOT committed
276 277 278 279 280 281 282 283 284 285
<div class="level2">

<p>
You can also get the <a href="download.html" class="wikilink1" title="download">LemonLDAP::NG archive</a> and make the package yourself:
</p>
<pre class="code">tar xzf lemonldap-ng-*.tar.gz
cd lemonldap-ng-*
make debian-packages</pre>

</div>
Xavier Guimard's avatar
Xavier Guimard committed
286
<!-- EDIT16 SECTION "Build your packages" [3493-] --></div>
Clément OUDOT's avatar
Clément OUDOT committed
287 288
</body>
</html>