IBM Support

Domino 8.5.x for IBM i: Checklist for upgrading

Technote (FAQ)


What do I need to do before installing or upgrading IBM i servers to Domino 8.5.x?


Refer to the following table for detailed steps to follow to ensure that your IBM i operating system and Lotus Domino server environment are ready to install and or upgrade to Domino version 8.5.x.




Learn how to get started and find information about this product release.

See the technical document:

Verify compatibility with the IBM i operating system release and other Lotus software products.

Refer to the Lotus Software for IBM i operating system Compatibility Guide

Determine if your IBM i system will support running Domino 8.5.x.

See the technical document:

Determine if a compatible OS level is being used, including all of the required licensed programs, options, cumulative PTF packages and group PTFs.

This step includes installing Java 6 Option 11 on IBM i 5.4, i 6.1 or i 7.1.

Domino 8.5.x is supported on i 5.4 and i 6.1.
Domino 8.5.1 is minimum release supported on i 7.1.

See these documents for required software and maintenance:
To obtain 5722JV1 Option 11 for i 5.4:

5722-JV1 Option 11 (JDK 6 32-bit) is available as orderable media in PTF SI30432. Contact your IBM Service Provider to order PTF SI30432 on media.

Before you order and install JDK 6, you must have V5R4M0 5722-JV1 Option *BASE installed on your IBM i server. It is recommended that you also have the latest Java Group PTF SF99291 on hand to obtain the most recent updates.

To obtain 5761JV1 Option 11 for i 6.1 or i 7.1:

5761JV1 Option 11 is available with the IBM i media.

Learn about the new release of Domino

Domino 8.5.1 and later is supported on i 5.4, i 6.1 and i 7.1.

Read the technotes:

If you are running Sametime check the software and hardware requirements.

See the technical document:
Java Option 8 is required if you are running Sametime Community or Sametime Classic servers. Install both the *BASE option and option 8:
    5722JV1 or 5761JV1 *BASE option
    5722JV1 or 5761JV1 Option 8: J2SE 5.0 32bit

If you are running Quickr, check for and install the corresponding enablement fix for this release of Domino PRIOR to upgrading your servers.

See the Web site:

Verify compatibility with any third-party add-on products.

If you are running third-party applications such as anti-virus, spam blockers, administration tools, etc., verify Domino version 8.5.x compatibility with your vendor.

Plan additional time for PROGRAM CONVERSION required:

- when installing Domino 8.5.x on i 5.4


- in select i 6.1 and i 7.1 upgrade

See the technical documents:
RECOMMENDED: Upgrade to IBM i 6.1 or i 7.1 before installing Domino 8.5.x to alleviate the additional time required to convert the Domino product during installation.

Domino 8.5.1 and later releases are supported on i 7.1.

Remove any Domino 8.5.x Beta or pre-Beta servers and software. Upgrade from Beta or pre-Beta software is not supported.

End Beta or pre-Beta servers:
    ENDDOMSVR SERVER(<server-name>) or WRKDOMSVR option 6.

Remove any Domino servers created using Beta or pre-Beta software.
Remove the Beta or pre-Beta software:

Plan for the new Lotus Notes client.

There are two client configurations available: basic and standard. For more information, refer to the Lotus Notes and Domino 8.5 Information Center.

Set a default size for the console log.

When you upgrade to Domino 8 or later release, the console log maximum size is automatically set to 1 KB, if you have not already explicitly set a maximum size in your notes. ini file. It is recommended that you set a maximum size prior to the upgrade so you do not lose valuable debugging information. A value between 100 - 1000 KB is good for most customers.

You can set the maximum size using the console_log_max_kbytes=<kbytes> parameter. A value of 0 means no maximum.

If you do not want console logging enabled, you can disable it with the setting console_log_enabled=0.

Plan for the new ODS level.

Domino version 8.5.0 introduces new ODS level 51. Domino databases are not upgraded to the new ODS level by default, and no conversion is required as part of the upgrade.

For details on Create_R85_Databases=1 and how to upgrade your databases to the new ODS, refer to the Domino 8.5 Information Center
    See the following technical document for changes to the RUNDOMCMD when running COMPACT on Domino 8.5.x for i.

    Plan for using DAOS

    Refer to the DAOS Quick Start Guide and DAOS Best Practices for more information about enabling this feature.

    Use the DAOS Estimator to evaluate your server's attachment sizes and identify the optimum DAOS minimum size.

    Use care when choosing the DAOS minimum size; selecting an attachment size that is too small (for example, the 8.5 default value which is 4K) can result in a large number of .nlo objects which will have a negative impact on the time required for save operations. In Domino release 8.5.1 the default value is changed to 64K. Save operations can be optimized by balancing a smaller number of .nlo objects with a larger minimum attachment size; the default values of 4K and 64K may be too small for many installations.

    Plan to upgrade the design of the Domino Directory (names.nsf) and allow time to rebuild views in names.nsf.

    If you are upgrading the first server in the domain, you also need to upgrade the design of the Domino directory (names.nsf).

    To do so, start the Domino server and answer "Yes" in the Domino console:
      WRKDOMCSL <server_name>

    Plan for any additional upgrade tasks if you are upgrading from a prior release of Domino.

    For example, if you are upgrading from Domino 7.0.x to Domino 8.5, read the documentation and upgrade recommendations for Domino 8 as well as the Domino 8.5 information.

    Become familiar with the new features in Lotus Notes and Domino version 8.5.x

    See the Domino 8.5 InfoCenter:
      New features in IBM Lotus Domino 8.5
      New features in IBM Lotus Notes 8.5
      New features in IBM Lotus Domino Designer 8.5
      New features in IBM Lotus Domino Web Access 8.5

    Obtain necessary hotfix(es)

    Obtain any high impact Domino 8.5.x hot fixes that are available at the time of general availability.

    If you are currently running any hotfixes on earlier releases of Domino, contact Lotus Support to see if you will need a replacement hotfix or if that hotfix is part of the 8.5.x product.

    Note: Hotfixes for the following issues are not required for Domino 8.5.0; they are already incorporated into the release:

    Remove Domino software that is no longer used.

    After the installation of a new release of Domino software and upgrading servers, remove any older versions of the Domino software that are no longer needed. For example, if you have installed Domino 8.5 and upgraded all of your servers to the new release level, remove older versions of Domino (8.0x, 7.0x, 6.5x) that are no longer used.

    Use the DSPSFWRSC command to display the installed Domino versions and options. Use the DLTLICPGM command to remove Domino software that is no longer required.

    Refer to the Technote Upgrade roadmap for Lotus Domino and related products on i 6.1 or i 7.1 for helpful information on removing older versions of the Domino product.

    Improve performance of existing Domino server(s) by removing DECS if it is not required.

    Check existing servers for DECS; configure new servers with CNNSRV(*NONE) if DECS is not required.

    The default value for Connection Services on the CFGDOMSVR command is CNNSRV(*DECS). If you are not using DECS, then remove this task from your existing servers using the CHGDOMSVR command:

    Related information

    Domino 8.5 Information Center
    Lotus Software for IBM i Compatibility Guide
    i5/OS V6R1 upgrade roadmap for Lotus Domino and related
    i5/OS V6R1 Installing Lotus Domino and Related Products
    Domino 8.5 for i: Getting started
    Fix Central
    Sametime for IBM i: System Requirements
    IBM Lotus Quickr for i Support

    Document information

    More support for: IBM Domino

    Software version: 8.5, 8.5.1, 8.5.2, 8.5.3

    Operating system(s): IBM i

    Software edition: All Editions

    Reference #: 1313145

    Modified date: 28 September 2010

    Translate this page: