Installing and

Configuring
HCL Domino 11.0.1
on CentOS 8
Enterprise Linux

Devin S. Olson ([email protected])

Reviewed by Wes Morgan ([email protected])

09 October 2020

Copyright 2020 HCL Technologies Ltd.

Introduction ............................................................................................................................................... 3

CentOS 8 Enterprise Linux ........................................................................................................................... 4

System Requirements............................................................................................................................................4

Domino Specific Configuration .................................................................................................................... 5

Security Enhanced Linux........................................................................................................................................5
Required Packages ................................................................................................................................................5
Conflicting Services ...............................................................................................................................................5
User Account .........................................................................................................................................................5

Domino Installation .................................................................................................................................... 7

Post-Installation Configuration.................................................................................................................. 11
Server ID ............................................................................................................................................................. 11
Launch Server in listen mode ............................................................................................................................. 11
Domino Remote Server Setup Utility.................................................................................................................. 12

Launch Domino ........................................................................................................................................ 18

Appendix A: Common Internet Ports ......................................................................................................... 19

Legal statements ...................................................................................................................................... 20

Disclaimers............................................................................................................................................... 21

©2020 HCL Technologies Ltd. 2

Introduction
This paper will walk through the steps necessary to perform an installation
of HCL Domino 11.0.1 on CentOS 8 Enterprise Linux.

Typographic Conventions

Throughout this document there are several different types of text.

• There is explanatory (normal body) text, which appears in Century

Gothic

• Example file content or lists of information appear in Consolas

• Courier New is used for command-line content

(stuff you should type)

• Console commands are orange bold Courier New

• Colors, italics, and bold fonts are used in various other areas to help
things stand out

©2020 HCL Technologies Ltd. 3

CentOS 8 Enterprise Linux
System Requirements

This document assumes you have installed CentOS 8 in an environment

that meets the following requirements:

CentOS 8 disk and memory requirements https://docs.centos.org/en-US/8-

docs/standard-install/assembly_system-requirements-reference.

HCL Domino 11.0.1 system requirements

https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0077
033.

Note: This document was prepared using CentOS-8.2.2004.

©2020 HCL Technologies Ltd. 4

Domino Specific Configuration
HCL Domino requires additional operating system configuration for proper
operation.

Security Enhanced Linux

HCL Domino has not been fully tested in Security Enhanced Linux (SELinux)
environments; SELinux is not supported at this time.

Required Packages
The following packages are required for Domino 11.0.1 on CentOS 8. Use
your package manager to install these packages:

• chrony: network time management service, replaces ntp.

• perl: open source general-use interpreted scripting language

• bc: an arbitrary precision numeric processing language

Conflicting Services
If the services httpd, sendmail, or postfix are installed on your system, they
will conflict with Domino and prevent some Domino services from
launching. You must disable and/or delete these services before installing
Domino.

User Account
Create a user account and group for use by your HCL Domino server. This
account should not be used for any other purpose. The username and
group can be anything you wish (The Domino installer’s expected defaults
are “notes” and “notes”). In this document, we will work with the
username demoserver1 and the group name hcldemos.

NEVER run Domino as root!

©2020 HCL Technologies Ltd. 5

Set File Handles

Increase the number of file handles available for use.

># ulimit -n 65535

># vi /etc/security/limits.conf

Add the following lines to the end of the file, where username is the name
of the Domino user you created above:

username soft nofile 65535

username hard nofile 65535

Allow Domino to tune the Linux kernel

Use the export command to set the following operating system variable.
(You must be root to do this).

># export DOMINO_LINUX_SET_PARMS=1

Append the above export command to the end of the .bashrc file in the
Domino user’s home directory: /home/username/.bashrc.

©2020 HCL Technologies Ltd. 6

Domino Installation
Get Install File

Download the Domino installation file from the HCL License and Delivery
Portal to your local machine
https://hclsoftware.flexnetoperations.com/flexnet/operationsportal/logon.do

Verify File and Unpack

Use the tar command to check the file.

-t Table of contents. List all the files contained in the tar file.

-v Verbose output.

-f Use the filename from the argument parameters.

-x Extract or restore the file(s)

># tar -tvf Domino_1101_Linux_English.tar

You should see a list of the tar file’s contents. If there are any problems
with the file, you will need to delete it and download a clean one. If there
are no problems, then go ahead and extract the file contents.

># tar -xvf Domino_1101_Linux_English.tar

©2020 HCL Technologies Ltd. 7

From the directory where you extracted the installer, change directory to
the linux64 folder, then run the install file.

># cd linux64
># ./install

Select your locale and proceed to answer the questions as they appear.
When prompted for the Program Files directory (default is
/opt/hcl/domino) you may change the value, however this is not
recommended.

©2020 HCL Technologies Ltd. 8

The installer will prompt you for the Data Files directory. The default is
/local/notesdata. If you wish to change it do so now, otherwise just
accept the default. If you used a different value for Group or User (default
is notes and notes), make sure you change those values when prompted:

When prompted for Select Server Setup (launch type), choose Manual.

©2020 HCL Technologies Ltd. 9

Select the Install Set for which you have a valid license, then hit <Enter> to
proceed with the installation.

The server installation will now begin. Once finished, you will be presented
with a post-installation instructions page.

Press <enter> and exit the installer. It will take a few moments to exit, do
not be alarmed by the delay.

Congratulations. The server is now installed. After completing some basic

configuration, you should have an operational Domino Server.

©2020 HCL Technologies Ltd. 10

Post-Installation Configuration
Log out of the server as root and log back in using the Domino user
account credentials.

Server ID

If this is the first server in your organization, go ahead and skip to the next
step (Launch Server in listen mode).

