Přeskočit na hlavní obsah

Průvodce instalací ChirpStack v4

Tento průvodce popisuje instalaci ChirpStack v4 v 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, aktualizujte 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 platformy ChirpStack 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
varování

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

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

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

  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 platformy ChirpStack 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 jedinečný secret key, který zabezpečí API a přihlašovací tokeny. Vygenerovaný klíč si zkopírujte, budete ho potřebovat v konfiguraci:

openssl rand -base64 32

Konfigurace platformy ChirpStack​

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

    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 souboru hosts​

Ověřte, že je adresa 127.0.0.1 přiřazená názvu localhost:

sudo cat /etc/hosts
varování

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 služby ChirpStack a Gateway Bridge a povolte jejich automatický start:

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

Kontrola stavu služeb​

V logech ověřte, že služby běží správně:

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

Povolení připojení k brokeru MQTT zvenčí​

informace

Hlavně pro testování a ladění.

  • Otevřete konfigurační soubor Mosquitto /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 názvem hostitele serveru.

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

    sudo netstat -tuln | grep 8080
poznámka

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​

Ověřte, že je brána LoRaWAN připojená a funguje:

  • 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:

    • Ověřte, že se brána zobrazuje v seznamu.

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

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

    • V logech brány ověřte, že je komunikace s ChirpStack správně nastavená.

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

Dokončení​

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