Licencia

Elowen beží s licenciou viazanou na Vašu inštaláciu. Bez použiteľnej licencie zostáva démon zamknutý: webová aplikácia zobrazí stránku Vyžaduje sa licencia a odpovedajú iba licenčné routy (GET /health, GET /setup, GET /licence, POST /licence/activate); všetko ostatné vracia licence_locked, kým licenciu neaktivujete.

Aktivácia

Tri spôsoby, všetky rovnocenné:

• Pri inštalácii. Spustite inštalátor a zadajte kľúč do jeho skrytého dotazu. <licence-server> nahraďte adresou licenčného servera od svojho poskytovateľa:

  curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh | bash

  Pri inštaláciách bez dozoru nastavte ELOWEN_LICENCE_KEY v prostredí z Vášho úložiska tajomstiev a odovzdajte inštalačné prepínače cez ELOWEN_INSTALL_ARGS. Kľúč nikdy nedávajte na príkazový riadok, ani ako vložené KEY=value: unikne do histórie shellu a zoznamu procesov.
• Na zamknutej stránke. Otvorte webovú aplikáciu, zadajte aktivačný kľúč a stlačte Aktivovať. Démon sa potom sám reštartuje.
• V termináli. Spustite:

  elowen licence activate

  Kľúč pochádza z premennej prostredia ELOWEN_LICENCE_KEY alebo zo skrytého dotazu. Nikdy ho neodovzdávajte ako argument príkazu: argumenty unikajú do zoznamu procesov aj do histórie shellu.

elowen licence bez argumentov ukáže aktuálny stav: zákazníka, dátum vypršania, pokryté pluginy a koniec ochrannej lehoty (pozri nižšie). Keď je licencia zamknutá, ukáže namiesto toho dôvod a ID inštalácie. Administrátori vidia stav aj v Nastavenia → Systém na karte Licencia, môžu tam kľúč nahradiť voľbou Nahradiť aktivačný kľúč alebo stlačiť Skontrolovať teraz a hneď kontaktovať licenčný server.

Kontrola väzby pred inštaláciou

Inštalátor overí kľúč skôr, než na stroji čokoľvek zmení. Ak existuje licence.json, prečíta z neho ID inštalácie (preinštalovanie si svoje ID ponechá) a opýta sa licenčného servera, či tam kľúč smie byť použitý. Neplatný, vypršaný alebo zrušený kľúč, prípadne kľúč už aktivovaný na inom serveri, inštaláciu zastaví s vysvetľujúcou správou a stroj zostane nedotknutý. Samotná kontrola kľúč nikdy nezaviaže. Až po jej úspechu inštalácia kľúč aktivuje, čím ho zaviaže k tomuto stroju.

Prečo sa objaví zamknutá stránka

Stránka uvedie dôvod:

• Nie je nainštalovaná žiadna licencia. Aktivujte ju niektorým zo spôsobov vyššie.
• Licencia vypršala. Obnovte ju u svojho poskytovateľa a potom aktivujte nový kľúč.
• Licenčný server je príliš dlho nedostupný. Inštalácia prekročila svoju 7-dňovú ochrannú lehotu (pozri nižšie). Obnovte serveru prístup na internet: démon sa sám ozve a pri uloženej licencii sa odomkne v priebehu niekoľkých minút, inak aktivujte svojím kľúčom znova.
• Licenčný server túto inštaláciu odmietol. Licencia bola zrušená alebo presunutá. Obráťte sa na podporu.
• Táto licencia bola vydaná pre iný server. Každá licencia patrí k jednému ID inštalácie. Aktivujte kľúč určený pre tento server.
• Licencia na tomto serveri nie je platná. Štrukturálne poškodený licence.json znemožňuje štart aj aktiváciu: démon nenastartuje a zadanie kľúča súbor neopraví. Obnovte licence.json zo zálohy tej istej inštalácie alebo požiadajte podporu o zodpovedajúci záznam. Súbor nikdy nemažte: nový súbor nesie nové ID inštalácie, takže kľúč viazaný na staré ID je potom odmietnutý ako patriaci inému serveru.

Ochranná lehota a kontroly

Elowen nepotrebuje trvalé spojenie s licenčným serverom. Démon sa hlási zhruba každých 6 hodín a vždy, keď stlačíte Skontrolovať teraz. Každé úspešné hlásenie obnoví 7-dňovú ochrannú lehotu: ak sa server stane nedostupným, Elowen beží ďalej až do konca ochrannej lehoty.

