HCL Domino AutoUpdate

HCL software downloaden, distribueren en installeren met AutoUpdate in HCL Domino, eventueel in combinatie met de Auto Update van HCL Notes, dit kan met een paar stappen eenvoudig!

HCL autoupdate icon

AutoUpdate informeert je over de nieuwste HCL Domino- en Domino productfamilie die beschikbaar zijn op de Domino server en stelt je in staat de software te downloaden.
Je kan het ook gebruiken om software te distribueren en optioneel te installeren naar groepen of geselecteerde Domino servers.

Softwarecatalogus

De softwarecatalogus (autoupdate.nsf) wordt dagelijks bijgewerkt met nieuwe versies, releases, fixpacks en tussentijdse fixes van HCL Software die beschikbaar zijn in de My HCLSoftware Portal. Beheerders kunnen software uit de catalogus selecteren om te downloaden naar de autoupdate.nsf-database.

Downloads

Wanneer downloads zijn ingeschakeld, wordt voor dit doel één server geselecteerd als downloadserver. Het is de enige server in het Domino domein die communiceert met de My HCLSoftware Portal.

Notitie:

Momenteel wordt alleen Domino, Traveler en de Notes client software ondersteund.

Snelstartgids

Om je snel op weg te helpen om dit op te zetten hebben wij hier de stappen op een rijtje gezet. Met deze uitleg kun je snel aan de slag. Koppelingen naar de Domino documentatie staan onderaan de pagina.

Open de Domino directory met behulp van een HCL Notes- of Administrator-client.

Selecteer Acties > Directoryprofiel bewerken en klik vervolgens op het tabblad Productupdates.

Selecteer in het veld “Status” de gewenste status:

  • Notify Only – Alleen notificeren om de nieuwste beschikbare software-updates in de Domino Directory en in de Domino Administrator client weer te geven.
  • Notify and Download – Melding en download om de nieuwste updates weer te geven, de softwarecatalogus te downloaden en beheerders de mogelijkheid te geven software te downloaden, deze automatisch op te slaan op autoupdate.nsf en softwaredownloads te distribueren naar doelservers in hetzelfde Domino-domein.
  • Notify, Download and Update – Download en Update om alle functies van Notify en Download in te schakelen, plus de mogelijkheid om automatisch servers bij te werken waarop momenteel Domino 14.5 of hoger draait.

Selecteer in het veld Downloadserver de server die de softwarecatalogus ophaalt en de downloads zal ophalen en opslaan.

Start of herstart op de eerder geselecteerde AutoUpdate Domino server de taak door het commando: restart task autoupdate

