====== IBM Lotus Domino r5 ====== This was all done on Debian system .. for Domino v6 [[:domino|see this page]] and [[http://www.icewalkers.com/Linux/Howto/Lotus-DominoR5/index.html|Lotus R5 mini-howto]] ===== instalation ===== Some basic stuff that can be done to secure your running linux system. Try to run (see init.d script below) domino proccesses as domino user not as root. * create notes user and group as //(example below)//: groupadd -g 501 domino useradd -g 501 -u 501 domino * and then run domino ./install script from CD as root * after successful install (for install troubleshooting see below) do: chown -R domino.domino $NOTESDATA_DIR * run $DOMINODIR/bin/server as **domino** user * connect to and fellow the instructions * after restart you can configurate it on ===== init.d script ===== **Change variables values to your settings** in this script below. #!/bin/sh # # domino Start/stop the Lotus Domino server # # # Usage: /etc/init.d/domino start|stop # # process name: server, ... # Change the USER, GROUP, DATA_DIR and BIN_DIR for your server DOMINO_USER="domino" DOMINO_GROUP="domino" DOMINO_DATA_DIR="/home/notesdata" DOMINO_BIN_DIR="/opt/lotus/bin" # See if the user that runs this script is root if [ `id -u` != 0 ]; then echo "This script must be run by root only" exit 1 fi # See how we were called. case $1 in start) echo -n "Starting domino server..." # Version with logfile su - ${DOMINO_USER} -c "cd ${DOMINO_DATA_DIR};\ ${DOMINO_BIN_DIR}/server" \ >> /var/log/domino 2>&1 & echo "done." ;; stop) echo -n "Stopping Domino server. " su - ${DOMINO_USER} -c "cd ${DOMINO_DATA_DIR}; ${DOMINO_BIN_DIR}/server -q" ;; *) echo "Usage: domino {start|stop}" exit 1 ;; esac exit 0 # End of the domino script ===== Troubleshooting ===== ==== ==== //most common install error as far as I've tested ;-]// During the installation you get the following error. An unexpected error occured during post-install processing: ''Died at (eval 34) line 2. ...propagated at (eval 33) line 231.'' ''/home/notes/linux/tools/lib/NIC.pm line 727 The installation failed for the local host.'' **Notes Installation does NOT like symlinks**.. so if you wanted so keep the default settings however you did not enough diskspace and created symlinks for the /opt/notes and /local/notesdata this is what happens. Try running the install with other directories again and you won`t have the same problem. ==== ==== I get the following error when starting [domino@iluzija notesdata]$ /opt/lotus/bin/http httpsetup /opt/lotus/notes/latest/linux/http: error while loading shared libraries: libstdc++-libc6.1-1.so.2: cannot load shared object file: No such file or directory you have a wrong verscion of libstdc check in your ''/usr/lib'' if you have a file with a different version number, e.g. ln -s libstdc++-libc6.2-2.so.3 libstdc++-libc6.1-1.so.2 #debian: apt-get install libstdc++2.9-glibc2.1 ==== ==== I get the following error when starting [domino@iluzija notesdata]$ /opt/lotus/bin/http httpsetup 10/18/2001 11:58:12 AM Created new log file as /usr/local/notesdata/log.nsf 10/18/2001 11:58:12 AM ***************************************** * Lotus Domino Server Setup * * To setup this server, please connect * * your web browser to port 8081 * * Example: http://this.server.com:8081 * ***************************************** libjitc.so: cannot open shared object file: No such file or directory (libjitc.so) This means that notes does not find its Java Libraries. Either they are not installed or you have to include them in your ''/etc/ld.so.conf'' and run ldconfig afterwards. ==== <--- SIGSEGV (Segmentation fault) ---> ==== When starting http httpsetup it stops just after [domino@iluzija notesdata]$ /opt/lotus/bin/http httpsetup 10/18/2001 01:43:53 PM ***************************************** * Lotus Domino Server Setup * * To setup this server, please connect * * your web browser to port 8081 * * Example: http://this.server.com:8081 * ***************************************** This is again a Java library problem You can verify this by running ''strace -p $pidofnotes'' you should normally then get a list of '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' '' --- SIGSEGV (Segmentation fault) ---'' This has everything to do with your JDK. Let`s tackle this problem step by step. remove the file ''libjava.so'' in ''/opt/lotus/notes/latest/linux'' now try starting the httpsetup again you should see a listing like this [domino@iluzija notesdata]$ /opt/lotus/bin/http httpsetup 10/18/2001 01:43:53 PM ***************************************** * Lotus Domino Server Setup * * To setup this server, please connect * * your web browser to port 8081 * * Example: http://this.server.com:8081 * ***************************************** 10/18/2001 01:43:53 PM JVM: The JVM runtime library could not be found. 10/18/2001 01:43:53 PM JVM: Java Virtual Machine failed to start 10/18/2001 01:43:53 PM HTTP server error, could not load the Java VM 10/18/2001 01:43:53 PM HTTP Web Server started As you can see this works but you don`t have a JVM available. Recently I have discovered that with the java versions that are currently included with Notes there are less problems. [root@linnotes linux]# more /etc/redhat-release Red Hat Linux release 7.3 (Valhalla) [root@linnotes linux]# ./java -version java.bin version "1.1.8" [root@linnotes linux]# pwd /opt/lotus/notes/50100/linux #debian iluzija:~# cat /etc/debian_version 3.0 No problem there .. but we use the java version included with Notes . ==== ==== You get ''Error : Lotus Notes: error 0x102'' this basically is a permission problem, make sure you run ''chown -R $DOMINOUSER.$DOMINOGROUP /opt/lotus'' , this should normally solve the problem.