Specifications

Lotus Redbooks Wiki – IBM Lotus Notes and Domino V8.5 Deployment Guide
110
Steps to create and attach an update kit to the Smart Upgrade database
1. Create a Smart Upgrade database.
2. Create a Smart Upgrade kit (tar file).
3. Open the Smart Upgrade database, click New Kit, complete the form fields, and attach the update
kit to the kit document, or designate a shared network drive in the kit document.
4. Click Save & Close.
The update kit is a tar file that contains several RPM and DEB packages and a shell script
(smartupgrade.sh). During the upgrade process, Notes downloads and decompress the tar package, and
then finds and executes the script . The script must include which RPM or DEB packages are to be
upgraded.
No other file named setup.sh or smartupgrade.sh must be present in the kit folder or sub-folders.
You can create a new folder and put the tar file into it.
Create a new folder, for example notes85standard_linux, and then copy these RPM packages to that folder.
1.
ibm_lotus_notes-8.5.i586.rpm
2. ibm_lotus_sametime-8.5.i586.rpm
3. ibm_lotus_activities-8.5.i586.rpm
4. ibm_lotus_cae-8.5.i586.rpm
5. ibm_lotus_symphony-8.5.i586.rpm
Create a script named smartupgrade.sh in this folder.
SUSE / RedHat: In your smartupgrade.sh file, make sure that all the RPM packages to upgrade are listed in
a single line (no line break) in order to avoid dependency issues.
Ubuntu: In your setup.sh file, list each DEB package to upgrade in its own line (not a single line) and list
ibm_lotus_notes-8.5.i586.deb first.
Package the folder, for example notes85standard_linux, as a tar file.
Limitations
The following limitations apply:
Smart Upgrade can not be used to deploy Cumulative Client Hotfixes (CCH) . Attempting to install
a CCH will cause the Lotus Notes client to no longer start as expected. Once you launch the client,
and enter your password, the following error occurs:
“File does not exist: Files\IBM\Lotus\Notes\notes.exe”
Smart Upgrade from a shared network drive is not supported for a non-admin Notes account on
Windows Vista if UAC is enabled. For details please refer to IBM Technote 1403215
On MacOS, Smart Upgrade can not be used to upgrade from Release 7.0.x or 8.5 Standard Client
to 8.5 / 8.5.1. For details please refer to IBM Technote 1327065
More Information
More information is provided in the following resources
The Lotus Education On Demand: the Lotus Domino/Notes 6 Smart Upgrade Tutorial
The IBM Redpaper “Understanding the Lotus Notes Smart Upgrade, REDP-4180“