Task
1. Install Ubuntu and Prep for Domino
2. Install HCL Domino 14.0
3. Install HCL Domino 14.0 FP5
4. Create the Domino Service
5. Perform Setup (First or Additional)
Notes:
- For this example:
- - First Server: MWDomApp01/MWNet
- - New/Additional Server name: MWDomApp02/MWNet
- - Domain: MWNet
- - Admin Account: AdminID MWNet/MWNet
Task 1 - Install Ubuntu OS and Packages
a. Create VM
vSphere / RHV --> New Virtual Machine -->
Name: <vmname>
CPU Cores: 2
Memory: 8 GB
Hard disk 1: 32 GB (depends on storage needs)
CD/DVD: ubuntu-24.0.4.4-live-server-amd64.iso
- Boot VM and Install Ubuntu:
- Choose minimized w/SSH server
- Setup network (e.g. 10.0.67.0/24 and IP 10.0.66.100) and admin account (e.g. mwadminid)
- Setup disk.
- Perform reboot at end
b. Update system:
$ ssh myadminid@myserver.mindwatering.net
<enter password>
$ sudo apt-get update
<wait>
$ sudo apt-get upgrade
<wait>
$ sudo apt-get autoremove
<wait>
$ sudo apt-get upgrade
<wait and confirm nothing new>
c. Install rpm for Domino and vi to edit config files
$ sudo apt-get install rpm
<confirm and wait>
$ sudo apt-get install vim
<confirm and wait>
d. Create server notes user:
$ sudo useradd -d /home/notes -m notes
$ sudo passwd notes
e. Create notesdata folder and give ownership to notes user:
$ sudo mkdir local
$ cd local
$ sudo mkdir notesdata
$ sudo chown -R notes /local/
$ sudo chgrp -R notes /local/
$ sudo chmod -R g+w /local/
f. Update /etc/security/limits.conf and add or modify the lines:
$ sudo vi /etc/security/limits.conf
...
notes soft nofile 20000
notes hard nofile 60000
g. Swap sh for bash:
Note:
- Domino
$ ssh myadminid@myserver.mindwatering.com
<enter password>
$ sudo su -
# /home/myadmin/tmp/linux64# rm /bin/sh
# /home/myadmin/tmp/linux64# ln -s /bin/bash /bin/sh
h. Update /etc/hosts (optional)
Notes:
- If DNS fails and Domino should keep functioning, add hosts entries for redundancy
# vi /etc/hosts
...
10.0.67.100 mwdomapp01 mwdomapp01.mindwatering.net
10.0.66.100 mwdomapp02 mwdomapp02.mindwatering.net
i. Update the Ubuntu firewall:
Notes:
- Add web ports 443 and 80
- Add NRPC port 1352
- Restrict SSH to the local network(s)
# ufw allow proto tcp to any port 443
# ufw allow proto tcp to any port 80
# ufw allow proto tcp to any port 1352
# ufw allow proto tcp to any port 22 from 10.0.66.0/24
# ufw allow proto tcp to any port 22 from 10.0.67.0/24
# ufw reload
# exit (root)
Task 2 - Install Domino 14.0
BEFORE YOU START:
Check server drive disk for free drive space (10 GB min)
This directions assume we are installing from an /home/myadmin home folder temporary Downloads directory. Update the path for your specific path structure when going through installation prompts
a. SCP/Filezilla transfer the files
Notes:
- Both file extract to linux64 subfolders. Therefore, we can either extract in different folders or rename folders after extraction to keep unique.
- HCL Domino 14.0: Folder path: /home/myadminid/tmp/dom140
--> Domino_14.0_Linux_English.tar
- HCL Domino 14.0 FP5: Folder path: /home/myadminid/tmp/dom14fp5
--> Domino_1400FP5_Linux.tar
b. Extract the Domino installations:
- SSH into new server:
$ ssh myadminid@myserver.mindwatering.net
<enter password>
- Confirm there is plenty of disk space
$ df -h
<read output>
- Uncompress the Domino install file:
Note:
$ cd /home/myadminid/tmp/dom140/
$ tar -xvf Domino_14.0_Linux_English.tar
<watched files extracted>
- Delete the tar archive:
$ rm Domino_14.0_Linux_English.tar
- Uncompress the Domino fixpack:
$ cd /home/myadminid/tmp/dom140fp5/
$ tar -xvf Domino_1400FP5_Linux.tar
<watched files extracted>
Delete the tar archive:
$ rm Domino_1400FP5_Linux.tar
c. Install Domino:
Note: We don't need to set the NUI export because no server exists yet to "find".
- Change to install directory and run:
$ cd /home/myadminid/tmp/dom140/install64/
$ ./install
- In the installation question steps:
CHOOSE LOCALE BY NUMBER: 3 (English) -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
PRESS ... LICENSE AGREEMENT ... PRESS '0' to ADVANCED TO END: 0 (End) -->
DO YOU ACCEPT TERMS ... (Y/N): Y -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
Unable to detect a previous Domino installation ... not an upgrade, PRESS <ENTER> TO CONTINUE: <ENTER> -->
Install Data Directory Only ... Server (Default: NO): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
Program File Directory Name (Default: /opt/hcl/domino): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
Partitioned Server (Default: NO): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
Program File Directory Name (Default: /local/notesdata): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
User Name (Default: notes): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
Group Name (Default: notes): <ENTER> -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
SERVER TYPE: 2 (Domino Enterprise Server) -->
PRESS <ENTER> TO CONTINUE: <ENTER> -->
SETUP... 1 (manual, or 2- remote, if you choose 2, you'll have to do setup before performing FP5 install)
PRESS <ENTER> TO CONTINUE: <ENTER> -->
- At this point, take what you have done with <ENTER> to perform the installation, or type 'back' to go back and change an option.
Task 3 - Install Domino 14.0 Fixpack 5
$ cd /home/myadminid/tmp/dom140fp5/install64/domino/
$ ./install
<TAB> to continue -->
<TAB> to continue -->
On license screen, click any key multiple times until the end, <TAB> to continue -->
On license agree screen, take default [Yes], with <TAB> to continue -->
On the installation settings screen, confirm the paths are correct, and the username/group for notes is correct, <TAB> to continue -->
Task 4 - Create the Domino Service
a. SCP/Filezilla the Nashed domino-startscript
SCP domino-startscript_v3.70.taz --> /home/myadminid/tmp/
b. Uncompress installation:
$ cd /home/myadminid/tmp/
$ tar -xf domino-startscript_latest.taz
< wait >
$ rm domino-startscript_latest.taz
c. Install Service and Perform Setup (if not using One-Touch below):
# cd domino-startscript/
# ./install_script
<wait a second - scripts and service are installed>
d. If wish to perform server setup via this script:
- Create the JQ/JSON Configuration (very similar to one-touch in step 5 below)
- Run the setup:
# domino setup
< review file - use wq! to save any changes >
e. Start the service:
# systemctl status domino.service
<confirm enabled but inactive/dead/not running>
# systemctl start domino.service
<wait a second>
# systemctl status domino.service
<confirm active (running)>
Note:
- If you performed the domino setup above, then there is no need to do the next task 5.
Task 5 - Alternate Way to Setup Domino with One-Touch-Setup
Note:
- There are 3 main options for performing the Domino set-up: domino-setup w/in the service start script, the one-touch setup (see below), or the legacy server -listen and serversetup -remote from an Admin client.
- We are going to do the set-up via one-touch, but still install the service.
a. Login:
$ ssh myadminid@myserver.mindwatering.net
<enter password>
$ sudo su -
<enter myadminid password again>
$ su notes -
<no password is needed>
$ exit
(to be root again)
# exit
(to be myadminid again)
b. Set-up the notes user so Domino checks its OS configuration:
$ sudo vi /home/notes/.bashrc
Add to the end of the file:
...
export DOMINO_LINUX_SET_PARMS=1
<esc>:wq <enter> (to save)
c. Use the Domino admin client's ServerSetup -remote utility program with the Domino Administrator, or the one touch setup method. We prefer the one touch setup.
Note:
- Use the example server data at the top of this technote.
- Create the JSON file for server setup:
$ sudo su -
# su notes -
$ cd /local/notesdata
$ vi /local/notesdata/serveradd.json
{
"serverSetup": {
"server": {
"type": "additional",
"name": "MWDomApp02",
"domainName": "MWNet",
"IDFilePath": "/local/notesdata/mwdomapp02.id"
},
"network": {
"hostName": "mwdomapp02.mindwatering.net"
},
"org": {
"orgName": "MWNet"
},
"admin": {
"CN": "AdminID MWNet"
},
"existingServer": {
"CN": "MWDomApp01"
}
}
}
- Run the setup:
$ /opt/hcl/domino/bin/server -autoconf serveradd.json
<wait - a few lines will print with the last of the group saying "No Error". Then the autoconfig will run for 30 seconds to a minute, and the server will start running on the console>
- Let the Domino console run for a while
<wait>
- Perform a manual replication with
> rep MWDomApp01
<wait while apps replicate>
- Stop the server so we can start via service
> q
<wait and watch shutdown>
- Start server:
$ exit (notes user)
# exit (root)
$ sudo systemctl start domino.service
<wait a second>
$ sudo systemctl status domino.service
<confirm active(running) status>
__________________
Reference - Start Script Locations:
Installing StartScript & Config
[/usr/bin/domino] installed
[/opt/nashcom/startscript/rc_domino_script] installed
[/opt/nashcom/startscript/rc_domino_readme.txt] installed
[/opt/nashcom/startscript/nshinfo.sh] installed
[/opt/nashcom/startscript/DominoOneTouchSetup.sh] installed
[/opt/nashcom/startscript/nshcfg.sh] installed
[/opt/nashcom/startscript/domino-example.cfg] installed
[/opt/nashcom/startscript/rc_domino_config_3.6.2.txt] installed
[/etc/sysconfig/rc_domino_config] installed
[/local/notesdata/systemdbs.ind] installed
[/etc/sysconfig/domino.cfg] installed
[/etc/systemd/system/domino.service] installed
Enabling Service
Created symlink /etc/systemd/system/multi-user.target.wants/domino.service → /etc/systemd/system/domino.service
previous page
|