02 Things you need to know
Server
Installing Domino for Linux
This guide explains how to install a Domino server on the Linux operating system. Refer to the Release Notes for this product and the Domino manual Administering the Domino Server for more details about configuring your server.
System Requirements
The minimum system requirements for a Domino server for Linux installation are:
- Processor: 486 or later
- RAM: 64MB or larger (128MB is recommended)
- Swap file: 3 times the physical RAM or greater
- Hard drive space: 750MB free space or larger (1GB is recommended)
- Operating system: Linux kernel version 2.2.5. Refer to the "Linux platforms supported" Release Note for supported distributions.T
NOTE: You must have selected the following packages during the Red Hat Linux install and setup:- C Development
- Development Libraries
- C++ Development
These packages provide the libraries that are required by Domino.
To install Domino for Linux and administer it, it is recommended that you use separate machines for Notes client and the Domino Administrator client. Both machines must run TCP/IP on the same network or on the Internet. You can confirm connectivity by pinging each from the other before proceeding.
NOTE: You can configure the server using a browser on the same machine, but you will need the Domino Administrator or Domino Designer (a Notes client) on a Windows machine if you plan to create new users and server IDs or design databases.
Release notes
See the release notes shipped with this product for the latest information.
Installing more than one server
You can install more than one instance of Domino on a Linux server on separate partitions. Each data directory will contain data specific to each server, such as databases, templates, bookmarks, ID files, etc., but all the program files reside in a single shared program directory. Each server must use different UNIX user names, to distinguish between processes for the different servers. Each user will be made the owner of the files in each data directory and the processes run by that server. If the user name is not changed for additional servers, you will not be able to start the server, because the operating system will only detect server processes that are not already running for existing user names.
Note that many of the steps detailed in this installation must be repeated for each additional server you install.
See Administering the Domino Server to review all your options before you begin.
Creating a notes user and group
Before you start the installation, you must add a user and group on the Linux machine.
1. Log onto Linux as "root."
2. Open a terminal session.
3. At the command prompt, enter a user name. For example:
adduser notes
This adds a user and group to your system called notes.
4. Give this new user a password by entering:
passwd notes
See "Installing more than one server", if you plan to install more than one server.
Downloading Domino for Linux1. Create a temporary directory for the Domino download at the command prompt:
cd /tmp
mkdir Domino
NOTE: Make sure that this space is large enough to accommodate the install file as well as the expanded files for the install (at least 20MB).
2. From a Web browser, open the Notes Web site (http://www.lotus.com/ldd/linux)
NOTE: You must be a registered user to download this software.
3. Download the tar file into the directory you've just created, (/tmp/Domino). If you do not have Internet access or X-window installed on your Linux machine, download the file and then transfer it to the Linux machine using FTP or some other tool.
4. Change to the correct directory by entering the following at the command prompt:
cd Domino
You should now be in the directory /tmp/Domino. You can verify your current location by entering pwd at the command prompt.
5. Unpack the installation files by entering the following (assuming the tar file is called "linux.tar"):
tar xvf linux.tar
Starting the install program
1. Change to the correct directory by enter the following at the command prompt:
cd linux
You should now be in the directory /tmp/Domino/linux. You can verify your current location by entering pwd at the command prompt.
2. Start the installation by entering:
./install
The install program displays a series of screens about the Lotus license agreement. Use the TAB key to accept a setting and advance to the next screen, the ESC key to back up to the previous screen, the space bar to toggle through possible choices other than the default, and ENTER to edit a text field.
3. Select a setup type. Choose Domino Mail Server, Domino Application Server, or Domino Enterprise Server and press TAB.
4. Select the program file location. The default is /opt/lotus. Make sure your have enough space. The installed files in the program directory are approximately 51MB.
NOTE: If you select a program directory other than /opt/lotus, then a soft link will be created from your program directory to /opt/lotus so that commands may be executed from that path.
5. Indicate if you plan a number of Domino servers on the current physical machine. The default is No.
6. Select the data file location. The default is /local/notesdata. Make sure your have enough space. The installed files in the data directory are approximately 60MB.
7. Select the user and group for this server. Choose the default that you set up earlier ("notes" in the example).
8. The install program displays the settings you selected. Use the TAB key to accept these settings and begin the installation, or press the ESC key to back up to change any settings. The install program will then begin installing the files.
Run the Server Setup program
1. Log on to Linux as the user you established earlier ("notes" in the example).
2. Change the directory to /local/notesdata by entering:
cd /
cd local/notesdata
and then enter the following:
/opt/lotus/bin/http httpsetup
3. A series of messages indicate the start of the Domino server. For example:
02/18/2000 10:49:35 AM Created new log file as
/local1/6.0_0218_Ent_dom/lotus/notesdata/log.nsf
02/18/2000 10:49:35 AM
*****************************************
* Lotus Domino Server Setup *
* To setup this server, please connect *
* your web browser to port 8081 *
* Example: http://this.server.com:8081 *
*****************************************
02/18/2000 10:49:36 AM JVM: Java Virtual Machine initialized.
02/18/2000 10:49:38 AM HTTP Web Server started
Continuing setup and configuration1. You begin the configuration process by connecting to your Linux server with a Web browser, either from an external machine, or the Linux machine.
to perform setup from another machine, enter:
http://mycompany.linux.server:8081
to perform setup from the Linux machine, enter:
http://localhost:8081
where mycompany.linux.server is either the IP address or DNS name of your Linux server. At this point, the standard Domino configuration screens are displayed in your browser. Follow the instructions on these screens and click the Finish button on the final screen to complete the initial configuration. Online help is available on each of these screens.
2. The HTTP Setup program will have created SERVER.ID and CERT.ID files in the /local/notesdata. The USER.ID file is attached to a person document in NAMES.NSF.
Starting the Server
Before starting your Domino server, make sure no other Web server is running because it will block the Domino HTTP task from operating correctly and you will be unable to use a Web browser to administer your server after the initial setup.
1. Log on to Linux as the user you established earlier ("notes" in the example).
2. From the /local/notesdata directory, enter:
/opt/lotus/bin/server
The server starts and the usual server console messages appear.
See "Installing more than one server," if you have installed more than one server.
Extracting your administrator ID file
Before you can perform any more administration on your Domino for Linux server, will need to extract the administrator ID file and move it to the machine you plan to use for administration.
1. After the HTTP Web Server task has started, switch to your administration machine and use a Web browser to connect to your new server:
http://mycompany.linux.server
2. Where mycompany.linux.server is either the IP address or DNS name of your Linux server. The default Lotus Domino navigator screen displays.
3. Now open the address book by entering:
http://mycompany.linux.server/names.nsf
4. Click to the People view and open the Person document for the administrator you created earlier and download the USER.ID file to your administration machine.
NOTE: If you are using a Netscape browser, you may have to rename the id file to "USER.ID."
Connecting a Notes Client to the Linux server
Many administration functions can be performed using a Web browser, but you need the Domino Administrator client to perform many other tasks such as creating IDs or designing new databases.
1. Open a Notes Client and switch to the ID you downloaded earlier.
2. Using File - Database - Open, enter the Server name or IP address of the new server and click Open. After a few seconds, the Notes client displays the databases available for the new server.
Topics