Produkcia a aktualizácie

Na trvale bežiacu inštaláciu použite elowen install. Ten nastaví spravované služby. Webové rozhranie postavte za HTTPS a všeobecné API démona nechajte súkromné, ak priamy prístup nie je zámerný.

Nainštalujte na server

Na Debiane alebo Ubuntu s balíkom nainštalovaným podľa článku Inštalácia spustite:

sudo elowen install

Pred schválením zmien v systéme si prejdite plán inštalácie. Inštalátor vie nastaviť používateľa služieb, prístup cez localhost alebo doménu, reverznú proxy, HTTPS a potrebné nástroje behového prostredia. Všetky podporované voľby vypíše elowen install --help. Pri nasadení na doménu odovzdajte --domain example.com.

Ak je Elowen na počítači už nainštalovaný, zavádzací skript si pred preinštalovaním vyžiada potvrdenie, pretože preinštalovanie znova pripraví bežiacu inštanciu. Bez terminálu odmietne a vypíše možnosti. Ak napriek tomu chcete preinštalovať, nastavte ELOWEN_FORCE=1. Zdrojový checkout prepojený cez npm link skript nikdy nepreinštaluje, ani s ELOWEN_FORCE. Na bežné upgrady používajte elowen update.

Skontrolujte a reštartujte služby

elowen status
elowen restart all

Reštart démona krátko počká na prebiehajúce ťahy, uloží zostávajúcu prácu a po štarte nadviaže na obnoviteľnú prácu. Vynútené zastavenie môže prácu prerušiť.

Stav služieb a záznamy na Linuxe skontrolujete cez systemd:

sudo systemctl status elowen-daemon elowen-web
sudo journalctl -u elowen-daemon -f
sudo journalctl -u elowen-web -f

Overte reštart

Po reštarte overte, že obe služby sú aktívne a že ich adresy vracajú odpoveď. Ak Vaša reverzná proxy mení hostiteľa a porty, upravte ich:

systemctl is-active elowen-daemon elowen-web
curl -fsS http://127.0.0.1:4400/health
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4500/chat

Potom v zázname démona hľadajte riadky paused in, boot recovery a plugin loaded. Riadok plugin skipped alebo ERROR znamená, že sa nejaký plugin nespustil. Kontroly cez curl dokazujú len to, že adresy vracajú odpoveď. Nič nehovoria o tom, ako rozhranie vyzerá a správa sa, preto po každom reštarte otvorte webové rozhranie a skúste poslať správu.

Aktualizujte Elowen

Pri inštalácii z balíka spustite:

elowen update

Príkaz sa opýta licenčného servera na najnovšie vydanie, ktoré licencia pokrýva, a stiahnutie overí podľa veľkosti a kontrolného súčtu. Ten istý inštalátor, ktorý používa zavádzací skript, spustí npm ci proti preverenému produkčnému locku vydania so zapnutými natívnymi skriptami zostavenia. Atomicky prepne odkaz spravovaného vydania, obnoví súbory vlastnené rootom a reštartuje služby. Ak kontroly pri štarte zlyhajú, existujúci záchranný žurnál obnoví predchádzajúce vydanie. Aktualizácia jadra sa nevracia len preto, že miestna databáza nemá schválenú politiku prostriedkov: zosúladenie politiku ohlási ako riadenú prevádzkovateľom a nastavenia databázy nechá bez zmeny, zatiaľ čo odchýlka v už schválenej politike stále zlyhá. Po úspešných kontrolách zostanú len aktuálne a predchádzajúce vlastnené vydanie. Po aktualizácii skontrolujte elowen status.

Keď používateľ služieb nemá do inštalačného umiestnenia právo zápisu, vykoná aktualizácia svoj inštalačný krok ako root cez riadok v sudoers zviazaný s týmto konkrétnym príkazom a licenčný token odovzdá na štandardnom vstupe, nie ako argument. Po prechode zo staršej inštalácie raz znova spustite sudo elowen install, aby sa nový riadok v sudoers zapísal; bez neho sa aktualizácie vrátia k otázke na heslo prevádzkovateľa.