• Po 24 hodinách bez kontaktu vidia administrátori upozornenie Licenčný server je nedostupný s dátumom, do ktorého inštalácia pobeží.
• 14 dní pred vypršaním vidia administrátori upozornenie Licencia čoskoro vyprší.
• Reštart ochrannú lehotu nepredlžuje: koniec lehoty je súčasťou podpísanej licencie, nie miestnych hodín.

Ak hlásenie ukáže, že licencia už nepokrýva plugin od vydavateľa, ktorý bol načítaný pri štarte, Elowen sa reštartuje, aby ho odstavil. Pluginov, ktoré ste pridali sami, sa to netýka.

Poznámky k hodinám

Licencia nesie čas podpisu zo servera, ktorý démon porovnáva s miestnymi hodinami. Udržujte hodiny servera synchronizované (NTP). Malé rozdiely do 5 minút sú tolerované.

Démon tiež zaznamenáva najnovší čas, ktorý kedy videl, a tento záznam sa nikdy nevracia späť. Vrátenie hodín nemôže oživiť vypršanú ochrannú lehotu. Ten istý záznam funguje aj opačne: hodiny nastavené ďaleko dopredu v zázname zostanú, takže ochranná lehota môže skončiť skôr, než by mala, a inštalácia sa môže zamknúť aj po oprave hodín. Ak sa to stane, skontrolujte hodiny a licenciu aktivujte alebo obnovte.

Kde licencia žije

Licenčný súbor je licence.json a leží v priečinku inštancie (v predvolenom nastavení ~/.config/elowen/, prípadne v priečinku, na ktorý ukazuje ELOWEN_INSTANCE_ROOT). Obsahuje ID inštalácie a licenčný token a čítať ho môže iba jeho vlastník.

Zálohujte a obnovujte spoločne: databázu PostgreSQL a priečinok inštancie s licence.json a kľúčom tajomstiev pluginov plugin-secrets.key. Každá inštalácia má vlastné ID uložené v licence.json, preto na každom stroji aktivujte samostatný kľúč, namiesto toho, aby ste súbor medzi nimi kopírovali.

Hlásenie problémov

Hlásenie problémov je vypnuté, kým ho administrátor nezapne. Prepínačom je riadok Hlásenie problémov v Nastavenia → Systém a vidia ho iba administrátori. Zapnutie vyžiada potvrdenie. Vypnutie zastaví odosielanie a vymaže dávku, ktorá ešte nebola odoslaná.

Kým je zapnuté, posiela Elowen varovania a chyby samotného démona prevádzkovateľovi licenčného servera Elowen. Záznamy, ktoré Elowen označí ako iba miestne, sa neodosielajú nikdy. Problém, ktorý prichádza z hostiteľa a nie z kódu Elowen, napríklad výpadok databázy alebo zaseknutie slučky udalostí vysvetlené nameranou medzerou v plánovaní hostiteľa, sa do hlásenia dostane až po zopakovaní: tri výskyty v priebehu piatich minút a potom každý ďalší, kým sa opakuje. Jeden alebo dva výskyty zostanú v miestnom protokole. Každé hlásenie obsahuje:

• kódy problémov a koľkokrát sa každý vyskytol, s úrovňou varovania alebo chyby;
• názvy a verzie všetkých nainštalovaných pluginov, vrátane súkromných a nelicencovaných, a verziu Elowen;
• až tri ukážky textu správy pri každom probléme;
• pri varovaniach o spomalení démona posledné meranie hostiteľa: CPU, RAM, kapacitu disku, rýchlosti diskového I/O a siete, vrátane času merania. Môže byť o minútu aj viac staršie ako varovanie, ak sa vzorkovanie oneskorilo.

Kým sa ukážka uloží alebo odošle, skráti sa na 500 znakov a odstránia sa z nej kľúče, tokeny, heslá, cookies, parametre URL, e-mailové adresy, IP adresy, identifikátory a cesty k adresárom. Zvyšný text môže stále obsahovať názvy poskytovateľov, modelov, častí pluginov, hostiteľov alebo mená osôb. Každá hlásená správa odosiela svoj redigovaný text, vrátane správ, ktoré môžu niesť obsah konverzácie alebo obchodné údaje.

Hlásenia nesú licenčný token, preto sa doručujú iba kým je licencia aktívna. Prevádzkovateľ ich uchováva najviac 14 dní. Vypnutie hlásenia nemôže odvolať údaje, ktoré už boli prijaté. Stavový riadok pri položke hlásenia ukazuje stav doručenia: Pripravené, Doručené, Opakovanie, Neplatná licencia, Server nedostupný alebo Chyba úložiska.

Ďalej: Konfigurácia