| For links to general information about program conversion and preparing to upgrade the operating system to i5/OS V6R1, see Lotus Domino for i5/OS V6R1 Planning.
This document should be used if you have not yet upgraded to i5/OS V6R1.
If you are planning to install Lotus Domino or other related products on a system that is already running V6R1, see i5/OS V6R1: Installing Lotus Domino and related products (technote #1295455 ). It includes important information about managing program conversion during installation. | Follow the steps described here to help ensure that Lotus Domino and related products are ready for the operating system upgrade to V6R1, minimizing disruption for your users.
This document contains the following sections:
Prepare Lotus products for upgrade to i5/OS V6R1
Pre-upgrade Checklist
Post-upgrade Product Conversion
There are separate sections below for each of the following:
Lotus Domino
Lotus Domino Document Manager
Lotus Enterprise Integrator®
Lotus Quickr™ or QuickPlace®
Lotus Sametime®
Lotus Sametime Gateway
Lotus Workflow®
IBM Integrated Domino Fax®
Note: The information in this document does not necessarily reflect all Lotus product releases that have shipped since i5/OS V6R1 became available in March, 2008. To determine the V6R1 compatibility characteristics of releases that are not listed here, see the Lotus Software for i5/OS Compatibility Guide.
Remember to consider Domino related third-party products you are using, such as spam filtering services. These may also require updates when you upgrade Lotus Domino or related products for V6R1.
1. Use the table below to determine whether you already have a Domino release installed that is supported on i5/OS V6R1.
2. If necessary, install a V6R1-compatible version of Domino and any required fixes. Make sure you install a level of Domino that is compatible with any other Lotus products or Domino applications you are using. More information is available in later sections.
3. If plan to use Domino 7.0.3, install the Domino 7.0.3 fix or fixpack required for V6R1 (technote #1295540).
Lotus Domino Releases supported on V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Additional Information | | Domino 8.5 | Resource ID: 5733L85 Options: *BASE plus options 1 and 10 | -- Domino 8.5 is built to install and run on IBM i 6.1, so program conversion is not required when installing Domino 8.5 on i 6.1. However, program conversion occurs and is mandatory when upgrading a Domino 8.5 installation from IBM i 5.4 (V5R4) to i 6.1 (V6R1). This conversion can be avoided by waiting to install Domino 8.5 until after you have upgraded the operating system to 6.1. For more information, see Domino 8.5 for i: Program Conversion (technote #7013152). | | Domino 8.0.1 or 8.0.2 | Resource ID: 5733LD8 Options: *BASE plus options 1 and 11 (8.0.1) or options 1 and 12 (8.0.2) |  | | Domino 7.0.4 | Resource ID: 5733LD7 Options: *BASE plus options 1 and 14 | | | Domino 7.0.3 | Resource ID: 5733LD7 Options: *BASE plus options 1 and 13 | Domino 7.0.3 requires a fix or fix pack to run on V6R1. See Enabling Lotus Domino 7.0.3 for i5/OS V6R1 (technote #1295540). |
4. Determine the Domino release currently used by each server on the system. (Run WRKDOMSVR command and press F11.)
5. Before upgrading to V6R1, update each server to a V6R1-compatible Domino release (UPDDOMSVR command).
Caution: Before updating a Domino server that is running any of the following products, consult the section below for more information:
Lotus Domino Document Manager
Lotus Enterprise Integrator
Lotus Quickr or QuickPlace
Lotus Sametime
Lotus Sametime Gateway
Lotus Workflow
IBM Integrated Domino Fax
6. (Optional) Remove any obsolete Domino servers that you do not plan to upgrade by running the following command:
CFGDOMSVR SERVER(<server_name>) OPTION(*REMOVE)
7. Once all of your Domino servers have been updated to a V6R1-compatible release, delete any other Domino versions that are still installed but are not being used.
Domino Releases
NOT supported for V6R1 | Resource
ID | Instructions to Delete | Domino R5,
all options | 5769LNT | Run the following command to delete all product options: DLTLICPGM LICPGM(5769LNT) | Domino 6.0.x,
all options | 5733LD6 | Run the following command to delete all product options: DLTLICPGM LICPGM(5733LD6) | Domino 6.5.x,
all options | 5733L65 | Run the following command to delete all product options: DLTLICPGM LICPGM(5733L65) | | Domino 7.0.x opt 10: Domino 7.0 opt 11: Domino 7.0.1 opt 12: Domino 7.0.2 | 5733LD7 | If you are still using Domino 7.0.3, run only the following commands to delete the options that are not supported on V6R1: DLTLICPGM LICPGM(5733LD7) OPTION(10)
DLTLICPGM LICPGM(5733LD7) OPTION(11)
DLTLICPGM LICPGM(5733LD7) OPTION(12) If you are no longer using any Domino 7.0.x release, run the following command to delete all product options: DLTLICPGM LICPGM(5733LD7) | Domino 8.0.x
opt 10: Domino 8.0 | 5733LD8 | Run the following command to delete options that are not supported on V6R1: DLTLICPGM LICPGM(5733LD8) OPTION(10) |
1. Use the table below to determine whether you are already using a Domino Document Manager release supported on i5/OS V6R1.
2. If your Domino Document Manager release is not supported on V6R1, upgrade to Domino Document Manager 7.0. Consult the Lotus Domino Document Manager documentation for upgrade instructions. As part of the upgrade process, be sure to update your Domino Document Manager servers to a V6R1-compatible version of Domino
3. If your Domino Document Manager release is supported on V6R1, determine whether each server running DDM is using a V6R1-compatible release of Domino. If necessary, run UPDDOMSVR to update the Domino release for the Domino server hosting Document Manager.
4. Install the Domino Document Manager fix required for V6R1 (see link in table for more information).
Lotus DDM Releases supported for V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Compatible Domino Release for V6R1 | Additional Information | | Domino Document Manager 7.0 | 5724J25 | Domino 7.0.4 or Domino 7.0.3 (with required fix) | -- DDM 7.0 requires an enabling fix to run on V6R1, see Enabling Lotus Domino Document Manager 7.0 for i5/OS V6R1 (technote #1295352 ). -- To upgrade to DDM 7.0 from an earlier release, see the Lotus Domino Document Manager 7.0 Installation Guide available from the Lotus DDM documentation site. |
1. Use the table below to determine whether you are already using an LEI release supported on i5/OS V6R1.
2. If your LEI release is not supported on V6R1, upgrade to a supported release. Consult the LEI product documentation for upgrade instructions. As part of the upgrade process, be sure to update your servers to a V6R1-compatible version of Domino and verify that the necessary prequisite software is installed. See Prequisites for installing Lotus Enterprise Integrator on V5R4 or V6R1 (technote #1299738).
3. If you are planning to install LEI with Domino and a Language pack, one of the following procedures can be used:
-- Option 1: Install Domino plus required fixes. Convert the Domino programs to i 6.1 if conversion was not done automatically during install. Install the Domino Language pack. Upgrade your Domino server(s) and start the server. Install LEI (the Domino server must be active in order to install LEI).
-- Option 2: Install Domino plus required fixes. Convert the Domino programs to i 6.1 if conversion was not done automatically during install. Upgrade your Domino server(s) and start the server. Install LEI (the Domino server must be active in order to install LEI). End the Domino server(s). Install the Domino Language pack.
LEI Releases
supported for V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Compatible Domino Release for V6R1 | Additional Information | | Lotus Enterprise Integrator 8.5 | Resource ID: 5733LEI Options: *BASE plus option 19 Release:
V8R5M0 | Domino 8.5 | -- To upgrade to LEI 8.5 from an earlier release, see the IBM Lotus Enterprise Integrator for Domino Installation Guide at the LEI documentation site. | | Lotus Enterprise Integrator 8.0.2 | Resource ID: 5733LEI Options: *BASE plus option 15 Release: V8R0M2 | Domino 8.0.2 | -- To upgrade to LEI 8.0.2 from an earlier release, see the IBM Lotus Enterprise Integrator for Domino Installation Guide at the LEI documentation site. | | Lotus Enterprise Integrator 8.0.1 | Resource ID: 5733LEI Options: *BASE plus option 15 Release: V8R0M1 | Domino 8.0.1 | -- To upgrade to LEI 8.0.1 from an earlier release, see the IBM Lotus Enterprise Integrator for Domino Installation Guide at the LEI documentation site. | | Lotus Enterprise Integrator 7.0.4 | Resource ID: 5733LEI Options: *BASE plus option 17 Release: V7R0M4 | Domino 7.0.4 | -- To upgrade to LEI 7.0.4 from an earlier release, see the IBM Lotus Enterprise Integrator for Domino Installation Guide at the LEI documentation site. | | Lotus Enterprise Integrator 7.0.3 | Resource ID: 5733LEI Options: *BASE plus option 14 Release: V7R0M3 | Domino 7.0.3 with required fix | -- Note that LEI 7.0.3 and 8.0 share the same product option number so verify that the release for option 14 is V7R0M3 and not V8R0M0. For more information, see Technote #1283601 .
-- To upgrade to LEI 7.0.3 from an earlier release, see the IBM Lotus Enterprise Integrator for Domino Installation Guide at the LEI documentation site. |
1. Use the table below to determine whether you are already using a Lotus Quickr or QuickPlace release supported on i5/OS V6R1.
2. If your Quickr or QuickPlace release is not supported on V6R1, upgrade to a version compatible with V6R1. Consult the Lotus Quickr or QuickPlace product documentation for upgrade instructions. As part of the upgrade process, be sure to update your Quickr or QuickPlace servers to a V6R1-compatible version of Domino. Also, install the Quickr or QuickPlace enabling fix for the Domino release if one is required (see table below).
3. If your Quickr or QuickPlace release is supported on V6R1, determine whether the servers are running a V6R1-compatible release of Domino. If necessary, install the required enabling fix for the Domino release and run UPDDOMSVR to update each server (see table below).
4. If you will use QuickPlace 7.0 on V6R1, also install the QuickPlace fix required for V6R1(technote #1295385).
Lotus Quickr & QuickPlace Releases supported for V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Compatible Domino Release for V6R1 | Additional Information | | Lotus Quickr 8.1 | Resource ID: 5724S31 Options: *BASE Release: V8R1M0 | Domino 8.0.1 or 8.0.2 | -- Lotus Quickr 8.1 requires an enabling fix to run on Domino 8.0.2. See About "Lotus Quickr 8.1 i5/OS Enabling Fix for Domino 8.0.x" (technote #1316470 ). | | Lotus Quickr 8.0.0.2 | Resource ID: 5724S31 Options: *BASE Release: V8R0M0 | Domino 7.0.4
or
Domino 7.0.3
with required fix | -- To determine whether 8.0 or 8.0.0.2 is installed, check the following directory for a file called QKR8002:
/qibm/proddata/lotus/quickplace/
(QKR8002 does not exist in Quickr 8.0.) -- Lotus Quickr 8.0.0.2 requires an enabling fix to run on Domino 7.0.3 or 7.0.4; see technote #1285465.
-- To upgrade to Quickr 8.0.0.2 from Quickr 8.0, see 8.0.0.2: Lotus Quickr version 8.0 fix pack 1 (document #4017250). | | Lotus Quickr 8.0 | Resource ID: 5724S31 Options: *BASE Release: V8R0M0 | Domino 7.0.3
with required fix | -- To determine whether 8.0 or 8.0.0.2 is installed, check the following directory for a file called QKR8002:
/qibm/proddata/lotus/quickplace/
(QKR8002 does not exist in Quickr 8.0.) -- Lotus Quickr 8.0 requires an enabling fix to run on Domino 7.0.3; see technote #1289433 -- Lotus Quickr 8.0 is not supported on Domino 7.0.4. -- To upgrade to Quickr 8.0 from an earlier release, see the IBM Lotus Quickr Version 8.0 Information Center available at the Lotus Quickr documentation site. | | QuickPlace 7.0 | Resource ID: 5724J24 Options: *BASE Release: V7R0M0 | Domino 7.0.3
with required fix | -- QuickPlace 7.0 requires 2 fixes:
- An enabling fix to run on Domino 7.0.3
- An enabling fix to run on V6R1.
See Enabling Lotus QuickPlace 7.0 for i5/OS V6R1 (technote #1295385). -- QuickPlace 7.0 is not supported on Domino 7.0.4. -- If upgrading to QuickPlace 7 from an earlier release, see the Lotus QuickPlace 7.0 Installation and Upgrade Guide available at the Lotus Quickr documentation site. | 1. Use the table below to determine whether you are already using a Sametime release supported on i5/OS V6R1.
2. If your Sametime release is not supported on V6R1, upgrade Sametime to version 7.5.1 or later. Consult the Lotus Sametime product documentation for upgrade instructions. As part of the upgrade process, be sure to update your Sametime servers to a V6R1-compatible version of Domino.
3. If your Sametime release is supported on V6R1, determine whether each Sametime server is running a V6R1-compatible release of Domino. If necessary, run UPDDOMSVR to update the Domino release.
4. If you are using Sametime 7.5.1, install the Sametime 7.5.1 updates required for V6R1 (see table below).
Lotus Sametime Releases supported for V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Compatible Domino Release for V6R1 | Additional Information | | Sametime 8.0, 8.0.1 or 8.0.2 | Resource ID: 5724J23 Options: *BASE plus option 1 for Sametime Standard Release: V8R0M0 | Domino 8.0.1, 8.0.2, Domino 7.0.4, or Domino 7.0.3 (with required fix) | -- To upgrade to Sametime 8.0.x from an earlier release, see the Lotus Sametime 8 Information Center , available at the Lotus Sametime documentation site. | | Sametime 7.5.1 | Resource ID: 5724J23 Options: *BASE plus option 1 for Sametime Standard Release: V7R5M1 | Domino 7.0.4 or Domino 7.0.3
(with required fix) | -- Installation of fixes is required for running on V6R1. As of June 26, 2008, 7.5.1 CF2 is available and recommended. It includes ALL of the necessary updates for running on V6R1.
Note Prior to availability of 7.5.1 CF2, it was necessary to permanently apply 7.5.1 CF1 and then install a separate enabling fix for V6R1. This environment is still supported but installation of 7.5.1 CF2 is preferred. -- See Enabling Lotus Sametime 7.5.1 for i5/OS V6R1 (technote #1295262). -- To upgrade to Sametime 7.5.1 from an earlier release, see Installing and Managing Lotus Sametime 7.5.1 for i5/OS at the Lotus Sametime documentation site. |
Lotus Sametime Gateway 8.0 is the minimum version supported on V6R1. It supports both Sametime 8 and Sametime 7.5.1 servers.
If you are running an earlier release of Sametime Gateway, upgrade to Sametime Gateway 8.0.x. For upgrade information, see the Lotus Sametime 8 Information Center available at the Lotus Sametime documentation site.
Lotus Workflow 7.0 is the minimum version supported on V6R1.
1. If you are running an earlier release of Workflow, upgrade to Lotus Workflow 7.0. For upgrade information, see the Lotus Workflow 7.0 Installation Instructions available at the Lotus Workflow documentation site.
2. If your Workflow release is supported on V6R1, determine whether it is running on a V6R1-compatible release of Domino. If necessary, run UPDDOMSVR to update the Domino release.
1. Use the table below to determine whether you are already using a Domino Fax release supported on i5/OS V6R1.
2. If your Domino Fax release is not supported on V6R1, upgrade Domino Fax to version V4R5. Consult the Domino Fax product documentation for upgrade instructions. As part of the upgrade process, be sure to update your Domino Fax servers to a V6R1-compatible version of Domino.
3. If your Domino Fax release is supported on V6R1, determine whether each Domino Fax server is running a V6R1-compatible release of Domino. If necessary, run UPDDOMSVR to update the Domino release.
4. Install the latest available fixes for Domino Fax V4R5.
Integrated Domino Fax Releases supported for V6R1 | DSPSFWRSC information
(F11 to display libraries and releases) | Compatible Domino Release for V6R1 | Additional Information | | Domino Fax V4R5 | Resource ID: 5733FXD Options: *BASE Release: V4R5M0 | Domino 8.0.1, 8.0.2, or Domino 7.0.3 with required fix | -- Install the latest available fixes for Integrated Domino Fax V4R5. -- If you need to upgrade to Domino Fax V4R5 from an earlier release, see the Domino Fax V4R5 Administrator’s Guide, at the Domino Fax documentation site. |
Before upgrading the operating system to V6R1, verify the following:
Before using any Domino commands (for example, WRKDOMSVR, STRDOMSVR and CFGDOMSVR) or using any of the related Lotus products, run the i5/OS commands shown in the table below to force program conversion for each installed product.
If you do not convert the product libraries first, program conversion will occur automatically when each product is first used. Due to the potentially lengthy program conversion process, typical server operations may appear as hang conditions, time-outs or may end abnormally if program conversion is started as the result of a "first-touch" server operation. Expect the STROBJCVN command to complete in a few minutes for some products, but it can run up to 3 hours or longer for Domino depending on the system performance characteristics (such as processor speed, number of processors, memory available and other system activity).
Note: The STROBJCVN command can be run interactively from a command line or submitted to batch using the SBMJOB command. Batch mode is highly recommended for the Domino libraries because the conversion process can run for a long time, but batch mode can be used for any of the products.
- To run program conversion in batch mode:
SBMJOB CMD(STROBJCVN OPTION(*CONVERT) LIB(<library_name>) )
- As instructed previously, do not run any Domino commands until Domino product conversion is complete. You can check whether the LIBNOTES service program has been converted by running the following command:
DSPSRVPGM <Domino_program_library>/LIBNOTES
Page down to the "Service program statistics" information and locate the "Conversion required" entry. A value of *NO indicates that conversion is either not required or the service program is already converted. A value of *YES indicates that conversion is required or has not yet completed. Only run Domino commands if the conversion required value is "*NO".
Product | Command to convert programs | | Lotus Domino 8.5 | Batch mode is recommended: SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO850)) Notes:
-- Additional Domino product libraries QNOTES and QNOTESAPI are relatively small and can be converted on first-touch without any noticable impact. STROBJCVN may be used, but is not required. -- Domino 8.5 is built to install and run on IBM i 6.1, so program conversion is not required when installing Domino 8.5 on i 6.1. However, program conversion occurs and is mandatory when upgrading a Domino 8.5 installation from IBM i 5.4 (V5R4) to i 6.1 (V6R1). This conversion can be avoided by waiting to install Domino 8.5 until after you have upgraded the operating system to 6.1. For more information, see Domino 8.5 for i: Program Conversion (technote #7013152). | | Lotus Domino 8.0.2 or 8.0.1 | Batch mode is recommended. For Domino 8.0.2:
SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO802)) For Domino 8.0.1:
SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO801)) Note: Additional Domino product libraries QNOTES and QNOTESAPI are relatively small and can be converted on first-touch without any noticable impact. STROBJCVN may be used, but is not required. | | Lotus Domino 7.0.4 or 7.0.3 | Batch mode is recommended: For Domino 7.0.4:
SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO704)) For Domino 7.0.3:
SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO703)) Note: Additional Domino product libraries QNOTES and QNOTESAPI are relatively small and can be converted on first-touch without any noticable impact. STROBJCVN may be used, but is not required. | | Lotus Domino Document Manager 7.0 | STROBJCVN OPTION(*CONVERT) LIB(QDOMDOC) | | LEI 8.0.1, 8.0.2, or 8.5 | STROBJCVN is not required if you have already run the STROBJCVN command for the corresponding Domino release library (QDOMINO801, QDOMINO802 or QDOMINO850). | | LEI 7.0.4 or 7.0.3 | STROBJCVN is not required if you have already run the STROBJCVN command for the corresponding Domino release library (QDOMINO704 or QDOMINO703). | | Lotus Quickr 8.0.x or QuickPlace 7.0 | STROBJCVN OPTION(*CONVERT) LIB(QQPLACE) | | Lotus Sametime 8.0, 8.0.1 or 7.5.1 | STROBJCVN OPTION(*CONVERT) LIB(QSAMETIME) | | Lotus Sametime Gateway 8.0 or 8.0.1 | Not applicable. (Gateway does not contain programs that require conversion.) | | Lotus Workflow 7.0 | Not applicable. (Lotus Workflow does not contain programs that require conversion.) | | IBM Integrated Domino Fax V4R5 | STROBJCVN OPTION(*CONVERT) LIB(QDOMFXD) |
Additional Program Conversion considerations This technote describes 3 categories of products:
Product
Category | Description | Products | I. | Products that are built to install and run on IBM i 5.4 without program conversion, but require conversion when installing on i 6.1. | All products described in this document other than those specifically listed in below in Category II. or III. | II. | Products that are built to install and run on IBM i 6.1 without program conversion, but require conversion when installing on i 5.4. | -- Lotus Domino 8.5
-- LEI 8.5 | III. | Products that do not contain programs that require conversion in any situation. | -- Lotus Sametime Gateway
-- Lotus Workflow | For products in category I: Once the program objects have been converted to run on i5/OS V6R1, moving the objects back to a V5 system will make it necessary to run conversion again. For example, if you upgrade to i5/OS V6R1, convert the Domino 8.0.x product library, save the Domino product and then restore the converted product on a V5 system, program conversion is required before you can run the product. It is preferable to use the original product media when installing these products on a V5 system in order to avoid the long conversion time.
For products in category II: Once the program objects have been converted to run on i5/OS V5R4, upgrading to V6R1 or moving the objects to a V6R1 system will make it necessary to run conversion again. For example, if you install Domino 8.5 on a V5R4 system, convert the Domino 8.5 product library and then upgrade to V6R1, program conversion is again required before you can run the product. Likewise, if you save the Domino 8.5 product from a V5R4 system and then restore the converted product on a V6R1 system, program conversion is again required. To avoid the long conversion time, it is preferable to install Domino 8.5 after you have upgraded the system to i 6.1. Likewise, it is best to use the original product media when installing these products on a V6 system rather than media that was saved from a V5R4 system. For more information, see Domino 8.5 for i: Program Conversion (technote #7013152). |
