You are on page 1of 9

Domino Installation / Usage Guide Lotus Domino 8.5.2 / RedHat 5.

5

Contents
Pre Installation ............................................................................................................................................3 Create service accounts ..........................................................................................................................3 Code installation..........................................................................................................................................4 Unpack IBM Lotus Domino Server Installation Files................................................................................4 Start the install script................................................................................................................................4 Running the Server Setup program.............................................................................................................9

Pre Installation
Create service accounts
Applies to: Linux Admin You will need to create service accounts for each of the domino instances you want to run. Login to the system as a root user. 1) Open a terminal window. 2) Create a Linux group to run Lotus Domino (i.e. notes) groupadd notes 3) Create a Linux user account to run Lotus Domino and make that user a part of the group created above. useradd -g notes -m domino

4) Set the password for Linux user domino. Passwd domino You will be asked the following:
Changing password for user domrt01. New UNIX password:

Enter the new password at the prompt twice – ignore the following message if it appears:
BAD PASSWORD: it is based on a (reversed) dictionary word

You will see the follow success message.
passwd: all authentication tokens updated successfully.

Code installation
Unpack IBM Lotus Domino Server Installation Files.
Change the directory where the Domino installation .tar file is located. The following example assumes the installation .tar file is located in the home directory of user domino. cd /home/domino/ tar -xvf lotus_domino852_xlinux_en.tar

Start the install script
You will now need to launch the install script, located in the domino/linux directory where you just tarred the install file. The following example assumes that you are still in the home directory of user domino: linux/domino/install The following screen should now appear.
Lotus Domino for Unix Install Program -----------------------------------You have to set environment variable DISPLAY to run in graphic mode Answer Yes to continue in console mode Answer No to exit application. Do you want to continue installation in console mode?[Yes]

Press Enter to continue
Continuing in console mode InstallShield Wizard Initializing InstallShield Wizard... Preparing Java(tm) Virtual Machine... ................................... ................................... ................................... ................................... ................................... ................................... --------------------------------------------------------------------Welcome to the InstallShield Wizard for Lotus Domino The InstallShield Wizard will install Lotus Domino on your computer. To continue, choose Next. Lotus Domino IBM http://www.lotus.com Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
---------------------------------------------------------------------------International Program License Agreement Part 1 - General Terms

BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, CLICKING ON AN "ACCEPT" BUTTON, OR OTHERWISE USING THE PROGRAM, LICENSEE AGREES TO THE TERMS OF THIS AGREEMENT. IF YOU ARE ACCEPTING THESE TERMS ON BEHALF OF LICENSEE, YOU REPRESENT AND WARRANT THAT YOU HAVE FULL AUTHORITY TO BIND LICENSEE TO THESE TERMS. IF YOU DO NOT AGREE TO THESE TERMS,

- DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, CLICK ON AN "ACCEPT" BUTTON, OR USE THE PROGRAM; AND

Press Enter to continue viewing the license agreement, or, Enter "1" to accept the agreement, "2" to decline it or "99" to go back to the previous screen, "3"

Press 1 to progress
Selecting the option below allows you to install additional or upgrade existing Server Partitions. The existing Program directory must be specified in order for new Server Partitions to be created, but it will not be upgraded. Existing Data directories do not need to be listed. Only those Data directories specified will be upgraded or added. If you wish to add more than one Partition to your existing Domino server, check the box when asked if you want to install a Partitioned server. Otherwise you will only be able to upgrade or install one Data directory. Warning: If you do not have an existing Domino Server on your system, please do not check the box below for the option to add data directories only. [ ] 1 - Install Data Directories Only for Partitioned Domino Server

To select an item enter its number, or 0 when you are finished: [0]

Press 0 to NOT install partitioned server directories.
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Lotus Domino Install Location Please specify a directory or press Enter to accept the default directory.

Press Enter to accept the defaults
Server with more than one partition Answer Yes to install partitioned server Answer No to install non-partitioned server Partitioned Server: [No]

Type No to not to install a new partitioned server
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Lotus Domino Install Location Please specify a directory or press Enter to accept the default directory.

Press Enter to accept the defaults
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1

Input Unix/Linux user name and group name panel User Name [notes] notes

Edit the username to match the service account of the server you are installing domino
Group Name [notes] notes

Press enter to accept the group name “notes”
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
You can click the following optional check box for installing your unix/Linux Domino Server The Domino Server software no longer requires the /opt/ibm/lotus soft link for handling multi-Domino Server installations on a single operating system. You can now select your own option for the /opt/ibm/lotus soft link feature if you have chosen a directory other than /opt/ibm/lotus for installation. [ ] 1 - Create /opt/ibm/lotus soft link To select an item enter its number, or 0 when you are finished: [0]

