Changeset 167c050 for server/major
- Timestamp:
- 02/03/2024 10:23:38 PM (7 months ago)
- Branches:
- lazarus
- Children:
- e734f29
- Parents:
- efec285 (diff), 4aa2043 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the(diff)
links above to see all the changes relative to each parent. - Location:
- server/major
- Files:
-
- 7 edited
Legend:
- Unmodified
- Added
- Removed
-
server/major/apache.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ … … 90 90 <para role="optional"> 91 91 <xref linkend="brotli"/>, 92 <xref linkend="db"/>,93 92 <xref linkend="doxygen"/>, 94 93 <xref linkend="jansson"/>, … … 101 100 <xref linkend="openldap"/> (<xref linkend="apr-util"/> needs to be 102 101 installed with ldap support), 103 <xref linkend="rsync"/>, and 102 <xref linkend="rsync"/>, 103 &berkeley-db;, and 104 104 <ulink url="https://sourceforge.net/projects/distcache">Distcache</ulink> 105 105 </para> 106 106 107 <para condition="html" role="usernotes">108 Editor Notes: <ulink url="&blfs-wiki;/apache"/>109 </para>110 107 </sect2> 111 108 … … 136 133 -e '/AP_TYPES_CONFIG_FILE/s:${rel_sysconfdir}/::' \ 137 134 -i configure && 135 136 sed -e '/encoding.h/a # include <libxml/xmlstring.h>' \ 137 -i modules/filters/mod_xml2enc.c && 138 138 139 139 ./configure --enable-authnz-fcgi \ … … 184 184 <application>apxs</application> utility to use absolute pathnames for 185 185 modules, when instructed to do so. 186 </para> 187 188 <para> 189 <command>sed -e '/HTTPD_ROOT/s ...</command>: Fixes some paths. 190 </para> 191 192 <para> 193 <command>sed -e '/encoding.h/a ...</command>; Fix building against 194 libxml-2.12.x. 186 195 </para> 187 196 -
server/major/bind.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ … … 8 8 <!ENTITY bind-download-ftp " "> 9 9 <!ENTITY bind-md5sum "&bind-md5;"> 10 <!ENTITY bind-size "5. 2MB">11 <!ENTITY bind-buildsize "1 35MB (21 MB installed)">12 <!ENTITY bind-time "0. 4SBU (with parallelism=4; about 40 minutes somewhat processor independent, to run the complete test suite)">10 <!ENTITY bind-size "5.3 MB"> 11 <!ENTITY bind-buildsize "126 MB (21 MB installed)"> 12 <!ENTITY bind-time "0.5 SBU (with parallelism=4; about 40 minutes somewhat processor independent, to run the complete test suite)"> 13 13 ]> 14 14 … … 109 109 <bridgehead renderas="sect4">Optional database backends</bridgehead> 110 110 <para role="optional"> 111 <xref linkend="db"/>,112 111 <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>, 113 112 <xref linkend="openldap"/>, 114 <xref linkend="postgresql"/>, and 115 <xref linkend="unixodbc"/> 113 <xref linkend="postgresql"/>, 114 <xref linkend="unixodbc"/>, and 115 &berkeley-db; 116 116 </para> 117 117 … … 121 121 </para> 122 122 123 <para condition="html" role="usernotes"> 124 Editor Notes: <ulink url="&blfs-wiki;/bind"/> 125 </para> 126 123 127 </sect2> 124 128 … … 135 139 <screen role="root"><userinput>pip3 install ply</userinput></screen> 136 140 --> 141 142 <note> 143 <para> 144 Starting with bind-9.18.20, the IP addresses for B.ROOT-SERVERS.NET 145 have changed. 146 </para> 147 </note> 137 148 138 149 <para> … … 445 456 A.ROOT-SERVERS.NET. 6D IN A 198.41.0.4 446 457 A.ROOT-SERVERS.NET. 6D IN AAAA 2001:503:ba3e::2:30 447 B.ROOT-SERVERS.NET. 6D IN A 1 99.9.14.201448 B.ROOT-SERVERS.NET. 6D IN AAAA 2 001:500:200::b458 B.ROOT-SERVERS.NET. 6D IN A 170.247.170.2 459 B.ROOT-SERVERS.NET. 6D IN AAAA 2801:1b8:10::b 449 460 C.ROOT-SERVERS.NET. 6D IN A 192.33.4.12 450 461 C.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2::c -
server/major/kea-kernel.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -
server/major/kea.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ … … 7 7 <!ENTITY kea-download-http "https://downloads.isc.org/isc/kea/&kea-dhcp-version;/kea-&kea-dhcp-version;.tar.gz"> 8 8 <!ENTITY kea-download-ftp " "> 9 <!ENTITY kea-md5sum " e01bdc8d68cfaca1cae17b20b26e09b6">10 <!ENTITY kea-size " 9.9MB">11 <!ENTITY kea-buildsize "1. 1 GB">12 <!ENTITY kea-time " 14 SBU"><!-- Thats unexpectedly long -->9 <!ENTITY kea-md5sum "ad23d02b3ce0475eb077da05b0ae2429"> 10 <!ENTITY kea-size "10 MB"> 11 <!ENTITY kea-buildsize "1.5 GB (332 MB installed; add 4 GB for tests)"> 12 <!ENTITY kea-time "4.1 SBU (with parallelism=4; add 12 SBU for tests)"> 13 13 <!ENTITY kea-arm-vers "&kea-dhcp-version;"> 14 14 ]> … … 78 78 <bridgehead renderas="sect4">Optional</bridgehead> 79 79 <para role="optional"> 80 <xref linkend="mitkrb"/>, for documentation 80 <xref linkend="mitkrb"/>, 81 <xref linkend="valgrind"/>; for documentation: 81 82 <xref linkend="doxygen"/>, 82 83 <xref linkend="graphviz"/>, and 83 <xref linkend="sphinx_rtd_theme"/> 84 <xref linkend="sphinx_rtd_theme"/>; for tests: 85 <ulink url="https://google.github.io/googletest/">GoogleTest</ulink> 84 86 </para> 85 87 … … 116 118 117 119 <para> 120 First fix detection of Python-3.12 by the build system: 121 </para> 122 123 <screen><userinput>sed -e 's/:3/:4/' \ 124 -i configure</userinput></screen> 125 126 <para> 127 Remove one installation step that uses an obsolete python module: 128 </para> 129 130 <screen><userinput>sed -e '/dlist="/d' \ 131 -i src/bin/shell/Makefile.in</userinput></screen> 132 133 <para> 118 134 Install <application>ISC Kea DHCP Server</application> by running 119 135 the following commands: … … 122 138 <screen><userinput>./configure --prefix=/usr \ 123 139 --sysconfdir=/etc \ 124 --docdir=/usr/share/doc/kea-&kea-dhcp-version; \125 140 --localstatedir=/var \ 126 141 --enable-shell \ 127 142 --with-openssl \ 128 --disable-static && 143 --disable-static \ 144 --docdir=/usr/share/doc/kea-&kea-dhcp-version; && 129 145 make</userinput></screen> 130 146 131 147 <para> 132 To test the results, issue: <command>make check</command>. 148 To test the results, you must have installed GoogleTest and kept 149 its source. You should also have passed 150 <option>--with-gtest-source=/path/to/googletest/sourcedir</option> to 151 <command>configure</command> above. Run the tests with 152 <command>make check</command>. Three tests in the TLSTest suite are 153 known to fail. 133 154 </para> 134 155 … … 147 168 148 169 <para> 149 <parameter>--with-pgsql</parameter> or <parameter>--with-mysql</parameter>: 170 <parameter>--enable-shell</parameter>: Allows building 171 <command>kea-shell</command>, a command line interface for 172 the control agent. 173 </para> 174 175 <para> 176 <parameter>--with-openssl</parameter>: Allows using OpenSSL for 177 communicating with the control-agent and for DNS updates. 178 </para> 179 180 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 181 href="../../xincludes/static-libraries.xml"/> 182 183 <para> 184 <option>--with-pgsql</option> or <option>--with-mysql</option>: 150 185 <application>ISC Kea</application> can store the leases on a 151 186 database. This might be useful in large environments running … … 155 190 156 191 <para> 157 < parameter>--enable-generate-docs</parameter>:192 <option>--enable-generate-docs</option>: 158 193 If documentation is to be rebuilt, add that option. Several 159 194 dependencies must be installed for generating the documentation. … … 161 196 162 197 <para> 163 < parameter>make -j1 install</parameter>: ISC does not recommend198 <command>make -j1 install</command>: ISC does not recommend 164 199 any form of parallel or job server options when doing the install. 165 200 </para> … … 170 205 <title>Configuring ISC Kea DHCP Server</title> 171 206 172 <para>The support of IPv4, IPv6 and DDNS has been split into 173 separate servers which runs independently from each other. Each 174 of them has its own configuration file. Additional configuration 175 files come from the keactrl agent which is uses to control the 176 servers in an easy way.</para> 177 178 <para>Consult the 179 <ulink url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/">Kea Administrator Reference Manual</ulink> 180 for detailed information about the configuration of <application>ISC Kea</application> 181 as it is a quite capable system. The configuration shown a bare 182 minimum to get a DHCP server running but it already includes 183 configuration for DDNS (Dynamic DNS). That setup might be working 184 for small networks with a few clients and low traffic. For greater 185 installations with thousands of clients, <application>ISC Kea</application> 186 can be configured to use databases (mariadb or postgresql) to store 187 the leases and build a cluster with multiple nodes. It can 188 be integrated to <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink> 189 which is a management dashboard to <application>ISC Kea</application>.</para> 207 <para> 208 The support of IPv4, IPv6 and DDNS has been split into 209 separate servers which runs independently from each other. Each 210 of them has its own configuration file.<phrase revision="sysv"> 211 Additional configuration files come from the keactrl agent which 212 is used to control the servers in an easy way.</phrase> 213 </para> 214 215 <para> 216 Consult the <ulink 217 url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/"> 218 Kea Administrator Reference Manual</ulink> 219 for detailed information about the configuration of 220 <application>ISC Kea</application> as it is a quite capable system. 221 The configuration shown below is a bare minimum to get a DHCP server 222 running but it already includes configuration for DDNS (Dynamic DNS). 223 That setup might be working for small networks with a few clients and 224 low traffic. For greater installations with thousands of clients, 225 <application>ISC Kea</application> can be configured to use databases 226 (mariadb or postgresql) to store the leases and build a cluster with 227 multiple nodes. It can be integrated to 228 <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink> 229 which is a management dashboard to <application>ISC Kea</application>. 230 </para> 190 231 191 232 <para> … … 206 247 207 248 <para> 208 <filename>/etc/kea/keactrl.conf</filename>, 249 <phrase revision="sysv"> 250 <filename>/etc/kea/keactrl.conf</filename>, 251 </phrase> 209 252 <filename>/etc/kea/kea-ctrl-agent.conf</filename>, 210 253 <filename>/etc/kea/kea-dhcp4.conf</filename>, 211 <filename>/etc/kea/kea-dhcp6.conf</filename> and254 <filename>/etc/kea/kea-dhcp6.conf</filename>, and 212 255 <filename>/etc/kea/kea-dhcp-ddns.conf</filename> 213 256 </para> 214 257 215 <indexterm zone="kea keactrl-config" >258 <indexterm zone="kea keactrl-config" revision="sysv"> 216 259 <primary sortas="e-etc-kea-keactrl.conf">/etc/kea/keactrl.conf</primary> 217 260 </indexterm> … … 224 267 <primary sortas="e-etc-kea-dhcp4.conf">/etc/kea/kea-dhcp4.conf</primary> 225 268 </indexterm> 226 <!-- 269 227 270 <indexterm zone="kea kea-dhcp6-config"> 228 271 <primary sortas="e-etc-kea-dhcp6.conf">/etc/kea/kea-dhcp6.conf</primary> 229 272 </indexterm> 230 --> 273 231 274 <indexterm zone="kea kea-dhcp-ddns-config"> 232 275 <primary sortas="e-etc-kea-dhcp-ddns.conf">/etc/kea/kea-dhcp-ddns.conf</primary> … … 234 277 </sect3> 235 278 236 <sect3 id="keactrl-config" >279 <sect3 id="keactrl-config" revision="sysv"> 237 280 <title>Kea Control Configuration</title> 238 281 … … 279 322 </itemizedlist> 280 323 281 <para>The Netconf service is not installed because required 282 dependencies are not covered by the current BLFS book.</para> 283 284 <para>With the following command, Kea will be configured to 285 start the dhcp service for IPv4 and the 286 dynamic DNS update, while the control agent and 287 the dhcp service for IPv6 remains down. Tweak the command to 288 match your needs on started services and execute as the 289 <systemitem class="username">root</systemitem> user:</para> 324 <para> 325 The Netconf service is not installed because required 326 dependencies are not covered by the current BLFS book. 327 . </para> 328 329 <para> 330 With the following command, Kea will be configured to 331 start the dhcp service for IPv4 and the 332 dynamic DNS update, while the control agent and 333 the dhcp service for IPv6 remain down. Tweak the command to 334 match your needs on started services and execute as the 335 &root; user: 336 </para> 290 337 291 338 <screen role="root"><userinput>sed -e "s/^dhcp4=.*/dhcp4=yes/" \ … … 298 345 </sect3> 299 346 347 <sect3 id="kea-sysd-config" revision="systemd"> 348 <title>Kea Configuration Using Systemd Units</title> 349 350 <para> 351 Four service units are used to start various daemons 352 provided by Kea: 353 </para> 354 355 <itemizedlist> 356 <listitem> 357 <para>Control Agent</para> 358 <para> 359 The Control Agent is a daemon which allows the 360 (re)configuration of the Kea DHCP service via REST API. 361 Run <command>systemctl enable kea-ctrl-agent</command> 362 if this daemon is needed. 363 </para> 364 </listitem> 365 <listitem> 366 <para>IPv4 DHCP server</para> 367 <para> 368 This daemon handles requests for IPv4 addresses. 369 Run <command>systemctl enable kea-dhcp4-server</command> to 370 have it started by systemd. 371 </para> 372 </listitem> 373 <listitem> 374 <para>IPv6 DHCP server</para> 375 <para> 376 This daemon handles requests for IPv6 addresses. 377 Run <command>systemctl enable kea-dhcp6-server</command> to 378 have it started by systemd. 379 </para> 380 </listitem> 381 <listitem> 382 <para>Dynamic DNS</para> 383 <para> 384 This daemon is used to update a DNS server dynamically 385 when Kea assigns an IP address to a device. 386 Run <command>systemctl enable kea-ddns-server</command> to 387 have it started by systemd. 388 </para> 389 </listitem> 390 </itemizedlist> 391 392 <para>The Netconf service is not installed because required 393 dependencies are not covered by the current BLFS book.</para> 394 395 </sect3> 396 300 397 <sect3 id="kea-ctrl-agent-config"> 301 398 <title>Control Agent Configuration</title> … … 303 400 <para> 304 401 The provided configuration could be used without changes 305 but in BLFS objects like sockets are stored in402 but in BLFS, objects like sockets are stored in 306 403 <filename class="directory">/run</filename> 307 404 rather than in … … 337 434 "output_options": [ 338 435 { 339 "output": "/var/log/kea-ctrl-agent.log" 436 "output": "/var/log/kea-ctrl-agent.log", 340 437 "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n" 341 438 } … … 357 454 <para> 358 455 A sample configuration file is created in <filename>/etc/kea/kea-dhcp4.conf</filename>. 359 Adjust the file to suit your needs or overwrite it by using 360 the following sample as the <systemitem class="username">root</systemitem> 361 user: 456 Adjust the file to suit your needs or overwrite it by running 457 the following command as the &root; user (you'll need to edit this 458 file anyway: at least the <emphasis>interfaces</emphasis> field, 459 the <emphasis>ddns-qualifying-suffix</emphasis> field, and almost 460 all the fields in <emphasis>Subnet4</emphasis>: 362 461 </para> 363 462 … … 444 543 EOF</userinput></screen> 445 544 545 </sect3> 546 547 <sect3 id="kea-dhcp6-config"> 548 <title>IPv6 DHCP Server Configuration</title> 549 446 550 <para> 447 551 The configuration for IPv6 is similar to the configuration … … 460 564 it gives an IP address to a client. A sample configuration 461 565 file is created in <filename>/etc/kea/kea-dhcp-ddns.conf</filename>. 462 Adjust the file to suit your needs or overwrite it by using 463 the following sample as the <systemitem class="username">root</systemitem> 464 user: 566 Adjust the file to suit your needs or overwrite it by running 567 the following command as the &root; user: 465 568 </para> 466 569 … … 541 644 </para> 542 645 <para> 543 In this sample configit is assumed that the DNS server544 runs on the same machine as Kea does (access able via646 In this example configuration, it is assumed that the DNS server 647 runs on the same machine as Kea does (accessible via 545 648 <literal>127.0.0.1</literal>) and that this machine has 546 649 the IP <literal>192.168.56.2</literal>. … … 566 669 </seg> 567 670 <seg> 568 libkea-* 671 libkea-asiodns.so, 672 libkea-asiolink.so, 673 libkea-cc.so, 674 libkea-cgfclient.so, 675 libkea-cryptolink.so, 676 libkea-d2srv.so, 677 libkea-database.so, 678 libkea-dhcp_ddns.so, 679 libkea-dhcp++.so, 680 libkea-dhcpsrv.so, 681 libkea-dns++.so, 682 libkea-eval.so, 683 libkea-exceptions.so, 684 libkea-hooks.so, 685 libkea-http.so, 686 libkea-log.so, 687 libkea-process.so, 688 libkea-stats.so, 689 libkea-tcp.so, 690 libkea-util.so, and 691 libkea-util-io.so 569 692 </seg> 570 693 <seg> 571 694 /etc/kea, 572 695 /usr/include/kea, 696 /usr/lib/kea, 697 /usr/lib/python&python3-majorver;/site-packages/kea, 698 /usr/share/kea, 699 /usr/share/doc/kea-&kea-dhcp-version;, and 573 700 /var/lib/kea 574 701 </seg> -
server/major/major.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -
server/major/proftpd.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ … … 7 7 <!ENTITY proftpd-download-http "https://github.com/proftpd/proftpd/archive/v&proftpd-version;/proftpd-&proftpd-version;.tar.gz"> 8 8 <!ENTITY proftpd-download-ftp " "> 9 <!ENTITY proftpd-md5sum " 28f84d8f27380956dbb9cf4dcf606b7c">9 <!ENTITY proftpd-md5sum "778cdeeac86e1d26451112bb7d4662af"> 10 10 <!ENTITY proftpd-size "19 MB"> 11 11 <!ENTITY proftpd-buildsize "66 MB"> 12 <!ENTITY proftpd-time "0. 2SBU">12 <!ENTITY proftpd-time "0.3 SBU"> 13 13 ]> 14 14 -
server/major/vsftpd.xml
refec285 r167c050 1 <?xml version="1.0" encoding=" ISO-8859-1"?>1 <?xml version="1.0" encoding="UTF-8"?> 2 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 3 3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
Note:
See TracChangeset
for help on using the changeset viewer.