Přeskočit na hlavní obsah

Průvodce instalací ChirpStack v4

Tento průvodce popisuje instalaci ChirpStack v4 na systému Debian/Ubuntu. Zahrnuje instalaci potřebných závislostí, konfiguraci serveru ChirpStack a zprovoznění komunikace s branami. Postupujte podle pokynů krok za krokem, aby instalace proběhla bez potíží.

Předpoklady​

Než začnete, ujistěte se, že máte aktuální systém. V terminálu spusťte tento příkaz:

sudo apt update && sudo apt upgrade -y

Postup​

Instalace potřebných závislostí​

Nainstalujte Mosquitto, Redis a PostgreSQL, které jsou pro provoz ChirpStacku nezbytné:

sudo apt install \
mosquitto \
mosquitto-clients \
redis-server \
redis-tools \
postgresql

Konfigurace databáze PostgreSQL​

  1. Přihlaste se do PostgreSQL CLI (příkazové řádky) a vytvořte pro ChirpStack samostatnou roli a databázi:

    sudo -u postgres psql

  2. Spusťte potřebné databázové příkazy:

    CREATE ROLE chirpstack WITH LOGIN PASSWORD 'chirpstack';

    CREATE DATABASE chirpstack WITH OWNER chirpstack;

    \c chirpstack

    CREATE EXTENSION pg_trgm;

    \q
warning

Následující SQL příkazy spouštějte v PostgreSQL CLI jeden po druhém.

Přidání repozitáře ChirpStack​

Standardní nastavení repozitáře (doporučené dokumentací ChirpStacku):

  1. Nainstalujte potřebné balíčky:

    sudo apt install apt-transport-https dirmngr

  2. Nastavte klíč repozitáře ChirpStack:

    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1CE2AFD36DBCCA00

  3. Přidejte repozitář do seznamu:

    sudo echo "deb https://artifacts.chirpstack.io/packages/4.x/deb stable main" | sudo tee /etc/apt/sources.list.d/chirpstack.list

  4. Aktualizujte seznam balíčků:

    sudo apt update

Instalace ChirpStacku a Gateway Bridge​

Aktualizujte seznam balíčků a nainstalujte ChirpStack server a Gateway Bridge:

sudo apt install chirpstack chirpstack-gateway-bridge

Vygenerování secret key​

Vygenerujte unikátní secret key pro zabezpečení API a přihlašovacích tokenů. Vygenerovaný klíč si zkopírujte, budete ho potřebovat v konfiguraci:

openssl rand -base64 32

Konfigurace ChirpStacku​

  1. Otevřete konfigurační soubor ChirpStacku:

    sudo nano /etc/chirpstack/chirpstack.toml

  2. Zapněte region EU868:

    [network]

    enabled_regions = [
        "eu868",
    ]

  3. Nastavte secret key:

    secret = "PASTE_YOUR_SECRET_KEY_HERE"

Konfigurace ChirpStack Gateway Bridge​

  1. Otevřete konfigurační soubor Gateway Bridge:

    sudo nano /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml

  2. Upravte šablony topiců integrace MQTT:

    [integration.mqtt]
    event_topic_template="eu868/gateway/{{ .GatewayID }}/event/{{ .EventType }}"
    state_topic_template="eu868/gateway/{{ .GatewayID }}/state/{{ .StateType }}"
    command_topic_template="eu868/gateway/{{ .GatewayID }}/command/#"

Kontrola konfigurace hostů​

Ujistěte se, že je 127.0.0.1 namapovaná na localhost:

sudo cat /etc/hosts
warning

Pokud chybí, přidejte do souboru /etc/hosts tento řádek:

echo "127.0.0.1 localhost" | sudo tee -a /etc/hosts

Spuštění a povolení služeb ChirpStack​

Spusťte a povolte služby ChirpStack a Gateway Bridge:

sudo systemctl start chirpstack
sudo systemctl enable chirpstack
sudo systemctl start chirpstack-gateway-bridge
sudo systemctl enable chirpstack-gateway-bridge

Kontrola stavu služeb​

Zkontrolujte logy, abyste se ujistili, že služby běží správně:

sudo journalctl -u chirpstack -f
sudo journalctl -u chirpstack-gateway-bridge -f

Povolení vnějších připojení k MQTT brokeru​

info

Především pro účely testování a ladění

  • Otevřete konfigurační soubor mosquitto v /etc/mosquitto/mosquitto.conf:
    Na konec přidejte: 
    listener 1883
    allow_anonymous true

Kontrolní seznam po instalaci​

Přístup do webového rozhraní ChirpStack​

  1. Po spuštění služby ChirpStack otevřete webové rozhraní v prohlížeči na adrese:

    http://localhost:8080

    Pokud ChirpStack běží na vzdáleném serveru, nahraďte localhost IP adresou nebo hostname serveru.

  2. Ujistěte se, že port 8080 není blokovaný a na serveru naslouchá:

    sudo netstat -tuln | grep 8080
note

Pokud výstup ukazuje, že port 8080 naslouchá, je připravený přijímat připojení.

  1. Přihlaste se výchozími údaji:

    Uživatelské jméno: admin
    Heslo: admin

Kontrola připojení brány LoRaWAN​

Abyste se ujistili, že je vaše brána LoRaWAN připojená a funkční:

  • Přejděte ve webovém rozhraní ChirpStack do sekce Gateway:

    • Ve webovém rozhraní ChirpStack přejděte na Gateways.

  • Zkontrolujte stav brány:

    • Ujistěte se, že se vaše brána objevila v seznamu.

    • Zkontrolujte, že se hodnota "Last Seen" aktualizuje.

  • Řešení problémů s připojením:

    • Zkontrolujte logy brány, abyste se ujistili, že je komunikace s ChirpStackem správně nastavená.

    • Zkontrolujte konfiguraci topiců MQTT v souboru chirpstack-gateway-bridge.toml.

Dokončení​

Instalace ChirpStacku je hotová! Nyní se můžete přihlásit do webového rozhraní ChirpStack a nastavit své brány a zařízení LoRaWAN. Pokud narazíte na problémy, podívejte se do logů nebo do oficiální dokumentace ChirpStack.