mark22k
/
dn42-wiki
зеркало из https://codeberg.org/mark22k/dn42-wiki.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287
							<!DOCTYPE html>
<html lang="en">
    <head>
<meta charset="UTF-8">


<title>Lglass | dn42 wiki</title>

<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="robots" content="index, follow">
<meta name="keywords" content="dn42,wiki,routing,bgp">

<link rel="canonical" href="https://dn42.obl.ong/howto/lglass.html">
<link rel="icon" type="image/x-icon" href="/favicon.ico">
<link rel="shortcut icon" type="image/x-icon" href="/favicon.ico">

<link rel="author" type="text/html" href="/docs/people">

<link rel="stylesheet" href="/css/normalize.css">
<link rel="stylesheet" href="/css/simple.min.css">
<link rel="stylesheet" href="/css/style.css">
<link rel="stylesheet" href="/css/menu.css">


</head>
    
    <body>

        <header>


<b>dn42 wiki / Lglass</b>

<div id="dn42_header">
    
    <p><a href="/"><img src="/dn42.png" alt="dn42" /></a></p>

</div>
</header>

        <main>
            <p>lglass is a Python software package designed for Internet Registries like the DN42. You can generate zone files for DNS and rDNS IPv4/v6, and handle the registry. It is available on GitHub as free software:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>git clone git://github.com/fritz0705/lglass.git
</code></pre></div></div>

<h2 id="links">Links</h2>
<ul>
  <li><a href="https://github.com/fritz0705/lglass">Fritz Gihub repo</a></li>
  <li><a href="http://lglass.flonet.dn42/">lglass Manual</a></li>
</ul>

<h2 id="running-your-own-whois-daemon">Running your own Whois daemon</h2>

<p>lglass provides an event-based whois daemon with internal caching, which was written in Python. It is very simple to run an instance:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-whoisd
</code></pre></div></div>

<p>without the configfile:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-regtool whoisd <span class="nt">-H</span> <span class="nv">$HOST</span> <span class="nt">-p</span> <span class="nv">$PORT</span>
</code></pre></div></div>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>usage: lglass-whoisd [-h] [-4] [-6] [--host HOST] [--port PORT]
                     [--cidr] [--no-cidr] [--inverse] [--no-inverse]

optional arguments:
    -h, --help            show this help message and exit
    -4                    Listen on IPv4
    -6                    Listen on IPv6
    --host HOST, -H HOST  Listen on host
    --port PORT, -p PORT  Listen on port
    --cidr, -c            Perform CIDR matching on queries
    --no-cidr             Do not perform CIDR matching on queries
    --inverse, -i         Perform inverse matching on queries
    --no-inverse          Do not perform inverse matching on queries
</code></pre></div></div>

<h2 id="generate-zone-files">Generate zone files</h2>

<p>lglass also provides a script to generate zone files from the registry. It’s named zonegen.py and requires a registry dump from Monotone.</p>

<p>To generate DNS zones:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-zonegen <span class="nt">-d</span> <span class="nv">$PATH_TO_DATA_DIR</span> <span class="nt">-n</span> ns1... <span class="nt">-n</span> ns2... <span class="nt">-e</span> foo.bar.com dns <span class="nt">-z</span> dn42
</code></pre></div></div>

<p>To generate IPv4 rDNS zones:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-zonegen <span class="nt">-d</span> <span class="nv">$PATH_TO_DATA_DIR</span> <span class="nt">-n</span> ns1... <span class="nt">-n</span> ns2... <span class="nt">-e</span> foo.bar.com rdns4 <span class="nt">-N</span> 172.22.0.0/16
</code></pre></div></div>

<p>To generate IPv6 rDNS zones:</p>
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-zonegen <span class="nt">-d</span> <span class="nv">$PATH_TO_DATA_DIR</span> <span class="nt">-n</span> ns1... <span class="nt">-n</span> ns2... <span class="nt">-e</span> foo.bar.com rdns6 <span class="nt">-N</span> fd00::/8
</code></pre></div></div>

<h2 id="reformat-rpsl-files">Reformat RPSL files</h2>

<p>You can also reformat RPSL files using lglass by using the lglass.rpsl module:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-rpsl &lt; <span class="nv">$DATA</span>/inetnum/172.22.0.53_32
</code></pre></div></div>

<p>lglass.rpsl also supports in-place operation:</p>

<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-rpsl <span class="nt">-i</span> <span class="nv">$DATA</span>/inetnum/172.22.0.53_32
</code></pre></div></div>

<p>This opens the file, reads the content into memory, seeks to position 0, writes the formatted object and truncates the file.
Simple web interface</p>

<p>lglass also comes with a simple web interface written in Python3 using Bottle and Jinja2. It also provides a binary to run it using wsgiref:</p>
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./bin/lglass-web
</code></pre></div></div>

<p>Furthermore you can use any WSGI server like Gunicorn by using lglass.web.application:app as WSGI callback. You can provide a path to the configuration file in the environment variable <code class="language-plaintext highlighter-rouge">LGLASS_WEB_CFG</code>.</p>

<h2 id="configuration">Configuration</h2>

<p>The configuration file format is JSON and allows configuration of the database chain, the listen parameters, the custom messages and the process management.</p>

<table>
  <thead>
    <tr>
      <th>Option</th>
      <th style="text-align: left">Meaning</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>listen.host</td>
      <td style="text-align: left">IP address for listening socket (Default: ::)</td>
    </tr>
    <tr>
      <td>listen.port</td>
      <td style="text-align: left">TCP port for listening socket (Default: 4343)</td>
    </tr>
    <tr>
      <td>listen.protocol</td>
      <td style="text-align: left">Protocol for listening socket (4 or 6, by default 6)</td>
    </tr>
    <tr>
      <td>database</td>
      <td style="text-align: left">Array of database URLs to initialize database chain</td>
    </tr>
    <tr>
      <td>database.types</td>
      <td style="text-align: left">Array of object types in database (Default: undefined) <br />Default chain:<br />[<br />  “whois+lglass.database.file+file:.”,<br />  “whois+lglass.database.cidr+cidr:”,<br />  “whois+lglass.database.schema+schema:”,<br />  “whois+lglass.database.cache+cached:”<br />]</td>
    </tr>
    <tr>
      <td>messages.preamble</td>
      <td style="text-align: left">String preamble for whois responses</td>
    </tr>
    <tr>
      <td>messages.help</td>
      <td style="text-align: left">String help message for help requests</td>
    </tr>
    <tr>
      <td>process.user</td>
      <td style="text-align: left">User to change after initialization</td>
    </tr>
    <tr>
      <td>process.group</td>
      <td style="text-align: left">Group to change after initialization</td>
    </tr>
    <tr>
      <td>process.pidfile</td>
      <td style="text-align: left">Path to PID file</td>
    </tr>
  </tbody>
</table>

<h2 id="rpsl">RPSL</h2>
<ul>
  <li>Routing Policy Specification Language <a href="https://tools.ietf.org/html/rfc2622">RFC2622</a></li>
  <li>Routing Policy Specification Language next generation (RPSLng) <a href="https://tools.ietf.org/html/rfc4012">RFC4012</a></li>
  <li><a href="http://www.ripe.net/data-tools/db/rpsl">http://www.ripe.net/data-tools/db/rpsl</a></li>
  <li><a href="http://www.ripe.net/data-tools/db/rpsl/transition-to-rpsl-version-of-the-ripe-database">http://www.ripe.net/data-tools/db/rpsl/transition-to-rpsl-version-of-the-ripe-database</a></li>
