Wed, Jun
4 New Articles

Cluster Domino on IBM i Servers on the Same Box!

Collaboration & Messaging
  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times

Don't just build a Domino server on IBM i. Build two or three Domino servers and cluster them!


Have you ever seen the Mel Brooks comedy Spaceballs? There's a scene where Dark Helmet and Colonel Sandurz (played by Rick Moranis and George Wyner, respectively) take their spaceship called Spaceball One through light speed all the way up to "ludicrous speed." In the world of performance computing and platform-specific features, running Domino on any other platform than IBM i would be the equivalent to light speed. As Dark Helmet says, "No. No. No. Light speed is too slow!"


One of the great things about running IBM Lotus Domino on IBM i is the ability to run multiple Domino servers independently from one another. While other operating systems have just begun to support this, IBM i has been doing it since the early 1990s on its great-grandfather OS/400.

The ability to run 99 Domino servers in a single partition is nothing new, but what makes this a rock solid solution is the ability to do high availability clustering between those servers. What an idea!

Creating a Cluster

A cluster is a collection of Domino servers deployed to ensure users have constant access to data. This means email or any other applications you run on your Domino servers will be accessible in a high availability environment. The servers in a cluster, called cluster mates, each have replicas of databases that you want to keep in sync with one another. If a Lotus Notes user is in his email and his primary mail server goes down, the Notes client will automatically fail over to a cluster mate in order for the user to get his email. Ideally, this transition should be transparent to a user.

It's very simple to do. If you're starting from scratch, then build your first Domino server. It will, by default, run in subsystem DOMINO01. Then you add other servers and eventually create the cluster. This is the same as putting a cluster on a few separate servers except you're doing it on one IBM i partition.

This allows you the following unmatched benefits:



Security on IBM i is second to none. Every now and then, in bulletins, I hear about platform holes that need to be plugged. Oh, how I love seeing the little asterisks at the bottom that say something like "does not apply to IBM i." Just because there's a hole that needs plugging in PHP, it doesn't mean that the hole affects your IBM i if you run PHP natively. IBM i's object-based design makes it impervious to malicious code and viruses. Detractors may make excuses, but if you find me an instance of IBM i being damaged by malicious code, then please speak up. I've been waiting a long time. IBM i administrators don't download patches to plug holes every few days like Windows administrators. We don't need to.


I won't go into the subject of security because of the oodles of information on it already, but I'll advise you that the IBM i Security Guide is a great start.



Come on. IBM i is more stable than Ward Cleaver with too much starch in his shirt.


My Domino servers go down 99.999% of the time only because I intended it to happen. Over the years, numerous studies have declared IBM i the clear winner in terms of up-time over AIX, Windows, Linux on x86-64, Power Linux, and even zOS. Yes, zOS. That's no small potatoes. Do you ever tout that your primary business system is more stable than a mainframe? Go tell your boss tomorrow. You've earned it.

Up-time of one Domino server on IBM i is unmatched. Two is absolutely bulletproof. Hell, why not add a tertiary system for even more resiliency? Some may think that's way too much overkill, but I disagree. With three clustered Domino servers, you're always having two servers up at all times in case of a failure or, most likely, an upgrade or backup. Chances are, you may have more disk and memory than you need and can spare a little for more Domino servers. Since those other two Domino servers will be fairly idle as they're not accepting client connections (only server-to-server cluster replication), then it's not too much overhead at all. If you can think of a better way to ensure up-time on a single IBM i partition, I'd love to hear about it. In fact, email me at This email address is being protected from spambots. You need JavaScript enabled to view it., and I'll post the best one on my personal blog and we can compare and contrast yours and mine.


Benchmark tests from a few years ago show a Domino release 6 server on a dual-core System i Model 520 handling 28,000 users with a 92 millisecond response time. Does that sound like a machine you've had experience with? Probably. It was a lower end machine at that time. How does it scale upward? Well, a model 595 16-way system handled 175,000 users with a 33 millisecond response time. That's six years ago on Power5 processor technology, not modern POWER7 processors. Also, modern Domino 8.5.x server code is far more efficient now than in the past, which begs for some new benchmark tests. I'd bet that modern Power Systems hardware running IBM i 7.1 and Domino 8.5.3 servers will blow those very impressive six-year-old benchmark tests right out of the water. Personally, we run our RPG-based business applications, Domino for email/applications, IBM Quickr for document management, IBM Sametime Standard for instant messaging and Web meetings, Zend PHP server, and a whole other raft of services on our little Power Systems 720 Express. That's an entry-level server with a ton of horsepower. Compare the specs on that system with an entry-level AS/400 model 170 with 30 CPW to support 1300 email users that was an oft-sold system as a Dedicated Server for Domino many years ago. Don't believe me? Check the Redpaper on the old girl.