Odmietnutá kontrola aktualizácií zlyhá a uvedie dôvod zo servera, napríklad odvolanú licenciu, namiesto hlásenia „už aktuálne“. Miestne prepadnutá licencia aktualizáciu zastaví, kým ju neobnovíte. Keď licenčný server nie je dostupný, žiadne vydanie jadra sa nenainštaluje a aktualizácia ohlási, že server sa nepodarilo kontaktovať. Oprava privilegovaných súborov napriek tomu prebehne, takže odchýlené súbory vlastnené rootom sa zrovnajú a ohlásia ako obvykle. Zdrojový checkout vydanie jadra preskočí, ale pluginy od vydavateľov vie aktualizovať cez tú istú službu; zdrojový kód jadra aktualizujte cez git a znova ho zostavte. Jeho aktualizačnú službu pripravte po zostavení príkazom sudo elowen privileged refresh.

Zaradené požiadavky na pluginy spúšťa elowen-update-coordinator.path, ktorý pripraví inštalácia alebo sudo elowen privileged refresh, vrátane zdrojových checkoutov. Sledovač používa súbor požiadaviek inštancie, takže požiadavky, ktoré dorazia tesne pred skončením predchádzajúceho behu, sa nestratia. Neúspešné zverejnenie potvrdenia zostáva obnoviteľné a nepočíta sa za dokončenú aktualizáciu. Kým transakcia neskončí, zmeny pluginu, ktorý transakcia spracúva, sú odmietané.

Elowen číta len žurnály aktualizácií schémy 2. Inštalácia so starším žurnálom prechádza ručne v odsúhlasenom okne so zastavenými službami: dokončite obnovu starším updaterom, ponechajte zodpovedajúce záchranné artefakty, archivujte len prezreté a preukázateľne ukončené staré žurnály a správy a potom nainštalujte zodpovedajúcu sadu jadra a pluginov a obnovte privilegované súbory. Nevynucujte automatický upgrade starého koordinátora a nearchivujte aktívny žurnál.

Automatické aktualizácie sú voliteľné. Kde sú podporované, môže ich administrátor zapnúť v Nastavenia → Systém.

Sledujte priebeh aktualizácie

Otvorte Nastavenia, zvoľte Systém a vyberte Aktualizovať teraz. Panel Stav aktualizácií ukazuje aktualizáciu jadra a každý riadok pluginu ukazuje vlastný stav. Stavy, ktoré môžete vidieť, idú v poradí Vo fronte, Sťahovanie balíka, Príprava, Zastavovanie služieb, Vykonávanie zmien, Overovanie spustenia a Dokončovanie. Beh končí stavom Dokončené. Potom každý riadok pluginu ukáže vlastný výsledok: Vykonané, keď sa plugin aktualizoval, alebo Preskočené, keď ho Elowen z behu zámerne vynechal, s uvedeným dôvodom.

Vo fronte znamená, že Elowen požiadavku prijal, nie že je inštalácia hotová. Elowen pripraví stiahnutie, zatiaľ čo inštancia obsluhuje požiadavky, krátko zastaví dotknuté služby, vykoná zmeny a overí, že sa nová sada spustí. Nezávislé služby pluginov môžu byť aj v tomto kroku krátko nedostupné. Počkajte na Dokončené. Ak kontrola zlyhá, Obnovovanie predchádzajúcej verzie a potom Vrátené na predchádzajúcu verziu ukazujú, že sa obnovuje predchádzajúca sada. Dôvod uvádza panel. Zablokované pred aktiváciou znamená, že sa beh zastavil už pri príprave, pred zastavením ktorejkoľvek služby, takže nainštalovaná verzia sa nezmenila.

Aktualizujte alebo opravte jeden plugin

Otvorte Nastavenia a zvoľte Pluginy. Plugin s novšou verziou ponúkne v ponuke akcií Aktualizovať. Ak chcete naraz aktualizovať všetky pluginy s novšou verziou, zvoľte Aktualizovať všetky pluginy a potvrďte. Elowen aktualizuje zapnuté pluginy spoločne s jedným krátkym reštartom, takže niekoľko aktualizácií nikdy neznamená niekoľko reštartov. Vypnuté pluginy zostanú vypnuté a aktualizujú sa, keď ich zapnete. Ak nová verzia žiada ďalšie oprávnenia, prejdite si ich a najprv ich schváľte. Odmietnutie nechá existujúcu verziu pluginu bez zmeny.

