Linux-installasjonsveiledning for digna Release 2026.06¶
Release: 2026.06
Sist oppdatert: 5. september 2026
Innholdsfortegnelse¶
- Introduksjon
- Systemkrav
- Forberedelser før installasjon
- Oppsett av PostgreSQL-server
- Webserverkonfigurasjon
- Første installasjon
- Backend-konfigurasjon
- Dashboard-konfigurasjon
- Kjøre digna som en systemd-tjeneste
- Oppgradere til en ny utgivelse
Introduksjon¶
Om digna¶
digna er en omfattende, AI-drevet plattform designet for å optimalisere datakvalitetsstyring på tvers av ulike data-miljøer som warehouses, lakes og lakehouses. Bygget for å være svært skalerbar og tilpasningsdyktig, håndterer digna moderne datautfordringer gjennom automatisering, sanntidsovervåking og anomalideteksjon.
digna består av to hovedkomponenter:
- dignabackend: Kjernen i applikasjonen, ansvarlig for å prosessere data og utføre kvalitetskontroller.
- dignadashboard: Et nettbasert grensesnitt hostet på en webserver, som gir en brukervennlig måte å samhandle med digna-plattformen og visualisere datakvalitetsmål.
Hva er nytt i Release 2026.06¶
Denne utgivelsen bringer observabilitet for data direkte inn i koden din, slik at utviklere kan overvåke datakvalitet ved kilden. Se utgivelsesnotatene for fullstendige detaljer.
Ser du etter Windows eller macOS?¶
Denne veiledningen dekker Linux. For andre plattformer, se Windows installasjonsveiledning eller macOS installasjonsveiledning.
Hvilken distribusjon dekker denne veiledningen?¶
Instruksjonene er skrevet for de to mest vanlige serverfamiliene. Der de to avviker, er begge kommandoene oppgitt:
- Debian-familien — Debian, Ubuntu. Pakkehåndterer:
apt. - RHEL-familien — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Pakkehåndterer:
dnf.
Enhver moderne distribusjon med systemd vil fungere; det er bare pakkenavn og noen konfigurasjonsstier som endres.
Systemkrav¶
Før du begynner installasjonen, sørg for at systemet ditt oppfyller følgende minimumskrav:
| Krav | Spesifikasjon |
|---|---|
| Operativsystem | Ubuntu 22.04 LTS eller nyere, Debian 12 eller nyere, RHEL 9 / Rocky 9 / AlmaLinux 9 eller nyere |
| Arkitektur | x86_64 (amd64) eller arm64 |
| Init-system | systemd |
| Minne (minimalt oppsett) | 16 GB RAM |
| Diskplass | 10 GB tilgjengelig lagring |
| Database | PostgreSQL Server 12 eller nyere |
| Webserver | nginx, Apache httpd, eller tilsvarende |
Databaseinstallasjonsalternativer¶
Hvis PostgreSQL allerede er installert: Du kan legge til en ny database for digna i din eksisterende PostgreSQL-server.
Hvis du installerer PostgreSQL på samme maskin som digna:
Anbefalte spesifikasjoner
- Minne: 32 GB RAM (istedenfor 16 GB)
- Diskplass: 50 GB tilgjengelig lagring (istedenfor 10 GB)
Disse høyere spesifikasjonene tar hensyn til at både digna og PostgreSQL-databasen kjører samtidig.
Sjekke distribusjon og arkitektur¶
Flere kommandoer i denne veiledningen skiller seg mellom Debian- og RHEL-familiene. For å sjekke hvilken du bruker, kjør:
ID=ubuntuellerID=debian— brukapt-kommandoene.ID=rhel,rocky,almalinuxellerfedora— brukdnf-kommandoene.x86_64elleraarch64— arkitekturen for installasjonspakken du trenger.
Forberedelser før installasjon¶
Før du installerer digna, sørg for at to viktige forutsetninger er på plass:
- PostgreSQL-server – for å lagre beregnede metrikker og ytelsesdata
- Webserver – for hosting av digna Dashboard
Hvis disse komponentene ikke allerede er satt opp, følg seksjonene nedenfor for å installere og konfigurere dem.
Oppdatering av pakkelisten¶
Oppdater pakkelistene før du installerer noe:
Merk
Gjennom denne veiledningen er den første kommandoen i et par for Debian-familien og den andre for RHEL-familien. Kjør kun den som matcher systemet ditt.
Oppsett av PostgreSQL-server¶
Hvis du allerede har PostgreSQL¶
Hvis PostgreSQL allerede er installert og kjører lokalt eller hvis du bruker en administrert ekstern PostgreSQL-server, kan du hoppe til neste seksjon.
Installere PostgreSQL¶
Steg 1: Installer serverpakken¶
Tips
Distribusjonspakkene kan ligge etter i forhold til nyeste PostgreSQL-utgivelse. Hvis du trenger en spesifikk nyere versjon, bruk den offisielle PostgreSQL apt- eller yum-repositoryen i stedet.
Steg 2: Initialiser databaseklyngen¶
På Debian-familien oppretter og starter pakken en klynge automatisk — hopp til neste steg.
På RHEL-familien må klyngen opprettes eksplisitt:
Steg 3: Start og aktiver tjenesten¶
Dette starter PostgreSQL umiddelbart og konfigurerer den til å starte automatisk ved oppstart.
Steg 4: Verifiser installasjonen¶
Du bør se PostgreSQL-versjonen og en active (running)-tjeneste.
Steg 5: Koble til serveren¶
En Linux PostgreSQL-pakke oppretter en systemkonto postgres som eier klyngen. Koble til via denne kontoen:
Merk — Linux skiller seg fra Windows her
Windows-installasjonen spør etter et passord for postgres-superbrukeren under installasjonen. Linux-pakker gjør ikke det. I stedet autentiseres lokale tilkoblinger med peer authentication: operativsystembrukeren postgres får koble til som databasebrukeren postgres uten passord.
Dette er grunnen til at kommandoen over bruker sudo -u postgres. digna-backend kobler over TCP med brukernavn og passord, så du vil opprette en eksplisitt digna-bruker i Første installasjon.
Steg 6: Bekreft porten¶
Standard PostgreSQL-port er 5432. For å bekrefte hvilken port serveren lytter på:
Noter verdien — du vil trenge den når du konfigurerer digna-backend.
Steg 7: Aktiver passordautentisering for digna-brukeren¶
digna kobler til PostgreSQL over TCP som digna_user, noe som krever passordautentisering fremfor peer authentication. Sjekk at pg_hba.conf tillater dette.
Finn filen:
Åpne den i en editor og bekreft at de lokale TCP-linjene bruker scram-sha-256 (eller md5 på eldre servere) i stedet for 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
Reload PostgreSQL etter enhver endring:
Viktig
Hvis digna rapporterer FATAL: Ident authentication failed for user "digna_user", er denne innstillingen årsaken.
Steg 8: Hvis PostgreSQL kjører på en annen maskin¶
For å akseptere tilkoblinger fra en annen vert, sett listen_addresses i postgresql.conf og legg til en tilsvarende host-linje for nettverket ditt i pg_hba.conf:
Deretter åpner du porten i brannmuren og starter tjenesten på nytt:
Webserverkonfigurasjon¶
digna krever en webserver for å hoste dashboardet. Velg ett av følgende alternativer:
- nginx — lettvekts og anbefalt
- Apache httpd — et mye brukt alternativ
Du trenger bare å installere og konfigurere én av disse serverne.
Begge seksjonene konfigurerer to ting dashboardet er avhengig av:
- En single-page-application fallback, slik at oppfrisking av en dashboard-URL ikke returnerer 404
- En
.mdMIME-type, slik at Markdown-filer serveres riktig
nginx-oppsett¶
Oversikt¶
nginx er en lettvekts, høyytelses webserver som egner seg godt til å servere det statiske digna-dashboardet.
Installasjon¶
Starte nginx¶
Verifiser installasjonen¶
- Åpne nettleseren
- Gå til
http://localhost - Du bør se nginx-velkomstsiden
Åpne brannmuren¶
Hvis serveren nås fra andre maskiner, tillat HTTP-trafikk:
Konfigurere et nettsted for dashboardet¶
nginx inkluderer alle filer i conf.d-katalogen på begge distribusjonsfamilier. Lag en dedikert konfigurasjonsfil for digna der:
Lim inn følgende, og erstatt /opt/digna/dashboard med den faktiske stien til din utpakkede dashboard-mappe:
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;
}
}
(Kommentarene over er i konfigurasjonen; de kan hjelpe ved feilsøking.)
Viktig
Uten try_files-direktivet vil oppfrisking av en dashboard-side annet enn rot-URLen gi 404. Dette er nginx-ekvivalenten til URL Rewrite-modulen som kreves av IIS på Windows.
Deaktiver standardnettstedet¶
Kun én serverblokk kan være default_server for en port. På Debian-familien, fjern den medfølgende standarden slik at den ikke konflikter:
På RHEL-familien, kommenter ut eller slett server { ... }-blokken inne i /etc/nginx/nginx.conf.
Aktiver konfigurasjonen¶
Test konfigurasjonen for syntaksfeil, og last deretter nginx på nytt:
Apache httpd-oppsett¶
Oversikt¶
Apache httpd er tilgjengelig i standardreposene for alle støttede distribusjoner. Pakken heter apache2 på Debian-familien og httpd på RHEL-familien.
Installasjon¶
Starte Apache¶
Verifiser installasjonen¶
- Åpne nettleseren
- Gå til
http://localhost - Du bør se distribusjonens standard Apache-side
Påkrevd: Aktiver mod_rewrite¶
Dashboardet krever URL-omskriving.
På Debian-familien, aktiver modulen og start på nytt:
På RHEL-familien lastes mod_rewrite som regel inn som standard. Bekreft det:
Påkrevd: Tillat .htaccess-overstyringer¶
Åpne konfigurasjonsfilen for dokumentroten:
Finn <Directory>-blokken som dekker dokumentroten din (/var/www/html på begge familier) og endre:
til:
Påkrevd: MIME-type for Markdown-filer¶
I samme fil, legg til følgende linje slik at Markdown-filer serveres riktig:
Viktig
Uten denne innstillingen kan .md-filer ikke bli servert riktig.
Aktiver konfigurasjonen¶
Sjekk konfigurasjonen for syntaksfeil, og start deretter Apache på nytt:
Første installasjon¶
Steg 1: Sett opp digna-repositoriet¶
digna-repositoriet lagrer alle metrikker som beregnes av digna. Det fungerer som den sentrale databasen for analytiske og ytelsesdata.
Opprett repositories-skjema og bruker¶
Åpne din PostgreSQL-klient (psql, pgAdmin eller lignende) og kjør følgende SQL-kommandoer:
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>;
Erstatt følgende plassholdere:
<digna_repo_schema>— ønsket skjema-navn (f.eks.dignarepo)<digna_repo_user>— ønsket brukernavn (f.eks.digna_user)<digna_repo_password>— et sikkert passord for denne brukeren
Eksempel:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
For å kjøre disse fra shell i ett trinn:
Lim så inn uttalelsene ved postgres=#-prompten og skriv \q for å avslutte.
Beste praksis
Bruk sterke, komplekse passord for databasebrukere. Unngå lett gjettbare legitimasjoner.
Steg 2: Pakk ut digna-installasjonspakken¶
- Finn digna-installasjons ZIP-filen som er levert til deg
- Pakk den ut til ønsket installasjonssted — for eksempel
/opt/digna - Etter utpakking skal du se følgende elementer:
dashboard/— web-dashboard grensesnittdigna— hovedkjørbar (backend + CLI kombinert)config.toml— konfigurasjonsfillicense.toml— lisensfil (kopier din fil hit)
For å pakke ut fra shell:
Merk
Hvis unzip ikke er installert, legg det til med sudo apt install -y unzip eller sudo dnf install -y unzip.
Gjør den kjørbare filen kjørbar¶
Avhengig av hvordan arkivet ble overført, kan den kjørbare biten mangle etter utpakking. Sett den eksplisitt:
Opprett en tjenestekonto¶
Det anbefales å kjøre backend som en dedikert, uprivilegert bruker for produksjonsdistribusjoner:
sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna
Merk
På RHEL-familien er tilsvarende shellsti /sbin/nologin.
Steg 3: Installer lisensfilen¶
Viktig
Lisensfilen er ikke inkludert i installasjonspakken og vil bli levert separat av digna.
- Finn
license.toml-filen som er levert til deg - Kopier den inn i rotmappen for digna-installasjonen (der
config.tomlog den kjørbaredignaligger)
Hvorfor dette er viktig: Lisensfilen inneholder kundeinformasjon, lisensutløpsdato og digital signatur. Ikke endre denne filen — enhver endring vil ugyldiggjøre den.
Katalogstruktur etter oppsett:
/opt/digna/
├── config.toml (konfigurasjonsfil)
├── license.toml (DIN LISENSFIL - kopier hit)
├── digna (hovedkjørbar)
├── bin/ (skript for tjenesteadministrasjon)
└── dashboard/ (webgrensesnitt)
└── (dashboard-filer)
Backend-konfigurasjon¶
Steg 1: Opprett og rediger konfigurasjonsfilen¶
config_template.toml-filen leveres i din digna-installasjonsmappe. Du trenger bare å gi den nytt navn til config.toml.
Plassering: /opt/digna/config.toml
Åpne config.toml i en teksteditor og konfigurer hver seksjon nedenfor.
[app]-seksjonen¶
Denne seksjonen konfigurerer digna-backend-applikasjonsinnstillingene:
[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 = ["*"]
| Parameter | Verdi | Notater |
|---|---|---|
digna_APP_HOST | localhost eller IP-adresse | Hostnavn eller IP der dignabackend hostes |
digna_APP_PORT | 8082 (standard) | Port for REST API-endepunkter |
digna_APP_CORS_ALLOW_ORIGINS | Frontend-URL | Hvis dashboardet ligger på en annen server, inkluder dens URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Påkrevd for CORS med legitimasjon |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Tillat alle HTTP-metoder |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Tillat alle headers |
Merk
Hvis du serverer dashboardet fra nginx eller Apache på standard HTTP-port, er origin å tillate http://localhost — eller serverens offentlige URL når dashboardet nås fra andre maskiner.
[repo]-seksjonen¶
Denne seksjonen konfigurerer tilkoblingen til PostgreSQL-databasen:
[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!"
| Parameter | Verdi | Notater |
|---|---|---|
digna_REPO_HOST | localhost eller IP | PostgreSQL-serverens hostnavn/IP |
digna_REPO_PORT | 5432 (standard) | PostgreSQL-port |
digna_REPO_DB | postgres | Databasenavn |
digna_REPO_SCHEMA | dignarepo | Skjema opprettet tidligere |
digna_REPO_USER | digna_user | Bruker opprettet i PostgreSQL-oppsettet |
digna_REPO_PASSWORD | Ditt passord | Passord satt ved skjemaopprettelsen |
Beste praksis
config.toml inneholder et databasepassord i klartekst. Begrens filens tillatelser slik at kun tjenestekontoen kan lese den:
[base]-seksjonen¶
Denne seksjonen inneholder sikkerhets- og cookie-innstillinger:
[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
| Parameter | Verdi | Notater |
|---|---|---|
digna_FERNET_KEY | Krypteringsnøkkel | Brukes for å kryptere tokens og cookies (standard levert) |
digna_COOKIE_DOMAIN | localhost | Match frontend-domenet ditt |
digna_COOKIE_SECURE | false (lokalt) / true (produksjon) | Bruk true for HTTPS-tilkoblinger |
digna_COOKIE_HTTPONLY | true | Alltid aktivert for sikkerhet |
digna_COOKIE_SAME_SITE | lax | Forhindrer CSRF-angrep |
digna_TOKEN_EXPIRES_IN | 86400 (24 timer) | Session timeout i sekunder |
digna_MAX_WORKERS | Antall CPU-kjerner - 1 | Antall parallelle inspeksjonsoppgaver |
Tips
For å finne antall CPU-kjerner tilgjengelig på serveren, kjør nproc.
[logging]-seksjonen¶
Denne seksjonen konfigurerer loggingsatferd:
| Parameter | Verdi | Notater |
|---|---|---|
digna_LOGGING_MODE | INFO eller DEBUG | INFO for produksjon, DEBUG for feilsøking |
digna_LOGGING_BACKUP_COUNT | 10 | Antall daglige logg-backups som beholdes |
Steg 2: Initialiser repositoriet¶
- Åpne et terminalvindu
- Gå til din digna-installasjonsmappe (der
config.tomlogdigna-kjørbar ligger) - Kjør tilkoblingstesten:
Du bør se en bekreftelse på at tilkoblingen er etablert (selve repoet er ikke initialisert ennå).
Merk
På Linux er ikke gjeldende katalog på din PATH, så den kjørbare filen kjøres som ./digna i stedet for digna. For å bruke kortformen overalt, legg til en symbolsk lenke:
Steg 3: Installer repositories-skjemaet¶
I samme katalog, kjør:
Denne kommandoen installerer nødvendige tabeller og skjema i PostgreSQL-databasen.
Steg 4: Start digna-serveren¶
I digna-installasjonskatalogen, start serveren med:
Parametere: - --address — Serverens hostnavn/IP - --port — Serverport
Du bør se oppstartsmeldinger som bekrefter at serveren kjører:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
Tips
Hvis dashboardet serveres fra en annen maskin enn backend, åpne API-porten i brannmuren også:
Steg 5: Opprett en administratorbruker¶
- Åpne et nytt terminalvindu
- Gå til din digna-installasjonsmappe
- Kjør følgende kommando for å opprette en admin-bruker:
Eksempel:
Dette oppretter en bruker med brukernavn admin og fulle administrative rettigheter.
Tips
Pakk passordet i enkle anførselstegn. bash og zsh behandler tegn som !, $ og * spesielt, og et ikke-innrammet passord som inneholder dem vil ikke bli sendt videre som skrevet.
Beste praksis
Bruk et sterkt passord med en blanding av store og små bokstaver, tall og spesialtegn.
Dashboard-konfigurasjon¶
Steg 1: Deploy dashboardet til webserveren¶
digna-dashboardet har sin egen separate config.toml-fil plassert i dashboard/-katalogen. Denne konfigurasjonen er allerede levert og krever vanligvis ikke endringer under første oppsett. Du trenger kun å konfigurere den hvis du må tilpasse backend-tilkoblingen.
Hvis du må endre dashboard-konfigurasjonen (f.eks. for multi-instans distribusjoner), se dashboardets dokumentasjon.
Velg webserver og følg tilsvarende distribusjonstrinn.
Deploy til nginx¶
Hvis du fulgte nginx-oppsettet, peker serverblokken allerede på din dashboard-mappe og ingen kopiering er nødvendig.
- Bekreft stien
- Åpne
/etc/nginx/conf.d/digna.conf -
Verifiser at
rootpeker til din utpakkededashboard-mappe -
Sørg for at mappen er lesbar
-
Reload nginx
-
Test installasjonen
- Åpne nettleseren
- Gå til
http://localhost(eller din konfigurerte URL) - Du skal se digna-dashboardets innloggingsside
Deploy til Apache httpd¶
-
Kopier dashboardet til dokumentroten
-
Legg til omskrivingsreglene
Opprett en .htaccess-fil inne i den deployerte mappen slik at dashboard-ruter overlever en oppfriskning i nettleseren:
Lim inn følgende:
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]
-
Restart Apache
-
Åpne dashboardet
- Åpne nettleseren
- Gå til
http://localhost/digna - Du skal se digna-dashboardets innloggingsside
Steg 2: SELinux (kun RHEL-familien)¶
På RHEL, Rocky, AlmaLinux og Fedora er SELinux som regel enforcing og vil blokkere webserveren fra å lese filer utenfor forventede steder. Sjekk om det er aktivt:
Hvis resultatet er Enforcing og du serverer dashboardet fra /opt/digna/dashboard, merk katalogen slik at webserveren kan lese den:
sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard
Merk
Hvis semanage ikke finnes, installer det med sudo dnf install -y policycoreutils-python-utils.
Viktig
Et dashboard som returnerer 403 Forbidden på en nylig konfigurert RHEL-server er nesten alltid et SELinux-label-problem snarere enn et filtillatelsesproblem. Bekreft med sudo ausearch -m avc -ts recent.
Kjøre digna som en systemd-tjeneste¶
Hvorfor kjøre digna som en tjeneste?¶
Å kjøre digna-backend som en systemd-tjeneste sikrer at den:
- Starter automatisk når maskinen boot-er
- Kjører i bakgrunnen uten et åpent terminalvindu
- Starter på nytt automatisk hvis den krasjer
- Kan administreres via
systemctl, standard Linux-tjenestebehandler
Filer for tjenesteadministrasjon¶
Alle nødvendige filer ligger i digna-installasjonskatalogen under: bin/
Følgende shell-skript er tilgjengelige:
install_service.sh— registrerer digna hos systemduninstall_service.sh— fjerner registreringenstart_service.sh— starter den registrerte tjenestenstop_service.sh— stopper den kjørende tjenesten
Rottilgang påkrevd
Alle skriptene må kjøres med sudo, fordi registrering av en tjeneste som starter ved boot skriver en enhetsfil til /etc/systemd/system.
Gjøre skriptene kjørbare¶
Utpakking bevarer kanskje ikke kjørbar-bit. Før første bruk:
Installere tjenesten¶
-
Åpne et terminalvindu
-
Gå til bin-mappen
-
Kjør installasjonsskriptet
digna-serveren er nå registrert hos systemd med automatisk oppstart aktivert. Tjenesten starter ikke umiddelbart — se neste seksjon for å starte den.
Starte og stoppe tjenesten¶
For å starte tjenesten¶
- Åpne et terminalvindu
- Gå til
/opt/digna/bin - Kjør:
For å stoppe tjenesten¶
- Åpne et terminalvindu
- Gå til
/opt/digna/bin - Kjør:
Tips
Stopp alltid tjenesten før du oppdaterer applikasjonsfiler.
Administrere tjenesten med systemctl¶
Når den er registrert, kan tjenesten også kontrolleres med standard systemd-kommandoer fra hvilken som helst katalog:
sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna
Verifisere tjenesten¶
For å bekrefte at tjenesten er registrert og kjører:
enabled betyr at tjenesten starter ved boot; active betyr at den kjører nå.
Vise tjenestelogger¶
systemd fanger opp alt backend skriver til konsollen. For å lese det:
For å følge loggen i sanntid mens du reproduserer et problem:
Tips
Dette er den raskeste måten å feilsøke en tjeneste som starter og umiddelbart stopper. En repository-tilkoblingsfeil eller en manglende license.toml rapporteres her.
Flytte tjenesten til en ny katalog¶
Enhetsfilen lagrer den absolutte stien til den kjørbare filen, så flytting av installasjonen krever ny registrering av tjenesten:
-
Avinstaller den nåværende tjenesten
-
Flytt applikasjonsfilene
-
Installer tjenesten på nytt
-
Start tjenesten
Avinstallere tjenesten¶
-
Stopp den kjørende tjenesten
-
Avinstaller tjenesten
digna-serveren er nå avregistrert fra systemd.
Oppgradere til en ny utgivelse¶
Før du oppgraderer¶
Det er obligatorisk å ta backup av digna-repositoriet
Før du oppgraderer digna, ta backup av repositoriet (PostgreSQL) for å beskytte mot datatap. En backup sikrer at du kan gjenopprette hvis oppgraderingen møter uventede problemer.
For å lage en backup fra shell:
Oppgraderingsprosess¶
Steg 1: Stopp digna-tjenesten¶
Hvis digna kjører som en systemd-tjeneste, stopp den først:
Hvis digna kjører i forgrunnen, trykk Ctrl + C i terminalvinduet der den kjører.
Steg 2: Backup av nåværende backend-installasjon¶
I din digna-installasjonsmappe:
Steg 3: Pakk ut og distribuer ny versjon¶
- Pakk ut den nye digna-installasjons ZIP-filen
- Kopier den nye
digna-kjørbare ogdashboard-mappen til installasjonskatalogen din - Gjenopprett kjørbar-bit og eierskap til tjenestekontoen:
Viktig
config.toml-filen er aldri inkludert i installasjons-ZIP-en. Din eksisterende konfigurasjon forblir trygg.
Steg 4: Gjenopprett konfigurasjonsfiler¶
Steg 5: Oppgrader repositories-skjemaet¶
Gå til din digna-installasjonsmappe og kjør:
Dette oppdaterer PostgreSQL-skjemaet til nyeste versjon samtidig som alle eksisterende data bevares.
Steg 6: Start tjenestene på nytt¶
Hvis du kjører som en systemd-tjeneste:
Hvis du kjører manuelt, start serveren på nytt:
Hvis du bruker nginx eller Apache, last inn webserveren på nytt:
På RHEL-familien, re-apply SELinux-labeling hvis dashboard-katalogen ble erstattet:
Steg 7: Verifiser oppgraderingen¶
- Åpne digna-dashboardet
- Bekreft at grensesnittet laster riktig
- Sjekk serverloggene for eventuelle feil: