Tato stránka představuje kroky k lokalizaci a nastavení nové Dtella sítě.

V průběhu popisu bude poukázáno na některé soubory které mohou vyžadovat úpravu, nebo skripty které bude třeba spustit. Tyto budou zobrazeny v bloku jako následující příklad:

dtella.py

Pokud nebude jinak uvedeno, všechny cesty k souborům budou uváděny relativně k Dtella složce. Například pokud jste nastavili výstup při instalaci do ~/mydtella/ bude poté význam cesty dtella/local_config.py znamenat: “~/mydtella/dtella/local_config.py

Pokud najdete na této stránce závady, obraťte se na autora, toto je jen překlad .

Pro úspěšné nastavení Dtella sítě by jste měli splňovat následující podmínky:

1. rychlá LAN síť
2. základní znalosti síťování
3. základní znalosti Python jazyka
4. počítače k sestavení sítě (Mac a PC)
5. nějaké umístění pro Dynamické nastavení

Doplňkové, pokud budete chtít nastavit Dtella to IRC Bridge budete potřebovat následující:

1. UnrealIRCd server (s administrátorským přístupem)
2. Doplňkové požadavky popsané v:

docs/requirements.txt

Prvním krokem k vybudování sítě je stažení zdrojových kódů z Dtella Labs repozitáře. To provedete následujícím příkazem:

svn checkout http://dtella.googlecode.com/svn/trunk/ dtella

Připomínám že by jste si měli zkontrolovat přesně vydání Dtella, protože repozitář může obsahovat i novější (rozuměj: pravděpodobně neotestované) schopnosti.

Druhým krokem je lokalizace a konfigurace vlastních nastavení Dtella sítě. Vše se dá zvládnout editací následujícího souboru umístěného ve složce projektu:

dtella/local_config.py

Soubor je podrobně popsán uvnitř, což vám pomůže s jednotlivými kroky.

Napřed se ujistěte že jste si přečetli a splňujete všechny závislosti vypsané v následujícím souboru:

docs/requirements.txt

V dalším kroku je vlastní vytvoření distribučních balíčků pro vaši Dtella síť.

Pro Windows a Linux verzi spusťte následující skript na počítači s Windows:

build_installer.bat

Pro vytvoření balíčku pro Mac OS X, spusťe následující skript:

build_osx.sh

Dynamické nastavení je vstupní bod do sítě, kde každý nový nod (uživatel) dostává informaci o nastavení sítě. Konfigurace se ukládá na jedno z těchto podporovaných míst:

• BIND DNS Server
• yi.org DNS Server
• Google Spreadsheet (Gdata)

Zaznamenávají se tyto údaje:

• IP Cache - šifrovaný seznam spolehlivých nodů, ke kterým se může klient připojit
• Minshare - Minimální velikost sdílení pro připojení a možnost stahování v síti
• Version - Potřebnáverze, aktuální verze a místo pro stažení pro vaši instalaci
• PK Hash - Hash veřejného klíče pro digitální podpis zpráv z Bridge nebo dalších administrativních zdrojů

Zde je příklad záznamu DNS dynamické konfigurace:

ipcache=2ggsZ4ROYqq99tFU3yHw8FVpW1DpOYqqxbhb2Kk199tFU3yHw8FVpWF58BmzxDpnMGXioHs=

minshare=5G

version=1.0.4 1.2.0 http://www.dtella.org/

pkhash=VpW2ggsZ4R7cZPJSfuVxwIDoTLk==

Tato sekce není finální.

Tato sekce vám předvede jak si nastavit Dtella na IRC Bridge. Bridge (most) spojení kde můžete chatovat mezi oběma sítěmi. Navíc, můžete pouužít IRC k moderování/správě jako je kopání, banování v síti Dtella přímo z IRC kanálu. Z důvodu složitého přístupu který bridge vyžaduje není jednpoduché se prostě připojit do existující IRC sítě (jako Freenode), jistější je spojit IRC server přímo k Dtella Bridge. Toto vyžaduje administrátorský přístup do konfigurace IRC sítě.

Kroky potřebné k nastavení bridge a spojení jsou následující:

• Nastavení UnrealIRCd podle vlastní dokumentace
• Vytvořit blok pro spojení v souboru links.conf (nebo unrealircd.conf pro unrealIRCD)
• Konfigurace vašeho bridge nastavením bridge_config.py
• Spuštění bridge a test funkčnosti (python dtella.py –bridge)

Konfigurace Inspircd

links.conf

<link name="bridge1.dtella.zomg" # This link name (bridge1.dtella.zomg) must match the my_host parameter in the bridge_config.py
      # the ip address of the host running the dtella bridge
      ipaddr="22.128.15.55"

      # The port which the bridge is configured to link to.
      port="7000"

      allowmask="*"
      timeout="300"

      # the ip address bound to the interface which the irc daemon is listening, can usually be left as an asterisk(*)
      bind="192.168.0.69"
      statshidden="no"
      hidden="no"

      # should match the recv pass within bridge_config.py
      sendpass="password1"

      # should match the send pass within bridge_config.py
      recvpass="password2">

Pro více informací o nastavení bridge na inspircd čtěte inspircd dokumentaci: http://wiki.inspircd.org/Configuration#.3Clink.3E_-_links.conf.

Konfigurace Dtella Bridge

bridge_config.py

service_args = dict(
    # ip or hostname of the irc server you wish the bot to connect to
    host = "irc.dhirc.com", 

    # port you set the irc daemon to listen on for incomming linked connections
    port = 7000, 

    # Matches the recv pass of the IRC Link configuration
    sendpass = "password2", 

    # Matches the send pass of the IRC link configuration
    recvpass = "password1", 

    # the network name of the IRC server you want to connect to
    network_name = "DarkHorse", 

    # Matches the link name= paramter in the link configuration for the irc daemon
    my_host = "bridge1.dtella.zomg", 

    # the name response you want the bot to have (shows in IRC WHOIS requests, not the nickaneme)
    my_name = "Dtella IRC Bridge", 

    # The channel you want the bot to join
    channel = "#dtella", 

    # Leave this as None
    sid = None,

    # To disable cloaking, set these 3 lines to None.

    # set to half or full to enable or disable half or full hostmask cloaking
    cloak_mode = "half",   

    # The prefix on the masked hostnames of the dtella clients
    cloak_prefix = "pre-", 

    # This is the hash used to mask the addresses of your clients, enter random letters and numbers.
    cloak_key = "asdf1234", 
    )

Konfigurace UnrealIRCd

unrealircd.conf

link bridge1.somedomain.com
{
        username          *;  
        hostname          *;  //This can be set to restrict to a static IP for security
        bind-ip           *;
        port              6667; 
        leaf              *;
        password-connect  "super_secret_password";
        password-receive  "super_secret_password";
        class             servers;
};

Poznámka: Dtella bridge aktuálně nepodporuje UnrealIRCD, čtěte inspircd výše.