Ease of Installation/Upgrade


Let's say you already have a Domino server running on IBM i. How fast can you create a brand new cluster mate? How fast can you upgrade a few of them? Well, once you've registered the server using Domino Administrator (which takes the same amount of time no matter what platform), creating a Domino server takes literally a matter of seconds. Since you already have the Domino licensed program installed on your IBM i, it's just a matter of using the CFGDOMSVR *ADD command, which creates the new server right away. You don't have to load any media or download images.


If you want to upgrade a Domino server to a level that's already loaded on your system, it's just a matter of using a single command. Again, no downloading or fiddling with media. Below, I'll upgrade the Domino server called mail1 to Domino release 8.5.3.


UPDDOMSVR SERVER('mail1') TORLS('8.5.3')


I pour, not drink, a cup of coffee, and it's done.




I can run multiple versions of Domino alongside each other on the same IBM i partition. This means I can upgrade one server in the cluster without affecting the others. If I have problems, I can just take it offline.


If you're running Domino transactional logging, you don't need a separate disk array on IBM i.


Communication between cluster mates, or just Domino servers on IBM i in general, is via the system bus. I don't have hardware like cables or switches in the middle, which means fewer points of failure and communication at 6 Gbps. That's pretty darn impressive.


You don't need to worry about buying operating system licenses for x86-64 based Domino servers that can't handle the workload of your one Power Systems server running IBM i. Take that savings and justify yourself a new executive-style office chair. I did a few years ago, much to the chagrin of my manager.

How Do We Do It Then?

It's very simple. I'll take it for granted that you already have one Domino server running on IBM i. With that being said, you need to do the following (in very basic terms):


  1. Register the new server (or servers) in the Domino Administrator client.
  2. Set up new IP addresses and host names for the two new servers and optionally use different Ethernet ports for each of these addresses. This will offer you more protection in the odd chance you have one Ethernet port fail.
  3. Create your new servers using the CFGDOMSVR *ADD command and specify ADVSVC *PARTITION *CLUSTER.
  4. Ensure you do a CFGDOMSVR and specify ADVSVC *PARTITION *CLUSTER on the primary Domino server.
  5. Set up scheduled replication between all servers.
  6. Replicate "like" databases from the primary server to the two new ones. If you want to provide high availability for email, replicate all mail databases to the two new servers.
  7. Create a new cluster in the Domino Administrator client.
  8. Add the two new servers to the cluster.
  9. Make sure you add the HidePromptFailoverInc=1 notes.ini variable on your Domino servers. This will ensure users are not prompted to switch to a replica on another server if their primary server is unavailable.


I'm fairly certain that IBM fully supports, with Collaboration Express entitlement, clustering your servers as long as you have all clients communicating to one server at a time. If you have half of your users on one Domino server and the other half on another, you may need to purchase full Enterprise entitlement. Please get clarification from your IBM Business Partner to ensure you can get support from IBM if you need it.


That's about it. Please read the documentation on clustering in your Domino administrator client for step-by-step instructions and best practices. Each environment is different, so plan with yours in mind.


With all of these fantastic benefits, launching a clustered solution directly on your IBM i is the equivalent of Domino servers working at "ludicrous speed."

One More Thing…

I'd like to offer a quick plug to Trevor Perry and his 20i2 campaign. Mr. Perry has launched a survey to determine how we, as IBM i enthusiasts, perceive the platform. As a show of IBM i community support, please take a couple of minutes to complete the survey. Thanks!

Steve Pitcher
Steve Pitcher works with iTech Solutions, an IBM Premier Business Partner. He is a specialist in IBM i and IBM Power Systems solutions since 2001. Feel free to contact him directly This email address is being protected from spambots. You need JavaScript enabled to view it..


Support MC Press Online

$0.00 Raised:

Book Reviews

