Installing the target server: qp85 

---

Migrating from IBM® Lotus® Quickr™ 8.1.1.1 to 8.5 requires the installation of Lotus Quickr 8.5 using the same LDAP directory and database type as the source server. The Lotus Quickr 8.5 server can be on the same or different system as the Lotus Quickr source server.

1. Install Lotus Quickr 8.5 on the target server. You must install a single server configuration. The server can be clustered after the migration is completed. See Installing.

If Lotus Quickr 8.1.1.1 and Lotus Quickr 8.5 are to be installed on the same host, ensure that 8.1.1.1 and 8.5 use different port numbers. Use of different port numbers can be achieved in two ways:

a. For all operating systems except AIX: Keep 8.1.1.1 started when installing 8.5.
b. For all operating systems including AIX: Shut down 8.1.1.1 before installing 8.5. When installing 8.5, use the appropriate command line:
• For Windows®:

install.bat -W 

adminPortBlockInput.startingPortToScan="20000" -W 

portalPortBlockInput.startingPortToScan="20025"

• For UNIX®:

install.sh -W 

adminPortBlockInput.startingPortToScan="20000" -W 

portalPortBlockInput.startingPortToScan="20025"

This command ensures that 8.5 uses port numbers starting at 20000, while 8.1.1.1 normally uses port numbers starting at 10000.
2. Install the latest available Lotus Quickr 8.5 cumulative fix for your target server operating system. Please refer to the "Update strategy for IBM Lotus Quickr 8.5 for WebSphere Portal" document for details, including instructions.
3. Configure the user registry to match the previous Lotus Quickr 8.1.1.1 options. See Configuring Lotus Quickr with the configuration wizard.

Reconfigure Lotus Quickr 8.5 to use the same LDAP server that was used with the 8.1.1.1 server. It is important to use the same administration ids and groups that were used with the 8.1.1.1 server.

Note: Lotus Quickr 8.5 requires a federated LDAP configuration. Lotus Quickr 8.1.1.1 did not support a federated configuration. The configuration wizard guides you through how to add or replace a federated LDAP configuration. After migration, other LDAP repositories can be added to the federation. When you reconfigure Lotus Quickr 8.5 with an LDAP server and remove the out of the box configuration, any places and data created using the default registry are orphaned and no longer accessible.

4. Configure Lotus Quickr 8.5 to use the same unique identifier as Lotus Quickr 8111. Lotus Quickr uses an attribute from LDAP as the key information for data associated with users and groups. In Lotus Quickr 8111, the default when configured with a Domino LDAP was to use the distinguished name (DN). In Lotus Quickr 8.5, the default when configured with a Domino LDAP, is to use the attribute dominounid. For a successful migration, the Lotus Quickr 8.5 system must be configured to use the same unique id as the Lotus Quickr 811 system. If the Lotus Quickr 8111 system is using the DN as the unique id, then a configuration update must be made to the Lotus Quickr 8.5 system before migrating:
a. Edit the wimconfig.xml file. The default location is quickr_install_root/wp_profile/config/cells/node name/wim/config
b. Locate the section that begins:
<config:attributeConfiguration>
c. Add the following entry
<config:externalIdAttributes name="distinguishedName"/>
d. Save the changes and restart the server.

Failure to make this update before performing the migration will cause an invalid migration that cannot be recovered without re-doing the migration.

5. Use the IBM WebSphere® Application Server administration console to set the primary user in the security configuration of the 8.5 system. The primary user must match that of the 8.1.1.1 system.
6. If the earlier portal environment is configured to use an external security manager and has resources that are under the control of the external security manager, you must configure the new portal to use that external security manager before starting migration. Alternatively, you can bring the externalized resources back under Lotus Quickr control in the earlier Lotus Quickr environment prior to migration, and then configure the new Lotus Quickr environment to use the external security manager after migration is complete.
7. If you create any places on the target system prior to migration, you must remove them to avoid problems during the migration process. If there is data you need to preserve, archive the place before running the migration.
8. For migration, you must install the latest available Lotus Quickr 8.5 cumulative fix for your target server operating system. Please refer to the "Update strategy for IBM Lotus Quickr 8.5 for WebSphere Portal" document for details, including instructions.

NOTE: If your source Quickr 8111 server ever had Quickr 8.0.0.2, please contact IBM service.

Parent topic: Preparing the target environment: qp85
Next topic: Rebuilding themes and skins: qp85