Linux diegimo vadovas digna leidimui 2026.06¶
Leidimas: 2026.06
Paskutinį kartą atnaujinta: 2026 m. rugsėjo 5 d.
Turinys¶
- Įvadas
- Sistemos reikalavimai
- Prieš diegiant
- PostgreSQL serverio nustatymas
- Tinklapio serverio konfigūracija
- Pradinis diegimas
- Backend konfigūracija
- Dashboard konfigūracija
- digna paleidimas kaip systemd paslauga
- Atnaujinimas į naują leidimą
Įvadas¶
Apie digna¶
digna yra visapusiška, dirbtiniu intelektu paremta platforma, skirta optimizuoti duomenų kokybės valdymą įvairiose duomenų aplinkose, tokiose kaip duomenų sandėliai, ežerai ir lakehouse sprendimai. Sukurta būti itin mastelijama ir pritaikoma, digna sprendžia šiuolaikines duomenų problemas per automatizavimą, realaus laiko stebėjimą ir anomalijų aptikimą.
digna susideda iš dviejų pagrindinių komponentų:
- dignabackend: programos branduolinis variklis, atsakingas už duomenų apdorojimą ir kokybės patikras.
- dignadashboard: web sąsaja, talpinama tinklapio serveryje, suteikianti patogią prieigą prie digna platformos ir duomenų kokybės metrikų vizualizacijos.
Kas naujo leidime 2026.06¶
Šis leidimas įtraukia duomenų stebėjimo galimybes tiesiai į jūsų kodą, leidžiant kūrėjams stebėti duomenų kokybę ties šaltiniu. Išsamią informaciją rasite išleidimo pastabose.
Ieškote Windows arba macOS instrukcijų?¶
Šis vadovas apima Linux. Kitiems platformoms žiūrėkite Windows diegimo vadovą arba macOS diegimo vadovą.
Kurioms distribucijoms skirtas šis vadovas?¶
Instrukcijos parašytos dviem dažniausiai naudojamoms serverinių šeimoms. Kur jos skiriasi, pateikiami abu komandų variantai:
- Debian šeima — Debian, Ubuntu. Paketų tvarkyklė:
apt. - RHEL šeima — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketų tvarkyklė:
dnf.
Bet kuri moderni distribucija su systemd tiks; keičiasi tik paketų pavadinimai ir keli konfigūracijos keliai.
Sistemos reikalavimai¶
Prieš pradėdami diegimą, įsitikinkite, kad jūsų sistema atitinka šiuos minimalus reikalavimus:
| Reikalavimas | Specifikacija |
|---|---|
| Operacinė sistema | Ubuntu 22.04 LTS arba naujesnė, Debian 12 arba naujesnė, RHEL 9 / Rocky 9 / AlmaLinux 9 arba naujesnė |
| Architektūra | x86_64 (amd64) arba arm64 |
| Init sistema | systemd |
| Atmintis (minimalus diegimas) | 16 GB RAM |
| Disko vieta | 10 GB laisvos vietos |
| Duomenų bazė | PostgreSQL Server 12 arba naujesnė |
| Tinklapio serveris | nginx, Apache httpd arba panašus |
Duomenų bazės diegimo parinktys¶
Jei PostgreSQL jau įdiegta: Galite pridėti naują duomenų bazę digna prie esamo PostgreSQL serverio.
Jei diegiate PostgreSQL tame pačiame kompiuteryje kaip digna:
Rekomenduojamos specifikacijos
- Atmintis: 32 GB RAM (vietoje 16 GB)
- Disko vieta: 50 GB laisvos vietos (vietoje 10 GB)
Šios didesnės specifikacijos užtikrina, kad tiek digna, tiek PostgreSQL veiktų vienu metu.
Kaip patikrinti distribuciją ir architektūrą¶
Kelios šio vadovo komandos skiriasi tarp Debian ir RHEL šeimų. Norėdami patikrinti, kuriai priklausote, vykdykite:
ID=ubuntuarbaID=debian— naudokiteaptkomandas.ID=rhel,rocky,almalinuxarbafedora— naudokitednfkomandas.x86_64arbaaarch64— tai diegimo paketo architektūra, kurios jums reikia.
Prieš diegiant¶
Prieš diegdami digna, įsitikinkite, kad įvykdyti du pagrindiniai reikalavimai:
- PostgreSQL serveris – saugoti apskaičiuotas metrikas ir našumo duomenis
- Tinklapio serveris – talpinti digna Dashboard
Jei šie komponentai dar nėra sukonfigūruoti, vadovaukitės žemiau pateiktomis sekcijomis, kad juos įdiegtumėte ir sukonfigūruotumėte.
Atnaujinti paketų indeksą¶
Atnaujinkite paketų sąrašą prieš diegimą:
Pastaba
Visame šitame vadove pirmoji komanda poroje skirta Debian šeimai, o antroji — RHEL šeimai. Vykdykite tik tą komandą, kuri atitinka jūsų sistemą.
PostgreSQL serverio nustatymas¶
Jei PostgreSQL jau yra¶
Jei PostgreSQL jau įdiegta ir veikia jūsų vietiniame kompiuteryje arba naudojate valdomą nuotolinį PostgreSQL serverį, galite pereiti prie kitos skilties.
PostgreSQL diegimas¶
1 žingsnis: įdiekite serverio paketą¶
Patarimas
Distribucijų paketai gali atsilikti nuo naujausių PostgreSQL leidimų. Jei reikia konkrečios naujesnės versijos, naudokite oficialų PostgreSQL apt arba yum saugyklą.
2 žingsnis: inicializuokite duomenų klasterį¶
Debian šeimoje paketas sukuria ir paleidžia klasterį automatiškai — pereikite prie kito žingsnio.
RHEL šeimoje klasteris turi būti sukurtas eksplicitiai:
3 žingsnis: paleiskite ir įgalinkite paslaugą¶
Tai paleidžia PostgreSQL iš karto ir sukonfigūruoja, kad jis būtų paleidžiamas automatiškai įkrovos metu.
4 žingsnis: patikrinkite įdiegimą¶
Turėtumėte matyti PostgreSQL versiją ir active (running) būsenos paslaugą.
5 žingsnis: prisijunkite prie serverio¶
Linux PostgreSQL paketas sukuria postgres sistemos paskyrą, kuri valdo klasterį. Prisijunkite per ją:
Pastaba — Linux čia skiriasi nuo Windows
Windows diegimo programa leidžia nustatyti slaptažodį postgres supervartotojui diegimo metu. Linux paketai to nedaro. Vietiniai ryšiai autentifikuojami per peer authentication: operacinės sistemos vartotojas postgres gali prisijungti kaip duomenų bazės vartotojas postgres be slaptažodžio.
Todėl aukščiau pateikta komanda naudoja sudo -u postgres. digna backend jungiasi per TCP su naudotojo vardu ir slaptažodžiu, todėl jūs sukursite aiškų digna vartotoją Pradiniame diegime.
6 žingsnis: patikrinkite prievadą¶
Numatytasis PostgreSQL prievadas yra 5432. Norėdami patikrinti, kokį prievadą serveris naudoja:
Užsirašykite reikšmę — jos prireiks konfigūruojant digna backend.
7 žingsnis: įgalinkite slaptažodžio autentifikavimą digna vartotojui¶
digna jungiasi prie PostgreSQL per TCP kaip digna_user, todėl reikalingas slaptažodinis autentifikavimas, o ne peer autentifikacija. Patikrinkite, ar jūsų pg_hba.conf tai leidžia.
Raskite failą:
Atidarykite jį redaktoriuje ir įsitikinkite, kad vietiniai TCP įrašai naudoja scram-sha-256 (arba md5 senesniuose serveriuose), o ne ident:
# TYPE DATABASE USER ADDRESS METHOD
host all all 127.0.0.1/32 scram-sha-256
host all all ::1/128 scram-sha-256
Persikraukite PostgreSQL po bet kokio pakeitimo:
Svarbu
Jei digna praneša apie FATAL: Ident authentication failed for user "digna_user", tai būtent šios nustatymo pasekmė.
8 žingsnis: jei PostgreSQL veikia kitoje mašinoje¶
Norėdami priimti jungtis iš kito hosto, nustatykite listen_addresses faile postgresql.conf ir pridėkite atitinkamą host eilutę savo tinkle pg_hba.conf:
Tada atverkite prievadą ugniasienėje ir paleiskite paslaugą iš naujo:
Tinklapio serverio konfigūracija¶
digna reikalauja tinklapio serverio dashboard talpinimui. Pasirinkite vieną iš šių variantų:
- nginx — lengvas ir rekomenduojamas
- Apache httpd — plačiai naudojama alternatyva
Jums reikės įdiegti ir sukonfigūruoti tik vieną iš šių serverių.
Abu skyriai konfigūruoja dvi dashboard reikalaujamas parinktis:
- Single-page-application fallback, kad perkrovus dashboard URL negrąžintų 404
- .md MIME tipą, kad Markdown failai būtų teisingai pateikiami
nginx diegimas¶
Apžvalga¶
nginx yra lengvas, aukštos veiklos tinklapio serveris, tinkamas talpinti statinį digna dashboard.
Diegimas¶
nginx paleidimas¶
Patikrinkite įdiegimą¶
- Atidarykite naršyklę
- Eikite į
http://localhost - Turėtumėte matyti nginx pasveikinimo puslapį
Ugniasienės atvėrimas¶
Jei į serverį jungiamasi iš kitų mašinų, leiskite HTTP srautą:
Svetainės konfigūravimas dashboard¶
nginx įtraukia kiekvieną failą iš conf.d katalogo abiejose distribucijų šeimose. Sukurkite atskirą konfigūracijos failą digna:
Įklijuokite žemiau pateiktą, pakeisdami /opt/digna/dashboard tikru keliu į jūsų išarchyvuotą dashboard katalogą:
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
root /opt/digna/dashboard;
index index.html;
# Serve Markdown files with the correct MIME type.
types {
text/markdown md;
}
# Single-page-application fallback: unknown paths return index.html
# instead of a 404, so dashboard routes survive a browser refresh.
location / {
try_files $uri $uri/ /index.html;
}
}
Svarbu
Be try_files direktyvos, perkrovus bet kurį dashboard puslapį, išskyrus pagrindinį URL, gausite 404. Tai nginx analogas URL Rewrite modulio, reikalingo IIS Windows aplinkoje.
Išjunkite numatytąją svetainę¶
Tik vienas server blokas gali būti default_server prievadui. Debian šeimoje pašalinkite paketais įdiegtą numatytąją svetainę, kad nekiltų konfliktų:
RHEL šeimoje komentarais arba ištrynimu ištrinkite server { ... } bloką faile /etc/nginx/nginx.conf.
Pritaikykite konfigūraciją¶
Patikrinkite konfigūraciją sintaksės klaidų atžvilgiu, tada perkraukite nginx:
Apache httpd diegimas¶
Apžvalga¶
Apache httpd yra prieinamas numatytųjų saugyklų kiekvienoje palaikomoje distribucijoje. Paketo pavadinimas Debian šeimoje yra apache2, o RHEL šeimoje — httpd.
Diegimas¶
Apache paleidimas¶
Patikrinkite įdiegimą¶
- Atidarykite naršyklę
- Eikite į
http://localhost - Turėtumėte matyti distribucijos numatytą Apache puslapį
Būtina: įjungti mod_rewrite¶
Dashboard reikalauja URL perrašymo.
Debian šeimoje įgalinkite modulį ir perkraukite:
RHEL šeimoje mod_rewrite yra įkeltas pagal nutylėjimą. Patikrinkite:
Būtina: leisti .htaccess perrašymus¶
Atidarykite dokumentų šaknies konfigūracijos failą:
Raskite <Directory> bloką, apimantį jūsų dokumentų šaknį (/var/www/html abiejose šeimose) ir pakeiskite:
į:
Būtina: MIME tipas Markdown failams¶
Toje pačioje byloje pridėkite šią eilutę, kad Markdown failai būtų pateikiami teisingai:
Svarbu
Be šio nustatymo .md failai gali būti neteisingai aptarnauti.
Pritaikykite konfigūraciją¶
Patikrinkite konfigūraciją sintaksės klaidų atžvilgiu, tada perkraukite Apache:
Pradinis diegimas¶
1 žingsnis: sukurkite digna saugyklą¶
digna saugykla saugo visus digna apskaičiuotus rodiklius. Ji veikia kaip centrinė analitinių ir našumo duomenų duomenų bazė.
Sukurkite saugyklos schemą ir vartotoją¶
Atidarykite PostgreSQL klientą (psql, pgAdmin ar panašiai) ir vykdykite šias SQL komandas:
CREATE SCHEMA <digna_repo_schema>;
CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';
GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;
Pakeiskite šiuos vietos laikiklius:
<digna_repo_schema>— pageidaujamas schemos pavadinimas (pvz.,dignarepo)<digna_repo_user>— pageidaujamas vartotojo vardas (pvz.,digna_user)<digna_repo_password>— saugus slaptažodis šiam vartotojui
Pavyzdys:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
Norėdami vykdyti tai iš shell vienu žingsniu:
Tada įklijuokite sakinius prie postgres=# prompto ir įveskite \q, kad išeitumėte.
Geriausia praktika
Naudokite stiprius, sudėtingus slaptažodžius duomenų bazės vartotojams. Venkite lengvai atspėjamų kredencialų.
2 žingsnis: išarchyvuokite digna diegimo paketą¶
- Suraskite jums pateiktą digna diegimo ZIP failą
- Išarchyvuokite jį į pageidaujamą diegimo vietą — pavyzdžiui
/opt/digna - Po išarchyvavimo turėtumėte pamatyti šiuos elementus:
dashboard/— web dashboard sąsajadigna— pagrindinis vykdomasis failas (backend + CLI kartu)config.toml— konfigūracijos failaslicense.toml— licencijos failas (įdėkite savo kopiją čia)
Išarchyvavimui iš shell:
Pastaba
Jei unzip nėra įdiegtas, pridėkite jį su sudo apt install -y unzip arba sudo dnf install -y unzip.
Paverskite vykdomąjį failą paleidžiamu¶
Priklausomai nuo to, kaip archyvas buvo perkeltas, vykdomasis bitas gali nebūti išsaugotas. Nustatykite jį aiškiai:
Sukurkite paslaugos paskyrą¶
Rekomenduojama backend paleisti kaip dedikuotą neprivilegijuotą vartotoją gamybos aplinkoje:
sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna
Pastaba
RHEL šeimoje ekvivalentinis šliuzas yra /sbin/nologin.
3 žingsnis: įdiekite licencijos failą¶
Svarbu
Licencijos failas nėra įtrauktas į diegimo paketą ir bus pateiktas atskirai iš digna.
- Suraskite jums pateiktą
license.tomlfailą - Nukopijuokite jį į pagrindinį digna diegimo katalogą (ten, kur yra
config.tomlir vykdomasis failasdigna)
Kodėl tai svarbu: Licencijos failas talpina jūsų kliento informaciją, licencijos galiojimo datą ir skaitmeninį parašą. Nekeiskite šio failo — bet koks pakeitimas jį invaliduoja.
Katalogo struktūra po nustatymo:
/opt/digna/
├── config.toml (konfigūracijos failas)
├── license.toml (JŪSŲ LICENCIJOS FAILAS - nukopijuokite čia)
├── digna (pagrindinis vykdomasis failas)
├── bin/ (paslaugos valdymo skriptai)
└── dashboard/ (web sąsaja)
└── (dashboard failai)
Backend konfigūracija¶
1 žingsnis: sukurkite ir redaguokite konfigūracijos failą¶
config_template.toml failas pateiktas jūsų digna diegimo kataloge. Jums tereikia pervardyti jį į config.toml.
Vieta: /opt/digna/config.toml
Atidarykite config.toml teksto redaktoriuje ir sukonfigūruokite kiekvieną žemiau pateiktą skyrių.
[app] skyrius¶
Šis skyrius konfigūruoja digna backend programos nustatymus:
[app]
digna_APP_HOST = "localhost"
digna_APP_PORT = 8082
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]
| Parametras | Reikšmė | Pastabos |
|---|---|---|
digna_APP_HOST | localhost arba IP adresas | Host vardas arba IP, kuriame talpinamas dignabackend |
digna_APP_PORT | 8082 (numatytasis) | REST API galinių taškų prievadas |
digna_APP_CORS_ALLOW_ORIGINS | Frontendo URL | Jei dashboard talpinamas kitur, pridėkite jo URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Reikalinga CORS su kredencialais |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Leidžiami visi HTTP metodai |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Leidžiami visi antraštės laukai |
Pastaba
Jei dashboard tiekiamas per nginx arba Apache numatytuoju HTTP prievadu, leistinas origin yra http://localhost — arba serverio viešasis URL, kai prieiga vyksta iš kitų mašinų.
[repo] skyrius¶
Šis skyrius konfigūruoja jungtį prie PostgreSQL duomenų bazės:
[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"
| Parametras | Reikšmė | Pastabos |
|---|---|---|
digna_REPO_HOST | localhost arba IP | PostgreSQL serverio hostas/IP |
digna_REPO_PORT | 5432 (numatytasis) | PostgreSQL prievadas |
digna_REPO_DB | postgres | Duomenų bazės pavadinimas |
digna_REPO_SCHEMA | dignarepo | Anksčiau sukurta schema |
digna_REPO_USER | digna_user | PostgreSQL sukurtas vartotojas |
digna_REPO_PASSWORD | Jūsų slaptažodis | Slaptažodis nustatytas kuriant schemą |
Geriausia praktika
config.toml talpina duomenų bazės slaptažodį atviru tekstu. Apribokite jo teises, kad tik paslaugos paskyra galėtų jį skaityti:
[base] skyrius¶
Šiame skyriuje yra saugumo ir slapukų nustatymai:
[base]
digna_FERNET_KEY = "your-fernet-key"
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
| Parametras | Reikšmė | Pastabos |
|---|---|---|
digna_FERNET_KEY | Šifravimo raktas | Naudojamas tokenams ir slapukams šifruoti (numatytasis pateiktas) |
digna_COOKIE_DOMAIN | localhost | Sutapti su frontend domenu |
digna_COOKIE_SECURE | false (lokaliai) / true (gamyboje) | Naudokite true HTTPS ryšiams |
digna_COOKIE_HTTPONLY | true | Visada įjungta dėl saugumo |
digna_COOKIE_SAME_SITE | lax | Apsaugo nuo CSRF atakų |
digna_TOKEN_EXPIRES_IN | 86400 (24 val.) | Sesijos galiojimo laikas sekundėmis |
digna_MAX_WORKERS | CPU branduolių skaičius - 1 | Lygiagretinimo užduočių skaičius |
Patarimas
Norėdami sužinoti, kiek CPU branduolių yra serveryje, vykdykite nproc.
[logging] skyrius¶
Šis skyrius konfigūruoja žurnalo elgseną:
| Parametras | Reikšmė | Pastabos |
|---|---|---|
digna_LOGGING_MODE | INFO arba DEBUG | INFO gamybai, DEBUG trikčių šalinimui |
digna_LOGGING_BACKUP_COUNT | 10 | Kiek dieninių žurnalų kopijų saugoti |
2 žingsnis: inicializuokite saugyklą¶
- Atidarykite terminalą
- Eikite į digna diegimo katalogą (ten, kur yra
config.tomlir vykdomasis failasdigna) - Patikrinkite ryšį:
Turėtumėte matyti patvirtinimą, kad ryšys užmegztas (saugykla dar neinicijuota).
Pastaba
Linux aplinkoje dabartinis katalogas nėra jūsų PATH, todėl vykdomasis failas paleidžiamas kaip ./digna, o ne digna. Norėdami naudoti trumpesnį variantą visur, pridėkite simbolinę nuorodą:
3 žingsnis: įdiekite saugyklos schemą¶
Toje pačioje direktorijoje paleiskite:
Ši komanda įdiegia reikalingas lenteles ir schemą jūsų PostgreSQL duomenų bazėje.
4 žingsnis: paleiskite digna serverį¶
digna diegimo kataloge paleiskite serverį:
Parametrai: - --address — serverio host vardas/IP - --port — serverio prievadas
Turėtumėte matyti paleidimo pranešimus, patvirtinančius, kad serveris veikia:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
Patarimas
Jei dashboard tiekiamas iš kitos mašinos nei backend, taip pat atverkite API prievadą ugniasienėje:
5 žingsnis: sukurkite administratoriaus paskyrą¶
- Atidarykite naują terminalo langą
- Eikite į digna diegimo katalogą
- Vykdykite šią komandą, kad sukurtumėte administratoriaus paskyrą:
Pavyzdys:
Tai sukuria vartotoją su vardu admin ir pilnomis administracinėmis teisėmis.
Patarimas
Apvyniokite slaptažodį viengubomis kabutėmis. bash ir zsh traktuoja simbolius, tokius kaip !, $ ir *, specialiai — nepakankamai apibrėžtas slaptažodis su tokiais simboliais nebus perduotas kaip įvestas.
Geriausia praktika
Naudokite stiprų slaptažodį, kuriame būtų didžiosios, mažosios raidės, skaičiai ir specialūs simboliai.
Dashboard konfigūracija¶
1 žingsnis: patalpinkite dashboard tinklapio serveryje¶
digna dashboard turi atskirą config.toml failą, esantį dashboard/ kataloge. Ši konfigūracija jau pateikta ir pradiniam nustatymui ją keisti nereikia. Ją reikės keisti tik tuo atveju, jei norite pritaikyti backend ryšį arba atlikti sudėtingesnes diegimo konfigūracijas.
Jei reikia modifikuoti dashboard konfigūraciją (pvz., daugiaserveriniams diegimams), žiūrėkite dashboard dokumentaciją.
Pasirinkite tinklapio serverį ir vykdykite atitinkamus diegimo veiksmus.
Diegimas su nginx¶
Jei vykdėte nginx diegimą, serverio blokas jau nurodo į jūsų dashboard katalogą ir kopijuoti nieko nereikia.
- Patvirtinkite kelią
- Atidarykite
/etc/nginx/conf.d/digna.conf -
Patikrinkite, ar
rootnurodo į jūsų išarchyvuotądashboardkatalogą -
Užtikrinkite, kad katalogas būtų skaitomas
-
Perkraukite nginx
-
Patikrinkite diegimą
- Atidarykite naršyklę
- Eikite į
http://localhost(arba jūsų konfigūruotą URL) - Turėtumėte matyti digna dashboard prisijungimo puslapį
Diegimas su Apache httpd¶
-
Kopijuokite dashboard į dokumentų šaknį
-
Pridėkite perrašymo taisykles
Sukurkite .htaccess failą įdiegtoje direktorijoje, kad dashboard maršrutai išliktų po puslapio perkrovimo:
Įklijuokite žemiau pateiktą:
RewriteEngine On
RewriteBase /digna/
# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]
-
Perkraukite Apache
-
Prisijunkite prie dashboard
- Atidarykite naršyklę
- Eikite į
http://localhost/digna - Turėtumėte matyti digna dashboard prisijungimo puslapį
2 žingsnis: SELinux (tik RHEL šeimai)¶
RHEL, Rocky, AlmaLinux ir Fedora pagal nutylėjimą paleidžia SELinux ir jis gali užblokuoti tinklapio serverį skaitant failus iš neįprastų vietų. Patikrinkite, ar jis aktyvus:
Jei rezultatas yra Enforcing ir jūs tiekiate dashboard iš /opt/digna/dashboard, pažymėkite katalogą tinkamu kontekstu, kad tinklapio serveris galėtų jį perskaityti:
sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard
Pastaba
Jei semanage neaptinkamas, įdiekite jį su sudo dnf install -y policycoreutils-python-utils.
Svarbu
Jei dashboard nuo naujai sukonfigūruotos RHEL sistemos grąžina 403 Forbidden, paprastai tai SELinux žymėjimo problema, o ne failų teisių. Patikrinkite su sudo ausearch -m avc -ts recent.
digna paleidimas kaip systemd paslauga¶
Kodėl paleisti digna kaip paslaugą?¶
digna backend paleidimas kaip systemd paslauga užtikrina, kad jis:
- Automatiškai paleidžiamas kompiuteriui įsijungus
- Veikia fone be atviro terminalo lango
- Automatiškai persikrauna, jei sugesti
- Gali būti valdoma per
systemctl, standartinį Linux paslaugų valdytoją
Paslaugos valdymo failai¶
Visi reikalingi failai yra digna diegimo kataloge po: bin/
Galimi šie shell skriptai:
install_service.sh— registruoja digna su systemduninstall_service.sh— pašalina registracijąstart_service.sh— paleidžia registruotą paslaugąstop_service.sh— sustabdo veikiančią paslaugą
Reikalingos root teisės
Visi skriptai turi būti vykdomi su sudo, nes registruojant paslaugą, kuri paleidžiama įkrovos metu, įrašomas unit failas į /etc/systemd/system.
Paverskite skriptus vykdomais¶
Išarchyvavimas gali neišsaugoti vykdomojo bito. Prieš pirmą naudojimą:
Paslaugos įdiegimas¶
-
Atidarykite terminalą
-
Eikite į bin katalogą
-
Vykdykite diegimo skriptą
digna serveris dabar registruotas systemd su automatiniu paleidimu. Paslauga nėra paleidžiama iš karto — žr. kitą skyrių, kaip ją paleisti.
Paslaugos paleidimas ir sustabdymas¶
Paslaugos paleidimas¶
- Atidarykite terminalą
- Eikite į
/opt/digna/bin - Vykdykite:
Paslaugos stabdymas¶
- Atidarykite terminalą
- Eikite į
/opt/digna/bin - Vykdykite:
Patarimas
Visada sustabdykite paslaugą prieš atnaujinant programos failus.
Paslaugos valdymas su systemctl¶
Užregistravus, paslauga gali būti valdoma standartinėmis systemd komandomis iš bet kurio katalogo:
sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna
Patikrinkite paslaugą¶
Norėdami patvirtinti, kad paslauga užregistruota ir veikia:
enabled reiškia, kad paslauga paleidžiama įkrovos metu; active reiškia, kad ji dabar veikia.
Peržiūrėkite paslaugos žurnalus¶
systemd perima visą tai, ką backend rašo į konsolę. Skaityti žurnalą:
Norėdami sekti žurnalą gyvai atkuriant problemą:
Patarimas
Tai greičiausias būdas diagnozuoti paslaugą, kuri paleidžiama ir iš karto sustoja. Ryšio su saugykla klaidos arba trūkstamas license.toml pranešimas bus čia matomas.
Perkelti paslaugą į naują katalogą¶
Unit failas saugo absoliutų kelią iki vykdomojo failo, todėl perkėlus diegimą reikia iš naujo registruoti paslaugą:
-
Pašalinkite esamą paslaugą
-
Perkelkite programos failus
-
Iš naujo įdiekite paslaugą
-
Paleiskite paslaugą
Pašalinti paslaugą¶
-
Sustabdykite veikiančią paslaugą
-
Pašalinkite paslaugą
digna serveris dabar neberegistruotas systemd.
Atnaujinimas į naują leidimą¶
Prieš atnaujinant¶
Digna saugyklos atsarginė kopija yra privaloma
Prieš atnaujinant digna, sukurkite atsarginę savo saugyklos (PostgreSQL) kopiją, kad apsisaugotumėte nuo duomenų praradimo. Atsarginė kopija leis atstatyti, jei atnaujinimas susidurs su netikėtomis problemomis.
Atsarginę kopiją sukurti iš shell:
Atnaujinimo procesas¶
1 žingsnis: sustabdykite digna paslaugą¶
Jei digna veikia kaip systemd paslauga, pirmiausia ją sustabdykite:
Jei digna veikia pirmame plane, paspauskite Ctrl + C to terminalo lange.
2 žingsnis: atsarginė dabartinio backend kopija¶
digna diegimo kataloge:
3 žingsnis: išarchyvuokite ir įdiekite naują versiją¶
- Išarchyvuokite naują digna diegimo ZIP failą
- Nukopijuokite naują
dignavykdomąjį failą irdashboardkatalogą į diegimo katalogą - Atstatykite vykdomąjį bitą ir paslaugos paskyros nuosavybę:
Svarbu
config.toml failas niekada nėra įtrauktas į diegimo ZIP. Jūsų esama konfigūracija lieka nepažeista.
4 žingsnis: atstatykite konfigūracijos failus¶
5 žingsnis: atnaujinkite saugyklos schemą¶
Eikite į digna diegimo katalogą ir vykdykite:
Tai atnaujins PostgreSQL schemą į naujausią versiją, išsaugant visus esamus duomenis.
6 žingsnis: paleiskite paslaugas iš naujo¶
Jei naudojate systemd paslaugą:
Jei paleidžiate rankiniu būdu, paleiskite serverį iš naujo:
Jei naudojate nginx arba Apache, perkraukite atitinkamą tinklapio serverį:
RHEL šeimoje, jei pakeitėte dashboard katalogą, iš naujo pritaikykite SELinux žymėjimą:
7 žingsnis: patikrinkite atnaujinimą¶
- Prisijunkite prie digna dashboard
- Patikrinkite, ar sąsaja užsikrauna teisingai
- Patikrinkite serverio žurnalus dėl klaidų: