Installing Domino for Linux/SuSE -- essential steps to run Domino on Linux


* |
|\| (c)1999-2001 NashCom - Communication Systems
| * mailto:info@nashcom.de - http://www.nashcom.de


------------------------------------------
Preparation of Installation
------------------------------------------

1. login root
2. create group notes via yast
3. create user notes via yast

4. mount CD (make sure not to use "nosuid" flag) like mount /dev/sr0 /cdrom

5. run /cdrom/linux/install

6. install notes in /opt/lotus & /local/notesdata

7. make sure all files have owner&group notes

- chown -R -h notes:notes /opt/lotus
- chown -R -h notes:notes /local/notesdata

8. make sure files have right permissions

- chmod -R 550 /opt/lotus
- chmod -R 700 /local/notesdata

9. make sure special file has root/daemon rights
for accessing ports < 1024 via notes user

- chown root:notes /opt/lotus/notes/latest/linux/bindsock
- chmod 4550 /opt/lotus/notes/latest/linux/bindsock

10. add Notes and JAVA libs to LIB search path

append the following lines to /etc/ld.so.conf

/opt/lotus/notes/latest/linux

11. add some environment settings in .profile of notes user

export LOTUS=/opt/lotus
export NOTES_DATA_DIR=/local/notesdata
export Notes_ExecDirectory=$LOTUS/notes/latest/linux
export PATH=$PATH:$NOTES_DATA_DIR:$Notes_ExecDirectory:$Notes_ExecDirectory/res/C

12. Set the apporiate time&date settings, because they are not read from OS like on NT

Example for Germany:

DateOrder=DMY
ClockType=24_HOUR
DateSeparator=.
TimeSeparator=:

------------------------------------------
Run Configuration
------------------------------------------

1. login as user notes

2. change to data directory via cd /local/notesdata

3. start the http setup via /opt/lotus/bin/http httpsetup

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

4. 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://servername.mydomain.com:8081

to perform setup from the Linux machine, enter:
http://localhost:8081

where servername.mydomain.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.


------------------------------------------
Automatic start on SuSE Linux
------------------------------------------

1. copy rc script domino to /sbin/init.d/

2. copy start_domino & stop_domino scripts to /opt/lotus/bin

3. change the following lines in /etc/rc.config

a.) append

--- snip ---
# Set to yes to allow to start the Lotus Domino Server
START_DOMINO="yes"
#
--- snip ---

b.) modify

--- snip ---
#disables Apache httpd
START_HTTPD=no

#disables mail daemon / SMTP
SMTP=no
--- snip ---


4. add links to one of the run level (e.g 3) directories via

cd /sbin/init.d/rc3.d
link -s ../domino S80domino
link -s ../domino K80domino


5. after finishing the configuration change
runlevel via init 3 to start domino server


----------------------------------
/opt/lotus/bin/start_domino
----------------------------------

#! /bin/sh

if [ `id -u` = 0 ]
then
echo "ERROR: root can not run the Lotus Domino Server"
exit 1
fi

export PATH=$PATH:/local/notesdata
/opt/lotus/bin/server < /dev/null > /home/notes/server.log &
exit 0


----------------------------------
/opt/lotus/bin/stop_domino
----------------------------------

#! /bin/sh

export PATH=$PATH:/local/notesdata
/opt/lotus/bin/server -q < /dev/null > /dev/null &
count=0
while
[`ps -ef | grep "/opt/lotus/notes" | grep -v "grep" | wc -l` -ne 0 ]
do
sleep 2
count=`expr $count + 1`
if [ $count = 61 ]
then
exit 1
fi
done
exit 0

----------------------------------
/sbin/init.d/domino
----------------------------------

#! /bin/sh
#
# Lotus Domino Server rc script
# April 2000, Hilden/Germany.
# Author: Daniel Nashed, nsh@nashcom.de
#
# /sbin/init.d/domino

. /etc/rc.config

# Determine the base and follow a runlevel link name.
base=${0##*/}
link=${base#*[SK][0-9][0-9]}

# Force execution if not called by a runlevel directory.
test $link = $base && START_DOMINO=yes
test "$START_DOMINO" = yes || exit 0

# The echo return value for success (defined in /etc/rc.config).
return=$rc_done
case "$1" in
start)
echo -n "Starting Lotus Domino Server "
startproc -u notes /opt/lotus/bin/start_domino || return=$rc_failed
echo -e "$return"
;;
stop)
echo -n "Shutting down Lotus Domino Server "
/opt/lotus/bin/stop_domino || return=$rc_failed
echo -e "$return"
;;
restart)
$0 stop && $0 start || return=$rc_failed
;;
reload)
$0 stop && $0 start || return=$rc_failed
;;
status)
echo -n "Checking for Lotus Domino Server: "
checkproc /opt/lotus/bin/server && echo OK || echo No process
;;
*)
echo "Usage: $0 {start|stop|status|restart|reload}"
exit 1
;;
esac

test "$return" = "$rc_done" || exit 1
exit 0


------------------------------------------
Optional after install & config
------------------------------------------

1. To void change of servertasks after installation

notes.ini setting

SetupLeaveServerTasks=1

2. Make sure DST Law is correct

notes.ini setting

DSTLAW=3,-1,1,10,-1,1


------------------------------------------
Installing on partitioned machine
------------------------------------------

1. Create additional users

2. Duplicate Notes Data directory
like /local/notesdata2

3. Set right file owner

chown -R -h notes2:notes /local/notesdata2

4. Add alias IP addresses to the IP stack

add lines like this to /sbin/init.d/network

ifconfig eth0:0 192.168.96.112
ifconfig eth0:1 192.168.96.113

/sbin/route add -host 192.168.96.112 dev eth0:0
/sbin/route add -host 192.168.96.113 dev eth0:1

5. Add the following lines to the corresponding notes.ini
and set the an unique IP address for each partition specified in step 4

This has changed in R5!!!
Before a notes.ini partition=n was used.
The name of the partition is the data directory!

TCPIP_TcpConnectTimeout=0,30
TCPIP_TcpIpAddress=0,192.168.96.111
SMTPNotesPort=TCPIP
POP3NotesPort=TCPIP
LDAPNotesPort=TCPIP
NNTPNotesPort=TCPIP
IMAPNotesPort=TCPIP


Show details for Additional InformationAdditional Information
Hide details for Additional InformationAdditional Information


Categories:Installation
Keywords:Installation, Linux
Posted:06/10/2001
Updated:06/10/2001