<HTML
><HEAD
><TITLE
> Installing Domino R5
</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="
Lotus Domino R5 for Linux mini-HOWTO
"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="
Preparing your distribution for Domino R5
"
HREF="prepdistro.html"><LINK
REL="NEXT"
TITLE="
Resources
"
HREF="resources.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Lotus Domino R5 for Linux mini-HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="prepdistro.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="resources.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="installingr5"
></A
>4. Installing Domino R5</H1
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="r5instmandrake81"
></A
>4.1. Mandrake Linux 8.1</H2
><P
></P
><OL
TYPE="1"
><LI
><P
> Log in as <SPAN
CLASS="QUOTE"
>"root"</SPAN
>. Open a terminal session. Add a user and group to
your system called <TT
CLASS="varname"
>notes</TT
>:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>adduser notes</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> Give this new user a password by entering:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>passwd notes</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> Mount the CD-ROM, and enter the following command to install the
Lotus Domino R5 package:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>/mnt/cdrom/dom509ux/linux/install</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
> The install program displays a series of screens about the IBM Lotus
license agreement. Use the <B
CLASS="keycap"
>TAB</B
> key to accept a setting and advance to the
next screen, the <B
CLASS="keycap"
>ESC</B
> key to back up to the previous screen, the space bar
to toggle through possible choices other than the default, and <B
CLASS="keycap"
>ENTER</B
> to
edit a text field.
</P
></LI
><LI
><P
> Select a setup type. Choose Domino Mail Server, Domino
Application Server, or Domino Enterprise Server and press <B
CLASS="keycap"
>TAB</B
>.
</P
></LI
><LI
><P
> Select the program file location. The default is
<TT
CLASS="filename"
>/opt/lotus</TT
>.
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
<TT
CLASS="filename"
>/opt/lotus</TT
>, then a soft link will be created from
your program directory to <TT
CLASS="filename"
>/opt/lotus</TT
> so that
commands may be executed from that path.
</P
></LI
><LI
><P
> Indicate if you plan a number of Domino servers on the current
physical machine. The default is <TT
CLASS="option"
>No</TT
>.
</P
></LI
><LI
><P
> Select the data file location. The default is
<TT
CLASS="filename"
>/local/notesdata</TT
>. If you do
not have a large root partition it will not work. If so, change the
directory to <TT
CLASS="filename"
>/usr/local/notesdata</TT
>.
If you ignore this during installation process, later you will get an error like this one:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> 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.
</PRE
></FONT
></TD
></TR
></TABLE
><P
> The installed files in the data directory are approximately 160 MB.
</P
></LI
><LI
><P
> Select the user and group for this server. Choose the default
that you set up earlier (<TT
CLASS="varname"
>notes</TT
> in the example).
</P
></LI
><LI
><P
> The install program displays the settings you selected. Use the
<B
CLASS="keycap"
>TAB</B
> key to accept these settings and begin the installation, or press the
<B
CLASS="keycap"
>ESC</B
> key to back up to change any settings. The install program will then
begin installing the files.
</P
></LI
><LI
><P
> During installation process you may see the warning:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> The following system commands were not located: rsh.
</PRE
></FONT
></TD
></TR
></TABLE
><P
> It does not influence the local server installation.
</P
></LI
><LI
><P
> After successful installation, this message will be displayed among
others:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> The installation completed successfully.
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN235"
></A
>4.2. SuSE 7.3 Professional</H2
><P
></P
><OL
TYPE="1"
><LI
><P
> Log in as <SPAN
CLASS="QUOTE"
>"root."</SPAN
> Open a terminal session. Add a user and group to
your system called <TT
CLASS="varname"
>notes</TT
>:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>groupadd notes</B
></TT
>
bash# <TT
CLASS="userinput"
><B
>useradd notes -g notes</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> Give this new user a password by entering:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# passwd notes
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> Mount the CD-ROM, and enter the following command to install the
Lotus Domino R5 package:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>/mnt/cdrom/dom509ux/linux/install</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
> The install program displays a series of screens about the IBM Lotus
license agreement. Use the <B
CLASS="keycap"
>TAB</B
> key to accept a setting and advance to the
next screen, the <B
CLASS="keycap"
>ESC</B
> key to back up to the previous screen, the space bar
to toggle through possible choices other than the default, and <B
CLASS="keycap"
>ENTER</B
> to
edit a text field.
</P
></LI
><LI
><P
> Select a setup type. Choose Domino Mail Server, Domino
Application Server, or Domino Enterprise Server and press <B
CLASS="keycap"
>TAB</B
>.
</P
></LI
><LI
><P
> Select the program file location. The default is
<TT
CLASS="filename"
>/opt/lotus</TT
>. 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
<TT
CLASS="filename"
>/opt/lotus</TT
>, then a soft link will be created
from your program directory to <TT
CLASS="filename"
>/opt/lotus</TT
> so
that commands may be executed from that path.
</P
></LI
><LI
><P
> Indicate if you plan a number of Domino servers on the current
physical machine. The default is <TT
CLASS="option"
>No</TT
>.
</P
></LI
><LI
><P
> Select the data file location. The default is
<TT
CLASS="filename"
>/local/notesdata</TT
>.
It works perfectly. Make sure your have enough space. The installed files
in the data directory are approximately 160 MB.
</P
></LI
><LI
><P
> Select the user and group for this server. Choose the default
that you set up earlier (<TT
CLASS="varname"
>notes</TT
> in the example).
</P
></LI
><LI
><P
> The install program displays the settings you selected. Use the
<B
CLASS="keycap"
>TAB</B
> key to accept these settings and begin the installation, or press the
<B
CLASS="keycap"
>ESC</B
> key to back up to change any settings. The install program will then
begin installing the files.
</P
></LI
><LI
><P
> After successful installation, this message will be displayed among
others:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> The installation completed successfully.
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN280"
></A
>4.3. For all Linux distributions</H2
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="rundssetup"
></A
>4.3.1. Run the Domino Server Setup program</H3
><P
></P
><OL
TYPE="1"
><LI
><P
> Log on to Linux as the user you established earlier (<TT
CLASS="varname"
>notes</TT
> in
the example).
</P
></LI
><LI
><P
> Change to the directory <TT
CLASS="filename"
>/usr/local/notesdata</TT
>
(<TT
CLASS="filename"
>/local/notesdata</TT
> for SuSE) by entering:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# cd /
bash# cd /usr/local/notesdata
and then enter the following:
bash# /opt/lotus/bin/http httpsetup
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> A series of messages indicate the start of the Domino server. For
example:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> 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
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="setupconfcont"
></A
>4.3.2. Continuing setup and configuration</H3
><P
></P
><OL
TYPE="1"
><LI
><P
> You begin the configuration process by connecting to your Linux
server with a Web browser, either from an external machine, or the Linux
machine.
</P
><P
> To perform setup from another machine, enter:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> <TT
CLASS="userinput"
><B
>http://example.com:8081</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
> To perform setup from the Linux machine, enter:
</P
><P
> <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
><TT
CLASS="userinput"
><B
>http://localhost:8081</B
></TT
></PRE
></FONT
></TD
></TR
></TABLE
> or
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
><TT
CLASS="userinput"
><B
>http://linux:8081</B
></TT
></PRE
></FONT
></TD
></TR
></TABLE
> for SuSE 7.3 Professional.
</P
><P
> where <TT
CLASS="varname"
>example.com</TT
> 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 <SPAN
CLASS="guibutton"
>Finish</SPAN
> button on the final screen to complete the initial
configuration. Online help is available on each of these screens.
</P
></LI
><LI
><P
> The HTTP Setup program will have created <TT
CLASS="filename"
>SERVER.ID</TT
> and
<TT
CLASS="filename"
>CERT.ID</TT
> files in
<TT
CLASS="filename"
>/usr/local/notesdata</TT
>. The <TT
CLASS="filename"
>USER.ID</TT
>
file is attached to a person document in <TT
CLASS="filename"
>NAMES.NSF</TT
>.
</P
></LI
></OL
></DIV
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="startdsserver"
></A
>4.3.3. Starting the Domino Server</H3
><P
> 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.
</P
><P
></P
><OL
TYPE="1"
><LI
><P
> Log on to Linux as the user you established earlier (<TT
CLASS="varname"
>notes</TT
> in
the example).
</P
></LI
><LI
><P
> From the <TT
CLASS="filename"
>/usr/local/notesdata</TT
> directory
(<TT
CLASS="filename"
>/local/notesdata</TT
> for SuSE), enter:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> bash# <TT
CLASS="userinput"
><B
>/opt/lotus/bin/server</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
> The server starts and the usual server console messages appear.
</P
></LI
></OL
></DIV
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="extractadminid"
></A
>4.3.4. Extracting your administrator ID file</H3
><P
> 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.
</P
><P
></P
><OL
TYPE="1"
><LI
><P
> After the HTTP Web Server task has started, switch to your
administration machine and use a Web browser to connect to your new
server:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> <TT
CLASS="userinput"
><B
>http://example.com</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
> where <TT
CLASS="varname"
>example.com</TT
> is either the IP address or DNS name of your
Linux server. The default Lotus Domino navigator screen displays.
</P
></LI
><LI
><P
> Now open the address book by entering:
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
> <TT
CLASS="userinput"
><B
>http://example.com/names.nsf</B
></TT
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
> Click to the People view and open the Person document for the
administrator you created earlier and download the <TT
CLASS="filename"
>USER.ID</TT
> file to your
administration machine. If you are using a Netscape browser, you may have
to rename the id file to <TT
CLASS="filename"
>USER.ID</TT
>.
</P
></LI
></OL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="prepdistro.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="resources.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Preparing your distribution for Domino R5</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
> </TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Resources</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
