Lotus Domino R5 for Linux mini-HOWTO
Prev |  | Next

# 4. Installing Domino R5

## 4.1. Mandrake Linux 8.1

1. Log in as "root". Open a terminal session. Add a user and group to your system called `notes`:

       	bash# adduser notes

2. Give this new user a password by entering:

       	bash# passwd notes

3. Mount the CD-ROM, and enter the following command to install the Lotus Domino R5 package:

       	bash# /mnt/cdrom/dom509ux/linux/install

   The install program displays a series of screens about the IBM 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.

4. Select a setup type. Choose Domino Mail Server, Domino Application Server, or Domino Enterprise Server and press TAB.

5. Select the program file location. The default is `/opt/lotus`. Make sure you have enough space. The installed files in the program directory are approximately 70 MB. 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.

6. Indicate if you plan a number of Domino servers on the current physical machine. The default is `No`.

7. Select the data file location. The default is `/local/notesdata`. If you do not have a large root partition it will not work. If so, change the directory to `/usr/local/notesdata`. If you ignore this during installation process, later you will get an error like this one:

       	Error validation settings:
       	There is not enough disk space for the data directory at /local/notesdata
       	125889K is required, and only 95370K would be available.
       	Make sure you have enough space.

   The installed files in the data directory are approximately 160 MB.

8. Select the user and group for this server. Choose the default that you set up earlier (`notes` in the example).

9. 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.

10. During installation process you may see the warning:

        	The following system commands were not located: rsh.

    It does not influence the local server installation.

11. After successful installation, this message will be displayed among others:

        	The installation completed successfully.

## 4.2. SuSE 7.3 Professional

1. Log in as "root." Open a terminal session. Add a user and group to your system called `notes`:

       	bash# groupadd notes
       	bash# useradd notes -g notes

2. Give this new user a password by entering:

       	bash# passwd notes

3. Mount the CD-ROM, and enter the following command to install the Lotus Domino R5 package:

       	bash# /mnt/cdrom/dom509ux/linux/install

   The install program displays a series of screens about the IBM 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.

4. Select a setup type. Choose Domino Mail Server, Domino Application Server, or Domino Enterprise Server and press TAB.

5. Select the program file location. The default is `/opt/lotus`. Make sure you have enough space. The installed files in the program directory are approximately 70 MB. 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.

6. Indicate if you plan a number of Domino servers on the current physical machine. The default is `No`.

7. Select the data file location. The default is `/local/notesdata`. It works perfectly. Make sure your have enough space. The installed files in the data directory are approximately 160 MB.

8. Select the user and group for this server. Choose the default that you set up earlier (`notes` in the example).

9. 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.

10. After successful installation, this message will be displayed among others:

        	The installation completed successfully.

## 4.3. For all Linux distributions

### 4.3.1. Run the Domino Server Setup program

1. Log on to Linux as the user you established earlier (`notes` in the example).

2. Change to the directory `/usr/local/notesdata` (`/local/notesdata` for SuSE) by entering:

       	bash# cd /
       	bash# cd /usr/local/notesdata
       	and then enter the following:
       	bash# /opt/lotus/bin/http httpsetup

3. A series of messages indicate the start of the Domino server. For example:

       	05/09/2002 8:39:09 PM Created new log file as
       	/usr/local/notesdata/log.nsf
       	05/09/2002 8:39:09 PM
       	***************************************
       	* Lotus Domino Server Setup           *
       	* To setup this server, please connect*
       	* your web browser to port 8081       *
       	* Example: http://example.com:8081    *
       	***************************************
       	05/09/2002 8:39:09 AM JVM: Java Virtual Machine initialized.
       	05/09/2002 8:39:10 AM HTTP Web Server started

### 4.3.2. Continuing setup and configuration

1. 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://example.com:8081

   To perform setup from the Linux machine, enter:

       http://localhost:8081

   or

       http://linux:8081

   for SuSE 7.3 Professional.

   where `example.com` 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 `/usr/local/notesdata`. The `USER.ID` file is attached to a person document in `NAMES.NSF`.

### 4.3.3. Starting the Domino 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 `/usr/local/notesdata` directory (`/local/notesdata` for SuSE), enter:

       	bash# /opt/lotus/bin/server

   The server starts and the usual server console messages appear.

### 4.3.4. Extracting your administrator ID file

Before you can perform any more administration on your Domino for Linux server, you 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://example.com

   where `example.com` is either the IP address or DNS name of your Linux server. The default Lotus Domino navigator screen displays.

2. Now open the address book by entering:

       	http://example.com/names.nsf

3. 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. If you are using a Netscape browser, you may have to rename the id file to `USER.ID`.

Prev | Home | Next
Preparing your distribution for Domino R5 |  | Resources