| This technote pertains only to new installs of Lotus products on a system running i5/OS® V6R1. If you are upgrading a current installation from V5 to i5/OS V6R1, see i5/OS V6R1 upgrade roadmap for Lotus Domino and related products (technote #1294587 ).
For additional information about i5/OS V6R1, see Lotus Domino for i5/OS V6R1 Planning. |
When installing one of the products listed below, your main source of information is the installation guide for that product. See Lotus documentation. This technote only provides information about special considerations when installing on i5/OS V6R1.
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.
This document contains the following sections:
- Summary of installation considerations
- Program conversion recommendations
- Controlling program conversion during installation
- Running program conversion manually after installation
- Program Conversion on i5/OS V5
Summary of installation considerations
Releases supported on V6R1 | Compatible Domino Release | Special Considerations and Additional Information | | Lotus Domino 8.5 | N/A | -- Program conversion is not required when installing Domino 8.5 on IBM i 6.1 (V6R1). However, program conversion is mandatory when: -- installing Domino 8.5 on i 5.4 (V5R4), or
-- upgrading a Domino 8.5 installation from i 5.4 to i 6.1 For more information, see Domino 8.5 for i: Program Conversion (technote #7013152). | | Lotus Domino 8.0.1 or 8.0.2 | N/A | -- Consider deferring program conversion until after product install. Do not run Domino commands until conversion is complete. See "Running program conversion manually after installation," later in this document. | | Lotus Domino 7.0.3, or 7.0.4 | N/A | -- Highly recommended that you defer program conversion during installation. Do not run Domino commands until conversion is complete. See "Running program conversion manually after installation," later in this document.
-- Domino 7.0.3 requires a hot fix or fix pack to run on V6R1. See Enabling Lotus Domino 7.0.3 for i5/OS V6R1 (technote #1295540). | | Lotus Domino Document Manager 7.0 | Domino 7.0.4 or 7.0.3 with required fix | -- DDM 7.0 requires an enabling fix to run on V6R1.
-- To avoid install failure, follow steps in technote #1295352 , Enabling Lotus Domino Document Manager 7.0 for i5/OS V6R1. | | Lotus Enterprise Integrator 8.5 | Domino 8.5 | -- Program conversion is not required when installing LEI 8.5 on IBM i 6.1 (V6R1). However, program conversion is mandatory when: -- installing LEI 8.5 on i 5.4 (V5R4), or
-- upgrading an LEI 8.5 installation from i 5.4 to i 6.1 See Prequisites for installing Lotus Enterprise Integrator on V5R4 or V6R1 (technote #1299738). | | Lotus Enterprise Integrator 8.0.2 | Domino 8.0.2 | -- See Prequisites for installing Lotus Enterprise Integrator on V5R4 or V6R1 (technote #1299738). | | Lotus Enterprise Integrator 8.0.1 | Domino 8.0.1 | | Lotus Enterprise Integrator® 7.0.4 | Domino 7.0.4 | -- See Prequisites for installing Lotus Enterprise Integrator on V5R4 or V6R1 (technote #1299738). | | Lotus Enterprise Integrator® 7.0.3 | Domino 7.0.3 with required fix | | Lotus Quickr® 8.1 | 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 | Domino 7.0.4 or Domino 7.0.3
with required fix | -- Lotus Quickr 8.0.0.2 requires an enabling fix to run on Domino 7.0.3 or Domino 7.0.4; see technote #1285465. | | Lotus Quickr 8.0 | Domino 7.0.3
with required fix | -- 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. | | Lotus QuickPlace® 7.0 | 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. -- QuickrPlace 7.0 is not supported on Domino 7.0.4. -- To avoid install failure, follow steps in technote #1295385, Enabling Lotus QuickPlace 7.0 for i5/OS V6R1. | | Lotus Sametime® 8.0, 8.0.1 or 8.0.2 | Domino 8.0.1, 8.0.2, 7.0.4 or 7.0.3 with required fix |  | Lotus Sametime
Gateway 8.0, 8.0.1 or 8.0.2 | N/A | -- For special considerations when installing on V6R1, see About Lotus Sametime Gateway and i5/OS V6R1 (technote #1295898). | | Lotus Sametime 7.5.1 | Domino 7.0.4 or 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. -- Follow the steps in technote #1295262, Enabling Lotus Sametime 7.5.1 for i5/OS V6R1. -- Sametime Gateway 7.5.1 is not supported on V6R1. Sametime Gateway 8.0 supports both 8.0 and 7.5.1 Sametime servers. | | Lotus Workflow® 7.0 | Domino 8.0.1 or 8.0.2 | | | IBM Integrated Domino Fax V4R5 | 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. |
Program conversion recommendations If program conversion occurs during the installation of Domino on i5/OS V6R1, the process may take significantly longer to complete than in previous releases due to the size of the service programs in the product. Conversion is a long-running process that may take from 10 to 90 minutes or longer. The actual time needed to complete the conversion depends on the performance characteristics of the system, including: speed of the processor, number of processors, priority of the job, disk arms attached, memory available, and other system activity.
In certain cases, it is best to avoid runnning program conversion during product installation and then run it manually afterwards:
- Domino 7.0.3: You need to install a fix or fix pack after installing Domino 7.0.3 on V6R1 (see the Domino 7 i5/OS Support site). It is highly recommended that you defer conversion when installing the product, install the fix, and then run program conversion manually. If you run program conversion when you install the product, you will need to run it again after installing the fix.
- Domino Document Manager 7.0 and QuickPlace 7.0 each contain a program that cannot be converted. If program conversion is attempted during installation, the install will fail. See table above for more links to more information for these products.
Of course, you may decide to defer conversion when installing any of the Lotus products. In this case it is highly recommended that you run program conversion manually before using the product.
Hint: If you are planning to install Domino release prior to 8.5 on several V6R1 systems, you can reduce the conversion impact by installing the product on one system, applying fixes if necessary, completing program conversion, and then saving the Domino product. When you use the saved Domino product for installation on your other V6R1 systems, program conversion is not necessary.
Note! If you deferred program conversion when installing a Domino release prior to 8.5, do not use any of the Domino commands until after you have run program conversion manually. When the programs have not yet been converted, conversion is started when you run one of the commands (STRDOMSVR, CFGDOMSVR, CHGDOMSVR, UPDDOMSVR). Because Domino conversion is a long-running process, this can appear to be a hang condition or may prevent the server from starting successfully due to time-outs. The result depends on the performance characteristics of your system.
More detailed information is provided in the following two sections of this document:
Controlling program conversion during installation
Running program conversion manually after installation
Controlling program conversion during installation
Whether or not program conversion occurs during product installation is typically controlled by:
1. The QFRCCVNRST (Force conversion on restore) system value. To view or change the system value, run the following command:
2. The FRCOBJCVN keyword value on the RSTLICPGM command.
Domino provides an additional method for deferring program conversion when using one of the interactive install methods (setup.exe or LODRUN). You can defer program conversion by creating a data area called QNNICVNRST in library QUSRSYS. If the data area exists, objects are not converted when installing Domino using setup.exe or LODRUN. Note that the data area is not used for installs using RSTLICPGM or for any products other than Domino.
To create the data area QNNICVNRST in library QUSRSYS, run the following command:
CRTDTAARA DTAARA(QUSRSYS/QNNICVNRST) TYPE(*CHAR) LEN(10 1) VALUE(V6R1)
The following table summarizes the settings you can use to control whether or not program conversion occurs during product installation:
Convert
during Install? | Install Method | QFRCCVNRST
System Value | Domino *DTAARA (*) | | Install from save file using RSTLICPGM command | | Convert | RSTLICPGM with
FRCOBJCVN(*SYSVAL) | 2 or greater
All objects will be converted | n/a | | Convert | RSTLICPGM with
FRCOBJCVN(*YES *RQD) | Any
All objects will be converted if required. | n/a | | Defer conversion | RSTLICPGM with
FRCOBJCVN(*SYSVAL) | 0 = Do not convert anything | n/a | | Defer conversion | RSTLICPGM with
FRCOBJCVN(*NO) | FRCOBJCVN(*NO) is only allowed when QFRCCVNRST is set to "0" or "1" | n/a | | Install from CD using LODRUN command | | Convert | LODRUN using CD | For Domino: 2 or greater
All objects will be converted | QUSRSYS/QNNICVNRST does not exist | For non-Domino: 2 or greater
All objects will be converted | n/a | | Defer conversion | LODRUN using CD | For Domino:
Any setting | QUSRSYS/QNNICVNRST exists | For non-Domino:
0 = Do not convert anything | n/a | | Install from Web kit or CD using SETUP.EXE (Domino only) | | Convert | SETUP.EXE using Web kit or CD | 2 or greater
All objects will be converted | QUSRSYS/QNNICVNRST does not exist | | Defer conversion | SETUP.EXE using Web kit or CD | Any | QUSRSYS/QNNICVNRST exists | * To create the *DTAARA QNNICVNRST in library QUSRSYS to defer program conversion during Domino install using LODRUN or SETUP.EXE, run the following command:
CRTDTAARA DTAARA(QUSRSYS/QNNICVNRST) TYPE(*CHAR) LEN(10 1) VALUE(V6R1) |
Running program conversion manually after installation
If you deferred program conversion during product installation, use the commands in the table below to run it manually.
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. To determine whether conversion is complete for Domino, check whether the LIBNOTES service program has been converted by running the following command:
DSPSRVPGM SRVPGM(<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 | N/A.
Program conversion is not required when installing Domino 8.5 on i 6.1. For more information, see Domino 8.5 for i: Program Conversion (technote #7013152). | | Lotus Domino 8.0.1 or 8.0.2 | Batch mode is recommended: SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO801)) or SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO802)) 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.3 or 7.0.4 | Batch mode is recommended: SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO703)) or SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO704)) 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.5 | N/A.
Program conversion is not required when installing LEI 8.5 on i 6.1. | | LEI 8.0.1 or 8.0.2 | Batch mode is recommended: SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO801)) or SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO802)) | | LEI 7.0.3 or 7.0.4 | Batch mode is recommended: SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO703)) or SBMJOB CMD(STROBJCVN OPTION(*CONVERT)
LIB(QDOMINO704)) | | Lotus Quickr 8.1, 8.0.x or QuickPlace 7.0 | STROBJCVN OPTION(*CONVERT) LIB(QQPLACE) | | Lotus Sametime 8.0, 8.0.1, 8.0.2 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) |
Program Conversion on i5/OS V5 All of the product releases described in this technote (except Domino 8.5 and LEI 8.5) require program conversion on i5/OS V6R1. Some of them also require fixes. For Domino releases prior to 8.5, special considerations are necessary due to the length of time required to convert the product library.
Keep in mind that once program objects have been installed and converted on i5/OS V6R1, moving the objects back to a V5 system will make it necessary to run conversion again. For example, if you install Domino 8.0.x on i5/OS V6R1, convert the 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 on a V5 system in order to avoid the long conversion time.
When installing on V5, the QNNICVNRST data area cannot be used to defer conversion during restore. To defer conversion during restore, use the QFRCCVNRST system value and/or the RSTLICPGM command's FRCOBJCVN keyword as described earlier in "Controlling program conversion during installation." |
