Enabling AutoUpdate

This feature makes administrators aware of the latest version of Domino and Domino product family available on the My HCLSoftware Portal and allows you to download and distribute the software. Starting with Domino 14.5, it also allows you to schedule automatic updates of Domino on one or more servers in the Domain.

The AutoUpdate feature requires the Domino 14 design of the Domino Directory (names.nsf) and is supported on Domino 14 and later servers only. Administrators must use the HCL Notes or Administrator client 12.0.1 or later when configuring AutoUpdate. Automatic updates (installs) of Domino require that the servers targeted for update are running Domino 14.5 or later. Only servers that are running as a Windows service or a Linux systemd service can be updated. Domino partitioned servers and servers running in a container environment cannot be updated. AIX and iSeries servers cannot be updated, but you can distribute software to AIX systems.

The following tables summarize the available AutoUpdate features.

Table 1. AutoUpdate capabilities by platform
Platform Distribute Install
Windows Yes Yes*
Linux Yes Yes*
AIX Yes No
OS400 No No

*Domino must be running as a Windows service on Windows or as a systemd service on Linux.

Table 2. AutoUpdate capabilities by Domino server type
ServerType Distribute Install
Started as a service Yes Yes
Partitioned Yes No
Container Yes No
Manually started Yes No

About this task

Enabling the AutoUpdate feature is a domain-wide setting and applies to Domino 14.0 and later releases only. Since the AutoUpdate task is enabled by default, as soon as the following steps are completed, it will be enabled on all Domino 14.0 or later servers in the domain.

When enabled, AutoUpdate starts automatically. If disabled, it just checks to see if the feature status changes.

Procedure

  1. Using an HCL Notes or Administrator client, open the Domino directory.

  2. Select Actions > Edit Directory Profile, then click the Product Updates tab.

  3. In the "Status" field, select the desired status:
    • Notify Only to display the latest available software updates in the Domino Directory and in the Domino Administrator client.
    • Notify and Download to display latest updates, download the software catalog, and allow administrators to download software, save it automatically to the autoupdate.nsf, as well as distribute software downloads to target servers in the same Domino Domain.
    • Notify, Download and Update to enable all of the features of Notify and Download plus the ability to automatically update servers that are currently running Domino 14.5 or later.
  4. In the Download server field, select the server that will retrieve the software catalog and host the downloads. This one server will act as the designated download and management server.
    Note: Since AutoUpdate applies domain-wide, it is configured per domain. Each domain can only have one designated download server.
  5. Save the document.

  6. Open the Domino console on the selected download server and restart the AutoUpdate task:
    restart task autoupdate

Verifying AutoUpdate is enabled

When AutoUpdate is enabled, a new database autoupdate.nsf is created on the download server, which will host the software catalog. By default, only the administrators and servers in the same Domino domain have access to the database.

With the Notify only, Notify and Download, and Notify, Download and Update statuses, a product.jwt is downloaded periodically and documents in the Product Info view in the Domino directory are updated with the latest production versions available for each product.

With the Notify and Download and Notify, Download and Update statuses and additionally a software.jwt is downloaded periodically and software documents in autoupdate.nsf are updated with the current availability of software downloads.

The information downloaded is signed using JSON Web Tokens. If the signature doesn't verify, Domino will not import the data into the autoupdate.nsf.

What to do next

Configuring the Global Configuration Document