Resource Center

  • SB Profound WC 5536 Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application. You can find Part 1 here. In Part 2 of our free Node.js Webinar Series, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Brian will briefly discuss the different tools available, and demonstrate his preferred setup for Node development on IBM i or any platform. Attend this webinar to learn:

  • SB Profound WP 5539More than ever, there is a demand for IT to deliver innovation. Your IBM i has been an essential part of your business operations for years. However, your organization may struggle to maintain the current system and implement new projects. The thousands of customers we've worked with and surveyed state that expectations regarding the digital footprint and vision of the company are not aligned with the current IT environment.

  • SB HelpSystems ROBOT Generic IBM announced the E1080 servers using the latest Power10 processor in September 2021. The most powerful processor from IBM to date, Power10 is designed to handle the demands of doing business in today’s high-tech atmosphere, including running cloud applications, supporting big data, and managing AI workloads. But what does Power10 mean for your data center? In this recorded webinar, IBMers Dan Sundt and Dylan Boday join IBM Power Champion Tom Huntington for a discussion on why Power10 technology is the right strategic investment if you run IBM i, AIX, or Linux. In this action-packed hour, Tom will share trends from the IBM i and AIX user communities while Dan and Dylan dive into the tech specs for key hardware, including:

  • Magic MarkTRY the one package that solves all your document design and printing challenges on all your platforms. Produce bar code labels, electronic forms, ad hoc reports, and RFID tags – without programming! MarkMagic is the only document design and print solution that combines report writing, WYSIWYG label and forms design, and conditional printing in one integrated product. Make sure your data survives when catastrophe hits. Request your trial now!  Request Now.

  • SB HelpSystems ROBOT GenericForms of ransomware has been around for over 30 years, and with more and more organizations suffering attacks each year, it continues to endure. What has made ransomware such a durable threat and what is the best way to combat it? In order to prevent ransomware, organizations must first understand how it works.

  • SB HelpSystems ROBOT GenericIT security is a top priority for businesses around the world, but most IBM i pros don’t know where to begin—and most cybersecurity experts don’t know IBM i. In this session, Robin Tatam explores the business impact of lax IBM i security, the top vulnerabilities putting IBM i at risk, and the steps you can take to protect your organization. If you’re looking to avoid unexpected downtime or corrupted data, you don’t want to miss this session.

  • SB HelpSystems ROBOT GenericCan you trust all of your users all of the time? A typical end user receives 16 malicious emails each month, but only 17 percent of these phishing campaigns are reported to IT. Once an attack is underway, most organizations won’t discover the breach until six months later. A staggering amount of damage can occur in that time. Despite these risks, 93 percent of organizations are leaving their IBM i systems vulnerable to cybercrime. In this on-demand webinar, IBM i security experts Robin Tatam and Sandi Moore will reveal:

  • FORTRA Disaster protection is vital to every business. Yet, it often consists of patched together procedures that are prone to error. From automatic backups to data encryption to media management, Robot automates the routine (yet often complex) tasks of iSeries backup and recovery, saving you time and money and making the process safer and more reliable. Automate your backups with the Robot Backup and Recovery Solution. Key features include:

  • FORTRAManaging messages on your IBM i can be more than a full-time job if you have to do it manually. Messages need a response and resources must be monitored—often over multiple systems and across platforms. How can you be sure you won’t miss important system events? Automate your message center with the Robot Message Management Solution. Key features include:

  • FORTRAThe thought of printing, distributing, and storing iSeries reports manually may reduce you to tears. Paper and labor costs associated with report generation can spiral out of control. Mountains of paper threaten to swamp your files. Robot automates report bursting, distribution, bundling, and archiving, and offers secure, selective online report viewing. Manage your reports with the Robot Report Management Solution. Key features include:

  • FORTRAFor over 30 years, Robot has been a leader in systems management for IBM i. With batch job creation and scheduling at its core, the Robot Job Scheduling Solution reduces the opportunity for human error and helps you maintain service levels, automating even the biggest, most complex runbooks. Manage your job schedule with the Robot Job Scheduling Solution. Key features include:

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • LANSAWhen it comes to creating your business applications, there are hundreds of coding platforms and programming languages to choose from. These options range from very complex traditional programming languages to Low-Code platforms where sometimes no traditional coding experience is needed. Download our whitepaper, The Power of Writing Code in a Low-Code Solution, and:

  • LANSASupply Chain is becoming increasingly complex and unpredictable. From raw materials for manufacturing to food supply chains, the journey from source to production to delivery to consumers is marred with inefficiencies, manual processes, shortages, recalls, counterfeits, and scandals. In this webinar, we discuss how:

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • Profound Logic Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application.

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: