2. De Brocade Registry

2.1. Inleiding

Het Brocade bibliotheeksysteem is verregaand geparametriseerd: meta-informatie bepaalt de specifieke functionaliteit en het uitzicht. Het minitieus parametriseren van een complex systeem kan enkel in een getrapt systeem en met verschillende technologieën.

sommige meta-informatie wordt handmatig verzameld en zijn intrinsiek verbonden met de doelstellingen van een bibliotheeksysteem: catalografische beschrijvingen, gebruikersbeschrijvingen

om deze meta-informatie adequaat te beschrijven heb je instrumenten nodig. Er mee rekening houdend dat niet alle Brocade installaties volgens dezelfde procedures en richtlijnen werken, is er weer meta-informatie nodig om deze instrumenten scherp te stellen naar een specifieke situatie toe.

software en data moeten tenslotte worden geexploiteerd in services: software, data en services moeten concreet worden georganiseerd op servers. Om deze passend - denk: performantie, afscherming, systeemonafhankelijkheid - in te bedden op een actieve machine, moeten er keuzes worden gemaakt die te maken hebben met filesystemen, hardware, netwerking. Deze keuzes moeten op hun beurt worden vastgelegd in meta-informatie. Deze keuzes noemen we in Brocade de registry. De registry is een gestructureerd bestand ergens op de server.

diverse systeem componenten moeten de registry kunnen terugvinden. Daarom wordt de plaats waar de registry zich bevindt vastgelegd in een environment variabele die ter beschikking is van elk proces op de server(BROCADE_REGISTRY).

Warning

BROCADE_REGISTRY moet beschikbaar zijn in elk Brocade process:

in M sessies
in web sessies
in SSH sessies

Deze doorgedreven visie op meta-informatie - een bibliotheeksysteem is het beschrijven van meta-informatie met een paar aanvullende services - biedt zo zijn voordelen:

een eenvoudige richtlijn om bibliotheek software te construeren: laat de software passen in dit getrapt model

terugvindbaarheid van de diverse componenten door het getrapte systeem af te dalen of op te klimmen

afstelbaarheid van het bibliotheeksysteem naar lokale noden

onafhankelijkheid van de hardware

onafhankelijkheid van het operating system

2.2. Structuur van de registry

De registry is opgeslagen in een file op het filesysteem van de server. De structuur is een eenvoudige key/value store, verwoord in een JSON object. De key is wat in de Brocade software wordt gebruikt en welke in runtime of bij installatie door de onderliggende software wordt omgezet in de value.

De plaats waar de registry wordt bewaard komt uit een environment variabele BROCADE_REGISTRY. De system administrator stelt deze environment variabele (en de bijhorende locatie) ter beschikking van elk Brocade process (interactieve shells, Web interface, SSH).

Beste praktijk (op een UN*X systeem):

export BASE=r4_database_base_dir
export BROCADE_REGISTRY=$BASE/registry/registry.json
mkdir -p $BASE/registry/private
touch $BROCADE_REGISTRY
chmod --reference=$BASE $BASE/registry
chown --reference=$BASE $BASE/registry/registry.json
chmod u=rw,g=r,o= $BASE/registry/registry.json
touch $BASE/registry/localregistry.json
chown --reference=$BASE/registry/registry.json $BASE/registry/localregistry.json
chmod --reference=$BASE/registry/registry.json $BASE/registry/localregistry.json
touch $BASE/registry/saltregistry.json
chown --reference=$BASE/registry/registry.json $BASE/registry/saltregistry.json
chmod --reference=$BASE/registry/registry.json $BASE/registry/saltregistry.json

De registry wordt opgebouwd uit 7 soorten bestanden:

registry.json

Dit bestand bevat de actieve registry. Het bevragen van de registry komt neer op het opzoeken van een sleutel in dit JSON bestand.

De inhoud van dit JSON bestand kan ook worden getoond door:

jq "." $BROCADE_REGISTRY

localregistry.json