If this is not the first server, you will need to register a new server using the
Domino Administrator client. Once you have the created the server.id file,
you need to move it to the new server’s Domino data directory.

Launch Server in listen mode

Change to the Domino data directory and launch the server in listen
mode for remote server setup access:

>$ /opt/hcl/domino/bin/server -listen

©2020 HCL Technologies Ltd. 11

Domino Remote Server Setup Utility
On a Windows machine, launch the HCL Domino Remote Server Setup
Utility. Enter the IP address (or FQDN) of your server in the dialog box to
begin configuring your server.

Select first or additional server, then proceed as appropriate

©2020 HCL Technologies Ltd. 12

First server in your organization or stand-alone server.

Enter the server name and title.

Create a Certifier ID and Password

©2020 HCL Technologies Ltd. 13

Create your Administrator account and set the password.

Continue to the step “Select Services”

©2020 HCL Technologies Ltd. 14

Set up Additional Server

Identify the location of the server.id file (the “browse” button will browse
the filesystem of the SERVER)

Verify the server name (pulled from the server.id file) is what you expect it
to be. If not, you will need to retrieve the correct server.id file before
proceeding.

©2020 HCL Technologies Ltd. 15

Proceed with the next step (Select Services). Eventually you will be
presented with a page requesting the server name and IP address of
another HCL Domino server in your organization from which to pull certain
system databases. Enter the information and continue with the server
setup.

©2020 HCL Technologies Ltd. 16

Select Services

Select the internet services this server will provide.

Select security Options

Continue through the setup screens until the server setup is complete.
When asked if the server listener should be stopped choose Yes.

©2020 HCL Technologies Ltd. 17

When you finish the configuration, a dialog will ask you if you want to shut
down the listening server. Shut the server down.

Launch Domino
Launch the server again, this time without any launch parameters:

>$ /opt/hcl/domino/bin/server

Celebrate

Congratulations. Your server is now operational. You can verify this by

using a web browser and navigating to your server’s IP address. Assuming
port 80 is open your firewall, you should be presented with the default HCL
Domino welcome screen.

©2020 HCL Technologies Ltd. 18

Appendix A: Common Internet Ports
This is for reference; keep all ports closed and only open those you will actually use.
20 FTP (File Transfer Protocol transfer)
21 FTPC (File Transfer Protocol Command)
22 SSH (Secure SHell) DO NOT CLOSE THIS IF USING SSH
389 LDAP (Lightweight Directory Access Protocol)
636 LDAPS (Lightweight Directory Access Protocol over SSL)
1352 NRPC (HCL Notes/Domino Remote Procedure Calls)
80 HTTP (Hypertext Transfer Protocol)
443 HTTPS (Hypertext Transfer Protocol over SSL)
25 SMTP (Simple Mail Transfer Protocol
143 IMAP (Internet Message Access Protocol)
220 IMAPV3 (Internet Message Access Protocol Version 3)
993 IMAPS (Internet Message Access Protocol over SSL)
110 POP3 (Post Office Protocol Version 3)
995 POP3S (Post Office Protocol Version 3 over SSL)
8585 Used by Domino Remote Server Setup

©2020 HCL Technologies Ltd. 19

Legal statements
This edition applies to HCL Domino version 11.0.1, and to all subsequent
releases and modifications until otherwise indicated in new editions.

When you send information to HCL Technologies Ltd., you grant HCL
Technologies Ltd. a nonexclusive right to use or distribute the information in
any way it believes appropriate without incurring any obligation to you.

©2020 Copyright HCL Technologies Ltd and others. All rights reserved.

Note to U.S. Government Users — Documentation related to restricted

rights — Use, duplication or disclosure is subject to restrictions set forth in
GSA ADP Schedule Contract with HCL Technologies Ltd.

©2020 HCL Technologies Ltd. 20

Disclaimers
This report is subject to the HCL Terms of Use (https://www.hcl.com/terms-
of-use) and the following disclaimers:

The information contained in this report is provided for informational

purposes only. While efforts were made to verify the completeness and
accuracy of the information contained in this publication, it is provided AS
IS without warranty of any kind, express or implied, including but not limited
to the implied warranties of merchantability, non-infringement, and fitness
for a particular purpose. In addition, this information is based on HCL’s
current product plans and strategy, which are subject to change by HCL
without notice. HCL shall not be responsible for any direct, indirect,
incidental, consequential, special or other damages arising out of the use
of, or otherwise related to, this report or any other materials. Nothing
contained in this publication is intended to, nor shall have the effect of,
creating any warranties or representations from HCL or its suppliers or
licensors, or altering the terms and conditions of the applicable license
agreement governing the use of HCL software.

References in this report to HCL products, programs, or services do not

imply that they will be available in all countries in which HCL operates.
Product release dates and/or capabilities referenced in this presentation
may change at any time at HCL’s sole discretion based on market
opportunities or other factors, and are not intended to be a commitment
to future product or feature availability in any way. The underlying
database used to support these reports is refreshed on a weekly basis.
Discrepancies found between reports generated using this web tool and
other HCL documentation sources may or may not be attributed to
different publish and refresh cycles for this tool and other sources. Nothing
contained in this report is intended to, nor shall have the effect of, stating.

or implying that any activities undertaken by you will result in any specific
sales, revenue growth, savings or other results. You assume sole
responsibility for any results you obtain or decisions you make as a result of
this report.

Notwithstanding the HCL Terms of Use (https://www.hcl.com/terms-of-

use), users of this site are permitted to copy and save the reports
generated from this tool for such users own internal business purpose. No
other use shall be permitted.

©2020 HCL Technologies Ltd. 21