Linuxi paigaldusjuhend digna väljalase 2026.06¶
Väljalase: 2026.06
Viimati uuendatud: 5. september 2026
Sisukord¶
- Sissejuhatus
- Süsteeminõuded
- Eelpaigaldus ja ettevalmistus
- PostgreSQL serveri seadistus
- Veebiserveri konfiguratsioon
- Algne paigaldus
- Backendi konfiguratsioon
- Dashboardi konfiguratsioon
- digna käitamine systemd teenusena
- Uuendamine uude versiooni
Sissejuhatus¶
Mis on digna¶
digna on terviklik tehisintellektil põhinev platvorm, mis on loodud optimeerima andmete kvaliteedi haldust mitmesugustes andmekeskkondades nagu andmelaod, andmejärved ja lakehoused. Selle eesmärk on olla kõrge skaleeritavusega ja kohanduv — digna lahendab kaasaegseid andmeprobleeme automatiseerimise, reaalajas monitooringu ja anomaaliate tuvastuse kaudu.
digna koosneb kahest põhikomponendist:
- dignabackend: Rakenduse tuum, mis vastutab andmete töötlemise ja kvaliteedikontrollide eest.
- dignadashboard: Veebipõhine liides, mis majutatakse veebiserveris ja pakub kasutajasõbralikku võimalust digna platvormiga suhelda ning andmete kvaliteeti visualiseerida.
Mis on uut väljalahes 2026.06¶
See versioon toob andmevaatlikkuse (data observability) võimalused otse teie koodi, võimaldades arendajatel jälgida andmete kvaliteeti juba allikal. Täielikud andmed leiate väljalaseteatmikust.
Otsite Windowsi või macOS-i?¶
See juhend käsitleb Linuxi. Muude platvormide jaoks vaadake Windowsi paigaldusjuhendit või macOS-i paigaldusjuhendit.
Millistele distributsioonidele see juhend kehtib?¶
Juhised on kirjutatud kahe kõige tavalisema serveripere jaoks. Kui kahe perekonna vahel on erinevusi, on mõlemad käsud toodud:
- Debian perekond — Debian, Ubuntu. Paketihaldur:
apt. - RHEL perekond — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketihaldur:
dnf.
Iga kaasaegne distributsioon, millel on systemd, töötab; muutuvad vaid paketinimed ja mõned konfiguratsiooniteed.
Süsteeminõuded¶
Enne paigaldust veenduge, et teie süsteem vastab järgmistele miinimumnõuetele:
| Nõue | Spetsifikatsioon |
|---|---|
| Operatsioonisüsteem | Ubuntu 22.04 LTS või uuem, Debian 12 või uuem, RHEL 9 / Rocky 9 / AlmaLinux 9 või uuem |
| Arhitektuur | x86_64 (amd64) või arm64 |
| Init-süsteem | systemd |
| Mälu (miinimum) | 16 GB RAM |
| Kõvaketta ruum | 10 GB vaba salvestusruumi |
| Andmebaas | PostgreSQL Server 12 või uuem |
| Veebiserver | nginx, Apache httpd või ekvivalent |
Andmebaasi paigaldamise valikud¶
Kui PostgreSQL on juba paigaldatud: Võite lisada digna jaoks uue skeemi ja kasutaja olemasolevale PostgreSQL serverile.
Kui paigaldate PostgreSQL-i samale masinale kui digna:
Soovitatavad spetsifikatsioonid
- Mälu: 32 GB RAM (võrreldes 16 GB-ga)
- Kõvaketta ruum: 50 GB vaba salvestusruumi (võrreldes 10 GB-ga)
Need kõrgemad spetsifikatsioonid arvestavad nii digna kui ka PostgreSQL andmebaasi samaaegset käivitamist.
Distribuutori ja arhitektuuri kontrollimine¶
Mitu käsku selles juhendis erinevad Debian ja RHEL perekondade vahel. Et kontrollida, kummal te olete, käivitage:
ID=ubuntuvõiID=debian— kasutageaptkäske.ID=rhel,rocky,almalinuxvõifedora— kasutagednfkäske.x86_64võiaarch64— paigalduspaki jaoks vajalik arhitektuur.
Eelpaigaldus ja ettevalmistus¶
Enne digna paigaldamist veenduge, et kaks peamist eeldust on täidetud:
- PostgreSQL server – salvestamaks väljarvutatud mõõdikuid ja jõudluse andmeid
- Veebiserver – digna Dashboardi majutamiseks
Kui need komponendid pole veel seadistatud, järgige allolevaid sektsioone nende paigaldamiseks ja konfigureerimiseks.
Paketiloendi värskendamine¶
Uuendage oma paketiloend enne mis tahes paigaldust:
Märkus
Selles juhendis on paarikaupa toodud käsud: esimene käsk on Debian perekonna jaoks ja teine käsk on RHEL perekonna jaoks. Käivitage ainult see, mis vastab teie süsteemile.
PostgreSQL serveri seadistus¶
Kui teil on PostgreSQL juba olemas¶
Kui PostgreSQL on juba paigaldatud ja töötab teie lokaalsel masinal või kasutate hallatavat kaugrepostgreSQL teenust, võite edasi liikuda järgmisse sektsiooni.
PostgreSQL paigaldamine¶
Samm 1: Serverpaketi paigaldamine¶
Vihje
Distrosõltuvad paketid võivad mõnikord järele jääda PostgreSQL ametlikest versioonidest. Kui vajate konkreetset uuemat versiooni, kasutage ametlikku PostgreSQL apt- või yum-repositsiooni.
Samm 2: Andmebaasi klastri algatamine¶
Debian perekonnas loob ja käivitab pakett klastri automaatselt — jätkake järgmise sammuga.
RHEL perekonnas tuleb klaster luua käsitsi:
Samm 3: Teenuse käivitamine ja lubamine¶
See käivitab PostgreSQLi kohe ja seab selle automaatselt käivituma taaskäivituse korral.
Samm 4: Paigalduse kontrollimine¶
Peaksite nägema PostgreSQL versiooni ja teenuse olekut active (running).
Samm 5: Ühendumine serveriga¶
Linuxi PostgreSQL-pakett loob süsteemikonto postgres, mis omab klastrit. Ühenduge selle kontoga:
Märkus — Linux erineb siin Windowsist
Windowsi paigaldaja küsib seadistuse käigus postgres superkasutaja parooli. Linuxi paketid ei tee seda. Selle asemel autentitakse kohalikud ühendused läbi peer authentication-i: operatsioonisüsteemi kasutaja postgres võib ühenduda andmebaasi kasutajana postgres ilma paroolita.
Sellepärast kasutab ülevaltoodud käsk sudo -u postgres. digna backend töötab TCP kaudu kasutajanime ja parooliga, seega loote eraldi digna kasutaja Algse paigalduse sammudes.
Samm 6: Pordi kinnitamine¶
Vaikimisi PostgreSQL kuulab porti 5432. Et kinnitada, millisel pordil teie server kuulab:
Pange väärtus kirja — seda vajate digna backendit konfigureerides.
Samm 7: Paroolipõhise autentimise lubamine digna kasutaja jaoks¶
digna ühendub PostgreSQL-iga TCP kaudu kasutajana digna_user, mis vajab paroolipõhist autentimist peer-auth asemel. Kontrollige, et teie pg_hba.conf lubab seda.
Leidke fail:
Avage see redaktoris ja kinnitage, et lokaalsed TCP-ridad kasutavad scram-sha-256 (või vanematel serveritel md5) mitte 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
Laadige PostgreSQL uuesti pärast igat muutust:
Oluline
Kui digna teatab veast FATAL: Ident authentication failed for user "digna_user", on selle põhjuseks ülaltoodud seadistus.
Samm 8: Kui PostgreSQL töötab teisel masinal¶
Et aktsepteerida ühendusi teiselt hostilt, seadistage listen_addresses failis postgresql.conf ja lisage võrgu jaoks sobiv host rida pg_hba.conf-i:
Avage seejärel pordi tulemüüris ja taaskäivitage teenus:
Veebiserveri konfiguratsioon¶
digna vajab veebiserverit dashboardi majutamiseks. Valige üks järgmistest:
- nginx — kerge ja soovitatav
- Apache httpd — laialt kasutatav alternatiiv
Teil on vaja installida ja konfigureerida ainult ÜKS neist serveritest.
Mõlemad sektsioonid seadistavad kaks asja, mis dashboardil vajalikud on:
- Ühe lehe rakenduse fallback, nii et dashboardi URL-i värskendamine ei tagasta 404 vea
.mdMIME-tüüp, et Markdown-failid teenitakse korrektselt
nginx seadistamine¶
Ülevaade¶
nginx on kerge ja kõrge jõudlusega veebiserver, mis sobib hästi staatilise digna dashboardi serveerimiseks.
Paigaldamine¶
nginx käivitamine¶
Paigalduse kontrollimine¶
- Avage brauser
- Minge
http://localhost - Te peaksite nägema nginx tervituslehte
Tulemüüri avamine¶
Kui serverile pääseb ligi teistelt masinatelt, lubage HTTP liiklus:
Veebisaidi konfiguratsioon dashboardi jaoks¶
nginx laeb distributsioonidel faili iga faili conf.d kataloogist. Looge digna jaoks pühendatud konfiguratsioonifail sinna:
Kleepige järgmine, asendades /opt/digna/dashboard tegeliku teega, kuhu olete dashboard kausta lahtipakinud:
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;
}
}
Oluline
Ilma try_files direktiivita tagastab mis tahes dashboardi lehe värskendamine peale juur-URL-i 404. See on nginx ekvivalent IIS-is Windowsis nõutavale URL Rewrite moodulile.
Vaikimisi saidi keelamine¶
Porti võib olla ainult üks default_server. Debian perekonnas eemaldage pakendatud vaikimisi konfiguratsioon, et see ei segaks:
RHEL perekonnas kommenteerige või kustutage server { ... } plokk failist /etc/nginx/nginx.conf.
Konfiguratsiooni rakendamine¶
Testige konfiguratsiooni süntaksi vea suhtes ja seejärel laadige nginx uuesti:
Apache httpd seadistamine¶
Ülevaade¶
Apache httpd on saadaval kõikide toetatud distributsioonide vaikerepositooriumites. Paketi nimi on Debian perekonnas apache2 ja RHEL perekonnas httpd.
Paigaldamine¶
Apache käivitamine¶
Paigalduse kontrollimine¶
- Avage brauser
- Minge
http://localhost - Te peaksite nägema distributsiooni vaikimisi Apache lehte
Nõutav: mod_rewrite lubamine¶
Dashboard vajab URL-ide ümberkirjutamist.
Debian perekonnas lubage moodul ja taaskäivitage:
RHEL perekonnas on mod_rewrite vaikimisi laetud. Kinnitage see:
Nõutav: .htaccess üle kirjutuste lubamine¶
Avage dokumentjuure konfiguratsioonifail:
Leidke <Directory> plokk, mis katab teie dokumentjuure (/var/www/html mõlemas perekonnas) ja muutke:
järgmiseks:
Nõutav: Markdown-failide MIME-tüüp¶
Lisage samasse faili järgmine rida, et Markdown-failid teenitakse korrektselt:
Oluline
Ilma selle seadeteta ei pruugi .md failid korralikult teeninduda.
Konfiguratsiooni rakendamine¶
Kontrollige konfiguratsiooni süntaksi vea suhtes ja seejärel taaskäivitage Apache:
Algne paigaldus¶
Samm 1: digna andmehoidla (repository) seadistamine¶
digna repository salvestab kõik digna poolt arvutatud mõõdikud. See toimib analüütiliste ja jõudlusandmete keskandmebaasina.
Loo repository skeem ja kasutaja¶
Avage oma PostgreSQL klient (psql, pgAdmin või sarnane) ja käivitage järgmised SQL-käsud:
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>;
Asendage järgmised kohatäited:
<digna_repo_schema>— Teie soovitud skeemi nimi (ntdignarepo)<digna_repo_user>— Teie soovitud kasutajanimi (ntdigna_user)<digna_repo_password>— Selle kasutaja jaoks turvaline parool
Näide:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
Shellist ühe sammuna käivitamiseks:
Seejärel kleepige laused postgres=# prompti ja väljumiseks tippige \q.
Parim praktika
Kasutage andmebaasi kasutajate jaoks tugevaid, keerukaid paroole. Vältige kergesti äraarvatavaid mandaate.
Samm 2: digna paigalduspaki lahtipakkimine¶
- Leidke teile antud digna paigaldus ZIP-fail
- Pakkige see soovitud paigalduskataloogi — näiteks
/opt/digna - Pärast lahtipakkimist peaksite nägema järgmisi elemente:
dashboard/— Veebidashboardi liidesdigna— Põhikäivitatav fail (backend + CLI koos)config.toml— Konfiguratsioonifaillicense.toml— Litsentsifail (kopeerige siia oma fail)
Lahtipakkimiseks shellis:
Märkus
Kui unzip pole paigaldatud, lisage see käsuga sudo apt install -y unzip või sudo dnf install -y unzip.
Muutke käivitatav fail käivitatavaks¶
Sõltuvalt sellest, kuidas arhiiv üle viidi, ei pruugi käivitatav õigus säilida. Seadke see ekspilti:
Looge teenusekonto¶
Soovitatav on käivitada backend spetsiaalse piiratud õigustega kasutajana tootmiskeskkonnas:
sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna
Märkus
RHEL perekonnas on ekvivalentne shelli tee /sbin/nologin.
Samm 3: Litsentsifaili paigaldamine¶
Oluline
Litsentsifaili ei sisaldu paigalduspakendis — see antakse teile eraldi digna poolt.
- Leidke teile antud
license.tomlfail - Kopeerige see digna paigalduse juurkataloogi (sinna, kus asuvad
config.tomljadignakäivitatav fail)
Miks see oluline on: Litsentsifail sisaldab teie kliendiinfot, litsentsi aegumist ja digitaalallkirja. Ärge muutke seda faili — iga muudatus muudab selle kehtetuks.
Kaustastruktuur pärast seadistust:
/opt/digna/
├── config.toml (konfiguratsioonifail)
├── license.toml (TEIE LITSENTSI FAIL - kopeerige siia)
├── digna (põhikäivitatav fail)
├── bin/ (teenusehaldusskriptid)
└── dashboard/ (veebiliides)
└── (dashboard failid)
Backendi konfiguratsioon¶
Samm 1: Loo ja muuda konfiguratsioonifaili¶
Paigalduskaustas on olemas config_template.toml fail. Lihtsalt ümbernimetamine config.toml-iks piisab.
Asukoht: /opt/digna/config.toml
Avage config.toml tekstiredaktoris ja seadistage alljärgnevad sektsioonid.
[app] sektsioon¶
See sektsioon seadistab digna backendi rakenduse seadeid:
[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 = ["*"]
| Parameeter | Väärtus | Märkused |
|---|---|---|
digna_APP_HOST | localhost või IP-aadress | Hostinimi või IP, kus dignabackend jookseb |
digna_APP_PORT | 8082 (vaikimisi) | REST API endpointide port |
digna_APP_CORS_ALLOW_ORIGINS | Frontendi URL | Kui dashboard asub teisel serveril, lisage selle URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Nõutav CORS-i puhul koos tunnustega |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Lubab kõiki HTTP meetodeid |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Lubab kõiki päiseid |
Märkus
Kui teenite dashboardi nginxi või Apache kaudu vaikimisi HTTP pordil, on lubatav origin http://localhost — või serveri avalik URL, kui dashboardile pääseb ligi teistelt masinatelt.
[repo] sektsioon¶
See sektsioon seadistab ühenduse PostgreSQL andmebaasiga:
[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!"
| Parameeter | Väärtus | Märkused |
|---|---|---|
digna_REPO_HOST | localhost või IP | PostgreSQL serveri hostinimi/IP |
digna_REPO_PORT | 5432 (vaikimisi) | PostgreSQL port |
digna_REPO_DB | postgres | Andmebaasi nimi |
digna_REPO_SCHEMA | dignarepo | Varasemalt loodud skeem |
digna_REPO_USER | digna_user | PostgreSQL-is loodud kasutaja |
digna_REPO_PASSWORD | Teie parool | Parool, mis määrati skeemi loomisel |
Parim praktika
config.toml sisaldab andmebaasi parooli selges tekstis. Piirake faili õigusi nii, et ainult teenusekonto seda loeks:
[base] sektsioon¶
See sektsioon sisaldab turbe- ja küpsise seadeid:
[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
| Parameeter | Väärtus | Märkused |
|---|---|---|
digna_FERNET_KEY | Krüpteerimisvõti | Kasutatakse tokenite ja küpsiste krüpteerimiseks (vaikesäte olemas) |
digna_COOKIE_DOMAIN | localhost | Vastab teie frontendi domeenile |
digna_COOKIE_SECURE | false (lokalis) / true (tootmises) | Kasutage true HTTPS-i puhul |
digna_COOKIE_HTTPONLY | true | Alati lubatud turvalisuse tõttu |
digna_COOKIE_SAME_SITE | lax | Aitab ära hoida CSRF-rünnakuid |
digna_TOKEN_EXPIRES_IN | 86400 (24 tundi) | Sessiooni aegumisaeg sekundites |
digna_MAX_WORKERS | CPU tuumade arv - 1 | Paralleelsete inspekteerimiste ülesannete arv |
Vihje
Saate serveri CPU tuumade arvu teada käsuga nproc.
[logging] sektsioon¶
See sektsioon seadistab logimise käitumist:
| Parameeter | Väärtus | Märkused |
|---|---|---|
digna_LOGGING_MODE | INFO või DEBUG | INFO tootmises, DEBUG tõrkeotsinguks |
digna_LOGGING_BACKUP_COUNT | 10 | Päevaste logivarude hoidmise arv |
Samm 2: Repository initsialiseerimine¶
- Avage terminal
- Minge digna paigalduskataloogi (kus asuvad
config.tomljadignakäivitatav fail) - Käivitage ühenduse test:
Te peaksite nägema kinnitust, et ühendus on loodud (repository ise ei ole veel initsialiseeritud).
Märkus
Linuxis ei ole praegune kataloog PATH-is, seega kutsutakse käivitatavat faili kui ./digna, mitte lihtsalt digna. Lühikese vormi kasutamiseks igal pool lisage sümboolne link:
Samm 3: Repository skeemi paigaldamine¶
Selles kataloogis käivitage:
See käsk paigaldab vajalikud tabelid ja skeemi teie PostgreSQL andmebaasi.
Samm 4: digna serveri käivitamine¶
digna paigalduskataloogis käivitage server:
Parameetrid: - --address — Serveri hostinimi/IP - --port — Serveri port
Te peaksite nägema käivitussõnumeid, mis kinnitavad serveri tööd:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
Vihje
Kui dashboard teenitakse teiselt masinalt kui backend, avage API port ka tulemüüris:
Samm 5: Admin-kasutaja loomine¶
- Avage uus terminaliaken
- Minge digna paigalduskataloogi
- Käivitage järgmine käsk admin-kasutaja loomiseks:
Näide:
See loob kasutaja nimega admin täielike administraatoriõigustega.
Vihje
Pange parool üksikutesse jutumärkidesse. bash ja zsh käsitlevad märke nagu !, $ ja * eriliselt ning kui parool ei ole tsiteeritud, ei pruugi need tähemärgid õigesti läbida.
Parim praktika
Kasutage tugevat parooli, mis sisaldab suurtähti, väiketähti, numbreid ja erimärke.
Dashboardi konfiguratsioon¶
Samm 1: Dashboardi juurutamine veebiserverisse¶
digna dashboardil on eraldi config.toml fail asukohaga dashboard/ kataloogis. See konfiguratsioon on juba kaasas ega vaja algseadistuse ajal muutmist. Muutke seda vaid juhul, kui peate kohandama backendiga ühenduse seadeid.
Kui peate dashboardi konfiguratsiooni muutma (nt multi-instance juurutuse puhul), vaadake dashboardi dokumentatsiooni.
Valige veebiserver ja järgige vastavaid juurutussamme.
Juurutamine nginx-i peale¶
Kui järgite nginx seadistamise juhiseid, osutab serveriblokk juba teie dashboard kaustale ja kopeerimist ei ole vaja.
- Kinnitage tee
- Avage
/etc/nginx/conf.d/digna.conf -
Kontrollige, et
rootosutab teie lahtipakituddashboardkaustale -
Veenduge, et kaust on loetav
-
Laadige nginx uuesti
-
Testige paigaldust
- Avage brauser
- Minge
http://localhost(või teie seadistatud URL) - Teile peaks avanema digna dashboardi sisselogimisleht
Juurutamine Apache httpd peale¶
-
Kopeerige dashboard dokumentjuurde
-
Lisage ümberkirjutusreeglid
Looge .htaccess fail paigaldatud kausta nii, et dashboardi teekonnad säiliksid brauseri värskendamisel:
Kleepige järgmine:
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]
-
Taaskäivitage Apache
-
Avage dashboard
- Avage brauser
- Minge
http://localhost/digna - Te peaksite nägema digna dashboardi sisselogimislehte
Samm 2: SELinux (ainult RHEL perekond)¶
RHEL, Rocky, AlmaLinux ja Fedora kasutavad vaikimisi SELinux-i, mis võib takistada veebiserveril lugemast faile väljaspool tema eeldatavaid asukohti. Kontrollige, kas see on aktiivne:
Kui vastuseks on Enforcing ja te teenite dashboardi kataloogist /opt/digna/dashboard, märgistage kataloog nii, et veebiserver saaks seda lugeda:
sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard
Märkus
Kui semanage ei ole leitud, paigaldage see käsuga sudo dnf install -y policycoreutils-python-utils.
Oluline
Kui RHEL serveris konfigureeritud dashboard tagastab 403 Forbidden, on tegemist peaaegu alati SELinux-i siltimise probleemiga, mitte faililubadega. Kinnitage see käsuga sudo ausearch -m avc -ts recent.
digna käitamine systemd teenusena¶
Miks käivitada digna teenusena?¶
digna backendi käitamine systemd teenusena tagab, et see:
- Käivitub automaatselt masina käivitamisel
- Töötab taustal ilma avatuna terminaliaknata
- Taaskäivitub automaatselt, kui see kukub kokku
- Seda saab hallata standardse Linuxi teenusehalduriga
systemctl
Teenusehalduse failid¶
Kõik vajalikud failid asuvad digna paigalduskataloogis alamkataloogis: bin/
Järgnevad shell-skriptid on olemas:
install_service.sh— registreerib digna systemd-gauninstall_service.sh— tühistab registreeritud teenusestart_service.sh— käivitab registreeritud teenusestop_service.sh— peatab töötava teenuse
Root õigused vajalikud
Kõiki skripte tuleb käivitada sudo-ga, sest teenuse registreerimine, mis käivitub boot-il, kirjutab üksuse faili kataloogi /etc/systemd/system.
Tee skriptid käivitatavaks¶
Arhiivi lahtipakkimine ei pruugi säilitada käivitusõigust. Enne esimest kasutust:
Teenuse paigaldamine¶
-
Avage terminal
-
Minge bin kataloogi
-
Käivitage paigaldusskript
digna server on nüüd registreeritud systemd-ga ja automaatne käivitamine on lubatud. Teenus ei pruugi käivituda koheselt — järgige järgmisi samme selle käivitamiseks.
Teenuse käivitamine ja peatamine¶
Teenuse käivitamiseks¶
- Avage terminal
- Minge
/opt/digna/bin - Käivitage:
Teenuse peatamiseks¶
- Avage terminal
- Minge
/opt/digna/bin - Käivitage:
Vihje
Peatage teenus alati enne rakedefailide uuendamist.
Teenuse haldamine systemctl abil¶
Pärast registreerimist saab teenust hallata ka standardsete systemd käskudega igast kataloogist:
sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna
Teenuse kontrollimine¶
Teenuse registreerimise ja töötamise kinnitamiseks:
enabled tähendab, et teenus käivitub boot-il; active tähendab, et see töötab praegu.
Teenuselogide vaatamine¶
systemd salvestab kõik, mida backend kirjutab konsoolile. Lugemiseks:
Reaalajas jälgimiseks ja probleemi reprodutseerimiseks:
Vihje
See on kõige kiirem viis diagnoosida teenust, mis käivitub ja kohe peatub. Siin teatatakse repositooriumi ühenduse vea või puuduva license.toml kohta.
Teenuse liigutamine uude kataloogi¶
Üksuse fail sisaldab täispikka teed käivitatavale failile, seega installatsiooni liigutamine nõuab teenuse uuesti registreerimist:
-
Desinstallige praegune teenus
-
Liigutage rakenduse failid
-
Paigaldage teenus uuesti
-
Käivitage teenus
Teenuse eemaldamine¶
-
Peatage töötav teenus
-
Desinstallige teenus
digna server on nüüd süsteemist unregisteritud.
Uuendamine uude versiooni¶
Enne uuendamist¶
digna repository varundamine on kohustuslik
Enne digna uuendamist varundage oma repository (PostgreSQL), et kaitsta andmete kadumise eest. Varukoopia võimaldab taastada, kui uuendamine peaks kokku jooksma või esinevad ootamatud probleemid.
Varunduse loomiseks shellist:
Uuendamise protsess¶
Samm 1: Peatage digna teenus¶
Kui digna töötab systemd teenusena, peatage see esmalt:
Kui digna töötab esiplaanil, vajutage terminaliaknas Ctrl + C.
Samm 2: Varundage praegune backend paigaldus¶
digna paigalduskataloogis:
Samm 3: Uue versiooni lahtipakkimine ja juurutamine¶
- Pakkige lahti uus digna paigaldus ZIP-fail
- Kopeerige uus
dignakäivitatav fail jadashboardkaust oma paigalduskataloogi - Taastage käivitusõigused ja teenuse konto omandiõigus:
Oluline
Faili config.toml EI SISALDATA kunagi paigaldusZIP. Teie olemasolev konfiguratsioon jääb alles.
Samm 4: Taastage oma konfiguratsioonifailid¶
Samm 5: Repository skeemi uuendamine¶
Minge digna paigalduskataloogi ja käivitage:
See uuendab PostgreSQL skeemi uusimale versioonile, säilitades kogu olemasoleva andmebaasi sisu.
Samm 6: Teenuste taaskäivitamine¶
Kui teenus on systemd kaudu:
Kui käivitate käsitsi, käivitage server uuesti:
Kui kasutate nginx-i või Apache-t, laadige vastav veebiserver uuesti:
RHEL perekonnas rakendage SELinux sildistamine uuesti, kui dashboard kataloog on asendatud:
Samm 7: Uuenduse kontrollimine¶
- Avage digna dashboard
- Kinnitage, et liides laadib korrektselt
- Kontrollige serverilogi vigade osas: