Tag: HCL Domino 12

  • Back-up en herstel functie in HCL Domino

    Back-up en herstel functie in HCL Domino

    Vanaf HCL Domino 12 wordt er een nieuwe, ingebouwde functionaliteit voor back-up en herstel van Notes databases, met de bijbehorende transactielog bestanden, geleverd met de servers van Domino.

    Notitie:

    Back-up en herstel is beschikbaar op Windows of Linux besturingssystemen.

    Een nieuwe applicatie, Domino Backup (dominobackup.nsf) biedt een gebruiksvriendelijke interface om back-up en herstel van Notes-databases en sjablonen te configureren. Nieuwe servertaken, Backup and Restore, gebruiken de configuratie in dominobackup.nsf om een back-up te maken van een of meer databases en om individuele databases op verzoek te herstellen.

    Een back-up naar schijf of netwerkstation is standaard beschikbaar. Echter is de back-up en het herstel mogelijkheid vooral ontworpen om te integreren met een back-up oplossingen die u misschien al gebruikt en die niet speciaal gemaakt is voor HCL Domino.

    De focus ligt op back-up van de Notes-database en back-up van transactielog bestanden om een moment terug in de tijd te kunnen herstellen. En voor het maken van back-ups van systeembestanden zoals de notes.ini en DAOS (Domino Attachment and Object Service) bestanden.

    Domino back-up en herstel biedt:

    • Back-up van het bestandssysteem naar schijf of netwerkschijf zonder integratie met een back-up oplossing van derden integratie.
    • Integratie met een back-upoplossing van derden, inclusief snelle back-up oplossingen die snapshots maken van een heel bestandssysteem. Back-up oplossing van derden integratie wordt geconfigureerd via cmd-bestanden (Windows) of shell-scripts (Linux), formules, of agenten.
    • Terug in de tijd herstel van een database door het gebruik van Domino transactielogs werken in combinatie met volledige back-ups.
    • Herstelopties die de mogelijkheid bieden om: eenvoudig het tijdstip te selecteren waarvan een database herstelt moet worden, herstelt u een verwijderde database naar het origineel locatie, verwijderde documenten of mappen herstellen in hun oorspronkelijke database, replicatie van een herstelde database uitschakelen.
    • Herstel ontbrekende of beschadigde DAOS NLO (Notes Large Objects) bestanden met behulp van back-ups die zijn uitgevoerd door een oplossing van derden.

    Geen vervanger

    HCL Notes Back-up en herstel is een aanvulling op een back-up oplossing die niet kan omgaan met open bestanden zoals het geval is bij een operationele Domino server.
    Dit component kan de open bestanden, de Notes databases, naar een locatie kopiëren op een manier waarop de integriteit van de applicaties gewaarborgd blijft. Vanaf deze back-up locatie kan een derde partij software pakket de data veilig back-uppen zonder rekening te moeten houden met open bestanden. Je zal ook nog steeds een back-up moeten maken van extra bestanden in de gegevensdirectory zoals de notes.ini, server.id, DAOS NLO bestanden enzovoort met een standaard bestands back-up of deze in een snapshot laten opnemen!
    Deze eenvoudige back-up oplossing ontdubbelt of comprimeert gegevens niet en kan veel schijfruimte in beslag nemen. De integratie met oplossingen van derden kan deze mogelijkheden en meer wel bieden.

    Waarschuwing:

    HCL Notes Back-up en herstel is een aanvulling op een back-up oplossing geen vervanger of een complete oplossing!

    Componenten van Back-up en Herstel

    Back-up en herstel omvat de volgende onderdelen:

    • Domino Backup-database (dominobackup.nsf).
    • Back-up taak. Servertaak die de back-ups uitvoert en ook oudere back-ups verwijderd met een interval die u opgeeft.
    • Taak herstellen. Servertaak die back-ups van databases herstelt.
    • Database inventarisatie. Een weergave in de back-updatabase die de actuele back-ups van databases laat zien. Je gebruikt deze weergave om databases te herstellen.
    • Back-up logboeken. Logboeken die worden gegenereerd door de back-uptaak.

    De implementatie van Domino Backup en Herstel is gebaseerd op de Backup and Restore API beschreven in de gebruikershandleiding van de Domino C API.

    Extra bestanden

    De Back-up en herstel configuratie documenten hebben vier keuzes als het gaat om het uitvoeren van commando’s voor een taak:

    • File commands Opdracht die een van de volgende ingebouwde bestandsbewerkingen uitvoert. Geconfigureerd via de opdrachtoptie Bestand in een configuratiedocument.
    • Formula-defined commands Een formule waarmee een opdracht wordt uitgevoerd. Geconfigureerd via de optie Cmd-formule in een configuratiedocument.
    • Agents Een agent die wordt uitgevoerd met goed gedefinieerde parameters die worden doorgegeven aan een document in het geheugen dat goed gedefinieerde velden bevat. Geconfigureerd via de Agent-optie in een configuratiedocument.
    • Native OS commands Directe opdrachten van het besturingssyteem.

    Door deze flexibele opdrachten is het mogelijk om zelf op diverse manieren automatiseringsscripts te maken om ook de bestanden die niet standaard door de Back-up en herstel functie worden meegenomen toch te back-uppen en te restoren.
    Een heel eenvoudig voorbeeld voor een back-up taak:

    In een map op de HCL Domino plaats je een eenvoudig batchbestand in ons geval backup.cmd. Hier bestaat het bestand uit slechts een enkele regel met de inhoud robocopy “C:\Program Files\HCL\Domino14\Data\DAOS” “%1\%2\DAOS” /E /W:2 /R:1 /FFT
    Deze regel maakt een kopie van de DAOS map van HCL Domino server naar een locatie die met de parameters %1 en %2 bepaald kan worden.
    In Notes applicatie dominobackup.nsf kies je in het Configuratie document bij het veld Post-backup command: Cmd Formula. In het formule veld zorg je dat de uitkomst van de formule het juiste pad naar het batchprogramma backup.cmd met de gewenste parameters wordt. Test eventueel de formule met de knop die hiervoor in het menu aanwezig is.
    Voer op de serverconsole het commando load backup -V uit.
    Als het goed is zie je het commando en het resultaat van de uitvoer:

    Backup-Log: OsLevelCommand(12): [{c:\\\\backup\\backup.cmd } + BackupTargetDir + { } + BackupNode + { } + BackupMode]
    Backup-Log: Formula Result: [c:\\backup\backup.cmd c:\backup\nsf MRPOWERZBOOK FULL]
    Backup-Debug: Running [BACKUP] CMD: [c:\\backup\backup.cmd c:\backup\nsf MRPOWERZBOOK FULL]
    Backup-Debug: CMD-RET: []
    Backup-Debug: CMD-RET: [C:\Program Files\HCL\Domino14>robocopy "C:\Program Files\HCL\Domino14\Data\DAOS" "c:\backup\nsf\MRPOWERZBOOK\DAOS" /E /W:2 /R:1 /FFT]
    Backup-Debug: CMD-RET: []
    Backup-Debug: CMD-RET: [---------]
    Backup-Debug: CMD-RET: [   ROBOCOPY     ::     Robust File Copy for Windows]
    Backup-Debug: CMD-RET: [---------]
    Backup-Debug: CMD-RET: []
    Backup-Debug: CMD-RET: [  Started : donderdag 30 oktober 2025 16:54:53]
    Backup-Debug: CMD-RET: [   Source : C:\Program Files\HCL\Domino14\Data\DAOS\]
    Backup-Debug: CMD-RET: [     Dest : c:\backup\nsf\MRPOWERZBOOK\DAOS\]
    Backup-Log: [{c:\\\\backup\\backup.cmd } + BackupTargetDir + { } + BackupNode + { } + BackupMode] CheckRetRef -- RET: [] REF: []
    Backup-Log: CheckOutputString OK: 0 ERR: 0
    Backup-Debug: Finished [BACKUP]

    Notitie:

    Niet alle parameters die beschreven staan in de HCL Domino help blijken overal te werken.

    Uitvoeren van de Back-up server taak

    Maak een back-up van databases door de server taak Backup te plannen via een programma document. Je kan ook een back-up uitvoeren op de Domino console met behulp van de opdracht ‘load backup’.

    Parameters

    Argument

    Beschrijving

    -b

    Maakt alleen een back-up van databases en sjablonen. Eén keer per dag wordt aanbevolen, ongeacht de modus van het transactielog.

    -t

    (Alleen voor transactielog’s in archief stijl) Back-up van transactielog (TXN) bestanden. Afhankelijk van de grootte van uw server en het volume van gewijzigde gegevens, is een back-up van deze bestanden om de 2 tot 8 uur aanbevolen.

    -i

    (Alleen voor transactielog’s in archief stijl) Om een terug in de tijd herstelpunt te krijgen voer je incrementele back-ups uit van nieuwe databases of databases waaraan een nieuwe instance IDs (DBIIDs) zijn toegewezen sinds de laatste volledige back-up. Elke 2 tot 4 uur een back-up maken met deze optie wordt aanbevolen. Bewerkingen zoals Fixup en Compact wijzen nieuwe DBIID’s toe aan databases, waardoor de nieuwe ID’s worden gebruikt bij transacties Logs. Door incrementele back-ups te maken van databases met nieuwe DBIID’s, wordt naar de nieuwe DBIID’s verwezen in de back-up en overeenkomen met de nieuwe ID’s in de transactielog’s die worden gebruikt voor herstel op een bepaald tijdstip.

    -s

    Voert een back-up van snapshots uit zoals geconfigureerd op het tabblad Snapshot van het back-up configuratiedocument.

    -e

    Uitgesloten databases worden standaard bepaald door het veld Uitgesloten databases in het tabblad Main van een back-upconfiguratie. In sommige gevallen, Het is zinvol om verschillende databases uit te sluiten voor Verschillende back-ups in een week. Met deze optie kan je databases uitsluiten via reguliere expressies die vergelijkbaar zijn met de back-upconfiguratie. Het enige verschil is dat het automatisch een * toevoegt aan het einde van het patroon voor uw gemak.

    -E

    Hiermee negeer je het veld Uitgesloten databases op het tabblad Main van configuratiedocumenten voor back-ups. Kan worden gebruikt in combinatie met -e ter vervanging van de uitgesloten databasepatroon in de configuratie met een andere uitgesloten databases patroon. Bijvoorbeeld: -E -e archief/.

    -p <aantal dagen>

    Hiermee worden herstelde databases verwijderd die zijn gemarkeerd als verlopen voor een bepaald aantal dagen. Je kan het aantal dagen opgeven in de opdracht. Als je dat niet doet, wordt het aantal aantal dagen dat is opgegeven voor de instelling Back-up bewaren (dagen) wordt gebruikt. Herstelde databases zijn gemarkeerd als verlopen volgens de “Standaard bewaardagen herstellen” configuratie-instelling.

    -v

    Hiermee kunt u uitgebreide logboekregistratie naar de console maken. Dit genereert een veel extra houtkap en is alleen bedoeld voor Probleemoplossing.

    -V

    Maakt uitgebreide logboekregistratie en foutopsporing mogelijk voor het oplossen van problemen. Logboeken worden in console.log geschreven. Standaard logberichten worden geschreven in log.nsf

    Lees voor meer informatie de documentatie van HCL op: Backup and restore en Domino Backup Introduction | Domino Backup en de presentatie van Daniel Nashed: Domino 12 Backup & Restore

    INECO kan behulpzaam zijn bij het inrichten en onderhouden van uw HCL Domino Servers en de back-up en herstel mogelijkheden. Dit kan op basis van een opdracht of door middel van een support contract.

  • Certificate Store voor SSL certificaten

    Certificate Store voor SSL certificaten

    Sinds Domino versie 12 is er weer een nieuwere methode om SSL certificaten te beheren binnen de Domino omgeving.
    HCL introduceerde daarvoor een nieuwe servertaak, Certificate Manager (CertMgr), die samenwerkt met een nieuwe database, Certificate Store (certstore.nsf), om de generatie van TLS-certificaten van de Let’s Encrypt-certificeringsinstantie (CA) en andere externe CA’s te automatiseren.
    CertMgr vereenvoudigt en beveiligt de werking van de Domino-webserver door automatisch gratis, breed vertrouwde TLS-certificaten aan te vragen, te configureren en te verlengen bij de Let’s Encrypt-certificeringsinstantie (CA) of een andere externe CA.

    In de Certificate Store kunnen ACME accounts, , DNS Providers en Configuaties, Trusted Roots, wachtwoorden en TLS Credentials worden ingesteld en opgeslagen.

    Gebruik van de Certificate Store Applicatie:

    De CertMgr-servertaak werkt met de Certificate Store-database (certstore.nsf) om certificaataanvragen en -beheer te vereenvoudigen. Als uw HCL Domino-server via uitgaande poort 443 en inkomende poort 80/443 met internet is verbonden, kunt u een certificaataanvraag genereren door (eenmalig) de volgende opdracht op de serverconsole uit te voeren:
    load certmgr -ACCEPT_TOU_AUTO_CONFIG

    (gelijk aan: load certmgr -r -c -o -y -ACCEPT_TOU )
    Met deze opdracht voert CertMgr de volgende stappen uit:
    Accepteert de gebruiksvoorwaarden voor de Let’s Encrypt®-certificeringsinstantie (-ACCEPT_TOU).
    Certstore.nsf wordt aangemaakt.
    De hostnaam van de machine wordt bepaald en een eerste certificaat wordt aangevraagd (-r).
    Het DSAPI-filter wordt geconfigureerd (-c).
    HTTP wordt gestart (-o) of HTTP wordt opnieuw gestart als deze al actief is (-c).
    Een certificaat wordt aangevraagd bij de Let’s Encrypt-certificeringsinstantie via het ACMEv2-protocol.
    Een .kyr-bestand wordt gegenereerd en op schijf opgeslagen.
    HTTP wordt opnieuw gestart om het .kyr-bestand te laden (-y).
    Ditzelfde certificaataanvraagscenario kan worden geautomatiseerd met behulp van de volgende notes.ini-instellingen:
    CertMgr_ACCEPT_TOU=1
    CertMgr_AutoRequestCert=1
    CertMgr_AutoConfig=1
    CertMgr_AutoConfigHttp=1
    CertMgr_RestartHttp=1

    Importeren

    Een eigen certificaat importeren in de TLS credentials van de Certificate Store kan natuurlijk ook.
    Zorg dan dat de hele certificaat keten uit bijvoorbeeld een PEM bestand formaat in een nieuw PEM bestand komt te staan met als eerste de tekst uit de private key. Noem dit bestand bijvoorbeeld fullchain.pem.

    —–BEGIN PRIVATE KEY—–
    ==content==
    —–END PRIVATE KEY—–
    —–BEGIN CERTIFICATE—–
    ==content==
    —–END CERTIFICATE—–
    —–BEGIN CERTIFICATE—–
    ==content==
    —–END CERTIFICATE—–

    Maak gebruik van een bestaande, of maak een nieuwe TLS credential in de Certificate Store.

    Importeer het eerder gemaakte gecombineerde bestand.

    Certificaat koppelen aan Website

    De TLS-cache zorgt voor het vinden van TLS-referenties. Het opzoeken kan via de DNS-naam, wat de nieuwe voorkeursmethode is. U vervangt dus de kyr-bestandsnaam door de DNS-naam. De nieuwe cache begrijpt ook KYR-bestandsnamen en gebruikt deze als tag voor het opzoeken.

    Maar dan moet in het TLS-referentiedocument de kyr-bestandsnaam zijn ingesteld (wat optioneel is in het TLS-referentiedocument en bedoeld is voor dit gebruik). De juiste manier is om altijd een DNS-naam op te geven. De nieuwe TLS-cache begrijpt DNS-namen, inclusief wildcard-certificaten, en ondersteunt meerdere SAN’s.

    Voorbeeld van een Web Site document:

    Met een bijbehorende  TLS referentie:

    Controle

    Door de certificaten met de Key file naam te vergelijken kan gecontroleerd worden of er een verband is tussen de TLS Credential en het Web Site document.

    tell certmgr show certs
    [19D0:0002-5264] Subject key identifier Key info Expiration KeyFile/Tag Host names (SANs)
    [19D0:0002-5264] ——————————————————————————————————————————————————
    [19D0:0002-5264] D5A9 FD93 2843 8506 … RSA 2048 88,6 days mrpowerzbook.ineco.nl
    [19D0:0002-5264] ——————————————————————————————————————————————————
    [19D0:0002-5264] 1 TLS Credentials

    tell http show security

    09-05-2025 22:56:17
    09-05-2025 22:56:17 Web Site: test (mrpowerzbook.ineco.nl)
    09-05-2025 22:56:17 SSL enabled
    09-05-2025 22:56:17 Key file name: c:\program files\hcl\domino12\data\mrpowerzbook.ineco.nl

    Dit laatste resultaat ziet er vreemd uit, maar negeer in dit geval het pad en kijk alleen of de hostname van het eerste resultaat gelijk is aan wat het bestand zou moeten zijn in het pad van het tweede resultaat. Dit is nog een kleine onvolkomendheid in de functie van HCL. In Dit geval is mrpowerzbook.ineco.nl gelijk in beide gevallen wat aangeeft dat het juiste certificaat is gekoppeld aan de website.

  • Kritisch defect in Domino gedetecteerd op 13-12-2024

    Kritisch defect in Domino gedetecteerd op 13-12-2024

    Zoals u waarschijnlijk al gelezen of gehoord heeft, heeft het ontwikkelingsteam van HCL Domino een kritisch defect (bug) geïdentificeerd dat vanaf 13 december 2024 van invloed zal zijn op ALLE Domino-server versies.

    (Bron: https://support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0118192)

    Klanten met HCL Domino versies 14.x,12.x en 11.x:

    Meer informatie vindt u via de bovenstaande link, inclusief hoe u toegang krijgt tot de oplossing voor klanten met actieve ondersteuning met HCL Domino-versies 14.x,12.x en 11.x. op Mijn HCL-softwareportaal.
    Domino-klanten zonder actieve ondersteuning moeten opnieuw een support contract opstarten met behulp van de Domino CCB Term-licentie. Neem hiervoor contact op met uw partner of HCL-verkoopvertegenwoordiger.
    Alleen klanten met een geldig recht en actieve ondersteuning (en uitgebreide ondersteuning voor v9 en/of v10) kunnen de oplossing ontvangen en toepassen.

    Alle fixes of patches van HCL Domino zijn het intellectuele eigendom van HCLSoftware.
    Elk ongeoorloofd gebruik, reproductie of distributie is ten strengste verboden en zou een inbreuk vormen op de IE-rechten van HCLSoftware.

    (Opmerking: Fixes zullen niet beschikbaar zijn voor alle tussentijdse versies van IBM Domino v9 en v10)

    Wat is er aan de hand?

    Volgens HCL zal als u uw server opnieuw opstart, er een routerfout optreden die resulteert in leveringsfouten als gevolg van een routeringslus. Ook zullen de e-mailregels beginnen te falen.
    Bovendien gebruikt Domino slechts één enkele mail.box, ongeacht waar het configuratiedocument om vraagt.
    Dit is een datum/tijd-probleem in de Domino router code. Het gebied waar het defect is gevonden, wordt gebruikt om te bepalen of de configuratie moet worden bijgewerkt.
    Sinds 13 december mislukt deze controle en laadt de router uw configuratie niet.

    Dit probleem treedt alleen op als Domino op of na 13 december 2024 opnieuw wordt opgestart. HCL heeft op 13 december een waarschuwing afgegeven om de impact te beperken.
    Er werd binnen 24 uur een tussentijdse oplossing geleverd. Zie tabel in de link voor downloaddetails.

    Dit probleem wordt niet veroorzaakt door een recente codewijziging en heeft geen invloed op de beveiliging. Deze bug bestaat al meer dan 30 jaar en lijkt van invloed te zijn op alle versies van Domino.
    Hij werd niet eerder door IBM of Lotus ontdekt.

    In de praktijk

    Wij hebben inderdaad ook geconstateerd dat bij een herstart de mailrouter postbussen zijn beperkt tot een enkele (nieuwe) postbus, de mail regels niet meer werken en Notes mail routering niet meer werkt. SMPT mail verkeer, ook tussen de servers (indien geconfigureerd) blijft wel werken, waardoor mailverkeer via deze methode wel mogelijk lijkt te zijn.

    In enkele gevallen werkt de mailroutering ook nog steeds, maar doordat het configuratie document mogelijk niet goed uitgelezen wordt is het maar zeer de vraag of de instellingen allemaal worden gebruikt, met alle gevolgen van dien. Onderschat het probleem dus niet, ook als er weinig aan de hand lijkt te zijn in uw situatie.

    HCL kan op aanvraag ondersteuning bieden: Critical Alert: Resolve Domino Server Issues Before December 2024

    Zie ook: HCL Notes/Domino – CRITICAL ALERT: Mail not routing after Domino restarts beginning December 13, 2024 – Community