Installation ​

Installér OneDoor ​

Septima udfører første installation af OneDoor og konfigurerer den til jeres behov.

Skal I opgradere en kørende installation til en ny version af OneDoor, se Opgradering.

Konfiguration ​

Øverste konfigurationsfil for OneDoor Server. Læses af septima-search ved opstart og bruges til serverport, CORS, logniveau og frontpage-type. Denne fil ligger øverst i konfigurationshierarkiet. Konfigurationen nedarves til underliggende konfigurationer.

Fil: config/config.json

Indstillinger ​

servername ​

  • Formål: Beskrivende navn for serveren, bruges i API-metadata og fejlbeskeder.
  • Fil: config/config.json, linje 2
  • Værdier: Tekststreng
  • Eksempel: "servername": "Demo"
  • Standard: "Septima Search Server" (hvis udeladt)

port ​

  • Formål: Port som serveren lytter på. Kan overstyres af miljøvariablen PORT.
  • Fil: config/config.json, linje 3
  • Værdier: Tal (fx 3000)
  • Eksempel: "port": 3000
  • Standard: 3000 (hvis udeladt)

logLevel ​

  • Formål: Logniveau for serverlogger (pino). Bruges både ved stdout og fil-logning.
  • Fil: config/config.json, linje 4
  • Værdier: "trace" | "debug" | "info" | "warn" | "error"
  • Eksempel: "logLevel": "debug"
  • Standard: "error" (hvis udeladt)

frontpage ​

  • Formål: Type af forside / startvisning.
  • Fil: config/config.json, linje 5
  • Værdier: "tree" (organisations/configurations-træ) eller anden fordefineret type
  • Eksempel: "frontpage": "tree"
  • Standard: "tree" (hvis udeladt)

uiDevMode ​

  • Formål: Om dev-/bluescreen UI skal vises (fx fejlsider til udvikling).
  • Fil: config/config.json, linje 6
  • Værdier: true | false
  • Eksempel: "uiDevMode": false
  • Standard: false (hvis udeladt)

allow_origins ​

  • Formål: CORS-origins der må kalde API'et. Bruges af CORS-middleware.
  • Fil: config/config.json, linje 7-12
  • Værdier: Array af strenge (URL'er) eller ["*"] for alle
  • Eksempel:
json
"allow_origins": [
  "*",
  "http://septima.dk",
  "http://localhost:7001"
]
  • Standard: ["*"] (alle origins tilladt, hvis udeladt)

Eksempel – fuld config.json ​

json
{
  "servername": "OneDoor test",
  "port": 4000,
  "publicEndpoint": "http://test.onedoor.mitunikkedomæne.dk/",
  "logLevel": "error",
  "frontpage": "tree",
  "uiDevMode": false,
  "allow_origins": ["*", "http://septima.dk", "http://localhost:7001"]
}

Kør OneDoor fra kommandoprompt ​

Start OneDoor med standard-konfigurationen:

UNIX:

bash
CONFIG_PATH=/mnt/data/apps/myonedoor/config node ./node_modules/@septima/onedoor-server/

Windows:

bash
>set CONFIG_PATH=C:\onedoor\sites\onedoor-test.minkommune.dk\config
>node ./node_modules/@septima/onedoor-server/

Valgfri indstillinger ​

Redigér den øverste konfigurationsfil, config.json:

  • servername — et beskrivende navn
  • port — porten serveren lytter på (typisk 3000 eller højere)
  • publicEndpoint — serverens værtsnavn
json
{
  "servername": "minkommune test",
  "port": 4000,
  "logLevel": "error",
  "frontpage": "tree",
  "uiDevMode": false
}