Domino 9.0.x for i: Installation and Upgrade

Technote (FAQ)


Question

How to install and upgrade Domino 9.0.x for i?

Answer

This technote refers to Domino 9.0.x installations and upgrade on IBM i.
Follow the steps below to install Domino 9.0.x and upgrade existing or configure new servers. Refer to Installing and Managing Domino 8 for System i page and download it for more information on Installation, Multi-version support and using commands or System i Navigator to configure and manage Domino servers.

End Domino 9.0.x servers and remove Domino 9.0.x Beta servers and software

Upgrade of Domino 9.0.x Beta software is not supported. End and remove any Beta servers using one of the two methods as described below and remove the Domino 9.0.x Beta software prior to installing the generally available Domino release.

End Domino 9.0.x Beta servers and subsystems using i Navigator:

For details about how to use System i Navigator to display and end Domino servers and subsystems, refer to Chapter 10 "Managing a Domino Server using iSeries Navigator" in Installing and Managing Domino 8 for System i.

End Domino 9.0.x Beta servers and subsystems using IBM i commands:

Use the WRKDOMSVR command to display the status of the servers. Use the ENDDOMSVR command, or option 6 from the WRKDOMSVR panel, to end servers. After all Domino 9.0.x Beta servers and server jobs are ended, check that all related Domino subsystems are also ended. It may take several minutes for the server jobs to end. If a server, or server job, does not end within 10 minutes, use the ENDDOMSVR command with OPTION(*IMMED). After the servers have ended, it may still be necessary to end the Domino 9.0.x Beta subsystems. Use the WRKDOMSVR command to obtain the subsystem name for the server. Then use the ENDSBS command to end the subsystems. For example:

    ENDSBS SBS(QDOMINO01)
    ENDSBS SBS(MYDOMSBS)

Use the WRKACTJOB or WRKSBS command to verify that no Domino 9.0.x Beta subsystems are active.

Remove Domino 9.0.x Beta servers and software

Check that there are no interactive jobs using the WRKDOMSVR command by using the following command to verify there are no locks held on the WRKDOMSVR panel group:
    WRKOBJLCK OBJ(QSYS/QGNNINDS) OBJTYPE(*PNLGRP)

Enter the following command to remove each of the Domino 9.0.x Beta servers:
    CFGDOMSVR SERVER(<Beta-server-name>) OPTION(*REMOVE)
NOTE: If the Domino Beta servers have customized data or environment, you can keep it and use UPDDOMSVR command to upgrade it to production version after Domino 9.0.x installation.

Then enter the following command to remove any Domino 9.0.x Beta software:
    DLTLICPGM LICPGM(5733LD9) OPTION(10) - Domino 9.0
    DLTLICPGM LICPGM(5733LD9) OPTION(11) - Domino 9.0.1

DO NOT DELETE THE QNOTES USER PROFILE!!

After Domino 9.0.x Beta servers and software have been removed, you can proceed with the installation of the production version of Domino 9.0.x.

OPTIONAL: Back up the Domino data directories and all of the Domino libraries on the IBM i server. For more information, see Chapter 18 "Managing Backup and Recovery" in Installing and Managing Domino 8 for System i.

Install required software and system fixes

Check that your system is up-to-date with required software and system fixes along with the latest cumulative and group PTFs. Note in particular that this release of Domino requires a new version of Java to be installed. Refer to the following technotes for the latest information.

Domino 9.0.x for i: Software requirements
Domino for i (i5/OS): What system fixes are required?

Install Domino 9.0.x for i

You can install Domino 9.0.x on both IBM i 6.1 or i 7.1. Domino 9.0.x targets to IBM i 6.1, and is built on Power 6 hardware, so it will has better performance if you run it on Power 6 or newer models, but if you run it on Power 5 models, program conversion is needed when you first install it with below command or when you start Domino the first time. Refer to the Domino 9.0.x for i: Program Conversion technote for more information and plan for additional time for installation on Power 5.

Domino 9.0.x is available on a single DVD or in a Web kit. Use one of the methods below to install the product. Refer to Installing and Managing Domino 8 for System i page and download it for more information on the installation methods available.

Prerequisite prior to installing Domino 9.0.x

NOTE: All installation methods (DVD, SETUP.EXE, RSTLICPGM) will fail with the following error message if there are interactive jobs using the WRKDOMSVR command.
    Cannot allocate object QGNNINDS.

Use the following command to verify there are no locks held on the WRKDOMSVR panel group. If locks exist, ask the user to exit the panel or type option 4 (End job) to end the jobs before installing Domino 9.0.x.
    WRKOBJLCK OBJ(QSYS/QGNNINDS) OBJTYPE(*PNLGRP)


TIP: The system value QVFYOBJRST must be set to a value of 3 or lower prior to the installing Domino. Otherwise, the installation may fail with the following error message (check the job log of the job that issued the RSTLICPGM command):
    Object has a signature that is no longer valid.

