Steps for In-place Upgrade
of HCL Domino 12.0.2 FPx to HCL Domino 14.0 FP4, including upgrading HCL Traveler services, with Traveler
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 (hot-fix 9) or Domino 14.0 FP4, when released.)
Notes:
- Linux server OS is RockyOS 8, existing Domino is 64-bit, or course.
- The existing start-up script is the Nashed one.
- See Other Upgrade Notes below for licensing and feature removals.
- Domino 14.0 FP4 is available (2025/04/17) and resolves the router HF. Hot-fixes have to be uninstalled before the next fix-pack, whereas fix-packs can be installed over each other w/o an uninstall of the previous fix-pack.
- In R12, there was a new ini ODS 55 and another for large ACL entries. If you never completed it on your Traveler server, it should be performed. Instructions are at the bottom of this tech-note. If you are skipping over Domino 12 (e.g. Domino 11 to Domino 14), you should perform the instructions after the Domino upgrades and before the Traveler upgrades.
BEFORE YOU START:
Check server drive disk for free drive space (10 GB min)
Write down or memorize the server program and data folders and the user name (e.g. notes) for verification when going through installation prompts
In-Place HCL Domino Upgrade:
1. Using Filezilla, copied the install file to the server in the server's Downloads folder.
Made a few new directories, dom14, dom14FP4, trav14, and trav14FP2.
Transferred to each respective folder:
Domino_14.0_Linux_English.tar
Domino_1400FP4_Linux.tar
Traveler_14.0_Linux_ML.tar.gz
Traveler_14.0.0FP2_Linux_ML.tar.gz
2. Started SSH Terminal to server.
$ ssh myadmin@myserver.mindwatering.com
<enter password>
3. Prepare for upgrade:
a. Confirm disk space:
$ sudo su -
# df -h
<view results>
b. Unpack the tar installation files:
$ cd /home/myadmin/Downloads/dom14/
$ ls -l
<confirm first file is transferred>
Unpack all four directories:
# tar -xvf /home/myadmin/Downloads/dom14/Domino_14.0_Linux_English.tar
<wait for extract>
# tar -xvf /home/myadmin/Downloads/dom14FP4/Domino_1400FP4_Linux.tar
<wait for extract>
# tar -zxf /home/myadmin/Downloads/trav14/Traveler_14.0_Linux_ML.tar.gz
<wait for extract>
# tar -zxf /home/myadmin/Downloads/trav14FP2/Traveler_14.0.0FP2_Linux_ML.tar.gz
<wait for extract>
Note:
- If you are low on space, you can remove the .tar and .tar.gz files now instead of later.
4. Perform the Domino upgrades.
Notes:
- The steps/questions are the same as version 12, 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.
- The installation defaults to /opt/hcl/domino, if you have an older installation location, change it to /opt/ibm/domino. We also use /local/notesdata for our data path. Also, our Domino server user id is notes.
- Major releases always have a directory upgrade, the server "hangs" waiting on the answer. So our first boot into 14 will be manually.
a. Install Domino 14.0:
$ sudo systemctl stop domino.service
<waited>
$ cd /home/myadmin/Downloads/dom1400/linux64
$ ./install
<go through the prompts>
b. Install Domino 14.0 FP4:
$ cd /home/myadmin/Downloads/dom1400/linux64/domino
$ ./install
<go through the prompts>
c. Start the server manually to update design of databases.
$ cd /local/notesdata/
$ su notes -
$ /opt/ibm/domino/bin/server
<The design upgrade occurred automatically. we were no longer prompted to click Y to upgrade>
Notes:
It might take a bit longer for large directories. But for us, it is done in about 30 seconds.
We let the Domino server run for a few minutes and just watched it for any issues.
Shutdown the Domino service.
> q
$ exit
(so we exit the notes user and return to the sudo root user)
In-Place Traveler Upgrade:
5. Upgrade the Traveler add-on:
a. Install Traveler 14.0:
# cd /home/myadmin/Downloads/trav14/
# vi installer.properties
- update/verify the program path and the data path.
- uncomment the LINUX_USER_NAME=notes and set to your server's Linux OS name, if not notes.
- uncomment the LINUX_GROUP_NAME=notes and set to your server's Linux OS name, if not notes.
# ./TravelerSetup -f /home/myadmin/Downloads/dom11/installer.properties -i silent -l en
The install will notify you that you are upgrading from Traveler 12.x to 14.0, and confirm the paths.
Once done, it should print Installation completed successfully.
b. Install Traveler: 14.0 FP2:
# cd /home/myadmin/Downloads/trav14FP2/
# vi installer.properties
- update/verify the program path and the data path.
- uncomment the LINUX_USER_NAME=notes and set to your server's Linux OS name, if not notes.
- uncomment the LINUX_GROUP_NAME=notes and set to your server's Linux OS name, if not notes.
# ./TravelerSetup -f /home/myadmin/Downloads/dom11/installer.properties -i silent -l en
The install will notify you that you are upgrading from Traveler 14.0 to 14.0 FP2, and confirm the paths.
Once done, it should print Installation completed successfully.
# exit
(back to myadmin user again)
Post-Upgrade Checks/Tasks:
6. Start the Domino server manually.
$ cd /local/notedata/
$ su notes
$ /opt/ibm/domino/bin/server
Traveler was running okay, but it displayed the same table error that the 10.x to 11.x upgrade gave us.
9. Fix the Traveler table issue again:
WARNING *system Exception caught trying to create Constraint PK_INVMAP on Table INV_MAP. Exception Thrown: com.lotus.sync.db.PersistenceException: java.sql.SQLSyntaxErrorException: 'DEVUID' cannot be a column of a primary key or unique key because it can contain null
Important:
- The normal fix for the table errors is the traveler tablerepair command. But it didn't work. We used the traveler sql command that we used to use in R9.0.1. Both commands are below.
a. Traveler Tablerepair command:
Since the INV_MAP is not a primary table, it is pretty save to clean-up with:
> tell traveler tablerepair repair * *
<wait>
> q
b. Traveler SQL command:
> tell traveler sql ALTER TABLE inv_map ALTER COLUMN devuid NOT NULL
Repeated running the server manually. No errors displayed. We verified the traveler status for a user.
$ /opt/ibm/domino/bin/server
Open a browser to:
https://myserver.mindwatering.com/traveler
<login>
Success:
Traveler server is available.
iPhone 8 Plus with Device ID ABDCCC123S4ABCDG49ABCUL1D123: Last synced at Thursday, June 3, 2021 5:40:36 PM EDT and no sync requests from the server are pending.
iPhone 6s Plus 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.
We also checked with the iPhones and verified we could see mail, delete mail, and read mail.
No user repair needed to be done.
Stop the manual run of the Domino server:
> q
10. Exit being the notes user, and start the server normally.
$ exit
# systemctl start domino.service
________________
Ubuntu 18.04/20.04/22.04 Notes for Upgrade if from Domino 10/11/12 to Domino 14:
- IMPORTANT -
Ubuntu is not a heavily HCL tested Linux OS/distro for HCL Domino. However, if you are going to do it anyway, below is what you need to do in step 3 above.
We run Ubuntu on our non Mail and App Domino servers because we prefer the in-place upgrade dependability of Ubuntu over CentOS/RockyOS.
In-Place HCL Domino Upgrade:
1 .The install script needs to have it's /bin/sh swapped out.
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
# /home/myadmin/tmp/linux64# rm /bin/sh
# /home/myadmin/tmp/linux64# ln -s /bin/bash /bin/sh
2. The checkminimumos.pl script will complain about null/uninitialized values. They can be ignored.
# /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.
Continue with the rest of the steps.
__________________
Domino 12 or 14 Application ODS Upgrade and Large ACL Update:
1. Switch to the notes user, and update the notes.ini with the new entries.
# su notes -
<enter pwd>
$ vi /local/notesdata/notes.ini
...
Locate the Create_R10_Databases=1 line, and change to Create_R12_Databases=1
If the Create_Rxx_Databases is not there, add this new line at the bottom.
...
Add a new line at the bottom, and enter: NSF_Enable_Large_ACL=1
<esc :wq> to save
2. Update the ODS of the apps on the server. This will take a while. Alternate, you can do just the main system ones, and then do all the rest (e.g. the mail and apps) later.
# su notes -
$ cd /local/notesdata/
$ /opt/ibm/domino/bin/dbmt -ct 24 -ut 8 -ods
Note:
For 100 GB of mail and apps, this takes less than 1 hour. Plan accordingly.
previous page
|