Dit bestand kan manueel worden gevuld met registry waarden. De sleutels en hun waarden hebben absolute voorrang.`

saltregistry.json

Dit bestand bevat core registry waarden aangemaakt door |Ansible| . Deze sleutels en hun waarden worden enkel geinstalleerd door Ansible indien die nog niet bestaan in registry.

/core/brocade/release.py

Deze script wordt uitgevoerd bij elke bootstrap van Brocade. Deze script vult ontbrekende registry waarden in maar overschrijft geen waarden.

*/release.py

Deze release scripts uit de diverse projecten kunnen registry waarden definiëren die nieuw zijn en die relevant zijn voor de betreffende projecten.

Het doordrukken van de waarden uit saltregistry.json en localregistry.json gebeurt door de instructie:

delphi reset

Deze instructie moet ook worden uitgevoerd bij de aanvang van elk Brocade bootstrap.

Voor redenen van performantie en gebruikersgemak wordt deze JSON structuur ook omgezet naar een MUMPS structuur. Deze omzetting gaat automatisch.

De sleutels zijn strings en worden samengesteld volgens de reguliere uitdrukking [a-z][a-z0-9-]*[a-z0-9]. In de sleutel wordt het koppelteken HYPHEN-MINUS

Er zijn een aantal (niet-bindende) afspraken:

de eerste component duidt het grote gebied aan waarvoor de sleutel wordt gebruikt: vb. process-base-dir

een directory eindigt op -dir

een executable eindigt op -exe

een URL eindigt op -url

bestandsnaam eindigt op -file

registry sleutels die een wachtwoord bevatten, moeten eindigen op -password!

de Brocade software moet zowel met http als met https kunnen worden gebruikt, afhankelijk van de keuze van de gebruiker. Gebruik daarom voor URLs steeds een absolute-path reference

sommige waarden zijn commando's uit te voeren in de shell:

beperk dit zoveel mogelijk

laat PATH zijn werk doen

gebruik nooit wildcards

zorg ervoor dat deze commando's geconstrueerd zijn volgens de richtlijnen van de Bourne shell (POSIX)

2.3. Samenstellen van de registry

Sleutels in de registry zijn niet evenwaardig:

sommige sleutels zijn berekenbaar en worden enkel opgenomen omdat het berekenen ervan te omslachtig is of te veel tijd zou nemen. Een voorbeeld hiervan is os-sep (separator van directories en bestandsnamen)

sommigen zijn afhankelijk van andere sleutels: vb. xml-catalog-dir is afhankelijk van web-base-dir.

Een ontwikkelaar die een nieuwe registry waarde nodig heeft, volgt de volgende stappen:

Is de nieuwe registry waarde afhankelijk van een reeds bestaande registry waarde, definieer dan in release.py de nieuwe registry waarde
Is de nieuwe registry waarde in te stellen door de system administrator, definieer dan de registry waarde in /core/brocade/release.py. De ontwikkelaar kan 2 strategieën volgen:
- is er een goede default waarde, neem dan deze
- kies anders een waarde die de installatie van het project doet falen
De ontwikkelaar documenteert deze registry waarde in de release notes.

De systeem administator kan een JSON bestand aanmaken dat hij over verschillende servers heen kan gebruiken. De naam van dit tekstbestand is localregistry.json en staat in dezelfde directory en heeft dezelfde toegangsstructuur als de registry zelf. Hij kan in dit bestand waarden specificeren die afwijken van de voorgestelde waarden. Let wel: de waarden in localregistry.json worden enkel gebruikt bij het bootstrappen van Brocade en indien de waarde zelf nog niet is gedefinieerd in registry.json

2.4. Gebruik van de registry

De registry wordt het best bevraagd via de delphi.

Er zijn een paar details die belangrijk zijn om weten:

bij de bevraging van de registry mag HYPHEN-MINUS in de sleutel ook worden vervangen door een LOW LINE
eindigt de sleutel op een HYPHEN-MINUS en begint de waarde met een SOLIDUS, dan wordt de inhoud van registry(web-base-url) geplaats vóór de waarde in de sleutel (zonder eindigende HYPHEN-MINUS)
het opvragen van een sleutel die eindigt op een COLON geeft de documentatie van deze sleutel zonder deze COLON

MUMPS

Gebruik de macro:

macro getDelphiValue($value, $key):
    '''
    $synopsis: verkrijg, gegeven een bepaalde sleutel, de Delphi waarde
    $value: de Delphi waarde
    $key: de Delphi sleutel
    $example: m4_getDelphiValue(value=value,key="docman-file")
    '''
    «s $value=$$%Get^uresget($key)»

Python2

Gebruik de constructie:

from anet.core.registry import registry

key = 'os-sep'
value = registry(key, 'default')

Python3

Gebruik de constructie:

from anet.core.base import registry

key = 'os-sep'
value = registry(key, "default")

In tekstbestanden kan steeds de constructie r4_key worden gebruikt. key is een registry sleutel met LOW LINE notatie. Het installatieproces gaat dan deze constructie vervangen door de waarde in de registry.

Deze techniek is soms de enige om aan parametrisering te doen. Toch is deze niet aan te raden: in situaties (MUMPS, Python2, Python3) waar zonder performantieverlies andere oplossingen bestaan, zijn deze te verkiezen.

2.5. delphi --- Interactief werken met de registry

Naam voor de executable: delphi

De delphi toolcatapplicatie beheert de registry waarden die in Brocade gebruikt worden. Hiermee kan je de waarden opzoeken, verwijderen en aanmaken.

info	Informatie omtrent de Brocade registry
list	Oplijsting Brocade registry sleutels
key	Geef waarde van een registry sleutel
add	Voeg een (key, value) toe aan Delphi
delete	Verwijder een registry waarde
search	Zoek registry keys/waarden
refresh	Vernieuw de registry waarden in Mumps
reset	Maak/overschrijf alle core registry waarden van de Brocade registry
sdoc	Voeg documentatie toe aan een registry key
doc	Vraagt de documentatie van een specifieke delphi waarde op.
lastsession	Zet het laatste sessienummer als delphi waarde lowest-session-allowed.

2.5.1. `info` --- Informatie omtrent de Brocade registry

Triggers

delphi info ...

Beschrijving

Toont de environment variabele voor de Brocade registry

Voorbeelden

delphi info

Argumenten

Geen argumenten

2.5.2. `list` --- Oplijsting Brocade registry sleutels

Triggers

delphi list ...

Beschrijving

Geeft alle Brocade registry sleutels op met hun waarden. Met 'undocumented' worden alle sleutels terug gegeven die geen commentaar string (.rst) hebben.

Voorbeelden

delphi list
delphi list all=True
delphi list undocumented=True

Argumenten

Geen argumenten

Modifiers

all

betekenis	geeft alle sleutels en waarden weer (ook documentatie)
default	false
type	boole

undocumented

betekenis	geeft enkel de sleutels en waarden weer die geen documentatie hebben
default	false
type	boole

2.5.3. `key` --- Geef waarde van een registry sleutel

Triggers

delphi key ...

Beschrijving

Geeft de waarde van een specifieke Brocade registry sleutel weer. Geeft None terug als de sleutel niet bestaat.

Voorbeelden

delphi key sgml-parser-exe

Argumenten

Argument 1

betekenis	de sleutel wiens waarde getoond moet worden
type	string

2.5.4. `add` --- Voeg een (key, value) toe aan Delphi

Triggers

delphi add ...

Beschrijving

Voeg een registry waarde toe met een specifieke value. Indien een value al bestaat, gebruik force=1 om te overschrijven. Als de waarde niet wordt meegegeven, dan wordt ernaar gevraagd (behalve als force=0 en de registry waarde al bestaat).

!!Het is niet de bedoeling dat via add de uitleg van een registry waarde wordt toegevoegd!! Deze uitleg moet in de correcte .rst komen te staan.

Als de waarde beheerd wordt door ansible dan wordt dit gemeld en moet in principe de waarde ook aangepast worden in project /ansible/servers/all/registry.yaml of meer specifiek in /ansible/servers/[servername]/registry.yaml

Voorbeelden

delphi add m-type
delphi add shell-exe /bin/sh force=yes

Argumenten

Argument 1

betekenis	De sleutel van een nieuwe registry item
type	string
lower	ja

Andere argumenten

betekenis	De waarde van het nieuwe registry item
aantal	0..1
type	string

Modifiers

empty

betekenis	Zet de waarde leeg
default	false
type	boole

force

betekenis	Overschrijf een bestaande registry waarde met dezelfde naam
default	false
type	boole

nosalt

betekenis	Hou geen rekening met waarden die beheerd worden door Ansible.
default	true
type	boole

2.5.5. `delete` --- Verwijder een registry waarde

Triggers

delphi del ...

Beschrijving

Verwijdert een registry waarde door middel van de sleutel (key) op te geven. Door verbose te gebruiken kan je zien welke waarde de sleutel (die je hebt verwijderd) had. Indien de uitleg string ook verwijderd moet worden, vergeet dan niet het .rst bestand weg te halen.

De documentatie van de registry waarde wordt niet verwijderd. Als deze bestaat, moet het .rst bestand uit het repository worden gehaald EN moet delphi delete key: worden gebruikt, de ':' toont dat het de documentatie waarde is.

Als de waarde beheerd wordt door ansible dan wordt dit gemeld en moet in principe de waarde ook aangepast worden in project /ansible/servers/all/registry.yaml of meer specifiek in /ansible/servers/[servername]/registry.yaml

Voorbeelden

delphi delete test-sleutel-naam verbose=true

Argumenten

Argument 1

betekenis	De sleutel van een bestaand registry item
type	string

Modifiers

nosalt

betekenis	Hou geen rekening met waarden die beheerd worden door Ansible.
default	true
type	boole

2.5.6. `search` --- Zoek registry keys/waarden

Triggers

delphi se ...

Beschrijving

Zoekt registry waarden/sleutels op door middel van een opgegeven (gedeeltelijke) zoekterm. Kan ook in de documentatie zoeken als aangegeven, dit staat standaard af.

Voorbeelden

delphi search system-
delphi search cache gtm
delphi search Zebra doc=true
delphi search TEST lower=true

Argumenten

Argument 1

betekenis	Een zoekterm om een bestaand registry waarde/sleutel te zoeken
type	string

Modifiers

doc

betekenis	Indien False dan wordt er niet op de gedocumenteerde uitleg gezocht van de zoekterm. Enkel de sleutel en de waarde worden doorzocht, niet de uitleg.
default	false
type	boole

lower

betekenis	Als False dan wordt er gezocht op lower en upper case karakters. Zoek je op 'Test', zal 'test' er ook uit komen.
default	false
type	boole

2.5.7. `refresh` --- Vernieuw de registry waarden in Mumps

Triggers

delphi refresh ...

Beschrijving

Vernieuwt de registry waarden in Mumps door ze vanuit json op te gaan halen en in een global te zetten.

Voorbeelden

delphi refresh

Argumenten

Geen argumenten

2.5.8. `reset` --- Maak/overschrijf alle core registry waarden van de Brocade registry

Triggers

delphi reset ...

Beschrijving

Reset alle Brocade registry sleutels naar de waarden die in Local of Ansible gedefinieerd zijn. Ansible past enkel waarden aan indien die niet bestaan in Registry. De hiërarchie is: Local > Registry > Ansible. Verbose toont welke sleutels gezet worden vanuit Local of Ansible. Een waarde kan 2x gezet worden (1x vanuit Ansible, erna nogmaals vanuit Local).

Voorbeelden

delphi reset
delphi reset verbose=true
delphi reset complete=true

Argumenten

Geen argumenten

Modifiers

complete

betekenis	Past ook de access codes aan van de bestanden en de directories
default	nee
type	boole

nosalt

betekenis	Hou geen rekening met waarden die beheerd worden door Ansible.
default	true
type	boole

2.5.9. `sdoc` --- Voeg documentatie toe aan een registry key

Triggers

delphi sdoc ...

Beschrijving

Voeg een documentatie string toe aan een bestaande registry key. Deze applicatie maakt een .rst bestand en zorgt ervoor dat deze .rst opgeladen wordt via qtechng. Er wordt geprompt naar de documentatie string indien deze niet wordt meegegeven.

Tijdens het ingeven van de string is een 'enter' het einde van de in te geven documentatie string.

Als de registry key niet bestaat, wordt er geen documentatie weggeschreven.

!!Overschrijft enkel met gebruik van force=True

Voorbeelden

delphi sdoc web-browser
delphi sdoc
delphi sdoc web-browser force=True

Argumenten

Argumenten

betekenis	De registry sleutel
aantal	0..1
type	string
lower	ja

Modifiers

force

betekenis	Enkel bij true wordt een alreeds bestaande documentatie overschreven. Als niet gedefinieerd, wordt het enkel aangemaakt indien er nog geen documentatie bestaat.
default	false
type	boole

2.5.10. `doc` --- Vraagt de documentatie van een specifieke delphi waarde op.

Triggers

delphi doc ...

Beschrijving

Vraagt de documentatie van een gegeven delphi waarde op. Als er geen documentatie is OF de delphi waarde bestaat niet, wordt None teruggegeven.

Voorbeelden

delphi doc web-browser
delphi doc

Argumenten

Argumenten

betekenis	De waarde van de delphi key
aantal	1
type	string

2.5.11. `lastsession` --- Zet het laatste sessienummer als delphi waarde lowest-session-allowed.

Triggers

delphi lastsession ...

Beschrijving

Haalt via Mumps het laatst gebruikte sessienummer op. De delphi waarde lowest-session-allowed wordt hierop gezet.

Voorbeelden

delphi lastsession

Argumenten

Geen argumenten

2.6. Documentatie van de registry

De registry waarden worden gedocumenteerd in project /doc/registry.

Is xyz een registry sleutel, maak dan een bestand xyz.rst aan en noteer in dit bestand wat de registry waarde betekent.

Hanteer daarbij de volgende afspraken:

gebruik /doc/registry/os-sep.rst als voorbeeld
documentatie in reST
in de documentatie heeft de effectieve waarde geen zin (het systeem gaat dat zelf wel tonen)
vermeld zeker de intentie van de registry sleutel en bijzonderheden (restricties) op de waarde.

De documentatie van de registry waarden die niet langer worden gebruikt in de software, moeten handmatig worden geschrapt in het project /doc/registry.

Warning

Maak het onderscheid tussen registry waarden die niet gedefinieerd zijn maar die toch worden gebruikt in de software. De documentatie van deze registry waarden moet vanzelfsprekend blijven bestaan.

2.7. Registry sleutels

$schema

https://anet.be/brocade/schema/registry.schema.json

aat-db

/library/process/aat/AAT.xml
Filepath naar de XML download van de AAT dataset van Getty

aat-process-dir

/library/process/aat
Directory waar AAT bestanden geplaatst worden.

acadbib-process-dir

/library/process/acadbib
De naam van de processdirectory voor verwerking van de Academische Bibliografie

acadbib-url

/acadbib
De (relatieve) url naar de startpagine voor de Academische bibliografie

acadbib-web-dir

/library/httpd/htdocs/acadbib
De naam van de directory, waar de hulpbestanden worden geplaatst voor de webomgeving van de Academische Bibliografie.

acqactionlist-process-dir

/library/process/acqlist

acqorderlist-process-dir

/library/process/acqorderlist

anet-support-dir

/library/process/anetsupport
Directory met tooling specifiek voor Anet servers

ansible-dir

/library/ansible

ansible-master

dev.anet.be

ansible-store

root@dev.anet.be:/library/database/ansible/store/

antilope-webdir

/library/httpd/htdocs/antilope
Directory, waar de export Antilope files ter beschikking worden gesteld voor derden.

antilope-weburl

/antilope/antilope.xml
URL , die verwijst naar de beschikbare Antilope export file.

apache-contentroot-dir

/library/httpd
'parent directory' van 'Apache Document Root Directory'

archive-base-dir

/library/archive
Dit is een directory waarin documenten worden bewaard die niet actief zijn maar die toch niet mogen worden geschrapt.

autocomplete-dir

/library/httpd/htdocs/brocade/autocomplete

autocomplete-url

/brocade/autocomplete

awlijst-archive-dir

/library/archive/awlijst
Op regelmatige tijdstippen produceert Brocade aanwinstenlijsten.

Deze registry waarde geeft de plaats aan waar de bestanden worden gearchiveerd.

awlijst-dir

/library/process/bibliografie/awlijst
Op regelmatige tijdstippen produceert Brocade aanwinstenlijsten.

Deze registry waarde geeft de plaats aan in het filesysteem waar dit gebeurt.

awlijst-webdir

/library/httpd/htdocs/awlijst
Op regelmatige tijdstippen produceert Brocade aanwinstenlijsten.

Deze registry waarde geeft de plaats aan waar de bestanden worden ondergebracht in de documentroot van de webserver.

awlijst-weburl

/awlijst
Op regelmatige tijdstippen produceert Brocade aanwinstenlijsten.

Deze registry waarde geeft de URL aan hoe de bestanden via het web kunnen worden geraadpleegd.

background-log-dead

14
Aantal dagen, dat de verwerkte background transacties worden bijgehouden.

background-stopfile

/library/tmp/background_stopfile
De naam van de background stopfile. Het bestaan van deze file verhindert het opstarten van het background proces.

background-time-between

900
Het minimum aantal seconden tussen twee sessies van de background verwerking.

backup-dir

/backup

backup-process-dir

/library/process/backup

backup-relay

nas1.cde.ua.ac.be

backup-rsync-exe

rsync -aP --delete --delete-excluded --link-dest=<linkdest> <sourcedir> <targetdir>

backup-send-dir

scp -r -q -p -o ControlPath=<controlmaster> <sourcedir>/. <host>:<targetdir>

backup-send-file

scp -q -p -o ControlPath=<controlmaster> <sourcefile> <host>:<targetfile>

backup-send-init

ssh -t -t -o ControlMaster=yes -o ControlPath=<controlmaster> <host>

backup-send-sansvc

rsync -aWR --delete --force --stats --rsh=ssh <sourcedir> backup-232.anet.be:<targetdir>

backup-send-withvc

rsync -aWR --delete --force --modify-window=60 --stats --rsh=ssh <sourcedir> backup-232.anet.be:<targetdir>

backup-server

backup-232.anet.be

backup-ssh

/bin/ssh -q <host> backup -ssh

backup-type

client

biblion-process-dir

/library/process/biblion
De naam van de directory, waarin de verwerking van Biblion files zich afspeelt.

bindir

/library/bin
Een directory waarin Brocade de binaries installeert die worden ontwikkeld binnen het Brocade project zelf. Hier staan ondermeer de toolcatapplicaties.

Deze directory moet onderdeel zijn van de PATH environment variabele

boot-exe

/sbin/shutdown -r +1 'Brocade reboot:'
De executable, die het herstarten van de server teweegbrengt.

brocade-common-dir

/library/httpd/htdocs/brocade/common
Dit is een directory in de documentroot van de webserver, waarin externe Javascript libraries worden opgeslagen.

brocade-common-url

/brocade/common
Dit is een URI reference naar de directory brocade-common-dir.

Deze URI moet een Relative Reference zijn van de gedaante absolute-path reference. Zie RFC 3986 voor meer details.

brocade-jquery-ui-home-dir

/library/httpd/htdocs/brocade/common/js/jquery-ui
Dit is een directory in de documentroot van de webserver, waarin externe jquery plugins worden opgeslagen.

brocade-jquery-ui-home-url

/brocade/common/js/jquery-ui
Dit is een URI reference naar de directory brocade-jquery-ui-home-dir.

Deze URI moet een Relative Reference zijn van de gedaante absolute-path reference. Zie RFC 3986 voor meer details.

brocade-js-home-dir

/library/httpd/htdocs/brocade/js
Dit is een directory in de documentroot van de webserver, waarin interne Javascript libraries worden opgeslagen.

brocade-js-home-url

/brocade/js
Dit is een URI reference naar de directory brocade-js-home-dir.

Deze URI moet een Relative Reference zijn van de gedaante absolute-path reference. Zie RFC 3986 voor meer details.

brocade-latex-styles

/packages/texlive/texmf-dist/tex/latex/brocade

brocade-layout-dir

/library/httpd/htdocs/brocade/layout
Dit is een directory in de documentroot van de webserver, waarin Brocade layouts worden opgeslagen.

brocade-layout-url

/brocade/layout
Dit is een URI reference naar de directory brocade-layout-dir.

Deze URI moet een Relative Reference zijn van de gedaante absolute-path reference. Zie RFC 3986 voor meer details.

brocade-localweb-url

/brocade/localweb.html

brocade-phpinclude-dir

/library/process/phpinclude
Deze registry waarde is een directory in het lokale file systeem. Hij specificeert de plaats waar de PHP include files zich bevinden.

Zorg ervoor dat deze directory zich bevindt buiten de documentroot van de webserver.

brocade-publicdoc-dir

/library/httpd/htdocs/brocade/publicdoc

brocade-publicdoc-url

/brocade/publicdoc

brocade-registry-file

/library/database/registry/registry.json
Dit is de bestandsnaam van het JSON bestand die de registry bevat.

Deze sleutel wordt automatisch gegenereerd uit de environment variabele BROCADE_REGISTRY.

brocade-release

6.20
Dit is de het versie nummer van de lopende Brocade release.

Verwar deze waarde niet met registry(qtechng-version).

brocade-release-say

6.20
Dit is een verwoording van het versie nummer van de lopende Brocade release.

Deze waarde is meestal gelijk aan registry("brocade-release").

Op de ontwikkelserver wordt deze standaard aangevuld met het label beta.

brocade-start-url

/brocade/index.phtml

brocade-web-home-dir

/library/httpd/htdocs/brocade

brocade-web-home-url

/brocade

brocade-workstation-file

/library/httpd/htdocs/workstations/<wks>.html

brocade-workstation-url

/workstations/<wks>.html

bvv-url

/bvv

catcnv-process-dir

/library/process/catcnv
Directory, waarin toolcat applicatie catcnv zijn logging en status informatie bewaart.

catcnv-web-dir

/library/httpd/htdocs/catcnv
De directory, waar logging/status informatie over import procedures via catcnv wordt bijgehouden. Komt overeen met de url catcnv-web-url .

catcnv-web-url

/catcnv
De URL, verwijzend naar logging/status informatie over import procedures via catcnv .

character-home

/library/httpd/htdocs/brocade/karakters

cleandir-db

/library/process/cleandirs/cleandir.file

cleandir-exe

/library/bin/cleandirs -empty

clipboard-read-url

/clipboard/clipread.phtml
Deze registry waarde wordt gebruikt bij clipboard acties.

Soms gebeurt het dat deze actie een verandering aan de actuele webpagina met zich meebrengt. Een goed voorbeeld hiervan is de aanpassing van de gegevens van een lezer aan de hand van de electronische identiteitskaart.

De update van het browser scherm gebeurt via een asynchrone Javascript request. Deze heeft nood aan een URL en deze wordt door deze registry waarde gegeven. Merk op dat dit een server-relatieve URL is.

clipboard-write-url

/clipboard/clipwrite.phtml
eze registry waarde wordt gebruikt bij clipboard acties.

Soms gebeurt het dat deze actie data naar de server moet sturen.

Daartoe moet de toepassing op het werkstation de beschikking hebben over een URL waar gegevens kunnen naar toe worden gestuurd. Deze wordt dan gespcificeerd in deze registry waarde. Merk op dat dit een server-relatieve URL is.

code-signing-password

********************

convant-process-dir

/library/process/convant
Naam van de process directory van de toolcat applicatie convant

crunch-db-dir

/library/process/crunch
De naam van de directory, waar de python module crunch, die de groei van file systemen en databanken onderzoekt, zowel zijn statistische als configuratie gegevens beheert.

currency-update-url

https://www.ecb.int/stats/eurofxref/eurofxref-daily.xml

database-base-dir

/library/database

deepl-translate-privatekey

59dea59b-0859-f61c-793d-7db407d9851a:fx
Key om de DeepL translator (https://www.deepl.com/en/translator) API aan te spreken. Wordt gebruikt door QtechNG.

delphi-db

/packages/py2/anet/registry.py
De volledige pathnaam van de python 2 file registry.py, die de registry waarden bevat. Voorbeeld : /library/python2.7/lib/python2.7/site-packages/anet/registry.py

desktop-admin-password

********************
Dit is het wachtwoord waarmee een systeem administrator toegang krijgt tot de services op de diverse desktops.

desktop-archive-dir

/library/archive/desktop

desktop-authenticate-dir

/library/httpd/htdocs/desktop

desktop-authenticate-url

/desktop/iam.phtml

desktop-authenticate-web-base-dir

/desktop

desktop-default

uantwerpen

desktop-install-dir

/library/process/desktop/meta

desktop-process-dir

/library/process/desktop

desktop-start-file

/library/httpd/htdocs/desktop.phtml

desktop-start-url

/desktop.phtml

desktop-web-base-dir

/library/httpd/htdocs/desktop

desktop-web-base-url

/desktop

digcat-rsync-destination

destination

digcat-rsync-host

scanpc

digcat-rsync-source

source

digiplat-process-dir

/library/process/digiplat

digiplat-secret-shared-key

f5b796fe655e7d0439e2066de3c1261d

discovery-ebsco-update-file

/library/process/discovery/ebsco/anetmarc21-20240413.xml
Naam van de actuele output file voor Ebsco

discovery-ebscoartap-update-file

/library/process/discovery/ebscoartap/anetmarc21-20240413.xml

discovery-ebscoartkdg-update-file

/library/process/discovery/ebscoartkdg/anetmarc21-20240413.xml

discovery-summonuh-update-file

/library/process/discovery/summonuh/anetmarc21-20240414.xml

discovery-unicat-update-file

/library/process/discovery/unicat/anetmarc21-20240414.xml
Naam van de actuele output file voor Unicat

dns-name

anet.be
De DNS naam van de Brocade server, zoals ze wordt gebruikt in de Brocade software.

doc-group-default

doc-sphinx-auth

sphinx.anet.authorityrules
Dit is de handle (sphinx.group.unit) voor de handleiding voor het gebruik van authority bestanden

doc-sphinx-authorities

sphinx.anet.authorities
Dit is de handle (sphinx.group.unit) voor de handleiding voor het gebruik van authority (nieuwe stijl)

doc-sphinx-cat

sphinx.anet.anetcatstart
Dit is de handle (sphinx.group.unit) voor de handleiding voor de handleiding catalografie.

doc-sphinx-copyright

2021 Anet
Default tekst die de copyright van de documentie moet dragen

doc-sphinx-enabled

1
Zet de waarde op 1 indien de documentatie met Sphinx moet worden uitgevoerd.

doc-sphinx-logo

/library/httpd/htdocs/brocade/layout/doc.png
Default logo voor de documentatie

doc-sphinx-rst

doc-sphinx-theme

anet
Default thema voor de documentatie

docbook-dsl-dir

/library/httpd/htdocs/brocade/catalog/stylesheets
De naam van de directory, waarin de stylesheets voor de docbook applicatie terechtkomen

docman-db

/library/database/docman
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is de naam van een directory: de bestanden worden bewaard is subdirectories. Het filesysteem bij deze directory moet in staat zijn om een massale hoeveelheid aan data te bevatten.

docman-file

/library/httpd/htdocs/docman/docman.phtml
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is de filenaam van de PHP die via het web toegang biedt tot de docman bestanden.

docman-host

localhost
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is de DNS naam van de webserver die toegang biedt tot de docman bestanden zonder gebruik te maken van een mounting technologie.

docman-original-url-complete

docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze registry waarde is optioneel. Het geeft de waarde aan van de URL aan waarmee de PHP script docman.phtml moet worden geaddresseerd. Zorg ervoor dat het protocol HTTPS is.

docman-process-dir

/library/process/docman
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is de naam van een directory waarin docman allerlei diagnostische informatie en statistieken schrijft.

docman-redirect

0
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is 0 of 1. Indien deze waarde 1 is, dan gaat de webserver elke referentie naar een docman bestand op de productieserver vertalen naar een adres op registry(docman-host).

docman-url

/docman/docman.phtml
docman is het systeem dat Brocade gebruikt om statische bestanden op schijf op te slaan.

Deze waarde is een absolute-path reference naar registry(docman-file)

docstore-db

/library/process/docstore/docstore.sqlite
Het pad naar de SQLite databank die gebruikt wordt om de externe download van docstore files te organiseren (zie ook toolcat applicatie rosetta)

docstore-file

/library/httpd/htdocs/docstore/docstore.phtml
het pad naar de .phtml file die externe docstore downloads organiseert

docstore-process-dir

/library/process/docstore
de folder waarin docstore-db en de loggings van docstore-file bewaard worden

docstore-url

/docstore/docstore.phtml
de URL voor externe docstore downloads

dspace-handle

dspace-postgres-bindir

/usr/bin

dspace-postgres-datadir

/var/lib/pgsql/data

dspace-postgres-script

/etc/init.d/postgresql

dspace-process-dir

/library/process/dspace

dspace-source-dir

/ds

dspace-tomcat-bindir

/usr/apache/tomcat55/bin

dspace-tomcat-script

/etc/init.d/tomcat6

dspace-user

dspace

dvips-exe

/opt/texbin/dvips -o

erm-process-dir

/library/process/erm

errorlog-account

errorlog:errorlog

errorlog-db

/library/database/roundup/trackers/errorlog

errorlog-mailbox

errorlog@anet.be

errorlog-main-dir

/library/process/errorlog

explorator-daemon-url

http://127.0.0.1:11111/explorator
Explorator kan als daemon draaien en aangesproken worden via deze basis-url.

explorator-database-dir

/library/database/explorator
De rootdirectory voor alle explorator indexen.

explorator-process-dir

/library/process/explorator
De werkdirectory voor de Explorator toolcatapplicatie. In subdirectory daemon komen alle log- en errorfiles van de daemon terecht.

explorator-update-dir

/library/process/explorator/update
Werkdirectory voor de updatethread van de Explorator daemon, indien de update-queue met bestanden werkt in plaats van globals.

explorator-web-dir

/library/httpd/htdocs/explorator
Webdirectory voor phtml- en js-scripts van de Explorator toepassing.

external-process-dir

/library/process/external

fs-owner-daemon

root:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

daemon staat voor scripts die als een system daemon worden uitgevoerd.

fs-owner-naked

apache:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

naked staat voor bestanden die voor iedereen toegankelijk zijn.

fs-owner-process

root:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

process staat voor bestanden die data bevatten voor de diverse Brocade processen.

fs-owner-qtech

root:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

qtech staat voor de bestanden die door de qtech toepassing worden beheerd.

fs-owner-script

root:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

script staat voor de executables die door Brocade worden aangemaakt.

fs-owner-temp

apache:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

temp staat voor tijdelijke bestanden: bestanden die na afloop van het proces mogen worden verwijderd.

fs-owner-web

root:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

web staat voor de bestanden die toegankelijk zijn via de web server.

fs-owner-webdav

apache:db
De waarde bij deze sleutel is van de vorm uid:gid. Deze sleutel regelt het eigenaarschap van bestanden en directories. uid zegt wat de user identifier is van deze bestanden, gid staat voor de group identifier.

webdav staat voor de bestanden die toegankelijk zijn voor WebDAV clients

fullcalendar-password

********************
De licentie key voor FullCalendar.io gebruikt voor de visualisatie van Caerus

gabriel-email

gabriel@mail.anet.be
Het afzender e-mail adres gabriel berichten. Gabriel is een toepassing, die jou e-mails stuurt op geregelde basis, om je aan iets te doen herinneren, wanneer jij dat wil.

getbootstrap-dir

/library/httpd/htdocs/brocade/bootstrap

getbootstrap-url

/brocade/bootstrap

glyph-char-url

/brocade/karakters/oc<glyph>.gif

google-translate-privatekey

/library/process/googleapi/translation-of-lgcodes-13ed844859ba.json
Key om de Google translate (https://translate.google.com/) API aan te spreken. Wordt gebruikt door QtechNG.

gtar-exe

/bin/gtar
gnu tar executable

gtm-install-dir

/packages/gtm
Directory, waar de GT.M binaries worden uitgepakt. Enkel voor systemen, draaiend met GT.M.

gtm-rou-dir

/library/mumps/brocade/r
De naam van de directory, waarin de m routines zich bevinden, als files met extensie .m . Enkel voor GT.M systemen.

gtm-rou-object-dir

/library/mumps/brocade/o
De naam van de directory, waarin de gecompileerde objecten (extensie .o) van m routines zich bevinden. Enkel voor GT.M systemen.

helpdesk

helpdesk@anet.be
Het e-mailadres waar helpdeskberichten naartoe gestuurd worden.

helpdesk-start-url

/brocade/helpdesk.phtml
De URL die opgestart wordt door de helpdeskknop in de Brocade taakbalk.

hg-base-dir

/library/process/hg

html2pdf

/packages/bin/htmldoc --webpage --bodyfont times --charset 8859-1 --fontsize 12 --footer ..1 --header .t. --headfootsize 8 --size A4 --right 2cm -f

zie htmldoc. Gebruikt in /acquisitie/application/bacwsbre.m

html2text

lynx -dump

iiif-base-dir

/library/database/iiif
Deze registry waarde duidt de root directory aan waar de IIIF sqlite bestanden worden geplaatst.

iiif-base-url

/iiif
Basis URL waaronder de Brocade IIIF APIs beschikbaar zijn.

iiif-index-db

/library/database/iiif/index.sqlite
Deze registry waarde duidt het pad aan van de SQLite databank die gebruikt wordt als index voor IIIF. Daarin worden IIIF identifiers gelinkt aan IIIF digests.

iiif-max-parallel

15
Het maximum aantal images dat iiiftool parallel mag converteren.

Een voorbeeldwaarde is 5. Vegelijk verschillende waardes voor dg:ua:303 (= 155 images):
# iiif-max-parallel=1
real 6m10.287s user 5m41.900s sys 0m20.534s

# iiif-max-parallel=5 real 1m23.880s user 6m15.398s sys 0m21.380s

# iiif-max-parallel=10 real 0m50.255s user 7m12.761s sys 0m22.790s

# iiif-max-parallel=15 real 0m37.619s user 7m41.938s sys 0m23.610s

iiif-mirador-base-url

/brocade/imageviewer/mirador
Basis URL waaronder de Brocade IIIF Mirador viewer beschikbaar is.

iiif-mirador-web-dir

/library/httpd/htdocs/brocade/imageviewer/mirador
Webdirectory waarin de Brocade IIIF Mirador viewer geïnstalleerd wordt.

iiif-universalviewer-base-url

/brocade/imageviewer/universalviewer
Basis URL waaronder de Brocade IIIF Universal Viewer beschikbaar is.

iiif-universalviewer-web-dir

/library/httpd/htdocs/brocade/imageviewer/universalviewer
Webdirectory waarin de Brocade IIIF Universal Viewer geïnstalleerd wordt.

iiif-web-dir

/library/httpd/htdocs/iiif
Deze registry waarde duidt de webdirectory voor IIIF aan.

impacq-mailbox-identifier

acquisitie

impala-desktop-url

https://anet.be/impala

impala-invoice

ebs
Deze registry waarde geeft aan welk systeem van facturatie wordt gebruikt in Impala. Vul deze waarde in met ebs is EBS wordt gebruikt.

impala-mail

impala@anet.be

impala-mailbox

impala

impala-redirect-mail

helpdesk@anet.be

impala-resolver

https://anet.be/openurl/impala

impalagateway-process-dir

/library/process/impalagateway

impstat-process-dir

/library/process/impstat

intranet-base-dir

/usr/netscape

inventory-process-dir

/library/process/inventory
Directory voor het aanmaken en verwerken van een boekeninventaris.

ir-process-dir

/library/process/ir

ir-ssh-exe

ssh -q <host> '<command>'

ir-transfer-exe

scp -q -p <sourcefile> <host>:<targetfile>

isbndb-accesskey

TTCKMH29
Toegangscode voor isbndb.com

isbndb-base-url

http://isbndb.com/api
Basisurl voor de api isbndb.com. Voorbeeld : http://isbndb.com/api

isbndb-book-link

/books.xml?access_key=<accesskey>&index1=isbn&value1=<bookid>
Template naar een link van een boek op isbndb.com. Voorbeeld : /books.xml?access_key=<accesskey>&index1=isbn&value1=<bookid>

isbndb-publisher-link

/publishers.xml?access_key=<accesskey>&index1=publisher_id&value1=<pubid>
Template voor isbndb.com voor de link naar de uitgever. Voorbeeld : /publishers.xml?access_key=<accesskey>&index1=publisher_id&value1=<pubid>

java-exe

/bin/java

jira-api-auth

Basic Ym90QGFuZXQuYmU6S2FDWWtINjVuSmtGbjQ5d1QzUzdDNzUy
De basic auth van de jira-bot-user om vanuit /universe/jira connectie te maken met de REST api van onze Jira instantie.

jira-api-base

https://brocade.atlassian.net/rest/api/2/
De basis url van de REST api van onze jira instance.

jira-bot-apitoken

KaCYkH65nJkFn49wT3S7C752
De apitoken van de jira-bot-user om vanuit /universe/jira connectie te maken met onze Jira instantie.

De token wordt beheerd via de gebruiker die in delphi-waarde jira-bot-user zit.

Je moet met deze gebruiker inloggen op Jira en dan naar https://id.atlassian.com/manage-profile/security/api-tokens gaan om dit token te beheren.

jira-bot-user

bot@anet.be
De userid (meestal e-mail) waarmee onze bot aanlogged op onze jira-server

jira-database-url

/library/database/jira_backup/db/jirabackup_db.sqlite
Locatie van de sqlite database waar de backup moet weggeschreven worden.

jira-server

https://brocade.atlassian.net
de url van onze jira server

jira-storage-directory

/library/database/jira_backup/assets
Locatie waar gedownloade bestanden moeten terecht komen.

jsmath-base-url

/jsMath

json-schema-dir

/library/httpd/htdocs/brocade/schema
Deze registry waarde geeft een directory aan in het filesysteem (onder beheer van de webserver) waar de JSON-schema's worden geplaatst.

json-schema-url

https://anet.be/brocade/schema
Geeft de volledige URL die toegang geeft tot de JSON-schema's. De naam van het specifieke schema moet - bij gebruik - wel worden aangeplakt.

kahawa-home

/library/httpd/htdocs/kahawa
De naam van de directory, die de web inhoud van de Kahawa toepassing bevat.

kahawa-process-dir

/library/process/kahawa
De naam van de directory, gebruikt door kahawa voor verwerkingen.

kahawa-web-dir

/library/httpd/htdocs/kahawa
De naam van de directory, die de web pagina's bevat, gegenereerd door de Kahawa toepassing.

kahawa-web-url

/kahawa
De (relatieve) web url naar de kahawa toepassing.

keyboard

standard
Deze registy wwaarde stelt de standaard keyboard layout voor. Keyboard layouts worden beheerd door middel van meta informatie charkb

labels-exe

/library/bin/labels
executable voor het aanmaken van labels

labels-formats-dir

/library/process/labels/formats
Process directory voor het aanmaken van labels. In deze directory worden de format templates geinstalleerd.

language-default

N
Dit is de default dialoogtaal. De dialoogtaal geeft aan welke taal er wordt gebruikt in Brocade dialogen. Dit is steeds een hoofdletter: N, E, D, F, U. Indien de dialoogtaal niet expliciet wordt gespecificeerd, dan wordt er steevast gekozen voor deze default dialoogtaal.

language-sequence

NEFDU
Dit is een string gevormd uit de codes N, E, D, F, U (dialoogtalen). Indien de verwoordingen, annotaties beschrijvingen niet beschikbaar zijn in de gangbare dialoogtaal, dan ontstaat er een afvallingsrace in volgorde van voorkomen in deze string. Dit proces verloopt niet automatisch en moet in de software, geval per geval, worden bekrachtigd.

lapith-dbnl-db

/library/process/lapith/dbnl.sqlite3
"lapith-dbnl-db" is het path naar de DBNL sqlite3 databank die geharverst wordt via lapith update dbnl

lapith-process-dir

/library/process/lapith
"lapith-process-dir" is een folder gebruikt voor data van lapith

latex-exe

/opt/texbin/latex

layout-alert-disable-begin

/* */
De standaard alert en confirmation widgets in Brocade kunnen ook gestyleerd worden aangeboden.

met styles

layout-alert-disable-begin: /* */

met system widgets:

layout-alert-disable-begin: /*

layout-alert-disable-end

/* */
De standaard alert en confirmation widgets in Brocade kunnen ook gestyleerd worden aangeboden.

met styles

layout-alert-disable-end: /* */

met system widgets:

layout-alert-disable-end: */

layout-font-disable-begin

/* */
Het hoofdmenu van Brocade wordt samengesteld door een beperkt aantal afbeeldingen. Deze afbeeldingen zijn ofwel GIF bestanden ofwel wordt er gebruik gemaakt van Web typografie.

met Webfonts

layout-font-disable-begin: /* */

met GIFs:

layout-font-disable-begin: /*

layout-font-disable-end

/* */
Het hoofdmenu van Brocade wordt samengesteld door een beperkt aantal afbeeldingen. Deze afbeeldingen zijn ofwel GIF bestanden ofwel wordt er gebruik gemaakt van Web typografie.

met Webfonts

layout-font-disable-end: /* */

met GIFs:

layout-font-disable-end: */

layout-id

moto
De naam van het actieve layout project. Voorbeeld : standard

layout-menu-complete

1
Flag,die de zoekfunctie op menu-ingangen regelt. 1 = Nieuwe stijl, 0 = Oude, 'traditionele' opac.

layout-noalert-disable-begin

/*
De standaard alert en confirmation widgets in Brocade kunnen ook gestyleerd worden aangeboden.

met styles

layout-noalert-disable-begin: /*

met system widgets:

layout-noalert-disable-begin: /* */

layout-noalert-disable-end

*/
De standaard alert en confirmation widgets in Brocade kunnen ook gestyleerd worden aangeboden.

met styles

layout-noalert-disable-end: */

met system widgets:

layout-noalert-disable-end: /* */

layout-nofont-disable-begin

/*
Het hoofdmenu van Brocade wordt samengesteld door een beperkt aantal afbeeldingen. Deze afbeeldingen zijn ofwel GIF bestanden ofwel wordt er gebruik gemaakt van Web typografie.

met Webfonts

layout-nofont-disable-begin: /*

met GIFs:

layout-font-disable-begin: /* */

layout-nofont-disable-end

*/
Het hoofdmenu van Brocade wordt samengesteld door een beperkt aantal afbeeldingen. Deze afbeeldingen zijn ofwel GIF bestanden ofwel wordt er gebruik gemaakt van Web typografie.

met Webfonts

layout-nofont-disable-end: */

met GIFs:

layout-font-disable-end: /* */

layout-project

/layout/moto
De naam van het geinstalleerde layout project. Wordt automatisch gezet bij het installeren van een layout.Voorbeeld: /layout/standard

lc-csvdelimiter

;
Het standaard scheidingsteken tussen velden bij csv bestanden. Voorbeeld : ;

lc-ctype

en_US.UTF-8
De waarde, die Brocade veronderstelt voor environment variabele LC_CTYPE, indien deze niet bestaat.

lc-date

dd.mm.yyyy
Het standaard patroon voor een datum aanduiding op dit Bocade systeem. Voorbeeld : dd.mm.yyyy .

lc-decimalseparator

,
Het lokaal gebruikte decimaal teken. Bevat doorgaans een komma of een punt.

lc-time

24
Standaard tijdnotatie voor het uur van de dag. Bevat '24' of '12'.

ldap-add

ldap change <uid>
openldap commando om nieuwe LDAP records aan te maken

bepaald in release.py

gebruikt in /universe/users/uusldap.m

ldap-basedn

l=brocade
Base Distinguished Name van de LDAP server.

bepaald in /core/brocade/release.py

default: l=brocade

ldap-bind-password

********************
Met dit (manager) paswoord kan men LDAP records aanmaken en editeren.

default: l...

zie /core/brocade/release.py

Zie ook registry ldap-manager

ldap-binddn

uid=<uid>,l=brocade
Bind Distinguished Name van de LDAP server.

gebruikt voor authenticatie.

bepaald in /core/brocade/release.py

voorbeeld: uid=foo,l=brocade

ldap-bypass

0
Omzeil de LDAP server bij het inloggen in brocade.

'1': Omzeil de LDAP server. userid en paswoord worden enkel afgechecked

tegenover de M databank. - default: '0'

ldap-delete

ldap delete <uid>
openldap commando om bestaande LDAP records te schrappen

bepaald in release.py

gebruikt in /universe/users/uusldap.m

ldap-filter

objectclass=*
Default LDAP zoekfilter

default: objectclass=* (alle records)

bepaald in release.py

ldap-hash

md5
default hash voor het versleutelen van paswoorden

default: md5

zie /core/brocade/release.py

ldap-host

127.0.0.1
DNS naam of ip adres van de server waarop de LDAP service draait.

bepaald in /core/brocade/release.py

default: registry waarde dns-name

ldap-lib

/library/database/ldap

ldap-manager

root
Met deze (manager) uid kan men de LDAP records aanmaken en editeren.

default: root

zie /core/brocade/release.py

zie ook registry ldap-bindpw

ldap-modify

ldap change <uid>
openldap commando om bestaande LDAP records aan te passen

bepaald in release.py

gebruikt in /universe/users/uusldap.m

ldap-nocheck

nok
Deze registry ingang mag enkel worden gedefinieerd in uitzonderlijke sitiuatie. Staat de waarde op ok, dan wordt het wachtwoord bij het inloggen niet gecontroleerd op geldigheid. Het userid moet wel nog altijd gedefinieerd zijn.

Om deze registry op ok te zetten:

delphi add ldap-nocheck ok force=yes nosalt=yes

Opgelet! Salt gaat deze waarde terugzetten.

ldap-port

389
TCP poort van de LDAP service.

bepaald in /core/brocade/release.py

default: 389

ldap-search

ldap search <uid>
openldap commando om LDAP records op te vragen

bepaald in registry.py

gebruikt in /universe/users/uusldap.m

libreoffice-exe

/library/bin/soffice

lock-dir

/run/lock/brocade
Deze folder wordt gebruikt om lock-bestanden op te slaan. Dit zijn bestanden die worden gebruikt om aan te geven dat een bepaalde bron (een database, een bestand, een apparaat) in gebruik is en niet door een ander proces mag worden geopend.

log-base-dir

/library/process/log
Basis folder, waarin alle log data wordt bijgehouden. Bij ontstentenis is dit process-base-dir/log

loganalyser-default-log

/var/log/httpd/error_log

lowest-session-allowed

200412694
De laagste Brocade sessie nummer, waarmee je actief kan werken. Natuurlijk getal.

lua-lib

/packages/share/lua
De naam van de directory, waar lua scripts zullen worden geinstalleerd. Voorbeeld: /packages/share/lua

lucene-version

LUCENE_6

lupa-log-dir

/library/process/lupa/log
De directory, waar eventuele logfiles komen, veroorzaakt door lupa acties

m-anetsource

0
Flag, die aanduidt in welke karakterset de MUMPS databank van Brocade zich bevindt. 1=Brocade 2000 karakterset,0=|UTF-8|

m-api-exe

mapi
Naam van de MUMPS API executable. Deze roept m routine %Api^uwww op.

m-clib

0
Geef 1 indien de M functionaliteit wordt aangevuld met een apart gecompileerde C library.

m-compile-exe

["yottadb","{source}"]
Deze registry waarde heeft aan hoe een bepaald bestand - van de gedaante routine.m - wordt gecompileerd in M. Er wordt verwacht dat de instructie, syntax fouten vermeld op stdout of stderr.

De registy waarde is in JSON format: een array met als eerste element de executable en de andere argumenten zijn dan passende parameters. Hierbij wordt elk voorkomen van de de waarde {source} vervangen door de gegeven bestandsnaam.

Voorbeeld: ["yottadb", "{source}"]

m-db

/library/mumps/brocade/g
De directory, waarin de default MUMPS databank zich bevindt. Voor Cache systemen wordt hier een database file CACHE.DAT verwacht, voor GT.M systemen wordt hier een configuratiefile glo.gld verwacht. In deze databank worden o.a. globals/routines geinstalleerd.

m-dir-install

/packages/gtm
Directory, waar de M binaries worden uitgepakt.

m-error-length

32000
De maximum lengte van een M string, die zal worden gelogd bij een M software fout. Geen beperking indien leeg of onbestaand.

m-error-limit

250
Aantal keer dat een M fout mag optreden op een dag, alvorens een gebruiker of ip nummer wordt geblokkeerd.

m-exe

anetcache
Naam van de M basis executable (mux). Deze dient volgende eigenschappen te hebben : - Indien men zich bevindt in de m-db directory, en men roept deze op zonder argumenten, dan komt men in M direct mode terecht. - Indien men hetzelfde doet met een argument, dan komt men in M application mode en wordt het argument beschouwd en uitgevoerd als een Entry^routine.

m-exe-host-legato

["ssh", "-q", "-o", "BatchMode=yes", "legato", "anetmumps '{routine}']

m-exe-legato

["ssh", "-q", "-o", "BatchMode=yes", "legato", "cd /library/mumps/brocade/g ; //library/bin/anetcache '{routine}']

m-generic-exe

anetmumps

m-import-auto-exe

["anetcache", "%RunDS^bqtm"]
Instructie waarmee Qtechng Brocade object files naar MUMPS importeert

m-journal-purge-scan

0
Moet een journal file worden gescand alvorens te worden verwijderd. 0=nee(default) 1=ja. De scanning gebeurt via qtechng source py /website/utf8/jouscan.py, de verwijdering neemt mutil -purge journal voor haar rekening. In een alarmfaze 'rood' wordt deze registry genegeerd.

m-license-warn

30
Hoeveel dagen op voorhand moet het (probe) systeem verwittigen wanneer een M licentie zal vervallen. Enkel relevant voor Cache systemen.

m-login-exe

mlogin
Volledige naam van de executable, die o.a. gebruikt wordt bij het inloggen via de desktop. Verwijst naar een binaire file, die meestal 'mlogin' heet.

m-lua

1
Geef 1 indien de M functionaliteit wordt aangevuld met een embedded Lua engine.

m-max

m-os-clearmstack

zg $zl-1
M executable, die de M stack cleart. Default voor GT.M : 'zg -1' .

m-os-trminit

v "NEVERLVNULLSUBS" u $i:(width=32767)
M executable, die een terminal sessie initialiseert.

m-os-type

gtm
Type M systeem van de default M databank. Voorbeelden : gtm, cache .

m-pipe-exe

anetcache
De executable, waarnaar je een reeks van M instructies kan sturen via piping, althans als je je in de juiste directory bevindt. Verwijst meestal naar de anetcache executable.

m-readonly

0
0 geeft aan dat MUMPS updatable is door processen. 1 (of leeg) geeft dan weer aan dat de databank enkel leesbaar is.

Sommige MUMPS versies kunnen immers enkel worden aangepast door speciale systeemprocessen (zoals bijvoorbeeld bij replicatie)

m-server-address

/library/process/mserver/mserver.uds
Dit is een bestandsnaam uit het filesysteem (geen directory!) dat wordt gebruikt om als eindpunt van een Unix domain socket te kunnen fungeren. Deze socket wordt gebruikt door de M server en clients.

m-server-logdir

/library/process/mserver/log
Dit is de naam van een directory waar de M server logging files wegschrijft. Hou er mee rekening dat deze logging informatie heel omvangrijk kan zijn.

m-server-max-idle

m-server-maxconnections

100
het maximum aantal vragen dat een |Mumps| proces mag beantwoorden. Deze techniek wordt gebruikt om te verhinderen dat er zich stabiliteitsproblemen kunnen voordoen.

m-server-maxmumps

5
De *M server * beheert een pool van M processen. Deze registry waarde duidt het maximaal aantal processen aan dat in deze pool mogen voorkomen.

m-server-minmumps

1
De *M server * beheert een pool van M processen. Deze registry waarde duidt het minimaal aantal processen aan dat in deze pool mogen voorkomen. Indien deze waarde positief is, dan worden deze processen op voorhand opgestart.

m-simpleobject-attributes

$$%GetAttr^uobsobj(.MDx)

m-simpleobject-build

$$%Build^uobsobj(MDx)

m-web-exe

mweb
Naam van de MUMPS Web executable. Deze roept m routine %Entry^uwww op. Ze vormt de basis ingang voor Brocade web formulieren.

mail-client-exe

/library/bin/shipping

mail2helpdesk-client-exe

/library/bin/anetsu shipping
Duidt de applicatie aan die kan gebruikt worden om een mail naar de helpdesk te sturen. Wordt enkel gebruikt door de script achter de helpdeskknop in de Brocade takenbalk.

maildomain

mail.anet.be

mailman-authentication-pair

anet.be@tqg8ancz

mailman-default-host-name

lists.anet.be

mailman-default-url

https://lists.anet.be/mailman/

mailman-home

/usr/lib/mailman

mailman-language

nl

mailman-webexe-url

https://lists.anet.be/mailexe/mailman.phtml?mode=<mode>&list=<list>&user=<user>&email=<email>&auth=<auth>

mailscan-default-mailserver

mail.anet.be
Mailscan werkt met een aantal gedefinieerde mailboxen. In de configuratie van een mailbox kan de mailserver opgegeven worden waarop de mailbox moet gelezen worden. Deze registry-waarde bevat de default mailserver, die dus theoretisch voor elke mailbox kan overschreven worden.

mailscan-main-dir

/library/process/mailscan
Directory waarin, per mailbox, de door Mailscan opgehaalde berichten verzameld worden in subdirectory messages.

mailserver

mail.anet.be
De DNS naam van de default mailhost.

mathjax-base-url

/mathjax

mathjax-dir

/library/httpd/htdocs/mathjax

menu-group-name

standard
Bepaalt de actieve menu groep. De menu folders, die tot deze groep behoren, vormen de geinstalleerde en opzoekbare folders. Indien niet bekend of leeg, wordt de waarde 'standard' verondersteld.

meta-json-dir

/library/process/meta/json
Directory, waar de meta data terechtkomt van 'nieuwe' meta objecten, in json formaat.

metaman-db-dir

/library/database/metaman
De directory, waarin configuratiebestanden terechtkomen, belangrijk voor metaman. Deze bestanden zijn niet groot, maar wel essentieel voor de goede werking van een Brocade systeem.

mime-types

/etc/mime.types

monitor-text

1
Is deze waarde gelijk aan "1", dan wordt de link tussen teksten en menu entries bijgehouden. De datastructuren worden beheerd in /menu/meta/gbmenu.m.

Het zetten van deze waarde creert een kleine overhead.

monitor-utf8

1
Is deze waarde gelijk aan "1", dan wordt HTML files gecontroleerd of ze volgens UTF-8 zijn gecodeerd.

Het zetten van deze waarde creert een kleine overhead.

mutil-process-dir

/library/process/mutil
Process directory voor output van mutil procedures (start/stop,..).

mutil-ssh-exe

ssh -q  <host> '<command>'
Template om remote ssh commando's te starten vanuit de mutil toolkit. Voorbeeld : "/usr/bin/ssh -q <host> '<command>'"

namespace-default

.
Optionele registry waarde. Deze namespace wordt steeds in plaats van de naamloze namespace gebruikt en enkel indien de tekstcode niet bestaat in de default namespace wordt er gekeken naar de naamloze namespace.

namespace-menu

Optionele registry waarde. Deze namespace wordt gebruikt, om lokale verwoordingen van menu-ingangen en folders te bepalen. Er wordt gezocht naar verwoordingen binnen deze namespace van de vorm [deze namespace].[menu roepcode]. Indien de tekstcode niet bestaat, wordt teruggevallen op de standaard verwoordingen van de meta-objecten van type mitem en mfolder.

newsletterrss-dir

/library/process/newsletter

newsletterrss-url

/newsletterrss.phtml

now

20240419060101
Deze registry waarde wordt iedere dag (automatisch) hernieuwd. Deze waarde wordt gebruikt om hardnekkige web caches te verschalken die CSS en JS bestanden als statisch aanzien. Op deze wijze is de cache hoogstens een dag geldig.

oai-log-dir

/library/process/oai/log

oai-logdir

/library/process/oai/log

oai-webdir

/library/httpd/htdocs/oai

oai-weburl

/oai/<target>/

opac-archive-dir

/library/archive/opac
Elke opac-omgeving bevat een zip-file met css-files en afbeeldingen. Deze zip-file kan vanuit de opac meta-informatie gearchiveerd worden in de hier aangegeven directory.

opac-process-dir

/library/process/opac
Tijdelijke werkdirectory voor de upload van opac-bestanden vanuit de opac meta-informatie. Van hieruit wordt een zip-file aangemaakt en worden de bestanden in de webomgeving van de bijhorende service geplaatst.

opac-savelist-file

/library/httpd/htdocs/service/opac/opacsvelist.phtml
In /opac/desktop/install.py wordt de phtml-script aangemaakt voor het tonen van bewaarlijsten vanuit de opac. Deze registry-waarde bevat de path van de aan te maken script.

opac-savelist-url

/service/opac/opacsvelist.phtml
De URL die vanuit de opac moet aangesproken worden om een aangemaakte bewaarlijst te tonen.

openoffice-macro-dir

/root/.openoffice.org2/user/basic

openurl-dir

/library/httpd/htdocs/openurl

option-start-file

/library/httpd/htdocs/option.phtml

option-start-url

/option.phtml

os

linux
Operatingsystem

os-copy-exe

/bin/cp
cp binary + parameters

os-move-exe

/bin/mv
mv binary + parameters

os-remove-exe

/bin/rm -f
rm binary + parameters

os-sep

/
Het karakter dat door het OS wordt gebruikt om de diverse componenten van een bestandsnaam te scheiden.

os-service

systemctl <action> <service>
template voor SystemD start, stop, restart, status services. Zie /doc/anetprocedures/services.rst.

owl-carousel-base-url

/owlcarousel

owl-carousel-dir

/library/httpd/htdocs/owlcarousel

package-database

/library/process/scrutiny/packages.sqlite3

parcels-base-dir

/library/process/parcels

password-deadline-omit

N
Naargelang het wachtwoord profiel van een gebruiker kan het wachtwoord verlopen. In sommige situaties echter - test omgevingen, demo, opleidingen - is dit niet wenselijk. Deze registry waarde kan worden gebruikt om de vervaldag vooruit te schuiven (zet de waarde gewoon gelijk aan 1)

password-profile

anet

path

/library/bin:/opt/texbin:/usr/local/bin:/bin:/sbin:/usr/bin

pay-process-dir

/library/process/pay
Deze registry waarde verwijst naar een directory waarin tijdelijke bestanden worden opgeslagen in verband met het betalingsverkeer. Deze bestanden worden dagelijks gewist.

paygasus-process-dir

/library/process/paygasus
De naam van de directory, waarin de processing van de applicatie paygasus zich afspeelt.

pdf-combine

/packages/bin/pdfcpu merge -q
Concat van 2 pdf bestanden. Wordt gebruikt in /universe/library/uliwmbrd.m

pdf2txt-exe

/library/bin/pdf2txt.py
pdfminer binary

vb /library/python2.7/bin/pdf2txt.py

pdfcovers-process-dir

/library/process/pdfcovers

pdflatex-exe

/opt/texbin/pdflatex
pdflatex binary

vb. /opt/texbin/pdflatex

porrima-base-dir

/library/porrima
Basis directory waar alles van Porrima onder staat

portunus-authenticate-url

/brocade/portunus.phtml

private-instname

moto2
De instance naam, geassocieerd met de M productiedatabank DB op deze server. Bevat maximaal 15 letters of cijfers. Deze naam moet uniek zijn over alle Brocade servers heen. Ze benoemt de databank, die fysiek aanwezig is op deze server. Ze wordt dus nooit gewijzigd, ook niet bij het wijzigen van de rol van de server.

private-role

moto
Een Brocade installatie kan verschillende rollen hebben (vooral belangrijk in het kader van replicatie van de M databank). Deze registry waarde geeft de rol aan van de huidige configuratie. Deze waarde mag enkel worden beheerd (aangemaakt, verandert of geschrapt) door middel van delphi. De waarde verwijst naar een bestandsnaam (moet wel worden aangevuld met .json) van additionele registry waarden. Met deze waarde wordt ook o.m. bepaald, weleke mutil ini file operationeel is.

probes-custom-file

/library/process/probes/custom.cfg

probes-diverted-to

probes-master-base-dir

/library/process/probes/scripts

probes-master-gsm

0475399175

probes-master-gsm-actual

0475399175

probes-master-gsm-end-time

18:00

probes-master-gsm-start-time

08:00

probes-master-html

/library/process/probes/probes.html

probes-master-loop-sleep

probes-master-reload-delay

probes-master-retrieve

scp -q -r <slave>/. .

probes-master-retrieve-delay

probes-master-rss

/library/process/probes/probesrss.xml

probes-master-sms-delay

probes-master-sms-exe

/bin/rm -f /etc/smslock; /bin/rm -f /var/lock/LCK*; /bin/sms_client proximus:

probes-master-solver-timeout

probes-slave-base-dir

/library/process/probes/scripts
Probe scripts folder op de slave.

probes-slave-gsm

mastergsm
Het nummer van het Anet GSM toestel. Deze GSM is normaal in het Anet kantoor.

Info:

Tijdens de werkdagen is het GSM toestel in de server room afgeleid naar dit GSM nummer.

Tijdens de permanentie periode is het GSM toestel in de server room afgeleid naar de persoon die die dag van permanentie is.

probes-slave-retrieve-html

anetsu scp -q probes.anet.uantwerpen.be:/library/process/probes/probes.html

probes-slave-retrieve-messages

anetsu scp -pq mail2-239.uantwerpen.be:/packages/probes/messages
Wordt gebruikt door de php script /probes/probes.phtml en bepaalt het protocol en plaats van de probe boodschappen.

probes-slave-retrieve-rss

anetsu scp -q probes.anet.uantwerpen.be:/library/process/probes/probesrss.xml

probes-slave-web-dir

/library/httpd/htdocs/probes
Folder met probe PHP scripts op de slave.

Deze scripts worden vanop de probe master uitgevoerd.

probes-slave-web-url

https://anet.be/probes
URL die verwijst naar de probe PHP scripts.

probes-ssh

ssh -q probes.anet.uantwerpen.be

probes-taskonduty

PERMANENTIE

probes-transport

/dev/ttyACM0

process-base-dir

/library/process
De naam van de basis process directory, waarvan andere process directories default als subfolders worden afgeleid.

process-dir

/run
De directory, waarin informatie over lopende processen wordt bijgehouden. Zie ook project /process/application

procman-db-dir

/library/process/procman
De directory, waarbinnen de actuele procman data wordt beheerd.

procman-forbidden

no
Flag, die het lanceren van processen via procman verbiedt of toelaat. Bevat een van de waarden 'yes' of 'no'. Wordt beheerd via het commando procman -forbid/allow.

procman-log-dir

/library/process/procman/log
De directory, waar de administratie van procman processen wordt bijgehouden.

procman-process-dir

/library/process/procman

purl-db-local

/library/database/purl/purl.db
Verwijst naar het bestand waarin apache web server Rewrite rules staan. De inhoud wordt beheerd in /universe/webservices

py-server-address

/library/process/pyserver/pyserver.uds
Dit is een bestandsnaam uit het filesysteem (geen directory!) dat wordt gebruikt om als eindpunt van een Unix domain socket te kunnen fungeren. Deze socket wordt gebruikt door de Python server en clients.

py-server-logdir

/library/process/pyserver/log
Dit is de naam van een directory waar de Python server logging files wegschrijft. Hou er mee rekening dat deze logging informatie heel omvangrijk kan zijn.

py-server-max-idle

py-server-maxconnections

100
het maximum aantal vragen dat een Python proces mag beantwoorden. Deze techniek wordt gebruikt om te verhinderen dat er zich stabiliteitsproblemen kunnen voordoen.

py-server-maxpython

5
De *Python server * beheert een pool van Python processen. Deze registry waarde duidt het maximaal aantal processen aan dat in deze pool mogen voorkomen.

py-server-minpython

1
De Python server beheert een pool van Python processen. Deze registry waarde duidt het minimaal aantal processen aan dat in deze pool mogen voorkomen. Indien deze waarde positief is, dan worden deze processen op voorhand opgestart.

python-brocade-lib

/packages/py2/anet/brocade
De naam van de directory, waarin de python 2 modules worden geplaatst, oproepbaar via 'from anet.brocade import ..'.

python-exe

py2
Dit is de volledige filenaam van de Python2 executable.

python-ext

py

python-group

db

python-lib

/packages/py2/anet
Dit is de directorynaam van de|PY2| package waarin de Brocade Python2 wordt geïnstalleerd.

python-owner

root

python3-exe

py3
Dit is de volledige filenaam van de Python3 executable.

python3-lib

/packages/py3
Dit is de directorynaam van de Python3 package waarin de Brocade Python3 wordt geïnstalleerd.

qtech-groupid

db

qtech-ownerid

root

qtech-root-dir

/library/software

qtech-server

dev.anet.be

qtech-ssh

/bin/ssh -l usystem -q <host> "anetsu qtech -ssh"

qtech-svn-disabled

qtech-type

qtech-user

usystem

qtechng-binary-dir

/library/process/qtechng
Directory waar Ansible de qtechng binary vindt om op het systeem te installeren Enkel op 'B'-machine

Registry waarde wordt gezet door Ansible.

Directory wordt aangemaakt door Ansible.

qtechng-block-doc

0
Bevat een timestamp. Deze timestamp verhindert het publiceren van documentatie.

Deze registry waarde wordt gezet en verwijderd door middel van het qtechng commando.

qtechng-block-install

Bevat een timestamp. Deze timestamp verhindert het installeren van het repository.

Deze registry waarde wordt interactief gezet en geschrapt door het qtechng commando.

qtechng-blocked-install

qtechng-exe

qtechng
Basename van de qtechng binary. Zorg ervoor dat deze geïnstalleerd is op PATH.

Voorbeelden zijn

qtechng (op Linux en OSX)

qtechng.exe (op Windows)

Op alle machines: wordt gezet door Ansible op 'B' en 'P' machines

qtechng-git-enable

0
Indien 1, dan is versie controle met Git ingeschakeld.

Enkel op 'B'-machines.

Wordt gezet door Ansible

qtechng-max-parallel

32
Het maximum aantal I/O gebonden qtechng commando's die parallel mogen lopen. Een voorbeeldwaarde is 16.

Wordt op elke machine gezet: op 'B' en 'P' machines door Ansible

qtechng-repository-dir

/library/repository
Directory op de ontwikkelserver en productieservers die de Brocade dataset bevatten. Deze moet geïnstalleerd worden met Ansible.

qtechng-server

dev.anet.be:22
DNS van de Brocade ontwikkelserver. Voornamelijk gebruikt bij SSH commando's.

Bevat zowel de naam van de ontwikkelserver als de poort:

voorbeeld: dev.anet.be:22

Moet gezet worden op de 'P'-machines met behulp van Ansible.

qtechng-sweep-dir

/library/process/sweep
Directory waar allerhande informatie in verband met het QtechNG intallatie-proces terecht komt: linting errors, rebuild info, install errors, ... Zie ook diverse verbs van toolcat applicatie qtool

Wordt gezet op 'B'-machines door Ansible

qtechng-sync-exe

["rsync", "-ai", "--whole-file", "--delete", "--exclude=source/.hg", "--exclude=log",  "--exclude=source/.git", "root@dev.anet.be:/library/repository/{versionsource}/", "/library/repository/{versiontarget}"]
Commando om uit te voeren op een productieserver en de Brocade software te synchroniseren vanaf de ontwikkelserver.

Executable en argumenten staan in een JSON array. De letterlijke termen versionsource en versiontarget zijn placeholders in de argumenten.

Ze staan tussen { en }.

Ze staan op elke 'P'-server en wordne gezet door Ansible.

qtechng-sync-shallow-exe

["rsync", "-azi", "root@dev.anet.be:/library/repository/{versionsource}/source/data/", "/library/repository/{versiontarget}/source/data"]

qtechng-syncdry-exe

["rsync", "-aicn", "--whole-file", "--delete", "--exclude=source/.hg", "--exclude=log",  "--exclude=source/.git", "root@dev.anet.be:/library/repository/{versionsource}/", "/library/repository/{versiontarget}"]
Commando om uit te voeren op een productieserver en de Brocade software te synchroniseren vanaf de ontwikkelserver met de --dry vlag.

Geïnstalleerd door Ansible.

Zie ook qtechng-sync-exe.

qtechng-test

test-entry
Deze registry variabele wordt gebruikt om de registry zelf te testen. De waarde die wordt geassocieerd met deze sleutel is steeds test-entry.

qtechng-type

P
Elk systeem dat werkt met qtechng heeft een specifieke relatie met het software repository op registry(qtechng-server). Deze relatie wordt aangeduid met een letter:

W: Werkstation: de desktops van de Brocade ontwikkelaars

B: de Beta-machine: dit is steeds (tenzij voor testdoeleinden) registry(qtechng-server): dev.anet.be

P: Productiemachine: dit zijn servers die een actieve Brocade installatie voeren.

Een concrete machine kan verschillende taken uitvoeren.

Op 'B' en 'P' machines wordt deze waarde gezet door Ansible.

qtechng-url

https://dev.anet.be/qtechng/qtechng-linux-amd64
URL onder de welke de QtechNG executable voor deze machine (D, P of W) beschikbaar is, bv. https://dev.anet.be/qtechng/qtechng-linux-amd64).

qtechng-user

root
Acties op het Brocade software repository worden steeds uitgevoerd onder een user identificatie. Indien de user niet expliciet wordt meegegeven in de opdracht, dan wordt deze overgenomen uit deze registry waarde. Deze waarde moet steeds bestaan als een uid op het ontwikkelplatform dev.anet.be.

Wordt gezet door Ansible op 'B'- en 'P'-machines: waarde moet 'root' zijn.

qtechng-vc-url

https://dev.anet.be/cgit/cgit.cgi/qtechng/tree/data/{qpath}
Dit is de waarde waarde voor een URL.

Moet worden gezet op 'W' machines.

Het bevat een placeholder van de gedaante {qpath}.

Deze wordt vervangen door de specifieke qpath waarde voor een source file en geeft dan toegang tot een web interface tot het git-repository.

role-procman-active

role-services-active

1
Indien de registry waarde private-role bestaat en verschillend is van leeg, dan kan deze registry waarde aansturen of de services zoals shipper en mailscan mogen worden geactiveerd.

roundup-db

/library/database/roundup
Roundup issue tracker base install dir. Gebruikt in /roundup/application

roundup-issue-url

https://anet.be/tracker/brocade/issue<issue>
Roundup issue tracker url template. Gebruikt in /core/python/resttools.py en /roundup/application

roundup-xmlrpc

https://usystem:surviv@l@anet.be/tracker/brocade/xmlrpc
XML-RPC toegang roundup issue tracker. Gebruikt in /core/python/resttools.py voor aanmaak documentatiee.

rssfeeds-dir

/library/httpd/htdocs/rssfeeds

rsync-exe

su root -c '/bin/rsync -varlpogt --rsh=ssh --stats --force --delete <source>/ <destination>:<directory>'

rsync binary + argumenten

core delphi-waarde

salt-log-dir

/var/log/salt
Directory waar de salt report log files verzamelt worden. Dagelijks wordt voor elke salt minion een rapport aangemaakt. Dit rapport wordt gebruikt voor het genereren van Brocade documentie. Zie anet.be/doc/anet/servers

salt-master

dev.anet.be
Boolean. Is True voor de salt-master server.

salt-minions

moto,vite,dolce,brio,piano,legato
Lijst met salt minions. Elke dag wordt voor elke minion in de lijst, 'salt' uitgevoerd en een rapport aangemaakt.

saml-cert-dir

/library/process/saml/cert

saml-webdir

/library/httpd/htdocs/saml

saml-weburl

/saml/

saxon

/bin/java -jar /library/bin/saxon8.jar
XSLT parser. Enkel nog gebruikt door CIPAL in /local/lucene2

scp-exe

scp -p -q
scp binary + parameters

core registry

gebruikt in /core/python/spawner.py

scratch-dir

/library/tmp
De naam van de klad directory, waarin men tijdelijk bestanden kan aanmaken. Deze directory wordt in principe dagelijks leeggemaakt.

screener-process-dir

/library/process/screener

sdi

sdi@anet.be

sdi-rss-css

/sdi/sdirss.css

sdi-rss-url

/sdi/sdirss.phtml

sdi-rss-xsl

/sdi/sdirss.xsl

sdi-web-dir

/library/httpd/htdocs/sdi

service-file

/library/httpd/htdocs/service.phtml

service-start-file

/library/httpd/htdocs/services.phtml

service-start-url

/services.phtml

service-web-base-dir

/library/httpd/htdocs/service

service-web-base-url

/service

sgml-parser-exe

/usr/bin/onsgmls
Parse en validate SGML document. Gebruikt in /xml/wrapper/openjade.py

sgml-xml-exe

/usr/bin/osx
Converteert SGML naar XML. Gebruikt in xml/wrapper/openjade.py

shell-exe

/bin/sh
shell binary

core delphi

shell-ext

sh

shipper-default-mailserver

mail.anet.be
Shipper werkt met een aantal gedefinieerde afzenders. In de configuratie van een afzender kan de mailserver opgegeven worden die moet aangesproken worden voor mails van deze afzender. Deze registry-waarde bevat de default mailserver, die dus theoretisch voor elke afzender kan overschreven worden.

shipper-main-dir

/library/process/shipper
Directory waarin, per afzender, de door Shipper te versturen berichten verzameld worden in subdirectory messages.

shipper-misc-user

misc
Berichten die een andere to of reply-to header moeten krijgen dan gedefinieerd in de Shipper afzenders, worden best via de hier gedefinieerde default afzender verstuurd, waarbij de gewenste to of reply-to header wordt meegegeven.

sinc-scp-exe

/usr/bin/scp -q
scp binary + parameters

aangemaakt door /sinc/application

vb. gebruikt in /vlacc/distribute

sinc-ssh-exe

/usr/bin/ssh -q <server> '<command>'
ssh binary + parameters

aangemaakt door /sinc/application

vb. gebruikt in /vlacc/distribute

sip2-process-dir

/library/process/sip2
De naam van de directory, waarin o.a. logging gegevens van de Sip2 server terecht komen.

sip2-type

cs
Type van Sip2 machine. bevat een combinatie van de letters s (machine doet dienst als Sip2 server) en c ( machine kan fungeren als Sip2 client)

slack-bot-token

xoxb-504175095589-589458034678-u3wp6Gum4rfDyPv82YNxsDdc

software-repository-url

software-web-dir

/library/httpd/htdocs/software

software-web-url

/software

sphinx-build-bin

/library/bin/sphinx-build
Binary die sphinx (aanmaak van de documentatie) aanstuurt.

sphinx-formats-brocade

html
Geef de formaten aan waarin de documentatie wordt geproduceerd (html, pdf, epub)

Scheidt deze formaten door een comma.

sphinx-themes-dir

/library/process/sphinx/themes
Geef de directory waarin de thema's voor Sphinx worden bijgehouden.

ssh-default-host

dev.anet.be:22
Adres en poort van de ontwikkelmachine die QtechNG met SSH aanspreekt, bv. dev.anet.be:22.

ssh-default-privatekey

/{user}/.ssh/id_rsa
Deze file wordt gebruikt bij SSH authorisering via authorized_keys.

Typische waarde: /{user}/.ssh/id_rsa ({user} wordt vervangen door userid)

ssh-default-user

root
Default username die QtechNG gebruikt om via SSH de ontwikkelmachine aan te spreken.

ssh-exe

ssh -q
ssh binary

Zie /core/python release.py en spawner.py

Wordt gebruikt op diverse plaatsen

staff-password-check

ABCDEFGHIJKLMNOPQRSTUVWXYZ

stylist-archiving-days

stylist-main-dir

/library/process/styles

submit-start-file

/library/httpd/htdocs/submit.phtml

submit-start-url

/submit.phtml

system-at

1
Booleaanse waarde (1 of 0) die aangeeft of er een audit trail wordt bijgehouden voor veranderingen aan concretiseringen

system-group

anet
Dit staat voor de groepsnaam van de huidige machine in de Brocade context. Deze naam moet voldoen aan de reguliere uitdrukking: [a-z][a-z0-9]*.

Verschillende machines kunnen toch dezelfde groepsnaam hebben.

Deze naam wordt ook gebruikt bij de installatie van software: of dat sommige projecten worden geïnstalleerd kan immers afhangen van deze groepsnaam.

system-name

moto
Dit staat voor de naam van de huidige machine in de Brocade context. Deze naam moet voldoen aan de reguliere uitdrukking: [a-z][a-z0-9]*

Deze naam wordt ook gebruikt bij de installatie van software: of dat sommige projecten worden geïnstalleerd kan immers afhangen van de naam.

system-roles

production,issuetracker
Dit is een , gescheiden lijst van rollen die de server kenmerken.

Op dit ogenblik zijn de volgende rollen gedefinieerd:

dev: ontwikkelmachine (vb. dev.anet.be)

production: een Brocade server die reeel door bibliotheken wordt gebruikt.

salt: een Brocade server die ook een repository voor Salt bijhoudt.

issuetracker: een Brocade server die de issues bijhoudt.

Deze rollen kunnen tijdens het installatie proces worden gebruikt: indien brocade.json een attribuut roles bevat, dan wordt het project pas geinstalleerd indien ALLE rollen, hierin vermeld, ook zijn opgenomen door de server.

Deze rollen kunnen ook individueel worden getest door:

checkrole in /core/python3/base.py

checkrole in /core/python/checker.py

system-tp

1
Is transactieprocessing actief. Waarde 1 is de default en geschikt voor productieservers. Waarde 0 is enkel voor bepaalde testsystemen, waar men de transactieprocessing wil uitschakelen.

system-user-id

probe
account gebruikt door /system/mail en /mailprobe/application

system-user-pw

aneteb0rp
account gebruikt door /system/mail en /mailprobe/application

toolcat-finish-dir

/library/process/toolcat/finish
Deze registry waarde verwijst naar een directory. In deze directory kunnen toolcat applicaties aangeven wanner ze succesvol zijn afgelopen. Deze informatie kan dan weer door het probe systeem worden gebruikt.

untar-exe

/bin/gtar -xvf
untar binary

unzip-exe

/bin/gzip -d
unzip binary

unzip-group-exe

/bin/unzip -o -q
unzip binary met parameters

'o': overwrite files WITHOUT prompting

'q': quiet mode

urlchecker-process-dir

/library/process/urlchecker

user-default

usystem
De default user id in Brocade (indien er geen andere voorhanden is).

vabb-current-year

2023
Het lopende werkjaar voor het Vlaams Academisch Bibliografisch Bestand voor de Sociale en Humane Wetenschappen (VABB-SHW). Enkel van belang voor VABB systemen.

vabb-opac-year

2022
Het lopende OPAC jaar voor het Vlaams Academisch Bibliografisch Bestand voor de Sociale en Humane Wetenschappen (VABB-SHW). Enkel van belang voor VABB systemen.

valuta-default

EUR
De standaard valuta code voor dit Brocade systeem. Drie letterige gestandardizeerde code in hoofdletters. Wordt gebruikt indien geen andere valuta kan bepaald worden.

virlib-mailbox

virlib
Dit is de identifier voor de mailscan applicatie die wordt toegewezen voor het onderscheppen van binnenkomende mails voor virlib.

virlib-process-dir

/library/process/virlib
Dit is de directory die wordt gebruikt door de virlib toolcat applicatie voor het verwerken van binnenkomende mails en het versturen van uitgaande mails. De structuur van deze directory wordt opgezet door /requests/virlib

virlib-reporter-url

/virlib/report.phtml
Deze waarde is een absolute-path reference naar een PHP script die een spreadsheet terugstuurt die een overzicht geeft van recent geleverde PDF bestanden via virlib

virlib-tiff2pdf-exe

/usr/bin/tiff2pdf -o <target> <source> 2> /dev/null
Dit is een executable met twee veranderelijken source en target. Deze executable maakt het mogelijk om een bestand in TIFF formaat om te zetten in PDF formaat.

virlib-web-dir

/library/httpd/htdocs/virlib
Dit is een directory in de documentroot van de webserver waar ook de script uit registry(virlib-reporter-url) zich bevindt.

visual-images-dir

/library/httpd/htdocs/visual/images

visual-images-url

/visual/images

vlacc-ds-process-dir

/library/process/vlacc/ds

vlacc-ftp-book-login

proantw

vlacc-ftp-book-password

********************

vlacc-ftp-book-pattern

ovdnmbr[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9].xml

vlacc-ftp-book-remotedir

/M21/updates

vlacc-ftp-book-site

ftp.bibliotheek.be

vlacc-ftp-bookmusic-login

proantw

vlacc-ftp-bookmusic-password

********************

vlacc-ftp-bookmusic-pattern

ovdalbr[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9].xml

vlacc-ftp-bookmusic-remotedir

/PBS/updates

vlacc-ftp-bookmusic-site

ftp.bibliotheek.be

vlacc-ftp-deleted-login

proantw

vlacc-ftp-deleted-password

********************

vlacc-ftp-deleted-pattern

ovdddbr[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9].csv

vlacc-ftp-deleted-remotedir

/M21/deletes

vlacc-ftp-deleted-site

ftp.bibliotheek.be

vlacc-ftp-processdir

/library/process/vlacc/ftp

vlacc-type

ds

watchdir-process-dir

/library/process/watchdir
Obsolete. De naam van de directory, waarin de applicatie watchdir zijn administratieve gegevens bojhoudt.

web-base-dir

/library/httpd/htdocs
De folder waarin de webpagina's worden geplaatst.

verplicht.

nodig bij brocade bootstrap.

aangemaakt door SALT.

web-base-url

https://anet.be
Web URL

Deze sleutel vormt de basis voor het samenstellen van absolute URL's in BROCADE (en andere) webtoepassingen.

verplicht.

afgeleid uit socket.gethostname(). Zie /core/brocade/release.py

aangemaakt tijdens bootstrap.

web-browser

/bin/lynx
Command line browser.

Gebruikt in 'web -info': Toon Apache/PHP server info

Default: lynx

web-controle-exe

/packages/sbin/apachectl
Apache control binary

default: apachectl

Gebruikt in 'web -info': Toon Apache/PHP server info

web-htdocs

/library/httpd/htdocs
Apache web directory

Core delphi-waarde

Bepaald in de 'salt' configuratie

web-lookup-autosearch

10
Beslist of het lookup object mag gebruik maken van autosearch en of de history getoond wordt of de beschikbare metadata als dit aantal beperkt is.

web-php-fpm-port

0
PHP-FPM poort voor de brocade webtoepassing

default: 0

Indien de delphi-waarde bestaat en verschillend aan 0 en proxypass gelijk aan 0, dan wordt RewriteRule+fcgi gebruikt. (P flag)

In het andere geval wordt gewerkt met apache mod_php. (L,... flags)

Voorkeur gaan uit naar PHP-FPM zonder ProxyPass directives maar met RewriteRules.

Delphi-waarden:

web-php-fpm-port: 9000 web-use-proxypass: 0

Bij de aanmaak van de purl databank wordt rekening gehouden met de manier waarop apache en PHP geconfigureerd zijn.

Hiervoor zijn 2 nieuwe delphi-waarden voorzien. Zie project /universe/webservices in release.py.

web-probe

/arg.phtml
Verwijst naar een probe script (HTML of PHP)

Gebruikt in 'web -info': Toon Apache/PHP server info

Default: arg.phtml

web-use-proxypass

0
Bepaalt of apache werkt met apache proxypass directive om de PHP-FPM engine aan te spreken. (PT flag)

default: 1

Indien de delphi-waarde niet bestaat of gelijk aan 0, dan worden andere rules gebruikt afhankelijk van de delphi-waarde web-php-fpm-port.

Bij de aanmaak van de purl databank wordt rekening gehouden met de manier waarop apache en PHP geconfigureerd zijn.

Hiervoor zijn 2 nieuwe delphi-waarden voorzien. Zie project /universe/webservices in release.py.

webdav-administrator

admin
Heeft schrijfrechten in alle webdav paths

bepaald in release.py

webdav-honey-dir

aa-anet-ua-verklaring
Webdav folder gebruikt voor detektie van ransomware aktiviteit.

Bepaald in release.py

De folder wordt in elke webdav site aangemaakt door 'webdav -update'

webdav-honey-docman-file

/webdav/opdrachtverklaring.docx
Webdav bestand gebruikt voor de detektie van ransomware aktiviteit.

Bepaald in release.py

Origineel bestand is geplaatst in docman onder id 'webdav'

Wordt gecopieerd naar de webdav folder registry('webdav-honey-dir') door 'webdav -update'

Er is een automatisch process dat dit document bewaakt.

Het proces berekent de digest en vergelijkt dit met registry('webdav-honeypotfile-digest') Indien dit niet gelijk is (ransomware aktiviteit) wordt een warning weggeschreven in de kernel messages log. Deze log wordt opgepikt door 'probes'.

webdav-honeypotfile-digest

df285e7cb88a36382a106b6a77e35ea7134182cec4ba8702c7afe079e750bcf3
Digest gebruikt voor de detektie van ransomware aktiviteit.

Aangemaakt met 'webdav -update'

Bevat digest van bestand registry('webdav-honey-docman-file')

Er is een automatisch process dat dit document bewaakt.

Het proces berekent de digest en vergelijkt dit met deze waarde. Indien dit niet gelijk is (ransomware aktiviteit) wordt een warning weggeschreven in de kernel messages log. Deze log wordt opgepikt door 'probes'.

webdav-host

localhost
De server waarop de webdav bestanden geplaatst worden.

default: localhost

bepaald in release.py

webdav-path-dir

/library/database/webdav
Webdav parent directory.

bepaald in release.py op basis van registry('database-base-dir')

webdav-process-dir

/library/process/webdav
Webdav process directory

Hierin komen de apache configuratie bestanden aangemaakt door 'webdav -update'

webdav-readonly

0
Als deze registry waarde op 1 staat op de WEBDAV server(vb. DOLCE), dan worden de webdav directories enkel als leesbaar opgestart. Het verwijderen (of op 0 zetten( zorgt er dan weer voor dat, mits de juiste privileges, deze bestanden ook schrijfbaar worden. Opgelet: Een aanpassing van deze registry waarde wordt pas zichtbaar na uitvoeren van webdav -update op de WEBDAV server. (vb. DOLCE)

webdav-redirect

0
Als deze delphi-waarde bestaat en verschillend van 0, dan worden de /webdav/application functies niet uitgevoerd

welcomemessage-baseurl

welcomemessage-dir

/library/httpd/htdocs/welcome
Folder waar welkom berichten worden geplaatst. Deze folder wordt het beste onder de documenttree van de webserver geplaatst. Zo wordt deze folder trouwens ook default geplaatst.

welcomemessage-findurl

wget-exe

/bin/wget
wget binary

wiki-base-url

/wiki

wiki-db

/library/database/wiki

wiki-process-dir

/library/process/wiki

wiki-web-dir

/library/httpd/htdocs/wiki

workstation-default

DEFAULT
Waarde van het werkstation, als alle andere methodes niets opleverden.

xelatex-exe

/opt/texbin/xelatex
binary di everwijst naar de xelatex variant van Latex. Deze software is beter geschikt om met unicode om te gaan.

xml-catalog-dir

/library/httpd/htdocs/brocade/catalog
Brocade exporteert diverse data in XML formaat. Deze registry waarde geeft een directory aan - in de documentroot van de webserver - waar allerlei statische informatie omtrent de XML bestanden worden bijgehouden:

XML catalogi

DTD's

Schema's

Entiteiten bestanden

xml-catalog-url

/brocade/catalog
Brocade exporteert diverse data in XML formaat. Via deze URL kunnen diverse statische bestanden worden bereikt. Deze bestanden geven informatie zoals:

XML catalogi

DTD's

Schema's

Entiteiten bestanden

yaz-client-exe

/packages/bin/yaz-client
Executable voor de yaz-client. Wordt gebruikt voor centaur downloads via Z3950. Zie http://www.indexdata.com/yaz

yaz-marcdump-exe

/packages/bin/yaz-marcdump
Executable voor yaz-marcdump. Wordt gebruikt voor centaur downloads via Z3950. Zie http://www.indexdata.com/yaz

zabbix-host-name

moto
Zabbix Host identifier. vb. moto

zabbix-port

10051
Zabbix server port. default: 10051

zabbix-server

piano.cde.uantwerpen.be
Zabbix server hostname (ip) vb. allegro.cde.uantwerpen.be

zebra-modulepath

/packages/lib/idzebra-2.0/modules
In de configuratiefiles van de Zebra indexing software wordt dmv deze registry-waarde aangeduid vanuit welke directory de Zebra modules moeten geladen worden.

zebra-profilepath

/packages/share/idzebra-2.0/tab
In de configuratiefiles van de Zebra indexing software wordt dmv deze registry-waarde aangeduid in welke directory de Zebra systeem-configuratiemodules staan.

zip-exe

/bin/gzip -f
zip binary

zip-group-exe

/bin/zip -q -j
zip binary met parameters

'j': junk (don't record) directory names

'q': quiet operation

zip-group-withdir-exe

/bin/zip -q -r
zip binary met parameters

'q': quiet operation

'r': recurse into directories

2. De Brocade Registry

2.1. Inleiding

2.2. Structuur van de registry

2.3. Samenstellen van de registry

2.4. Gebruik van de registry

2.5. delphi --- Interactief werken met de registry

2.5.1. info --- Informatie omtrent de Brocade registry

2.5.2. list --- Oplijsting Brocade registry sleutels

2.5.3. key --- Geef waarde van een registry sleutel

2.5.4. add --- Voeg een (key, value) toe aan Delphi

2.5.5. delete --- Verwijder een registry waarde

2.5.6. search --- Zoek registry keys/waarden

2.5.7. refresh --- Vernieuw de registry waarden in Mumps

2.5.8. reset --- Maak/overschrijf alle core registry waarden van de Brocade registry

2.5.9. sdoc --- Voeg documentatie toe aan een registry key

2.5.10. doc --- Vraagt de documentatie van een specifieke delphi waarde op.

2.5.11. lastsession --- Zet het laatste sessienummer als delphi waarde lowest-session-allowed.

2.6. Documentatie van de registry

2.7. Registry sleutels

2.5.1. `info` --- Informatie omtrent de Brocade registry

2.5.2. `list` --- Oplijsting Brocade registry sleutels

2.5.3. `key` --- Geef waarde van een registry sleutel

2.5.4. `add` --- Voeg een (key, value) toe aan Delphi

2.5.5. `delete` --- Verwijder een registry waarde

2.5.6. `search` --- Zoek registry keys/waarden

2.5.7. `refresh` --- Vernieuw de registry waarden in Mumps

2.5.8. `reset` --- Maak/overschrijf alle core registry waarden van de Brocade registry

2.5.9. `sdoc` --- Voeg documentatie toe aan een registry key

2.5.10. `doc` --- Vraagt de documentatie van een specifieke delphi waarde op.

2.5.11. `lastsession` --- Zet het laatste sessienummer als delphi waarde lowest-session-allowed.