Skip to content

Commit 047b4e8

Browse files
committed
Text changes and menu structure changes
1 parent 1dbe640 commit 047b4e8

File tree

7 files changed

+48
-55
lines changed

7 files changed

+48
-55
lines changed

docs/drift-og-hjemtagelse/index.md

Lines changed: 0 additions & 5 deletions
This file was deleted.

docs/drift-og-hjemtagelse/oprydning_af_scripts.md

Lines changed: 0 additions & 29 deletions
This file was deleted.

docs/drift-og-hjemtagelse/installation-og-drift.md renamed to docs/installation-og-drift/index.md

Lines changed: 36 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
2-
title: "Installation og drift af OS2BorgerPC Admin"
3-
parent: "Drift og hjemtagelse"
2+
title: "Installation og drift"
43
nav_exclude: false
54
---
65

@@ -166,15 +165,10 @@ Password: admin
166165

167166
---
168167

169-
### On premice drift
170-
OS2BorgerPC Admininstartionssitet egener sig meget fint til hjemtagelse. Som regel er det ret få medarbejdere der skal tilgå systemet, og man kan derfor vælge at placere serveren på et internt netværk frem for internettet. Arbejdes der hjemme kan sitet evt. nås via VPN. Det gør sikkerheden lettere at håndtere.
171-
172-
Nedetid på OS2BorgerPC Administrationssitet påvirker ikke BorgerPC-maskinerne. De kører fint videre, selvom serveren ikke er tilgængelig. Skulle serveren drille en dag hvor jeres system administrator holder fridag, mærkes det ikke på biblioteket, i jobcenteret eller hvor ellers jeres BorgerPC maskinerne står.
173-
174-
Sønderborg Kommune har selv hostet OS2BorgerPC Administrationssitet i 5 år med gode erfaringer.
168+
## Drift og backup
175169

176170
### Automatiserede Jobs (Cron Jobs)
177-
Cron er en facilitet indbygget i Ubuntu ,som kan bruges til at planlægge kørsler af jobs.
171+
Cron er en facilitet indbygget i Linux, som kan bruges til at planlægge kørsler af jobs.
178172

179173
På et OS2BorgerPC Administrationssite er der to jobs, der skal køres regelmæssigt:
180174
- Et der udsender email notifikationer ved sikkerhedshændelser
@@ -204,7 +198,7 @@ Har du brug for at køre cron jobbene manuelt kan det gøres via kommandoen:
204198
task cron
205199
```
206200

207-
### Persistens og backup
201+
### Filer og backup
208202

209203
For at sikre, at scripts og andre uploads bevares mellem genstarter og ved opgradering gemmes de på et persistent volume, der hedder `admin-media`.
210204

@@ -213,6 +207,10 @@ Volume data ligger på denne sti. Stien kan variere lidt alt efter hvordan docke
213207
/var/lib/docker/volumes/os2borgerpc-admin-site-deployment_admin-media
214208
```
215209