After the installation of Domino has completed, the system value may be changed back to a more restrictive setting. An example of changing the system value QVFYOBJRST is provided below:
    CHGSYSVAL SYSVAL(QVFYOBJRST) VALUE('1')

Install Domino 9.0.x from DVD

Domino can be installed using SETUP.EXE with the physical media in your PC's DVD-RAM or IBM i optical drive. When you install using media in your PC's DVD-RAM drive, additional network time is required to transfer the save files from your PC to the IBM i system. You can save the additional network time by copying the setup.exe and version.txt files to your PC, and then place the Domino media in your IBM i optical drive. To install Domino, double-click the setup.exe file to launch the installation setup wizard.

You can also install Domino using the LODRUN command with the physical media located in the IBM i optical drive.
    LODRUN DEV(<optical-device-name>) DIR('/os400/')

Whether using SETUP.EXE or LODRUN, you will be prompted to read and accept the terms of the license agreement.

Install Domino 9.0.x from Web kit

Download the self-extracting zip file to your PC and extract the contents:

README.HTML - Sources of documentation for the release
LICENSE - Domino International Program License Agreement or license Folder
QNOTES - IBM Domino 9.0.x *BASE Option save file
QNOTESAP - IBM Domino 9.0.x C API Option 1 save file
QNOTESRL - IBM Domino 9.0.x Server Option 10 (9.0) or 11 (9.0.1) save file
SETUP.EXE - Installation Wizard
VERSION.TXT - Installation Wizard version file
DOMWZD.EXE - Domino Configuration Setup Wizard

Note: The C API is not multi-version capable. If you install the C API option with another multi-version capable release of the Domino C API option already installed, only the latest installation of the C API will be available.

Follow the instructions below to install Domino using either the Installation Wizard (SETUP.EXE) or RSTLICPGM commands. Be aware that additional time is required for program conversion of Domino in selected install and upgrade scenarios. See the technote Domino 9.0.x for i: Program Conversion for more information.

Install Domino using the Installation Wizard

From the directory on your workstation where the Web kit files were extracted, run SETUP.EXE to launch the installation wizard. Follow the panels provided to install Domino.

Install Domino using RSTLICPGM commands

An alternative to installing Domino using setup.exe, you can install Domino using the RSTLICPGM command for each save file. Transfer each of the binary save files (QNOTES, QNOTESAP, QNOTESRL) from the workstation to the IBM i server where Domino will be installed. Use the RSTLICPGM command to install each option, as described below.

Pre-create save files (SAVFs) on your IBM i server to contain the Domino product options: *BASE, option 1 and option 10 (Domino 9.0) or 11 (Domino 9.0.1). For example, create a library to contain the save files and then create save files for each option, as follows:

> crtlib mylib
> crtsavf mylib/qnotes
> crtsavf mylib/qnotesap
> crtsavf mylib/qnotesrl

Transfer the binary save files from the workstation to the pre-created save files. For example, issue these commands from a PC command prompt:

cd <dir-name> {<dir-name> contains the binary save files
ftp <system-name or IP@> {your IBM i system name or IP address
Name: {Enter your IBM i user profile name, press enter
Password: {Enter your user profile's password, press enter
ftp>binary {Set the transfer mode to binary
Representation type is binary IMAGE.
ftp>put qnotes mylib/qnotes (replace
ftp>put qnotesap mylib/qnotesap (replace
ftp>put qnotesrl mylib/qnotesrl (replace
ftp>quit

The save files for the option(s) you plan to install should now be on your IBM i server. You can use these commands to verify the save files have been transferred correctly:

> dspsavf mylib/qnotes
> dspsavf mylib/qnotesap
> dspsavf mylib/qnotesrl

Use the RSTLICPGM CL command to install each Domino option.

NOTE: Starting from Domino 9.0, please remember to specify which type of Domino install you want (Messaging=0, Utility=1, Enterprise=2) via the DOMINO_INSTALL_TYPE variable (case sensitive) set by following CL command before the first installing the Domino server option 10. Otherwise, the installation will fail and exit.

ADDENVVAR ENVVAR(DOMINO_INSTALL_TYPE) VALUE('0') REPLACE(*YES) <--- Messaging
ADDENVVAR ENVVAR(DOMINO_INSTALL_TYPE) VALUE('1') REPLACE(*YES) <--- Utility
ADDENVVAR ENVVAR(DOMINO_INSTALL_TYPE) VALUE('2') REPLACE(*YES) <--- Enterprise

1. Program conversion occurs when you first install it with following commands.
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) SAVF(YOURLIB/QNOTES) FRCOBJCVN(*YES *RQD)
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(1) SAVF(YOURLIB/QNOTESAP) FRCOBJCVN(*YES *RQD)
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(10) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*YES *RQD) - Domino 9.0
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(11) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*YES *RQD) - Domino 9.0.1

2. If you do not want program conversion occurs during RSTLICPGM, you can restore Domino with following commands.
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) SAVF(YOURLIB/QNOTES) FRCOBJCVN(*NO)
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(1) SAVF(YOURLIB/QNOTESAP) FRCOBJCVN(*NO)
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(10) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*NO) - Domino 9.0
  • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(11) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*NO) - Domino 9.0.1

When installing the Domino server option from the QNOTESRL save file, a message will be displayed asking to accept the product license. Read the license agreement and then press F14-Accept to accept the license and continue the installation.

If you are installing on a non-English system you must specify the LNG(2924) on each of the RSTLICPGM commands. Otherwise, you will receive an error stating that LNG objects for the product were not found in the save file.

Verify the software is installed correctly

Use the DSPSFWRSC command to display the installed software.

Resource
ID Option Feature Description
5733LD9 *BASE 5050 IBM Domino 9.0
5733LD9 *BASE 2924 IBM Domino 9.0
5733LD9 1 5050 IBM Domino 9.0: C API
5733LD9 10 5050 IBM Domino 9.0: Release 9.0.0
5733LD9 10 2924 IBM Domino 9.0: Release 9.0.0

5733LD9 11 5050 IBM Domino 9.0: Release 9.0.1
5733LD9 11 2924 IBM Domino 9.0: Release 9.0.1

Use the Check Product Option CL command to verify the software is installed correctly.

> CHKPRDOPT PRDID(5733LD9)
No errors detected by CHKPRDOPT.

Upgrade existing servers to Domino 9.0.x

Server upgrade from the following releases to Domino 9.0.x is supported.

IBM i 5.4: Domino 6.5.x, 7.0.x, 8.0.x, 8.5.x upgrade to 9.0.x along with IBM i OS slip install to i 6.1 or i 7.1.
IBM i 6.1: Domino 7.0.3, 8.0.1, 8.5.0 and later MRs upgrade to 9.0.x.
IBM i 7.1: Domino 8.5.1 and later MRs upgrade to 9.0.x.

Run the Display Software Resources (DSPSFWRSC) command to determine which versions of Domino are installed. The product identifiers are:

Domino 6.5 5733L65
Domino 7 5733LD7
Domino 8 5733LD8
Domino 8.5 5733L85

Determine the release of Domino servers configured on your IBM i server. Use the Work Domino Server (WRKDOMSVR) command to see all Domino servers. Then press F11=Display library to display the library and release of the servers.

Use the Update Domino Server (UPDDOMSVR) command to update any existing multi-version capable Domino servers to latest release level, as follows:

QDOMINO900/UPDDOMSVR SERVER(<server-name>) TORLS('9.0.0') or
QDOMINO900/UPDDOMSVR SERVER(<server-name>) TORLS(*LATEST) - Domino 9.0

QDOMINO901/UPDDOMSVR SERVER(<server-name>) TORLS('9.0.1') or
QDOMINO901/UPDDOMSVR SERVER(<server-name>) TORLS(*LATEST) - Domino 9.0.1

Start the Domino server

You can now start the Domino server using the STRDOMSVR command, WRKDOMSVR option 1 or System i Navigator.

The Domino server status will change from *ENDED to *STARTING. If the status remains at *STARTING, check the Domino console for any messages asking to upgrade the design of the Domino directory. Answer "Yes" to this question and the Domino server start will proceed.

NOTE: You can only view the Domino console using WRKDOMSVR Option 5 (Display console) or the command DSPDOMCSL <server name>. In order to enter a response to the message asking to upgrade the design, you must use WRKDOMSVR Option 8 (Work console) or the command WRKDOMCSL <server name>.

Configure a new Domino 9.0.x server

In addition to upgrading an existing server to Domino 9.0.x, you can configure a new server using the CFGDOMSVR CL command or the Domino Configuration Setup Wizard. Library qualify the CFGDOMSVR command to configure a Domino 9.0.x server. For example:

QDOMINO900/CFGDOMSVR SERVER(<server-name>) ... configures an 9.0 server
QDOMINO901/CFGDOMSVR SERVER(<server-name>) ... configures an 9.0.1 server

Refer to Installing and Managing Domino 8 for System i page and download it for more information on using commands and System i Navigator to configure and manage Domino servers.

Related information

Domino 8.5 Administration HELP Information Center
Installing and Managing Domino 8 for System i
Domino 9.0.x for i: Checklist for upgrading
Domino 9.0.x for i: Getting Started
Domino 9.0.x for i: Program Conversion
Domino 9.0.x for i: Hardware Requirements
Domino 9.0.x for i: Software Requirements
Domino for i (i5/OS): What system fixes are required?
Lotus Software for IBM i Operating System Compatibility

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IBM Domino
Deployment

Software version:

9.0, 9.0.1

Operating system(s):

IBM i, i5/OS

Software edition:

All Editions, Social Edition

Reference #:

1621247

Modified date:

2014-05-22

Translate my page

Machine Translation

Content navigation