Changeset 0d3cd5d


Ignore:
Timestamp:
06/12/2023 09:49:19 AM (12 months ago)
Author:
Thomas Trepl <thomas@…>
Branches:
12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal
Children:
baf6d5a0
Parents:
930d002c
Message:

Update dependencies, reformat config files

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/connect/kea.xml

    r930d002c r0d3cd5d  
    7373    <bridgehead renderas="sect4">Required</bridgehead>
    7474    <para role="required">
     75      <xref linkend="boost"/>,
    7576      <xref linkend="log4cplus"/>
     77    </para>
     78
     79    <bridgehead renderas="sect4">Optional</bridgehead>
     80    <para role="optional">
     81      <xref linkend="doxygen"/>,
     82      <xref linkend="graphviz"/>,
     83      <xref linkend="mitkrb"/>,
     84      <xref linkend="sphinx_rtd_theme"/>
     85    </para>
     86
     87    <bridgehead renderas="sect4">Optional database backends</bridgehead>
     88    <para role="optional">
     89      <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
     90      <xref linkend="postgresql"/>
    7691    </para>
    7792
    … …  
    132147
    133148    <para>
    134       <parameter>make -j1 install</parameter>: ISC doesn not recomment any form of
    135       parallel or job server options when doing the install.
     149      <parameter>--with-pgsql</parameter> or <parameter>--with-mysql</parameter>:
     150      <application>ISC Kea</application> can store the leases on a
     151      database. This might be useful in large environments running
     152      a cluster of DHCP servers. Using the <emphasis>memfile</emphasis>
     153      backend (which is a CSV file stored locally) is possible anyhow.
     154    </para>
     155
     156    <para>
     157      <parameter>make -j1 install</parameter>: ISC does not recommend
     158      any form of parallel or job server options when doing the install.
    136159    </para>
    137160
    … …  
    140163  <sect2 role="configuration">
    141164    <title>Configuring ISC Kea DHCP</title>
     165
     166    <para>The support of IPv4, IPv6 and DDNS has been splitted into
     167    separate servers which runs independently from each other. Each
     168    of them has its own configuration file. Additional configuration
     169    files come from the keactrl agent which is uses to control the
     170    servers in an easy way.</para>
    142171
    143172    <para>Consult the
    … …  
    149178    for small networks with a few clients and low traffic. For greater
    150179    installations with thousands of clients, <application>ISC Kea</application>
    151     can be configured to use databases (mariabd or postgresql) to store
     180    can be configured to use databases (mariadb or postgresql) to store
    152181    the leases and build a cluster with multiple nodes. It can
    153     be integrated to <ulink url="https://www.isc.org/categories/stork/">Stork</ulink>
     182    be integrated to <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink>
    154183    which is a management dashboard to <application>ISC Kea</application>.</para>
    155 
    156 
    157     <para>The support of IPv4, IPv6 and DDNS has been splitted into
    158     separate servers which runs independently from each other. Each
    159     of them has its own configuration file. Additional configuration
    160     files come from the keactrl agent which is uses to control the
    161     servers in an easy way.</para>
    162184
    163185    <sect3 id="kea-dhcp-config">
    … …  
    234256          control agent (service providing a REST API), set
    235257          <literal>ctrl_agent=no</literal> in case the control agent
    236           is not wanted.</para>
     258          is not needed.</para>
    237259        </listitem>
    238260      </itemizedlist>
    … …  
    283305<literal>// Begin /etc/kea/kea-dhcpd4.conf
    284306{
    285 "Dhcp4": {
     307  "Dhcp4": {
    286308    // Add names of your network interfaces to listen on.
    287309    "interfaces-config": {
    288         "interfaces": [ "eth0", "eth2" ]
     310      "interfaces": [ "eth0", "eth2" ]
    289311    },
    290312
    291313    "control-socket": {
    292         "socket-type": "unix",
    293         "socket-name": "/tmp/kea4-ctrl-socket"
     314      "socket-type": "unix",
     315      "socket-name": "/tmp/kea4-ctrl-socket"
    294316    },
    295317
    296318    "lease-database": {
    297         "type": "memfile",
    298         "lfc-interval": 3600
     319      "type": "memfile",
     320      "lfc-interval": 3600
    299321    },
    300322
    301323    "expired-leases-processing": {
    302         "reclaim-timer-wait-time": 10,
    303         "flush-reclaimed-timer-wait-time": 25,
    304         "hold-reclaimed-time": 3600,
    305         "max-reclaim-leases": 100,
    306         "max-reclaim-time": 250,
    307         "unwarned-reclaim-cycles": 5
     324      "reclaim-timer-wait-time": 10,
     325      "flush-reclaimed-timer-wait-time": 25,
     326      "hold-reclaimed-time": 3600,
     327      "max-reclaim-leases": 100,
     328      "max-reclaim-time": 250,
     329      "unwarned-reclaim-cycles": 5
    308330    },
    309331
    … …  
    316338    "ddns-qualifying-suffix": "your.domain.tld",
    317339    "dhcp-ddns" : {
    318         "enable-updates": true
     340      "enable-updates": true
    319341    },
    320342
    321343    "subnet4": [
    322         {
    323             "subnet": "192.168.56.0/24",
    324             "pools": [ { "pool": "192.168.56.16 - 192.168.56.254" } ],
    325             "option-data": [
    326                 {
    327                     "name": "domain-name",
    328                     "data": "your.domain.tld"
    329                 },
    330                 {
    331                     "name": "domain-name-servers",
    332                     "data": "192.168.56.2, 192.168.3.7"
    333                 },
    334                 {
    335                     "name": "domain-search",
    336                     "data": "your.domain.tld"
    337                 },
    338                 {
    339                     "name": "routers",
    340                     "data": "192.168.56.2"
    341                 }
    342             ]
    343         }
     344      {
     345        "subnet": "192.168.56.0/24",
     346        "pools": [ { "pool": "192.168.56.16 - 192.168.56.254" } ],
     347        "option-data": [
     348          {
     349            "name": "domain-name",
     350            "data": "your.domain.tld"
     351          },
     352          {
     353            "name": "domain-name-servers",
     354            "data": "192.168.56.2, 192.168.3.7"
     355          },
     356          {
     357            "name": "domain-search",
     358            "data": "your.domain.tld"
     359          },
     360          {
     361            "name": "routers",
     362            "data": "192.168.56.2"
     363          }
     364        ]
     365      }
    344366    ],
    345367
    346368    "loggers": [
    347         {
    348             "name": "kea-dhcp4",
    349             "output_options": [
    350                 {
    351                     "output": "/var/log/kea-dhcp4.log",
    352                     "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
    353                 }
    354             ],
    355             "severity": "INFO",
    356             "debuglevel": 0
    357         }
     369      {
     370        "name": "kea-dhcp4",
     371        "output_options": [
     372          {
     373            "output": "/var/log/kea-dhcp4.log",
     374            "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
     375          }
     376        ],
     377        "severity": "INFO",
     378        "debuglevel": 0
     379      }
    358380    ]
    359 }
     381  }
    360382}
    361383// End /etc/kea/kea-dhcpd4.conf</literal>
    362384EOF</userinput></screen>
    363385
    364       <note>
    365         <para>The double braces at the end of the config is not a typo.
    366         This is because the inner "dhcp4" block is not indented as is
    367         should be because the configuration data would move too much
    368         to the right.</para>
    369       </note>
    370 
    371       <para>The configuration for IPv6 is similar to the configuration
    372       of IPv4. The configuration file is <filename>/etc/kea/kea-dhcpd6.conf</filename>.</para>
     386      <para>
     387        The configuration for IPv6 is similar to the configuration
     388        of IPv4. The configuration file is
     389        <filename>/etc/kea/kea-dhcpd6.conf</filename>.
     390      </para>
    373391
    374392    </sect3>
    … …  
    389407<literal>// Begin /etc/kea/kea-dhcp-ddns.conf
    390408{
    391 "DhcpDdns": {
     409  "DhcpDdns": {
    392410    "ip-address": "127.0.0.1",
    393411    "port": 53001,
    394412    "control-socket": {
    395         "socket-type": "unix",
    396         "socket-name": "/tmp/kea-ddns-ctrl-socket"
     413      "socket-type": "unix",
     414      "socket-name": "/tmp/kea-ddns-ctrl-socket"
    397415    },
    398416
    399417    "tsig-keys": [
     418      {
     419        "name"      : "rndc-key",
     420        "algorithm" : "hmac-sha256",
     421        "secret"    : "1FU5hD7faYaajQCjSdA54JkTPQxbbPrRnzOKqHcD9cM="
     422      }
     423    ],
     424
     425    "forward-ddns" : {
     426      "ddns-domains" : [
    400427        {
    401             "name"      : "rndc-key",
    402             "algorithm" : "hmac-sha256",
    403             "secret"    : "1FU5hD7faYaajQCjSdA54JkTPQxbbPrRnzOKqHcD9cM="
     428          "name" : "your.domain.tld.",
     429          "dns-servers" : [
     430            {
     431              "ip-address" : "127.0.0.1",
     432              "port" : 53
     433            }
     434          ]
    404435        }
    405     ],
    406 
    407     "forward-ddns" : {
    408         "ddns-domains" : [
     436      ]
     437    },
     438
     439    "reverse-ddns" : {
     440      "ddns-domains" : [
     441        {
     442          "name" : "56.168.192.in-addr.arpa.",
     443          "dns-servers" : [
    409444            {
    410                 "name" : "your.domain.tld.",
    411                 //"key-name" : "rndc-key",
    412                 "dns-servers" : [
    413                     {
    414                         "ip-address" : "127.0.0.1",
    415                         "port" : 53
    416                     }
    417                 ]
     445              "ip-address" : "127.0.0.1",
     446              "port" : 53
    418447            }
    419         ]
    420     },
    421 
    422     "reverse-ddns" : {
    423         "ddns-domains" : [
    424             {
    425                 "name" : "56.168.192.in-addr.arpa.",
    426                 //"key-name" : "rndc-key",
    427                 "dns-servers" : [
    428                     {
    429                         "ip-address" : "127.0.0.1",
    430                         "port" : 53
    431                     }
    432                 ]
    433             }
    434         ]
     448          ]
     449        }
     450      ]
    435451    },
    436452
    437453    "loggers": [
    438         {
    439             "name": "kea-dhcp-ddns",
    440             "output_options": [
    441                 {
    442                     "output": "/var/log/kea-ddns.log"
    443                     "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
    444                 }
    445             ],
    446             "severity": "INFO",
    447             "debuglevel": 0
    448         }
     454      {
     455        "name": "kea-dhcp-ddns",
     456        "output_options": [
     457          {
     458            "output": "/var/log/kea-ddns.log"
     459            "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
     460          }
     461        ],
     462        "severity": "INFO",
     463        "debuglevel": 0
     464      }
    449465    ]
    450 }
     466  }
    451467}
    452468// End /etc/kea/kea-dhcp-ddns.conf</literal>
    453469EOF</userinput></screen>
     470
     471      <note>
     472        <para>
     473          The value of <literal>secret</literal> is just an example.
     474          Generate the key for your installation by using the
     475          <command>rndc-confgen -a</command> command or the
     476          <command>tsig-keygen</command> command which both are
     477          provided by <xref linkend="bind"/>.
     478        </para>
     479      </note>
     480
    454481    </sect3>
    455482
    … …  
    497524      </varlistentry>
    498525
    499       <!-- ... -->
     526      <!-- ...to be completed... -->
    500527
    501528    </variablelist>
Note: See TracChangeset for help on using the changeset viewer.