Nainštalovaný plugin, ktorý sa nedokáže spustiť, zostane v zozname ako Nenačítané, s dôvodom a tlačidlom Opraviť. Oprava ide tou istou frontou a tou istou kontrolou spustenia. Elowen tiež pri štarte požiada o opravu chýbajúcich alebo nenačítaných zapnutých pluginov od vydavateľov, ale pri verzii, ktorej kontrola spustenia už zlyhala, prestane opakovať pokusy. Pluginy vlastné organizácii sa len ohlásia, nenahrádzajú sa.

Požiadavka môže skončiť stavom Vyžaduje súhlas, Chýba licencia, Zrušené pred spustením, Nepodarilo sa alebo Vyžaduje zásah správcu. Skôr než to skúsite znova, prejdite si uvedený dôvod. Zrušené pred spustením znamená, že túto požiadavku nahradila novšia požiadavka alebo zmenené schválené stiahnutie skôr, než sa spustila. Pri stave vyžadujúcom zásah správcu ponechajte súbory aktualizácie a použite záchranný príkaz, alebo kontaktujte svojho administrátora:

elowen update --recover

Ručné požiadavky na inštaláciu, aktualizáciu a opravu fungujú aj pri vypnutých automatických aktualizáciách. Zmeny bežnej konfigurácie pluginu alebo stavu zapnutia si zachovávajú doterajšie správanie s reštartom démona. Pripojení používatelia chatu uvidia existujúce oznámenie o reštarte; obnoviteľná práca po štarte pokračuje.

Zálohujte pred upgradom

Elowen nemá vstavaný príkaz na zálohu ani obnovu. Zálohujte databázu PostgreSQL a celý koreň inštancie (<dataDir>) ako jeden pár: databáza obnovená proti inému koreňu inštancie neprečíta svoje dáta pluginov, pretože plugin-secrets.key leží v koreni. Koreň obsahuje aj licenčný záznam, prihlasovacie údaje poskytovateľov, dáta pluginov, prílohy a žurnál aktualizácií; nainštalované služby držia svoje záznamy v priečinku protokolov, s ktorým boli nastavené. Databázu aj koreň zálohujte so zastaveným Elowenom, aby obe časti opisovali rovnaký stav. Príkazy nájdete v článku Konfigurácia.

Migrácie databázy prebiehajú pri štarte démona. Ponechajte si obnoviteľnú zálohu a keď sa nová verzia nespustí, prejdite záznamy služieb. Neodstraňujte migračné ani zámkové súbory, aby ste obišli neúspešný upgrade.

Licencia

Elowen sa prevádzkuje len na Linuxe s Debianom alebo Ubuntu. Nainštalujte ho skriptom zo svojho licenčného servera a s aktivačným kľúčom:

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

Predbežná kontrola odmietne kľúč, ktorý je už zviazaný s iným strojom, skôr než na hostiteľovi čokoľvek zmení. Aktivácia licencie viaže licenciu k jednej inštancii a licenčné kontroly prebiehajú pravidelne. Licencie sú podpísané Ed25519. Jadro obsahuje len verejný kľúč a licenciu overuje offline pri štarte. Bez platnej licencie démon nebeží a neaktualizuje sa. Katalóg ponúka len pluginy, ktoré Vaša konkrétna licencia povoľuje. Aktualizácie jadra prichádzajú z licenčného servera cez elowen update a pluginy sa z neho tiež sťahujú. Nepoužívajte npm ako inštalačný ani distribučný kanál.

Podpisovací kľúč licenčného pluginu leží vo Vašom dátovom priečinku (<dataDir>). Majte ho v zálohe a nikdy ho nemažte ani neodstraňujte licenčný plugin.

Elowen je dostupný ako zdrojový kód pod komerčnou licenciou, nejde o verejný open source. Verzie už vydané pod MIT zostávajú MIT, novšie verzie sú uzavreté. Balík elowen v npm je zastaraný a značky last-mit označujú posledný zdroj pod MIT. Ďalšie verejné vydania v npm nie sú.

Ďalšie: Webové rozhranie