Tuesday, September 22, 2026

Setting Up Domino's Native Backup: A Hands-On Guide

Why Native Backup Matters

If you've been juggling third-party backup solutions for your Domino servers, you know the drill: compatibility issues, complex configurations, and sometimes, less-than-ideal integration. With Domino 12, HCL introduced a native backup and restore feature that simplifies the process, offering a seamless way to protect your data without external tools. Let's dive into setting it up.

Prerequisites

Before we get our hands dirty, ensure:

  • Domino Version: You're running Domino 12 or later. This feature isn't available in earlier versions.
  • Operating System: Your server is on Windows or Linux. The native backup doesn't support other Operating Systems.

Step 1: Initialize the Backup Database

First things first, we need to create the dominobackup.nsf database, which will house our backup configurations and logs.

  • Run the Backup Task: Open your Domino console and execute:

`` load backup ``

This command initializes the backup database. If it's the first run, Domino will create dominobackup.nsf in the data directory.

  • Verify Creation: Navigate to your Domino data directory and confirm the presence of dominobackup.nsf.

Step 2: Configure Backup Settings

With the backup database in place, let's set up the backup configurations.

  1. Open dominobackup.nsf: Using the Domino Administrator client, access the backup database.
  2. Create a New Configuration:

- Platform Selection: Choose between 'Default' (applies to multiple servers) or 'Server' (specific to one server). For most setups, 'Default' suffices.

- Backup Paths: Specify directories for storing backup files. Ensure these paths have adequate storage and permissions.

- Excluded Databases: If there are databases you don't want to back up, list them here.

- Schedule: Define when backups should run. Regular scheduling ensures consistent data protection.

For a detailed breakdown of each configuration field, refer to the official documentation.

  1. Save and Close: Once configured, save your settings.

Step 3: Schedule the Backup Task

To automate backups:

  1. Create a Program Document:

- Program Name: backup

- Command Line: Leave this blank.

- Server to Run On: Specify your server.

- Schedule: Set the desired frequency and time for backups.

  1. Save the Document: This schedules the backup task as per your configuration.

Step 4: Test the Backup

Before relying on the setup:

  • Manually Run the Backup: In the Domino console, execute:

`` load backup ``

  • Monitor the Process: Check the console for any errors. Also, verify that backup files are created in the specified directories.

Step 5: Restore a Database

Testing the restore process ensures your backups are reliable.

  1. Open dominobackup.nsf: Navigate to the 'Restore' view.
  2. Select a Database: Choose a database to restore.
  3. Restore Options: Decide whether to restore to the original location or an alternate one. You can also choose to restore deleted documents.
  4. Initiate Restore: Click 'Restore' and monitor the process.

For more insights on the restore process, check out the Domino Backup Introduction.

To Review

Setting up Domino's native backup isn't just about ticking boxes; it's about ensuring your data's safety without unnecessary complexity. By following these steps, you integrate a robust backup solution directly into your Domino environment. Remember, regular testing of both backup and restore processes is crucial. After all, a backup is only as good as its restore.

For a visual walkthrough, consider watching this HCL Domino Backup/Restore Function video.

Thursday, September 17, 2026

Optimizing Domino Cluster Failover for Seamless High Availability

Ensuring high availability in an HCL Domino environment requires meticulous configuration of cluster failover mechanisms. Proper tuning not only guarantees seamless user access during server outages but also optimizes overall server performance. 

This guide delves into key settings and parameters essential for effective cluster failover management.

Understanding Domino Cluster Failover

In a Domino cluster, failover is the process by which the system redirects user requests from an unavailable server to a replica on another server within the cluster. This mechanism ensures continuous access to databases, even during server downtimes. The Cluster Manager on each server monitors the availability of other cluster members and manages the redirection process accordingly.
Learn more about how failover works here.

Configuring Silent Failover on Notes Clients

