Home
Installing
Use this documentation to install the HCL Domino® server and subsequently deploy the HCL Notes®client.
Installing and upgrading Domino® servers
Perform a new or upgrade install of one or many Domino® servers.
Preparing for installing and setting up Domino® servers
Installing an HCL Domino® server is the first part of deploying a server. The second part is using the Domino server setup program to configure the server.
Using the Domino® server setup program
The following procedures describe the ways you can use the server setup program.
One-touch Domino setup
Use one-touch Domino setup to simplify setting up a server.
Invoking one-touch Domino setup
To invoke one-touch Domino setup, follow the appropriate procedure, depending on whether you provide input through a JSON file or system environment variables and the platform on which you run Domino.
Invoking one-touch Domino setup with system environment variables on Windows or UNIX
Complete this procedure to invoke one-touch Domino setup with system environment variables if you run Domino on Windows or UNIX.

Installing
Use this documentation to install the HCL Domino® server and subsequently deploy the HCL Notes®client.
- Installing and upgrading Domino® servers
  Perform a new or upgrade install of one or many Domino® servers.
  - Preparing for installing and setting up Domino® servers
    Installing an HCL Domino® server is the first part of deploying a server. The second part is using the Domino server setup program to configure the server.
    - Entering system commands
      Some of the procedures that follow include instructions for entering commands at the system command prompt.
    - Domino on Docker
      HCL Domino® includes a Docker-compatible Red Hat Universal Base Image (UBI) of Domino that is part of your entitlement and available for download through the HCL Licensing Portal. HCL Domino is pre-installed on this image, allowing you to deploy Domino servers as containers with just a few commands.
    - Domino® server installation
      The first step in deploying a Domino® server is installation, or copying the program files to the system's local drive.
    - Disabling concurrent I/O and direct I/O on Domino® servers on AIX®
      Concurrent I/O (CIO) and Direct I/O (DIO) are not supported with Domino® servers. CIO is a file system feature introduced in IBM® AIX® 5.2.0.10, also known as maintenance level 01, in the Enhanced Journaling File system (JFS2). This feature improves performance for relational databases.
    - Domino® server setup program
      The Domino® server setup program guides you through the choices you make to configure a Domino server. Setting up the first Domino server in a domain establishes a framework that consists of the Domino Directory, ID files, and documents. When you set up additional servers, you build upon this framework.
    - Using the Domino® server setup program
      The following procedures describe the ways you can use the server setup program.
      - One-touch Domino setup
        Use one-touch Domino setup to simplify setting up a server.
        Preparing input parameters for one-touch Domino setup
        To prepare input parameters for one-touch Domino setup, follow the appropriate procedure, depending on whether you provide input through a JSON file or system environment variables.
        Schema used for JSON validation
        Domino provides a JSON schema for one-touch Domino setup that is used to validate JSON in a JSON input file.
        Invoking one-touch Domino setup
        To invoke one-touch Domino setup, follow the appropriate procedure, depending on whether you provide input through a JSON file or system environment variables and the platform on which you run Domino.
        Invoking one-touch Domino setup with system environment variables on Docker
        Complete this procedure to invoke one-touch Domino setup with system environment variables if you run Domino on Docker.
        Invoking one-touch Domino setup with parameters in a JSON file on Docker
        Complete this procedure to invoke one-touch Domino setup with parameters in a JSON file if you run Domino on Docker.
        Invoking one-touch Domino setup with system environment variables on Windows or UNIX
        Complete this procedure to invoke one-touch Domino setup with system environment variables if you run Domino on Windows or UNIX.
        Invoking one-touch Domino setup with parameters in a JSON file on Windows or UNIX
        Complete this procedure to invoke one-touch Domino setup with parameters in a JSON file if you run Domino on Windows or UNIX.
        Troubleshooting one-touch Domino setup
        If you run into problems with one-touch Domino setup, use these tips to help troubleshoot.
      - Indic language support in the Domino® server setup program
        You can change both the font and the alphabet that displays when you enter text in a field on a server setup program screen.
      - Using automatic Domino® server setup on UNIX™
        Automatic server setup is a UNIX™ feature for single local Domino® servers. When automatic server setup is used for new server installations, server setup runs automatically after the server installation is complete. For server upgrades, the server is restarted automatically after the installation is complete.
      - Using the Domino® server setup program locally
        After installing the Domino® server program files on a server, you can run the Domino server setup program locally by starting the server. The server setup program guides you through the setup process.
      - Using the Domino® server setup program remotely
        After you install the program files for a Domino® server on a system, you can use either a client system or another Domino server to run the server setup program remotely. Running the server setup program from a Windows™ client is easier if the client has Domino Administrator installed -- to run the program from a client without Domino Administrator, you need the Java™ runtime environment plus some files from the program directory of an installed Domino server.
      - Creating a server setup profile
        A server setup profile is a file that you use to quickly configure servers.
      - Using a server setup profile
        You can use a server setup profile to set up a Domino server. You can use the profile from the server you are setting up or from a client system.
      - Using Domino® silent server setup with a profile
        You can use a server setup profile to set up a Domino server silently without viewing the setup screens. You can do a silent setup at the server you are setting up or from a client system.
    - Understanding the Domino® server certification log
      The Domino® certification log records server certification and ID information.
    - Domino® server registration
      Before you install and set up additional servers, you must register them. In effect, registering a server adds the server to the system. The server registration process creates a Server document for the server in the Domino® Directory and creates a server ID. After registering and installing a server, you use the server setup program to obtain a copy of the Domino Directory for the new server and to set up the server to run particular services and tasks -- for example, the HTTP service, the Mail Router, and so on.
    - Optional tasks to perform after Domino® server setup
      You can perform addition tasks after server startup.
    - Starting and shutting down the Domino® server
      Start the Domino® server at the server console.
    - Starting Domino® as an application or a Windows™ service
      If you have installed Domino® as a Windows™ service, when you start the Domino server, you are prompted to specify whether to start Domino as an application or a Windows service.
    - Using instant messaging in the Domino® Directory
      The Domino® Directory is enabled for instant messaging, meaning that you can conduct an online chat directly from the Domino Directory.
    - Running the Domino-Portal integration wizard
      Use the Domino-Portal integration (DPI) wizard to configure an IBM® WebSphere® Portal server to work with your Domino-based infrastructure.
  - Uninstalling a Domino® server
    While it is not necessary to uninstall a Domino® server prior to upgrading to a new Domino release, you may want to uninstall a server.
- Installing and upgrading Notes® clients
- Upgrading
  Use this documentation to upgrade the existing Domino® server and subsequently upgrade the Notes® client to a new release. You can also upgrade additional clients such as Domino Administrator and Domino Designer clients and additional features and plug-ins such as the embedded HCL Sametime® client.

Invoking one-touch Domino setup with system environment variables on Windows or UNIX

Complete this procedure to invoke one-touch Domino setup with system environment variables if you run Domino on Windows or UNIX.

Before you begin

Complete the procedure Preparing input parameters through system environment variables.

Procedure

Install Domino.
Change to the directory in which you installed Domino, for example, C:\Domino.
Use a shell script or batch file or run individual commands to export the system environment variables needed to set up your server. This step makes the variables available for processing in the next step.
To invoke one-touch Domino setup, run the command that corresponds to the operating system you use:
On Windows:
```
<Domino-program-dir>\nserver -autoconf
```
On UNIX:
```
/opt/hcl/domino/bin/tools/startup /opt/hcl/domino/notes/latest/linux/server -autoconf
```

Results

Your new Domino server should be up and running.