Changeset 167c050 for server/major


Ignore:
Timestamp:
02/03/2024 10:23:38 PM (7 months ago)
Author:
Thomas Trepl <thomas@…>
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.
Message:

Merge branch 'trunk' into lazarus

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"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    … …  
    9090    <para role="optional">
    9191      <xref linkend="brotli"/>,
    92       <xref linkend="db"/>,
    9392      <xref linkend="doxygen"/>,
    9493      <xref linkend="jansson"/>,
    … …  
    101100      <xref linkend="openldap"/> (<xref linkend="apr-util"/> needs to be
    102101      installed with ldap support),
    103       <xref linkend="rsync"/>, and
     102      <xref linkend="rsync"/>,
     103      &berkeley-db;, and
    104104      <ulink url="https://sourceforge.net/projects/distcache">Distcache</ulink>
    105105    </para>
    106106
    107     <para condition="html" role="usernotes">
    108       Editor Notes: <ulink url="&blfs-wiki;/apache"/>
    109     </para>
    110107  </sect2>
    111108
    … …  
    136133    -e '/AP_TYPES_CONFIG_FILE/s:${rel_sysconfdir}/::' \
    137134    -i configure  &amp;&amp;
     135
     136sed -e '/encoding.h/a # include &lt;libxml/xmlstring.h&gt;' \
     137    -i modules/filters/mod_xml2enc.c  &amp;&amp;
    138138
    139139./configure --enable-authnz-fcgi                              \
    … …  
    184184      <application>apxs</application> utility to use absolute pathnames for
    185185      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.
    186195    </para>
    187196

  • server/major/bind.xml

    refec285 r167c050  
    1 <?xml version="1.0" encoding="ISO-8859-1"?>
     1<?xml version="1.0" encoding="UTF-8"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    … …  
    88  <!ENTITY bind-download-ftp  " ">
    99  <!ENTITY bind-md5sum        "&bind-md5;">
    10   <!ENTITY bind-size          "5.2 MB">
    11   <!ENTITY bind-buildsize     "135 MB (21 MB installed)">
    12   <!ENTITY bind-time          "0.4 SBU (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)">
    1313]>
    1414
    … …  
    109109    <bridgehead renderas="sect4">Optional database backends</bridgehead>
    110110    <para role="optional">
    111       <xref linkend="db"/>,
    112111      <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
    113112      <xref linkend="openldap"/>,
    114       <xref linkend="postgresql"/>, and
    115       <xref linkend="unixodbc"/>
     113      <xref linkend="postgresql"/>,
     114      <xref linkend="unixodbc"/>, and
     115      &berkeley-db;
    116116    </para>
    117117
    … …  
    121121    </para>
    122122
     123    <para condition="html" role="usernotes">
     124      Editor Notes: <ulink url="&blfs-wiki;/bind"/>
     125    </para>
     126
    123127  </sect2>
    124128
    … …  
    135139<screen role="root"><userinput>pip3 install ply</userinput></screen>
    136140-->
     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>
    137148
    138149    <para>
    … …  
    445456A.ROOT-SERVERS.NET.     6D  IN      A       198.41.0.4
    446457A.ROOT-SERVERS.NET.     6D  IN      AAAA    2001:503:ba3e::2:30
    447 B.ROOT-SERVERS.NET.     6D  IN      A       199.9.14.201
    448 B.ROOT-SERVERS.NET.     6D  IN      AAAA    2001:500:200::b
     458B.ROOT-SERVERS.NET.     6D  IN      A       170.247.170.2
     459B.ROOT-SERVERS.NET.     6D  IN      AAAA    2801:1b8:10::b
    449460C.ROOT-SERVERS.NET.     6D  IN      A       192.33.4.12
    450461C.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"?>
    22<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33  "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"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    … …  
    77  <!ENTITY kea-download-http "https://downloads.isc.org/isc/kea/&kea-dhcp-version;/kea-&kea-dhcp-version;.tar.gz">
    88  <!ENTITY kea-download-ftp  " ">
    9   <!ENTITY kea-md5sum        "e01bdc8d68cfaca1cae17b20b26e09b6">
    10   <!ENTITY kea-size          "9.9 MB">
    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)">
    1313  <!ENTITY kea-arm-vers      "&kea-dhcp-version;">
    1414]>
    … …  
    7878    <bridgehead renderas="sect4">Optional</bridgehead>
    7979    <para role="optional">
    80       <xref linkend="mitkrb"/>, for documentation
     80      <xref linkend="mitkrb"/>,
     81      <xref linkend="valgrind"/>; for documentation:
    8182      <xref linkend="doxygen"/>,
    8283      <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>
    8486    </para>
    8587
    … …  
    116118
    117119    <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>
    118134      Install <application>ISC Kea DHCP Server</application> by running
    119135      the following commands:
    … …  
    122138<screen><userinput>./configure --prefix=/usr        \
    123139            --sysconfdir=/etc    \
    124             --docdir=/usr/share/doc/kea-&kea-dhcp-version; \
    125140            --localstatedir=/var \
    126141            --enable-shell       \
    127142            --with-openssl       \
    128             --disable-static &amp;&amp;
     143            --disable-static     \
     144            --docdir=/usr/share/doc/kea-&kea-dhcp-version; &amp;&amp;
    129145make</userinput></screen>
    130146
    131147    <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.
    133154    </para>
    134155
    … …  
    147168
    148169    <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>:
    150185      <application>ISC Kea</application> can store the leases on a
    151186      database. This might be useful in large environments running
    … …  
    155190
    156191    <para>
    157       <parameter>--enable-generate-docs</parameter>:
     192      <option>--enable-generate-docs</option>:
    158193      If documentation is to be rebuilt, add that option. Several
    159194      dependencies must be installed for generating the documentation.
    … …  
    161196
    162197    <para>
    163       <parameter>make -j1 install</parameter>: ISC does not recommend
     198      <command>make -j1 install</command>: ISC does not recommend
    164199      any form of parallel or job server options when doing the install.
    165200    </para>
    … …  
    170205    <title>Configuring ISC Kea DHCP Server</title>
    171206
    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>
    190231
    191232    <para>
    … …  
    206247
    207248      <para>
    208         <filename>/etc/kea/keactrl.conf</filename>,
     249        <phrase revision="sysv">
     250          <filename>/etc/kea/keactrl.conf</filename>,
     251        </phrase>
    209252        <filename>/etc/kea/kea-ctrl-agent.conf</filename>,
    210253        <filename>/etc/kea/kea-dhcp4.conf</filename>,
    211         <filename>/etc/kea/kea-dhcp6.conf</filename> and
     254        <filename>/etc/kea/kea-dhcp6.conf</filename>, and
    212255        <filename>/etc/kea/kea-dhcp-ddns.conf</filename>
    213256      </para>
    214257
    215       <indexterm zone="kea keactrl-config">
     258      <indexterm zone="kea keactrl-config" revision="sysv">
    216259        <primary sortas="e-etc-kea-keactrl.conf">/etc/kea/keactrl.conf</primary>
    217260      </indexterm>
    … …  
    224267        <primary sortas="e-etc-kea-dhcp4.conf">/etc/kea/kea-dhcp4.conf</primary>
    225268      </indexterm>
    226 <!--
     269
    227270      <indexterm zone="kea kea-dhcp6-config">
    228271        <primary sortas="e-etc-kea-dhcp6.conf">/etc/kea/kea-dhcp6.conf</primary>
    229272      </indexterm>
    230 -->
     273
    231274      <indexterm zone="kea kea-dhcp-ddns-config">
    232275        <primary sortas="e-etc-kea-dhcp-ddns.conf">/etc/kea/kea-dhcp-ddns.conf</primary>
    … …  
    234277    </sect3>
    235278
    236     <sect3 id="keactrl-config">
     279    <sect3 id="keactrl-config" revision="sysv">
    237280      <title>Kea Control Configuration</title>
    238281
    … …  
    279322      </itemizedlist>
    280323
    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>
    290337
    291338<screen role="root"><userinput>sed -e "s/^dhcp4=.*/dhcp4=yes/" \
    … …  
    298345    </sect3>
    299346
     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
    300397    <sect3 id="kea-ctrl-agent-config">
    301398      <title>Control Agent Configuration</title>
    … …  
    303400      <para>
    304401        The provided configuration could be used without changes
    305         but in BLFS objects like sockets are stored in
     402        but in BLFS, objects like sockets are stored in
    306403        <filename class="directory">/run</filename>
    307404        rather than in
    … …  
    337434        "output_options": [
    338435          {
    339             "output": "/var/log/kea-ctrl-agent.log"
     436            "output": "/var/log/kea-ctrl-agent.log",
    340437            "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
    341438          }
    … …  
    357454      <para>
    358455        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>:
    362461      </para>
    363462
    … …  
    444543EOF</userinput></screen>
    445544
     545    </sect3>
     546
     547    <sect3 id="kea-dhcp6-config">
     548      <title>IPv6 DHCP Server Configuration</title>
     549
    446550      <para>
    447551        The configuration for IPv6 is similar to the configuration
    … …  
    460564        it gives an IP address to a client. A sample configuration
    461565        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:
    465568      </para>
    466569
    … …  
    541644        </para>
    542645        <para>
    543           In this sample config it is assumed that the DNS server
    544           runs on the same machine as Kea does (accessable via
     646          In this example configuration, it is assumed that the DNS server
     647          runs on the same machine as Kea does (accessible via
    545648          <literal>127.0.0.1</literal>) and that this machine has
    546649          the IP <literal>192.168.56.2</literal>.
    … …  
    566669        </seg>
    567670        <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
    569692        </seg>
    570693        <seg>
    571694          /etc/kea,
    572695          /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
    573700          /var/lib/kea
    574701        </seg>

  • server/major/major.xml

    refec285 r167c050  
    1 <?xml version="1.0" encoding="ISO-8859-1"?>
     1<?xml version="1.0" encoding="UTF-8"?>
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33  "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"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    … …  
    77  <!ENTITY proftpd-download-http "https://github.com/proftpd/proftpd/archive/v&proftpd-version;/proftpd-&proftpd-version;.tar.gz">
    88  <!ENTITY proftpd-download-ftp  " ">
    9   <!ENTITY proftpd-md5sum        "28f84d8f27380956dbb9cf4dcf606b7c">
     9  <!ENTITY proftpd-md5sum        "778cdeeac86e1d26451112bb7d4662af">
    1010  <!ENTITY proftpd-size          "19 MB">
    1111  <!ENTITY proftpd-buildsize     "66 MB">
    12   <!ENTITY proftpd-time          "0.2 SBU">
     12  <!ENTITY proftpd-time          "0.3 SBU">
    1313]>
    1414

  • server/major/vsftpd.xml

    refec285 r167c050  
    1 <?xml version="1.0" encoding="ISO-8859-1"?>
     1<?xml version="1.0" encoding="UTF-8"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
Note: See TracChangeset for help on using the changeset viewer.