</ul>


            <div id="menu-container" class="menu-container">
                <hr>
                <div id="menu" class="menu">
                    
                    <ul>
  <li><a href="/Home">Home</a>
    <ul>
      <li><a href="/howto/Getting-Started">Getting Started</a></li>
      <li><a href="/howto/Registry-Authentication">Registry Authentication</a></li>
      <li><a href="/howto/Address-Space">Address Space</a></li>
      <li><a href="/howto/BGP-communities">BGP communities</a></li>
      <li><a href="/FAQ">FAQ</a></li>
    </ul>
  </li>
  <li>How-To
    <ul>
      <li><a href="/howto/wireguard">Wireguard</a></li>
      <li><a href="/howto/openvpn">Openvpn</a></li>
      <li><a href="/howto/IPsec-with-PublicKeys">IPsec With Public Keys</a></li>
      <li><a href="/howto/tinc">Tinc</a></li>
      <li><a href="/howto/GRE-on-FreeBSD">GRE on FreeBSD</a></li>
      <li><a href="/howto/GRE-on-OpenBSD">GRE on OpenBSD</a></li>
      <li><a href="/howto/IPv6-Multicast">IPv6 Multicast (PIM-SM)</a></li>
      <li><a href="/howto/multicast">SSM Multicast</a></li>
      <li><a href="/howto/mpls">MPLS</a></li>
      <li><a href="/howto/Bird2">Bird2</a></li>
      <li><a href="/howto/frr">FRRouting</a></li>
      <li><a href="/howto/OpenBGPD">OpenBGPD</a></li>
      <li><a href="/howto/mikrotik">Mikrotik RouterOS</a></li>
      <li><a href="/howto/EdgeOS-Config">EdgeRouter</a></li>
      <li><a href="/howto/Static-routes-on-Windows">Static routes on Windows</a></li>
      <li><a href="/howto/networksettings">Universal Network Requirements</a></li>
      <li><a href="/howto/vyos1.4.x">VyOS</a></li>
      <li><a href="/howto/nixos">NixOS</a></li>
    </ul>
  </li>
  <li>Services
    <ul>
      <li><a href="/services/IRC">IRC</a></li>
      <li><a href="/services/Whois">Whois registry</a></li>
      <li><a href="/services/DNS">DNS</a></li>
      <li><a href="/services/IX-Collection">IX Collection</a></li>
      <li><a href="/services/Clearnet-Domains">Public DNS</a></li>
      <li><a href="/services/Looking-Glasses">Looking Glasses</a></li>
      <li><a href="/services/Automatic-Peering">Automatic Peering</a></li>
      <li><a href="/services/Repository-Mirrors">Repository Mirrors</a></li>
      <li><a href="/services/Distributed-Wiki">Distributed Wiki</a></li>
      <li><a href="/services/Certificate-Authority">Certificate Authority</a></li>
      <li><a href="/services/Route-Collector">Route Collector</a></li>
    </ul>
  </li>
  <li>Internal
    <ul>
      <li><a href="/internal/Internal-Services">Internal services</a></li>
      <li><a href="/internal/Interconnections">Interconnections</a></li>
      <li><a href="/internal/APIs">APIs</a></li>
      <li><a href="/internal/ShowAndTell">Show and Tell</a></li>
      <li><a href="/internal/Historical-Services">Historical services</a></li>
    </ul>
  </li>
  <li>Historical
    <ul>
      <li><a href="/historical/Bird">Bird 1</a></li>
      <li><a href="/historical/Quagga">Quagga</a></li>
    </ul>
  </li>
  <li>External Tools
    <ul>
      <li><a href="https://paste.dn42.us">Paste Board</a></li>
      <li><a href="https://git.dn42.dev">Git Repositories</a></li>
    </ul>
  </li>
</ul>

<hr />


                </div>
            </div>
        </main>
        
        <footer><div class="center">
    <div id="dn42_footer">
        
        <table>
  <tbody>
    <tr>
      <td>Hosted by: <a href="mailto:dn42@burble.com">BURBLE-MNT</a>, <a href="mailto:nurtic-vibe@grmml.net">GRMML-MNT</a>, <a href="mailto:xuu@dn42.us">XUU-MNT</a>, <a href="mailto:janeric@ortgies.it">JAN-MNT</a>, <a href="mailto:lare@lare.cc">LARE-MNT</a>, <a href="mailto:danny@saru.moe">SARU-MNT</a>, <a href="mailto:androw95220@gmail.com">ANDROW-MNT</a>, <a href="mailto:dn42@mk16.de">MARK22K-MNT</a></td>
      <td>Accessible via: <a href="https://wiki.dn42">dn42</a>, <a href="https://dn42.dev/">dn42.dev</a>, <a href="https://dn42.eu/">dn42.eu</a>, <a href="https://wiki.dn42.us/">wiki.dn42.us</a>, <a href="https://dn42.de/">dn42.de</a> (IPv6-only), <a href="https://dn42.cc/">dn42.cc</a> (wiki-ng), <a href="https://dn42.wiki/">dn42.wiki</a>, <a href="https://dn42.pp.ua/">dn42.pp.ua</a>, <a href="https://dn42.obl.ong/">dn42.obl.ong</a></td>
    </tr>
  </tbody>
</table>

    </div>
</div>
</footer>

        
    </body>

</html>