Press 0 not to create a softlink
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Select Server Setup After the installation completes, for new installation server setup will be launched and for upgrade the server will be restarted automatically. The default value is "Manual Server Setup" which does not launch server setup or restart the server after installation. Select "Local Server Setup" to launch server setup after a new server installation or to restart the server after a server upgrade. Select "Remote Server Setup" to launch server setup in listen mode for new server installations. You will then be able to connect to the server with the Remote Server Setup tool. [ ] 1 - Local [ ] 2 - Remote [X] 3 - Manual To select an item enter its number, or 0 when you are finished: [0]

Press 0 to accept option 3, manual startup
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Choose the setup type that best suits your needs. [ ] 1 - Domino Utility Server

Installs a Domino server that provides application services only. Note that it does not include support for messaging services. See full licensing text for details. [ ] 2 - Domino Messaging Server Installs a Domino server that provides messaging services. Note that it does not include support for application services or Domino clusters. [X] 3 - Domino Enterprise Server Installs a Domino server that provides both messaging and application services. [ ] 4 - Customize Domino Server Allows you to select the features you want to install. To select an item enter its number, or 0 when you are finished: [0]

Press 0 to accept option 3, Domino Enterprise server
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Lotus Domino will be installed in the following location: Program Files: Data Files: Domino Kit Type: /opt/ibm/lotus /local/notesdata EnterpriseServer

Unix Install Options: User Name: domrt01 Group Name: notes Install Data Only: No Create soft link /opt/ibm/lotus/:No Start Server Setup: No (Manual) with the following features: Program Files Billing Support Clustering Support Data Files Required Templates Press ENTER to read the text [Type q to quit]

Press ENTER
Administration Templates Optional Templates Certificate Management Web Services Data Files Readme File Dojo 1.4.3 Dojo 1.3.3 XPages Domino Enterprise Connection Services Domino Offline Services Lotus iNotes Sametime Integration Resource Modeling Engine Help for a total size: 1043.9 MB Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to progress
Installing Lotus Domino. Please wait... |-----------|-----------|-----------|------------| 0% 25% 50% 75% 100% ||||||||||||||||||||||||||||||||||||||||||||||||| Please, manually configure the Domino Server as follows: 1) Login as the appropriate Unix user: 'domino'; 2) Change to the data directory using the command:'cd /local/notesdata'; 3) Configure the server using the command: '/opt/ibm/lotus/bin/server' To configure server remotely, the remote server setup tool is required and you can use the command: '/opt/ibm/lotus/bin/server -listen' After issuing this command, additional instructions will appear for remote server setup. For additional details see the section 'Using the Domino Server Setup remotely' in the Lotus Domino Administrator Help Documentation. ------------------------------------------------------------------------------The InstallShield Wizard has successfully installed Lotus Domino. Choose Finish to exit the wizard. Press 3 to Finish or 4 to Redisplay [3]

Press 3 to finish. Domino is now installed. Proceed to Running the server setup program.

Running the Server Setup program
Once you have completed the first two steps, you should now be ready to bring the server setup program online, and begin to setup the Domino server. Assuming we are setting up a server called auweb01: 1. Login via SSH to auweb01 2. Login as: domino, with the password you specified above. Enter the following command in the console: cd /local/notesdata /opt/ibm/lotus/bin/server -listen You should see a screen similar to the following:
./java -ss512k -Xoss5M -cp jhall.jar:cfgdomserver.jar:./ndext/ibmdirectoryservices.jar lotus.domino.setup.WizardManagerDomino -data /local/notesdata –listen Remote server setup enabled on port 8585. The Domino setup server is now in listening mode. A remote client can now connect to this server and configure Domino. To connect to this server, launch the Remote Domino Setup program from a command-prompt as follows: From a Domino administrator client: serversetup -remote From a Domino server: server -remote To end this server, launch the Remote Domino Setup program from a command-prompt as follows: From a Domino administrator client: serversetup -q auweb01 From a Domino server: server -q auweb01 For more information, see the printed guide Setting Up Domino Networks and Servers.

If you see error messages related to “DISPLAY” or “TERMINAL” messages – you may need to install “screen” (see appendix) You can now proceed with the remote server setup (Domino Administrator Task), using the remote server setup tool that is installed with the Domino Administrator client.