HOWTO: Install & setup Lotus Notes for Linux

[malmo]

Get package
The best way is to get it from Partnerworld program.
Name of package is: C93D1NA.zip

Prerequisites
1, install mozilla package - should be >= 1.7.12 (apt-get install mozilla-browser)
2, create symlink to mozilla binary (ln -sf /usr/bin/mozilla-suite /usr/bin/mozilla)
3, edit /etc/gre.d/gre.conf to match your mozilla version (you can also add symlink /etc/gre.conf)
insert:

[1.7.13]
GRE_PATH=/usr/lib/mozilla

4, Get Gnome libraries (I'm not sure which ones - i got Gnome as alternative Desktop)

Install
1, unpack C93D1NA.zip (unzip -d lotus C93D1NA.zip)
2, unpack Personality.zip
3, chmod +x on lotus/setup_wct_platform.bin and setuplinux.bin
4, copy setuplinux.bin to updateSite/features/com.ibm.workplace.notesinstall.linux.feature_7.0.1 .0000-0900/bin/linux/
5, run installer ./lotus/setup_wct_platform.bin as non-root user (it'll be a little bit complicated installing it as root, but it's possible)
6, as first, there will be Workplace Manged Client installed (agree to
licenses, set install path etc. to install it - don't forget to set privileges on install dirs ) and then you will be asked to install Lotus Notes Client plug-in, so be patient. At the end launch icon will be installed to your desktop.
7, after installation, empty client will be started so don't panic
8, close client

Setup
To start client correctly, you have to make some environment settings:
$CLASSPATH pointing to the top-level installation directory.
Add the top-level installation directory, and jvm/bin to your path
Set $NOTESDIR to the data subdirectory of the top-level installation directory
Set $NOTESBIN to the top-level installation directory
Add the subdirectories jvm/bin/classic, jvm/bin and the top-level installation directory to $LD_LIBRARY_PATH

example:

NOTESBIN=/home/malmo/notes
NOTESDATA=/home/malmo/notes/data
NOTESDIR=/home/malmo/notes/data

LD_LIBRARY_PATH=$NOTESBIN:$NOTESBIN/jvm/bin/classic:$NOTESBIN/jvm/bin:$LD_LIBRARY_PATH

PATH=$NOTESBIN/jvm/bin:$NOTESBIN:$PATH

CLASSPATH=./:$NOTESBIN/:$CLASSPATH

export NOTESBIN NOTESDATA NOTESDIR LD_LIBRARY_PATH PATH CLASSPATH

The way you do it is up to you
KDE:
I've put those variables into file (.notesrc) & sourcing it before launch of main app.

(command section in desktop file:
. /home/malmo/.notesrc;/opt/ibm/Workplace\ Managed\ Client/rcp/richclient -personality com.ibm.workplace.noteswc.standalone.linux.personality)

Gnome:
Create script to launch notes
e.g. /home/malmo/bin/notesstart

#!/bin/sh

NOTESBIN=/home/malmo/notes
NOTESDATA=/home/malmo/notes/data
NOTESDIR=/home/malmo/notes/data
LD_LIBRARY_PATH=$NOTESBIN:$NOTESBIN/jvm/bin/classic:$NOTESBIN/jvm/bin:$LD_LIBRARY_PATH
PATH=$NOTESBIN/jvm/bin:$NOTESBIN:$PATH
CLASSPATH=./:$NOTESBIN/:$CLASSPATH
export NOTESBIN NOTESDATA NOTESDIR LD_LIBRARY_PATH PATH CLASSPATH

/opt/ibm/Workplace\ Managed\ Client/rcp/richclient -personality com.ibm.workplace.noteswc.standalone.linux.personality

chmod 755 notesstart

now you can edit launcher icon to point to script

Final:
Then, after launching application you should be able to setup Lotus Notes common way - LotusNotes wizard will pop-up.

Enjoy

[evilcartman]

Malmo,

Excellent Howto! However, even after following this when I launched the client the way you specify, I got the empty two pane window and setup never started. To fix this, change all of the statements in your .notesrc file to start with "export <VARIABLE> = <VALUE>". E.g., "export NOTESBIN=/home/malmo/notes". After making this change and then starting Notes, setup appears and now I'm up and running. Thanks again

[loupy]

I followed the instructions but I get the following errors

If running the launcher as ". /home/loupy/.notesrc;/opt/ibm/Workplace\ Managed\ Client/rcp/richclient -personality com.ibm.workplace.noteswc.standalone.linux.persona lity"

"Details: Failed to execute child process "." (Permission denied)"

If I run the launcher as "./home/loupy/.notesrc;/opt/ibm/Workplace\ Managed\ Client/rcp/richclient -personality com.ibm.workplace.noteswc.standalone.linux.persona lity" (no space in between first 2 characters)

Details: Failed to execute child process "./home/loupy/.notesrc;/opt/ibm/Workplace Managed Client/rcp/richclient" (No such file or directory)

If I remove the first part and do the export first from the cli I get the same empty 2 pane app and no way of setting it up


EDIT: There is no space in "personality" I am not sure why it's showing up that way when I post.

[evilcartman]

Loupy,

It may be that you are missing a library needed for setup? If you run the following command:

. ~/.notesrc; ldd ~/notes/lnotes

Do you see any entries with "File not found"? If so, then you may be missing a library or there is a problem with the environment settings in the .notesrc file.

[malmo]

Loupy,

in fact, this space between "." an path to file with envs is important, as it means taht this file should be sourced. Other way how to do it, is to use "source /home/loupy/.notesrc". Maybe this'll help you.

[loupy]

I tried doing the source command from the cli and there are no missing files when I run "~/.notesrc; ldd ~/notes/lnotes" I am so lost on how to get this working.

loupy@ubuntu32:~$ . ~/.notesrc; ldd ~/notes/lnotes
        linux-gate.so.1 =>  (0xffffe000)
        libnotes.so => /home/loupy/notes/libnotes.so (0xb6347000)
        libXp.so.6 => /usr/lib/libXp.so.6 (0xb6334000)
        libXm.so.3 => not found
        libXt.so.6 => /usr/lib/libXt.so.6 (0xb62e6000)
        libX11.so.6 => /usr/lib/libX11.so.6 (0xb6200000)
        libdl.so.2 => /lib/tls/i686/cmov/libdl.so.2 (0xb61fd000)
        libemulator.so => /home/loupy/notes/libemulator.so (0xb604b000)
        libpthread.so.0 => /lib/tls/i686/cmov/libpthread.so.0 (0xb6038000)
        libresolv.so.2 => /lib/tls/i686/cmov/libresolv.so.2 (0xb6025000)
        libjvm.so => /home/loupy/notes/jvm/bin/classic/libjvm.so (0xb5e09000)
        libstdc++.so.5 => /usr/lib/libstdc++.so.5 (0xb5d4f000)
        libm.so.6 => /lib/tls/i686/cmov/libm.so.6 (0xb5d2d000)
        libc.so.6 => /lib/tls/i686/cmov/libc.so.6 (0xb5bfe000)
        libgcc_s.so.1 => /lib/libgcc_s.so.1 (0xb5bf3000)
        libndgts.so => /home/loupy/notes/libndgts.so (0xb5bf1000)
        libxmlproc.so => /home/loupy/notes/libxmlproc.so (0xb567f000)
        libglib-2.0.so.0 => /usr/lib/libglib-2.0.so.0 (0xb55fb000)
        librt.so.1 => /lib/tls/i686/cmov/librt.so.1 (0xb55f3000)
        libSM.so.6 => /usr/lib/libSM.so.6 (0xb55eb000)
        libICE.so.6 => /usr/lib/libICE.so.6 (0xb55d2000)
        libXau.so.6 => /usr/lib/libXau.so.6 (0xb55cf000)
        /lib/ld-linux.so.2 (0xb7fd3000)
        libgtk-x11-2.0.so.0 => /usr/lib/libgtk-x11-2.0.so.0 (0xb52fa000)
        libgdk-x11-2.0.so.0 => /usr/lib/libgdk-x11-2.0.so.0 (0xb527d000)
        libatk-1.0.so.0 => /usr/lib/libatk-1.0.so.0 (0xb5264000)
        libgdk_pixbuf-2.0.so.0 => /usr/lib/libgdk_pixbuf-2.0.so.0 (0xb524e000)
        libpangoxft-1.0.so.0 => /usr/lib/libpangoxft-1.0.so.0 (0xb5248000)
        libpangox-1.0.so.0 => /usr/lib/libpangox-1.0.so.0 (0xb523d000)
        libpango-1.0.so.0 => /usr/lib/libpango-1.0.so.0 (0xb5205000)
        libgobject-2.0.so.0 => /usr/lib/libgobject-2.0.so.0 (0xb51cd000)
        libgmodule-2.0.so.0 => /usr/lib/libgmodule-2.0.so.0 (0xb51ca000)
        libgthread-2.0.so.0 => /usr/lib/libgthread-2.0.so.0 (0xb51c5000)
        libXcursor.so.1 => /usr/lib/libXcursor.so.1 (0xb51bc000)
        libcups.so.2 => /usr/lib/libcups.so.2 (0xb518f000)
        libpsprint.so => /home/loupy/notes/libpsprint.so (0xb5076000)
        libgnomeprint-2-2.so.0 => /usr/lib/libgnomeprint-2-2.so.0 (0xb5014000)
        libgnomeprintui-2-2.so.0 => /usr/lib/libgnomeprintui-2-2.so.0 (0xb4fdd000)
        libgnomevfs-2.so.0 => /usr/lib/libgnomevfs-2.so.0 (0xb4f81000)
        libpangocairo-1.0.so.0 => /usr/lib/libpangocairo-1.0.so.0 (0xb4f79000)
        libcairo.so.2 => /usr/lib/libcairo.so.2 (0xb4f33000)
        libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb4f05000)
        libXext.so.6 => /usr/lib/libXext.so.6 (0xb4ef7000)
        libXrender.so.1 => /usr/lib/libXrender.so.1 (0xb4eef000)
        libXinerama.so.1 => /usr/lib/libXinerama.so.1 (0xb4eec000)
        libXi.so.6 => /usr/lib/libXi.so.6 (0xb4ee4000)
        libXrandr.so.2 => /usr/lib/libXrandr.so.2 (0xb4ee1000)
        libXfixes.so.3 => /usr/lib/libXfixes.so.3 (0xb4edd000)
        libpangoft2-1.0.so.0 => /usr/lib/libpangoft2-1.0.so.0 (0xb4eb8000)
        libXft.so.2 => /usr/lib/libXft.so.2 (0xb4ea6000)
        libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb4e3d000)
        libz.so.1 => /usr/lib/libz.so.1 (0xb4e29000)
        libgnutls.so.12 => /usr/lib/libgnutls.so.12 (0xb4dc0000)
        libcrypt.so.1 => /lib/tls/i686/cmov/libcrypt.so.1 (0xb4d92000)
        libart_lgpl_2.so.2 => /usr/lib/libart_lgpl_2.so.2 (0xb4d7d000)
        libxml2.so.2 => /usr/lib/libxml2.so.2 (0xb4c6e000)
        libgnomecanvas-2.so.0 => /usr/lib/libgnomecanvas-2.so.0 (0xb4c45000)
        libgconf-2.so.4 => /usr/lib/libgconf-2.so.4 (0xb4c15000)
        libbonobo-2.so.0 => /usr/lib/libbonobo-2.so.0 (0xb4bbd000)
        libbonobo-activation.so.4 => /usr/lib/libbonobo-activation.so.4 (0xb4ba9000)
        libORBit-2.so.0 => /usr/lib/libORBit-2.so.0 (0xb4b58000)
        libavahi-glib.so.1 => /usr/lib/libavahi-glib.so.1 (0xb4b55000)
        libavahi-common.so.3 => /usr/lib/libavahi-common.so.3 (0xb4b4b000)
        libavahi-client.so.3 => /usr/lib/libavahi-client.so.3 (0xb4b3c000)
        libutil.so.1 => /lib/tls/i686/cmov/libutil.so.1 (0xb4b38000)
        libpng12.so.0 => /usr/lib/libpng12.so.0 (0xb4b15000)
        libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb4af6000)
        libtasn1.so.2 => /usr/lib/libtasn1.so.2 (0xb4ae6000)
        libgcrypt.so.11 => /usr/lib/libgcrypt.so.11 (0xb4a99000)
        libgpg-error.so.0 => /usr/lib/libgpg-error.so.0 (0xb4a95000)
        libORBitCosNaming-2.so.0 => /usr/lib/libORBitCosNaming-2.so.0 (0xb4a91000)
        libpopt.so.0 => /lib/libpopt.so.0 (0xb4a89000)
        libdbus-1.so.2 => /usr/lib/libdbus-1.so.2 (0xb4a51000)
        libnsl.so.1 => /lib/tls/i686/cmov/libnsl.so.1 (0xb4a3c000)

EDIT - I found the problem - I needed libmotif3 installed

[jshein]

The install worked perfectly. Thank You for this HOWTO.

One little issue..

"Set up Lotus Notes common way"

What is required for the URL ?? Normally in a windows client we point it at the domino server hostname or ip. It says "invalid url" if I do that.

Any ideas?

Is there maybe something additional that needs to be done on the server prior to using the linux client?

[evilcartman]

jshein,

No URL is required. If all the prerequisites are installed and all environment variables set correctly (particularly LD_LIBRARY_PATH), then setup should appear after you launch the Workplace client. The setup dialogs are equivalent to the initial setup for the Windows Notes client.

[malmo]

Thanks for feedback. The code should be noow correct

[jlt5]

Help!!!!! Got the darn thig to sort of come up using the notesstart script. the Panel comes up and says Notes Applications - Lotus Notes. I have the File tab and Help tab. Within the Help tab what am i connecting too? The notes server? Need help getting further. There is not much doc past this point. Thanks Jim