210+
Det er vigtigt at du sikrer dig at der tages backup af filerne.
211+
212+
### Database backup
213+
216214
Tilsvarende ligger databasen på et persistent volume, der hedder `postgres-data`.
217215
```bash
218216
/var/lib/docker/volumes/os2borgerpc-admin-site-deployment_postgres-data
@@ -234,31 +232,48 @@ HUSK! Tilret stien hen til installationsmappen. Udskift `mitbrugernavn` med dit
234232
Eksemplet her laver et db_dump hver nat kl. 02:00. Samtidig slettes db_dumps der er ældre end 10 dage.
235233

236234

237-
### Globale Scripts
238-
OS2BorgerPC Admin fødes uden globale scripts. I forbindelse med opstart udfyldes globale scripts med indholdet af [os2borgerpc-core-scripts](https://github.com/OS2borgerPC/os2borgerpc-core-scripts/releases).
235+
## Globale Scripts
236+
OS2BorgerPC Admin fødes uden indhold i globale scripts. Når serveren startes befolkes globale scripts med de scripts med indholdet af [os2borgerpc-core-scripts](https://github.com/OS2borgerPC/os2borgerpc-core-scripts/releases).
239237

240-
Hvilken version af script-pakken, der indlæses under opstart, styres via disse to variabler:
238+
Du styrer selv hvilken version af core-script-pakken, der skal indlæses under opstart via disse to variabler:
241239

242240
- `CORE_SCRIPT_VERSION_TAG`: Version af de globale scripts (f.eks. `v1.0.1`).
243241
- `CORE_SCRIPT_COMMIT_HASH`: Matchende commit-hash for versionen (f.eks. `6a96d19567bf5c002c76d16cf80f6c894c2af499`).
244242

245243

246-
#### Opdatering af Globale Scripts
244+
### Opdatering af globale Scripts
247245
Vil man indlæse en nyere version af core-scripts er det så simpelt som at opdatere de to variable og genstarte.
248246

249-
Det kan gøres via
250247
1. Opdater `CORE_SCRIPT_VERSION_TAG` og `CORE_SCRIPT_COMMIT_HASH`.
248+
Man finder versionsnummer og commit hash øverst i [release notes for os2borgerpc-core-scripts pakken](
249+
https://github.com/OS2borgerPC/os2borgerpc-core-scripts/releases).
251250

252-
Man finder commit hash øverst i release notes.
253-
https://github.com/OS2borgerPC/os2borgerpc-core-scripts/releases
254-
255-
2. Genstart. F. eks. via
251+
2. Genstart serveren. F. eks. via
256252
```bash
257253
task stop
258-
```
259-
```bash
260254
task up
261255
```
262256

263257
**Bemærk:** Eksisterende scripts fjernes ikke automatisk og skal ryddes manuelt via SQL eller `/admin`.
264258

259+
### Fjern ældre udgaver fra globale scripts
260+
261+
Globale scripts i ældre versioner kan slettes via Djangos adminside og dermed fjernes fra script-oversigten.
262+
263+
Ændringerne på denne side **kan ikke fortrydes**.
264+
265+
1. Gå ind på Djangos adminside på path `/admin/`.\
266+
F.eks.:\
267+
```https://demo.os2borgerpc.dk/admin/```
268+
269+
2. Log ind med admin-brugeren (kun denne har adgang).
270+
271+
3. Tryk på `Scripts`\
272+
![](opryd_scripts_1.png)
273+
4. Vælg de scripts der skal slettes ved at sætte hak ud for dem. Brug evt. søgefunktionen.\
274+
![](opryd_scripts_2.png)
275+
5. Vælg `Slet valgte scripts` og tryk `Udfør` for at slette dem.\
276+
![](opryd_scripts_3.png)
277+
278+
**Bemærk:** Efter dette trin er de valgte scripts slettet permanent og kan ikke gendannes.
279+
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: "Drift på egen server (on-premise)"
3+
parent: "Installation og drift"
4+
nav_exclude: false
5+
---
6+
Det er ret enkelt at drive et OS2BorgerPC Administrationssite på en lokal VMWare server eller lign.
7+
8+
Placeres serveren på på et internt netværk frem for at være tilgængelig via internettet forenkles den overordnede sikkerhedsadministration. Typisk er det et begrænset antal medarbejdere, der har behov for adgang. Fjernadgang kan det evt. håndteres sikkert via VPN.
9+
10+
Skulle der opstå nedetid på administrationssitet påvirker det ikke driften af selve BorgerPC-maskinerne. Disse fungerer uafhængigt og fortsætter som normalt, også hvis serveren er utilgængelig. Derfor vil eksempelvis biblioteket eller jobcenteret ikke opleve forstyrrelser, hvis en teknisk fejl gør serveren utilgængelig i en periode.
11+
12+
Sønderborg Kommune har haft gode erfaringer med selv at hoste OS2BorgerPC Administrationssitet i mere end fem år.

0 commit comments

Comments
 (0)