Task:
1. Update Domino from Domino 14.FP3 with mail hotfix to FP5
2. Update Traveler from Traveler 14.0.x to 14.5.0
Task 1 - Update Domino to Domino 14.0 FP5
Steps for In-place Upgrade
of HCL Domino 11.0.1 FPx to HCL Domino 12.0.0, including upgrading HCL Traveler services
2024/12/14 Router Failure Warning
- All versions of Domino, at least through version 8.5.x, have a long-term bug where, unless you are running routing defaults, the router will likely stop working midnight 2014/12/13. Immediately upgrade to Domino 14.0 FP3 HF9, or Domino 12.0.2 FP5 HF12 (Which is also IF2 - 1202FP5HF12-linux64.tar.)
Notes:
- Linux server OS is CentOS 8, or Ubuntu 24. Existing HCL Domino is 64-bit, or course.
- The existing start-up script is an updated HCL/Nashed one. It's a couple years old, but still worked, so we didn't replace it with the newest one.
- The APNS (Apple Push Notification Services) certificates no longer have to be used after the Domino 14.5 upgrade.
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
In-Place HCL Domino Upgrade:
1. Using Filezilla or SCP, copied the install file to the server in the server's downloads folder.
(In this case, to a dom12 folder in the server's admin user's Downloads folder)
Made two new directories, dom14FP5 and trav145
Transferred to the dom14FP5 folder:
Domino_1400FP5_Linux.tar
Transferred to the trav145 folder:
Traveler_14.5_Linux_ML.tar.gz
2. Started SSH Terminal to server and uncompressed files.
$ ssh myadmin@myserver.mindwatering.com
<enter password>
Confirm there is plenty of disk space
$ df -h
<read output>
Uncompress the Domino install file:
Note: both file extract to linux64 subfolders. Therefore, we rename the folders after extraction.
$ cd /home/myadmin/Downloads/dom14FP5/
$ pwd
/home/myadmin/Downloads/dom1202/
$ tar -xvf Domino_1400FP5_Linux.tar
<watched files extracted>
Rename the folder:
$ mv linux64 linux64dom140fp5
Delete the tar archive:
$ rm Domino_1400FP5_Linux.tar
Uncompress the Traveler install file:
Note: Unlike the Domino tar files, these gz files extract into the same folder the gz file is located.
$ cd /home/myadmin/Downloads/trav145/
$ tar zxf Traveler_14.5_Linux_ML.tar.gz
<watched files extracted>
Verify the installer.properties settings are correct for upgrade:
$ vi installer.properties
...
DOMINO_PROGRAM_DIRECTORY=/opt/hcl/domino/notes/latest/linux
DOMINO_DATA_DIRECTORY_1=/local/notesdata
DOMINO_NOTESINI_DIRECTORY_1=/local/notesdata
...
LINUX_USER_NAME=notes
...
LINUX_GROUP_NAME=notes
...
NTS_WEBSITE_HOME=0
...
<esc>:wq (to save)
In-Place Domino Upgrade from 14.0FP3HF9 or 14.0FP4 to 14.0FP5:
3. Shutdown Domino service and upgrade Domino to latest FP:
$ sudo systemctl stop domino.service
<wait>
Set the environmental variables the FP will need:
# NUI_NOTESDIR=/opt/ibm/domino
# export NUI_NOTESDIR
If the Domino 14 HF9 is still installed, remove it:
Note: We must uninstall hot-fixes to get to a later FP.
$ cd /home/myadmin/Downloads/dom140HF9/linux64dom140hf9
$ ./install
<follow the prompts to revert to 140FP3>
$ cd /home/myadmin/Downloads/dom14FP5/linux64dom140fp5/domino
$ sudo su -
< password >
# ./install
<go through the prompts>
Notes:
- The steps/questions are the same as version 12.0.1, as installation program is still InstallAnywhere. So click <enter> instead of <tab> to accept a setting, and use "0" to get to the end of the license fine print page.
- Since my server has been upgraded over the years, the executable path still shows an IBM based one. Update if yours if different. We also use /local/notesdata for our data path. Also, our Domino server user id is notes.
- Major releases typically do NOT have a directory upgrade, so there is no danger of the server "hang" waiting on the answer to answer 'Y' to upgrade the Domino Directory. Therefore, we'll start the service directly after both the Domino and Traveler add-on installations.
In-Place Traveler Upgrade from 14.0.x to 14.5.0:
4. The installer.properties file for our environment was already updated, so ready to install:
# cd /home/myadmin/Downloads/trav145
# ./TravelerSetup -f /home/myadmin/Downloads/trav1202/installer.properties -i silent -l en
The install will notify you that you are upgrading from Traveler 14.0.0.x to 14.5.0.0, and confirm the paths.
Once done, it should print Installation completed successfully.
Verify it started okay:
$ sudo systemctl status domino.service
<view output and confirm service green and the tasks are all listed>
7. Verify the Traveler service via a web browser:
Open a browser to:
https://myserver.mindwatering.com/traveler
<login>
Success:
Traveler server is available.
iPhone 8 Plus with Device ID ABDCCC123S4PVRCG49ABCUL1D123: Last synced at Thursday, June 3, 2021 5:40:36 PM EDT and no sync requests from the server are pending.
iPhone 11 with Device ID 123ABDC1QIP2DH1ABC2O3ASL9234: Last synced at Thursday, June 3, 2021 5:40:36 PM EDT and no sync requests from the server are pending.
7b. Verify on the iPhone:
Navigate to a mail folder, and you should quickly see the "updated now" message.
We also checked with the iPhones and verified we could see mail, delete mail, and read mail.
7c. Verify on the Domino Administrator console:
> show traveler status
<confirm that Traveler reports GREEN>
__________________
Ubuntu 24 Notes for Upgrade if from Domino 10 / Domino 11 / Domino 12 to Domino 12.0.2.x
- WARNING -
Ubuntu is supported Linux OS/distro for HCL Domino finally, but they assume you know how to tweak a few things.
If you are running /bin/sh instead of /bin/bash, you must switch your your shell to bash.
Starting with HCL Domino
In-Place HCL Domino Upgrade - Unexpected Operator Error Running ./install Script:
Cause:
The install script needs to have it's /bin/sh swapped out for /bin/bash. This should have been done already, but if you are on Ubuntu 18 or have upgraded Ubuntu forever, this will get us Domino shops starting with HCL Domino 10.
Example Error:
# /home/myadmin/tmp/linux64# ./install
./install: 44: [: /home/myadmin/tmp/linux64/tools/-E: unexpected operator
./install: 51: [: /home/myadmin/tmp/linux64/tools/-e: unexpected operator
./install: 57: [: /home/myadmin/tmp/linux64/tools/-e: unexpected operator
./install: 1: .: -e: not found
Resolution:
# /home/myadmin/tmp/linux64# rm /bin/sh
# /home/myadmin/tmp/linux64# ln -s /bin/bash /bin/sh
Uninitialized values Issue:
Example Error:
The checkminimumos.pl script will complain about null/uninitialized variables/values.
# /home/myadmin/tmp/linux64# ./install
Use of uninitialized value $tmpStr in pattern match (m//) at /home/sysadmin/tmp/linux64/tools/checkminimumos.pl line 242.
Use of uninitialized value $linuxStr in scalar chomp at /home/sysadmin/tmp/linux64/tools/checkminimumos.pl line 243.
Use of uninitialized value $linuxStr in string eq at /home/sysadmin/tmp/linux64/tools/checkminimumos.pl line 245.
Use of uninitialized value in concatenation (.) or string at /home/sysadmin/tmp/linux64/tools/checkminimumos.pl line 253.
Resolution:
They can be ignored.
Continue with the rest of the steps.
__________________
Issue:
Domino Traveler status is Yellow after Upgrade from Traveler 14.0 to Traveler 14.5.0
tell traveler status
...
02/26/2026 11:38:39 PM Traveler: Yellow Status Messages
02/26/2026 11:38:39 PM Traveler: Server log level is INFO which is lower than the recommended level of FINE and should only be used for special circumstances. Increase the log level using the command "tell traveler log <newlevel>".
02/26/2026 11:38:39 PM Traveler: The overall status of Traveler is Yellow.
Solution:
We were so used to Yellow being disk space issues, or table issues, etc. we had not seen it for the log level. At first, FINE log level looked more fine, like debug. After staring at it for a few seconds, it hit us - that is why the status is yellow.
Enter on the console:
> tell traveler log level FINE
> tell traveler status
02/26/2026 11:39:52 PM Traveler: The overall status of Traveler is Green.
previous page
|