By default, when a Notes client encounters a server failure, it prompts the user with a dialog box before switching to a replica on another server. To enhance user experience by making this process transparent, you can enable silent failover:

    1. Set the FailoverSilent Parameter:

- Add the following line to the client's notes.ini file: `` FailoverSilent=1 `` - This setting suppresses failover prompts, allowing the client to switch servers without user intervention. Detailed information on this parameter.

    2. Deploy via Desktop Policy:

- Navigate to Policies - Settings Desktop Settings in the Domino Directory. - Under the Mail tab, select Client Settings. - Enable the option "Enable silent failover when a server goes down". - This policy distributes the FailoverSilent=1 setting to all clients, ensuring consistency across the organization.

Enabling Mail Router Cluster Failover

To ensure that the Domino Mail Router can reroute emails to available servers during a mail server outage, configure the following:

    1. Set the MailClusterFailover Parameter:

- Add the following line to the server's notes.ini file: `` MailClusterFailover=1 `` - This setting allows the Router task to forward incoming messages to a cluster replica of the recipient's mail file on another available server. More details on this parameter.

    2. Configure via Server Configuration Document:

- Open the Domino Administrator. - Navigate to Configuration > Servers > Configurations. - Edit the relevant Server Configuration document. - Under the Router/SMTP tab, go to Advanced > Controls. - Enable the Cluster failover option.

Managing Server Availability and Load Balancing

To prevent servers from becoming overloaded and to manage failover effectively, adjust the following settings:

    1. Set the Server_Availability_Threshold Parameter:

- Add the following line to the server's notes.ini file: `` Server_Availability_Threshold=75 `` - This value (ranging from 0 to 100) defines the minimum acceptable level of available system resources. When a server's availability index falls below this threshold, it declines new database open requests, prompting clients to failover to less loaded servers. Further information on this parameter.

    2. Configure via Server Configuration Document:

- Open the Domino Administrator. - Navigate to Configuration > Servers > Configurations. - Edit the relevant Server Configuration document. - Under the Notes.ini Settings tab, add or modify the Server_Availability_Threshold setting.

Restricting Server Access During Maintenance

During maintenance windows, it's crucial to prevent new user connections while allowing existing sessions to conclude gracefully:

    1. Set the Server_Restricted Parameter:

- To restrict new database open requests: `` set config Server_Restricted=1 ` - This command can be issued directly on the server console. The value 1 restricts access until the next server restart, while 2` makes the restriction persistent across restarts. Detailed explanation of this parameter.

    2. Monitor and Manage Active Sessions:

- Use the Domino Administrator to monitor active user sessions. - Notify users of impending maintenance to minimize disruption.

Tuning the Cluster Repair Service

For environments utilizing symmetrical clusters, the Cluster Repair service ensures database replicas remain consistent across servers. To optimize its performance:

  1. Access the Cluster Configuration Document:

- Open the Domino Administrator. - Navigate to Configuration > Clusters > Configuration. - Edit the Cluster Configuration document.

  1. Adjust Repair Service Settings:

- Under the Tuning tab, configure the following: 

  • Number of repair threads: Set between 1 and 20 (default is 4). 
  • Check donor availability: Frequency (in minutes) to check donor server availability (default is 5 minutes).
  • Retry failed repairs after: Interval (in minutes) before retrying a failed repair (default is 5 minutes).
  • Maximum number of retries: Number of retry attempts before marking a repair as unrepairable (default is 3).
  • Repair performance: Level of CPU and disk I/O dedicated to the repair service, from 1 (slowest) to 5 (fastest) (default is 3).
  • Repair logging level: Level of logging detail, from 0 (none) to 4 (diagnostic) (default is 2).

- These settings help balance repair efficiency with system resource utilization. More on tuning the repair service.

Conclusion

By carefully configuring these parameters and settings, you can enhance the resilience and performance of your HCL Domino cluster. Regular monitoring and adjustments ensure failover processes remain seamless, providing users with uninterrupted access to critical services.