> restart task autoupdate
Entitlement Scan : Begin
31-10-2025 17:16:18   AutoUpdate: Quit request received, shutting down...
31-10-2025 17:16:19   AutoUpdate: Shutdown complete
Entitlement Scan : End
31-10-2025 17:16:20   AutoUpdate: Waiting for server to be ready
31-10-2025 17:16:20   AutoUpdate: Automatic notifications, downloads, and distributions are enabled.
31-10-2025 17:16:20   Recovery Manager: Assigning new DBIID for C:\Program Files\HCL\Domino14\Data\autoupdate.nsf (need new backup for media recovery).
31-10-2025 17:16:21   AutoUpdate: Importing product information from [https://ds-infolib.hcltechsw.com/product.jwt] to [names.nsf]
31-10-2025 17:16:22   AutoUpdate: Importing software catalog from [https://ds-infolib.hcltechsw.com/software.jwt] to [autoupdate.nsf]
31-10-2025 17:16:23   AutoUpdate: Created autoupdate.nsf server document
31-10-2025 17:16:23   AutoUpdate: Updating software document filters

Als het goed is zal er een nieuwe database aangemaakt worden op de server: autoupdate.nsf.

My HCLSoftware Portal API sleutel

Het is mogelijk om de software catalogus op te halen van het My HCLSoftware Portal maar om de software te downloaden is een zogenaamde API key (sleutel) nodig.

Een API-sleutel is een unieke code die fungeert als een inloggegevens om de identiteit van een applicatie of gebruiker te verifiëren wanneer deze toegang vraagt tot een andere service of API. Deze sleutel zorgt ervoor dat alleen geautoriseerde clients toegang krijgen tot gegevens, wat vergelijkbaar is met een wachtwoord maar dan voor software, en wordt gebruikt om gebruik te volgen en toegangsrechten te beheren.

Ga naar https://my.hcltechsw.com/tokens en meld aan met je account gegevens van HCL.

Vul een label naar keuze in met een herkenbare naam en klik Create.

Kopieer de sleutel en bewaar deze voor de volgende stap.
Open het Global Configuration document door te klikken op de knop links onder in het navigatiemenu van de AutoUpdate applicatie.
klik op de knop Set Download Token en plak daar de API sleutel uit de vorige stap. Klik OK in de dialoog. Maak eventueel aanpassingen aan de selectie van software zoals de producten, platformen, talen, types e.d.
Sla het document op.

De inhoud van de Software catalogus

Zodra de server contact heeft gemaakt met HCL zal de gekozen selectie van software te zien zijn in de catalogus.
Met de knop “Mark for download” is hier een gekozen om Domino Server 14.5FP1 te downloaden. Hierdoor is ook Domino Server 14.5 gemarkeerd. Beide staan in de afbeelding met de status “pending”.

HCL autoupdate pending download

Om direct actie te zien hebben wij het server commando Tell autoupdate process all op de server console uitgevoerd.

> Tell autoupdate process all
31-10-2025 17:40:19   AutoUpdate: Importing product information from [https://ds-infolib.hcltechsw.com/product.jwt] to [names.nsf]
31-10-2025 17:40:20   AutoUpdate: Importing software catalog from [https://ds-infolib.hcltechsw.com/software.jwt] to [autoupdate.nsf]
31-10-2025 17:40:21   AutoUpdate: Downloading 2 software package(s)
31-10-2025 17:40:46   AutoUpdate: File [Domino_14.5_Win_English.exe] attached to note 0xA32, Upload Rate: 104,8 MB/sec
31-10-2025 17:40:52   AutoUpdate: File [Domino_1450FP1_Win.exe] attached to note 0xA52, Upload Rate: 205,3 MB/sec

Op de console is te zien dat voor beide documenten in de wachtrij de software gedownload en als bijlagen opgeslagen zijn.

Wanneer we terug gaan naar de catalogus is de status gereed.

De inhoud van een document in de catalogus waarvan de software is gedownload ziet er zo uit:

HCL autoupdate domino-server 14.5FP1

De software is onderin het document aanwezig als bijlage en is beschikbaar om handmatig te installeren of door het AutoUpdate proces verder te laten distribueren en/of uit te rollen.

AutoUpdate integratie met Notes AUT Catalog

Vanaf HCL Domino 14.0 Fixpack 1 kan AutoUpdate geïntegreerd worden met Notes AUT Catalog. Deze Notes AUT Catalog bestaat al langer en is met name bedoeld om de Notes Client software (automatisch) bij te werken.
Je kan nu Domino AutoUpdate (autoupdate.nsf) gebruiken om het eenvoudiger te maken Notes softwarepakketten voor Windows toe te voegen aan de Notes Auto Update Catalog (autcat.nsf).
De server waarop de Notes AUT-catalogus (autcat.nsf) wordt gehost, kan op een eerdere versie van de Domino-server worden uitgevoerd, maar kan ook op de zelfde server staan.

Je bent niet afhankelijk van producten van derden om de implementatie van nieuwe versies en updates van HCL Notes of HCL Client Application Access (HCAA) te automatiseren.

Open nogmaals het globale configuratiedocument en helemaal onderin
in het veld Actie selecteer je Push Notes-clientsoftware naar AUT-catalogus.

> Tell autoupdate process all
31-10-2025 23:28:15   AutoUpdate: Importing product information from [https://ds-infolib.hcltechsw.com/product.jwt] to [names.nsf]
31-10-2025 23:28:15   AutoUpdate: Importing software catalog from [https://ds-infolib.hcltechsw.com/software.jwt] to [autoupdate.nsf]
31-10-2025 23:28:17   AutoUpdate: Downloading 2 software package(s)
31-10-2025 23:28:22   AutoUpdate: File [Domino_1450FP1_autoinstall_Win.exe] attached to note 0xA5A, Upload Rate: 236,4 MB/sec
31-10-2025 23:28:39   AutoUpdate: File [Notes_Designer_Admin_14.5_Win64_English.exe] attached to note 0xF3A, Upload Rate: 259,2 MB/sec
31-10-2025 23:28:39   AutoUpdate: Found 1 software package(s) to push to autcat.nsf

De software is nu ook beschikbaar voor uitrol naar de Notes werkplekken met Notes Auto Update!

Met de beschikbaar gekomen software in de AUT Catalog kan een beheerder de juiste versie paden instellen en eventuele instellingen aanpassen.

Wanneer de instellingen bij Version Paths en Version Maps goed staan kunnen deze beide klaar gezet worden op de Domino voor uitrol naar de werkplekken door de knoppen “Deploy Files” en “Deploy Version Maps” te gebruiken.

Wanneer er een Desktop policy instelling gemaakt is voor het bijwerken van de Notes client en Auto Update goed is ingericht op de server zal de ingestelde actie bij het beschikbaar komen van nieuwe software uitgevoerd worden.

Wanneer de Notes client verbinding maakt, Auto update is ingeschakeld en een nieuwe versie beschikbaar is op de server, zal na enige tijd een melding op de werkplek een melding getoond worden.

Wanneer gekozen wordt om de upgrade te downloaden zal vervolgens een dialoog venster vragen om Notes af te sluiten. Het is belangrijk om Notes eerst af te sluiten. Open Notes processen kunnen een foutmelding geven en de installatie verhinderen.

De voortgang is vervolgens zichtbaar in een aantal vensters.

Wanneer alles goed verloopt zal de melding getoond worden dat de installatie is afgerond.

Hulp nodig?

Dit zou voldoende moeten zijn om je op weg te helpen met de nieuw AutoUpdate functionaliteit.
INECO kan natuurlijk helpen bij het opzetten van deze functie en het verder uitbreiden en automatiseren binnen jouw HCL Domino omgeving.

Bronnen

Downloading, distributing, and installing software using AutoUpdate

Pushing Notes installs to the AUT Catalog using Domino AutoUpdate

Notes Auto Update

HCL Domino v14 Deep Dive Series #4 – Auto Update:

HCL AUT Overview, Configuration, Debugging Troubleshooting:

Geplaatst in Beheer, Domino, Domino Server, Notes en getagd met , , , , , .