HCL Domino 12.0.2 FP3 and Traveler 12.0.2 FP1 In-Place Upgrade from Domino 12.0.1 FPx and Traveler 12.0.1.1.x

Mindwatering Incorporated

Author: Tripp W Black

Created: 06/03/2021 at 05:45 PM

 

Category:
Domino Upgrades / Installations
Software Upgrade

Steps for In-place Upgrade
of HCL Domino 11.0.1 FPx to HCL Domino 12.0.0, including upgrading HCL Traveler services


Notes:
- Linux server OS is CentOS 8, or Ubuntu 20 or Ubuntu 22. 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 are generated by Apple periodically. If you don't desire to update your Traveler software, you can elect to use the HCL patch of just the certificates (e.g. Traveler_APNS_Prod.zip)

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, 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, dom1202. trav1202, and trav1202fp1.

Transferred to the dom1202 folder:
Domino_12.0.2_Linux_English.tar
Domino_1202FP3_Linux.tar

Transferred to the trav1202 folder:
Traveler_12.0.2_Linux_ML.tar.gz

Transferred to the trav1202fp1 folder:
Traveler_12.0.2FP1_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 two Domino install files:
Note: both file extract to linux64 subfolders. Therefore, we rename the folders after extraction.
$ cd /home/myadmin/Downloads/dom1202/
$ pwd
/home/myadmin/Downloads/dom1202/
$ tar -xvf Domino_12.0.2_Linux_English.tar
<watched files extracted>
$ mv linux64 linux64dom1202
$ tar -xvf Domino_12.0.2FP1_Linux_English.tar
<watched files extracted>
$ mv linux64 linux64dom1202fp1

Uncompress the two Traveler install files:
Note: Unlike the Domino tar files, these gz files extract into the same folder the gz file is located.
$ cd /home/myadmin/Downloads/trav1202/
$ tar zxf Traveler_12.0.2_Linux_ML.tar.gz
<watched files extracted>
$ cd /home/myadmin/Downloads/trav1202fp1/
<watched files extracted>
$ tar zxf Traveler_12.0.2FP1_Linux_ML.tar.gz


3. Stopped Domino and Performed the installation.
$ sudo systemctl stop domino.service
<waited>

Performed the install as root user:
$ cd /home/myadmin/Downloads/dom1202/linux64dom1202
$ 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.


4. Repeat the install for the FP.
# cd /home/myadmin/Downloads/dom1202/linux64dom1202fp1
# cd domino/
Set the path variable needed for a FP:
# NUI_NOTESDIR=/opt/ibm/domino
# export NUI_NOTESDIR

Install:
# ./install


In-Place Traveler Upgrade:
5. Updated the installer.properties file for our environment and installed:
# cd /home/myadmin/Downloads/trav1202
# vi installer.properties
- update/verify the program path and the data path.
- - Update them if not correct.
- if your Domino user service account is not notes, uncomment the LINUX_USER_NAME=notes and set to your server's Linux OS name.
- if your Domino user service account is not notes, uncomment the LINUX_GROUP_NAME=notes and set to your server's Linux OS name.
# ./TravelerSetup -f /home/myadmin/Downloads/trav1202/installer.properties -i silent -l en

The install will notify you that you are upgrading from Traveler 12.x to 12.0.2, and confirm the paths.
Once done, it should print Installation completed successfully.

Repeat for the FP:
# cd /home/myadmin/Downloads/trav1202fp1
# vi installer.properties
- update/verify the program path and the data path.
- - Update them if not correct.
- if your Domino user service account is not notes, uncomment the LINUX_USER_NAME=notes and set to your server's Linux OS name.
- if your Domino user service account is not notes, uncomment the LINUX_GROUP_NAME=notes and set to your server's Linux OS name.
# ./TravelerSetup -f /home/myadmin/Downloads/trav1202/installer.properties -i silent -l en

The install will notify you that you are upgrading from Traveler 12.0.2 to 12.0.2 FP1, and confirm the paths.
Once done, it should print Installation completed successfully.

# exit
(back to myadmin user again)


6. Start the Domino server via its service.
$ sudo systemctl start domino.service
<wait a second>

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 18.04 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.

__________________




previous page