Domino og Linux
Mini-seminar hvor Morten Aksdal og Kjeld Dunweber vil gennemgå
installationen af både Linux og Domino, og dele ud af de praktiske erfaringer.
System Requirements SLES 11 64bit – 8.5.2
09-04-2015
• Operating System
• SUSE Linux Enterprise Server (SLES) 11.0 x86-64
• Attributes
•
•
•
•
And Future: OS Fix Packs
Bitness: 32 Bit
Deployment Role: Server
Hardware platform: x86-64
• Notes
• XGL and SELinux must be disabled
Page 2
Domino 8.5.1 - Required Linux packages and
updates
09-04-2015
Note: Domino 8.5.1 supports SLES 11, which requires equivalent packages.
• glibc-32bit-2.4-31.2
• libgcc-4.1.0-28.4
• libstdc++-4.1.0-28.4
• libXp-1.0.0.-8.i386.rpm (RHEL 5)
In addition, due to Java, the following packages are required for the server (some may not be needed on System z (64-bit))*:
• alsa-32bit-1.0.11-32.2
• atk-32bit-1.10.3-15.2
• cairo-32bit-1.0.2-27.4
• compat-libstdc++-5.0.7-22.2
• expat-32bit-2.0.0-13.2
• fontconfig-32bit-2.3.94-18.5
• freetype2-32bit-2.1.10-18.5
• glib-32bit-1.2.10-609.2
• glib2-32bit-2.8.5-21.2
• glibc-32bit-2.4-31.2
• glitz-32bit-0.4.4-21.2
• gtk-32bit-1.2.10-907.2
• gtk2-32bit-2.8.10-39.12
• libgcc-4.1.0-28.4
• libpng-32bit-1.2.8-19.2
• pango-32bit-1.10.2-23.2
• resmgr-32bit-0.9.8_SVNr75-18.4
• unixODBC-32bit-2.2.11-21.4
• xorg-x11-libs-32bit-6.9.0-50.14
• zlib-32bit-1.2.3-15.2
Page 3
30 steps to install SLES 11
09-04-2015
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Page 4
1. Boot from ISO or DVD
2. Choose Installation
3. On Welcome Page choose Language, Keyboard Layout and select I Agree to the License Terms and click on Next
4. Media Check just click Next
5. Installation Mode select New Installation and click on Next
6. Clock and Time Zone select a Region, Time Zone and Change Date and Time to current date and time. Click on Next
7. Server Base Scenario, Select Physical Machine (Also for Fully Virtualized Guests) and click on Next
8. Installation Settings select Expert tab
9. Click on Partitioning
10. Select Custom Partitioning (for experts) and click on Next
11. Go to -> Linux -> Hard Disks and select sda. Click on Add. Select Primary Partition. Custom Size and change to at least the same as physical
memory. Click on Next. Format partition select Swap under File system. Click on Finish
12. Select sda again and click on Add. Select Primary Partition and click on Next. Select Maximum Size and click on Next. Under Format partition
select Ext3. Set Mount Point to / and click on Finish
13. Select sdb and click on Add. Select Primary Partition and click on Next. Select Maximum Size and click on Next. Under Format partition select
Ext3. Under Mount partition change Mount Point to /local Select Fstab options and select No access time and click on Ok. Click on Finish
14. Select sdc and click on Add. Select Primary Partition and click on Next. Select Maximum Size and click on Next. Under Format partition select
Ext3. Under Mount partition change Mount Point to /translogs Select Fstab Options and select No access time and click on Ok. Click on Finish
15. Select sdd and click on Add. Select Primary Partition and click on Next. Select Maximum Size and click on Next. Under Format partition select
Ext3. Under Mount partition change Mount Point to /view Select Fstab Options and select No access time and click on Ok. Click on Finish
16. Click on Accept
17. Click on Software and deselect: Novell AppArmor, Print Server and Web-Based Enterprise Management. Click on Details. Under Development
click on C/C++ Compiler and Tools and select: gcc-c++ and kernel-source. (Install required packages for Domino or use YaST later) Click on
Accept, Accept and Continue
18. Click on Default Runlevel and select 3: Full multiuser with network and click on Ok
19. Click on Kdump and select Disable Kdump and click Ok
20. Click on Install and Install again to begin the installation
21. Enter a Password for the user root and click on Next
22. Enter a Hostname and Domain Name, unselect Change Hostname via DHCP and click on Next
23. Network Configuration. Click on Disable IPv6 under General Network Settings and Click on disable under Firewall and click on Next
24. Test Internet Connection. Just select No, Skip This Test and click on Next
25. Network Services Configuration. Click on CA Management and select Do Not Create CA and Certificate click on Next
26. User Authentication Method select Local (/etc/passwd) and click on Next
27. Create new local user "notes" and click on Next
28. Release Notes click on Next
29. Hardware Configuration click on Next
30. Installation Completed. Deselect Clone This System for AutoYaST and click on Finish
Create the group domino and change owner
09-04-2015
• Create the group domino: groupadd domino
• Add the user notes to the group domino: usermod –G domino notes
• Change the owner on /translogs & /view
• chown notes:domino /tranlogs
• chown notes:domino /view
Page 5
Setup SLES for Domino using YaST
09-04-2015
• From a command prompt type yast
• Install Required Packages
• Go to -> Software -> Software Management
• Make sure that you install the required packages for domino
• You can also install other packages like mc and sysstat
• Select Accept and OK
• You can also use a command to install a package. Example: yast -i sysstat
• Disable Postfix
• Go to -> System -> System Services (Runlevel)
• Select postfix, Disable and OK. Now the changes to the runlevels will be saved, select Yes
• Select Quit to exit YaST
Page 6
Maximum number of file handles
09-04-2015
Page 7
• Default maximum number of file handles for Domino is 1024 on Linux. If
Domino is started from a login session edit the file /etc/security/limits.conf
• Use WinSCP
• Go to -> etc -> security and open limits.conf
• Add:
#Number of open files for notes
notes soft nofile 49152
notes hard nofile 49152
#Number of processes/threads for notes
notes soft nproc 12500
notes hard nproc 12500
Domino Installation Guide
09-04-2015
1. Login as root
2. Download Domino for Linux and Copy the .tar file to the server (Use
WinSCP)
3. Untar the .tar file: tar –xvf nameofthetarfile.tar
4. Tar creates a sub-folder called linux in the folder we just unzipped in
5. Run the install script from linux/domino: ./install
6. Follow the instructions for the installation
7. Default user: notes
8. Default group: domino
9. Choose Remote Server Setup
10.When the Domino setup server is in listening mode use Remote Server
Setup to finish the installation of the Domino Server
Page 8
Start/Stop Script by Daniel Nashed
09-04-2015
•
For at få tilsendt Start-Script fra Daniel Nashed udfyld formularen på:
http://www.nashcom.de/nshlstrq.nsf/StartScript!openform
•
Scriptet kan bruges til start/stop, monitorere og fejlsøgning (NSD)
Page 9
Start Script by Daniel Nashed
09-04-2015
Page 10
1. Copy the file rc_domino_script to the Domino binary directory (default
/opt/ibm/lotus/
2. Copy the file rc_domino to /etc/init.d/
3. Ensure the script files are executable by root
1.
2.
chmod 755 /opt/ibm/lotus rc_domino_script
chmod 755 /etc/init.d/rc_domino
4. Check that regional settings are set to en_UK in /opt/ibm/lotus/rc_domino
1.
2.
Open /opt/ibm/lotus/rc_domino_script using WinSCP
DOMINO_LANG=en_UK
5. Add the script to INSSERV
1.
2.
insserv /etc/init.d/rc_domino
To verify that your service is correctly added to the rc-levels: find /etc/init.d/ -name
“*domino*” which should give you something like this output:
/etc/init.d/rc3.d/S11rc_domino
/etc/init.d/rc3.d/K11rc_domino
/etc/init.d/rc5.d/S11rc_domino
/etc/init.d/rc5.d/K11rc_domino
/etc/init.d/rc_domino
Start Script Commands
09-04-2015
Page 11
• /etc/init.d/rc_domino <command>
• example: /etc/init.d/rc_domino start
• start
• starts the Domino server
• start live
• starts the Domino server and displays the live console
• stop
• stops the Domino server
• stop live
• stops the Domino server and displays the live console
• restart
• restarts the Domino server
• restart live
• restarts the Domino server and displays the live console
• status
• checks if the Domino server is running and prints a message
• monitor
• allows a kind of live console from a telnet/ssh session. ctrl+c or stop to terminate the live console
Transactional Logging & View Rebuild
09-04-2015
• Enable Transactional Logging and change the path to /translogs
• Set the path for View Rebuild to /view
Page 12
Notes.ini Settings
09-04-2015
Page 13
• ClockType=24_Hour
• set clock type to 24 hour format
• DateOrder=DMY
• set date order to Day Month Year
• Update_Fulltext_Thread=1
• allows use of a separate thread to do Full Text Indexing so that long full text indexes don't delay
View Updates
• Updaters=2
• run 2 Update Tasks - as a rule of thumb do not exceed a maximum of one Update task per CPU
• Replicators=2
• Will allow the server to replicate its databases with two servers simultaneously
• Server_Session_Timeout=45
• will cause the Domino server to terminate a session that has been idle for the specified amount of
time
• Ftg_Use_Sys_Memory=1
• will instruct the full-text (FT) engine to directly use the operating system memory manager for
large allocations, instead of requesting memory through the Notes Memory Manager and will avoid
memory fragmentation
Notes.ini Settings
09-04-2015
Page 14
• Ft_Fly_Index_Off=1
• By default, when an agent that requires a full-text index runs against a database that does not
have one, a temporary full-text index is created on the fly. This causes significant overhead for
the server in direct proportion to the size of the index
• Log_DisableTxnLogging=1
• The 'Log_DisableTXNLogging' setting will disable transaction logging for LOG.NSF. This will reduce
resource demands on Domino
• Create_R85_Log=1
• Beginning with Domino 8.5, the format of transaction logs can be optimized for Domino servers
that use a block size different than the default block size of 512 bytes
The NOTES.INI option Create_R85_Log=1 will create new transaction logs with an updated
format, properly aligning blocks for I/O
• Create_R85_Databases=1
• enable ODS 51 as the default. Remember to run compact -c to change ODS
Install Fix Pack
09-04-2015
1. Shutdown the domino server 
2. Untar the .tar file: tar –xvf nameofthetarfile.tar
3. Tar creates a sub-folder called linux in the folder we just unzipped in
4. Run the install script from linux/domino: ./install
5. Follow the instructions for the installation
6. If you get the below error just make the terminal window size larger:
Error: The minimum supported terminal size is 130 columns by 24 rows.
Please ensure that the terminal/window used is at least this size.
Page 15
Linux Commands
09-04-2015
•
•
•
•
•
•
•
•
•
•
•
•
ll - list information about the files in the current directory
cd - change the current working directory
pwd - print working directory
mv - move or rename a file
cp - copy a file
mkdir - creates a new directory
rm - remove a file
cat - list the content of a file
ifconfig - displays the status of the currently active interfaces
df - disk space available on all currently mounted file systems
du - disk usage of each file recursively for directories
mount - display all mounted filesystems
Page 16
Linux Commands (Performance)
09-04-2015
• top - display Linux tasks
• ”top -u notes” - display only tasks for the user notes (domino tasks)
• iostat - monitoring system input/output device loading
• ”iostat -x 1” - monitoring disk performance
• pmap - display process memory usage
• ”pmap -d <pid>” - display memory usage for a specific process id
• netstat - display network information
• ”netstat -i” summarizes network activity
Page 17
Summarize
09-04-2015
• Install SLES
• Add notes to domino group
• Change owner on /tranlogs and /view
• Edit limits.conf
• Untar the .tar file and install Domino
• Add start script
Page 18
Links
09-04-2015
• Detailed System Requirements for Lotus Domino
• https://www-304.ibm.com/support/docview.wss?uid=swg27007909&wv=1
• Required Linux Packages and Updates
• https://www-304.ibm.com/support/docview.wss?uid=swg27013075&wv=1
• Tuning SUSE LINUX Enterprise Server on IBM Eserver xSeries Servers
• http://www.redbooks.ibm.com/redpapers/pdfs/redp3862.pdf
• Daniel Nashed Unix Start-Script
• http://www.nashcom.de/nshweb/pages/startscript.htm
• Novell Downloads - SUSE Linux Enterprise Server
• http://download.novell.com/index.jsp
• WinSCP
• http://winscp.net/eng/download.php
• Putty
• http://www.putty.org
Page 19