Lotus Quickr 8.1 Services for Lotus Domino (i5/OS)
Consolidated Fixpack 8.1.0.28 and Enabling Fix for Domino 8.0.2
PTF LQ03603 for product ID 5724S31
August, 2011
Table of Contents
About the Fixpack
Prerequisites
Installing the Fixpack
Additional Steps if you have installed Fixpack 8.1.0.3 or 8.1.0.4
Upgrading your places and other Quickr Domino databases
Upgrading offline installations
Documentation Updates / Addendums
Additional Information for special fixes
Troubleshooting
Quickr 8.1 Fix List
About the Fixpack
· Information for customers with locked down client environments:
This current build, 8.1.0.28, does not include an updated qp2.cab. The most recent update was included in 8.1.0.18, dated 2010/01/14.
· Sept/2010 – Fix List information
As of 2010/09/15, the Fix List will contain both the SPR and APAR number if an APAR number exists. The APAR information is useful when dealing with support.
· May/2009 – New option added to “qptool upgrade”
When running “qptool upgrade -f -a” as specified in this documentation, some Form customizations may be lost. Those customizations are now retained if you use the new qptool upgrade switch -saveformprefs. The customizations that will be retained are the “hidden” status of the form and also the “order” in which the forms are displayed.
· IMPORTANT: Please read if you’ve installed Fixpack 8.1.0.3 or 8.1.0.4:
An issue was introduced in FixPack 8.1.0.3; this issue is fixed in Fixpack 8.1.0.5. If you have installed either 8.1.0.3 or 8.1.0.4, it is important to perform additional steps after installing 8.1.0.5 or a later fixpack.
· This Fixpack package includes the following files:
o Readme.doc: this file
o LQ03603: a savefile containing the fixpack that is built and applied as an i5/OS PTF to Lotus Quickr 8.1 for i5/OS (5724S31).
· This Enabling Fix for Domino 8.0.2 is required in order for Quickr 8.1 servers on i5/OS to run on Domino 8.0.2. Do not install the PTF if you plan to run your Lotus Quickr server on any level of Domino other than 8.0.2.
· This fix only includes the changes to the Quickr Domino services code. You should also obtain the latest available version of the 8.1 Quickr Domino Connectors update from Fix Central and copy the update to your server. The latest Quickr connectors update is included in the recommended fix group for 8.1 Quickr services for Domino on i5/OS. The Connector updates are intended only for Lotus Quickr version 8.1 but are independent of the level of Domino.
New Quickr installation:
· If you are deploying Lotus Quickr for the first time and have never installed an earlier QuickPlace release, you should first install Domino 8.0.2 and Quickr 8.1. Then install the pre-requisite PTF (see "Prerequisites" section below), install this fixpack, and also install the connectors update before configuring your Lotus Quickr server.
· For more information, see the Lotus Quickr 8.1 information center, which is available from the Lotus Quickr documentation site: http://www.ibm.com/developerworks/lotus/documentation/quickr/
Upgrade from an earlier release:
· Before installing the fixpack or connectors update, Lotus Quickr 8.1 must be installed. Therefore, if you are using an earlier release of Quickr or QuickPlace, first complete the upgrade to Quickr 8.1.
· If you need to upgrade your Quickr server to Domino 8.0.2, you can install this PTF and the connectors update before or after installing Domino 8.0.2 and upgrading your server to Domino 8.0.2. However, complete the Domino upgrade and install the fixpack before you start the server and attempt to use Quickr.
· PTF LQ01447 is a prerequisite for this fixpack and must be applied permanently before installing this fix. See the Prerequisites section below for more information.
· If you have installed any Quickr 8.1 PTFs other than LQ01447, remove them before installing this PTF. It is not necessary to remove connector updates before installing a later level.
· If you have multiple QuickPlace or Quickr servers running in the same i5/OS LPAR, they must all be running Quickr 8.1 and Domino 8.0.2 in order to use this fix.
(Domino multi-versioning permits you to run other Domino or Sametime servers in the same LPAR using different Domino releases if you prefer.)
Prerequisites
Before installing this fixpack:
· 5724S31 V8R1M0 Quickr 8.1 for i5/OS must already be installed on your system.
· 8.1-Quickr-LQ01447-Domino-i5OS (5724S31 PTF# LQ01447) must be permanently applied. This fix is available from Fix Central.
Installing this Fixpack (PTF LQ03603)
This fixpack installation procedure requires a user profile with command line capability and a user class of *SECOFR.
The PTF is provided as i5/OS save file called LQ03603.
1. Establish a 5250 session with the IBM i server and sign on with the appropriate user profile.
2. Run the following command to create a temporary library:
CRTLIB LIB(MYLIB) TEXT('Library for Quickr 8.1 Fixes')
3. Run the following command to create the necessary Save file:
CRTSAVF FILE(MYLIB/LQ03603) TEXT('Quickr 8.1 Fix LQ03603')
4. Transfer the PTF save file from your workstation to the System i server.
From your workstation, enter the following commands and responses when prompted:
cd xxxx [change to the directory on your workstation that contains LQ03603]
ftp: [your System i name or IP address]
Name: [Enter your user profile name and press ENTER]
Password: [Enter your password and press ENTER]
ftp>binary
Representation type is binary IMAGE.
ftp>put LQ03603 MYLIB/LQ03603
ftp>quit
5. To end any active Quickr servers, enter the following command:
WRKDOMSVR
Use option 6 (End Domino server) to end each active server that is running Quickr.
Use the Work with Active Job (WRKACTJOB) command to determine when all Quickr servers have ended. Wait until the servers have completely shut down before continuing to the next step.
6. Determine if any Quickr hot fixes are currently installed by running the following command:
DSPPTF LICPGM(5724S31)
PTF LQ01447 is a prerequisite for this fixpack and must be permanently applied. If any other PTFs are currently applied, remove them using the RMVPTF command.
7. Run the following commands to load and apply the Quickr PTF:
LODPTF LICPGM(5724S31) DEV(*SAVF) SAVF(MYLIB/LQ03603)
APYPTF LICPGM(5724S31) SELECT(LQ03603)
8. Now you can start the Quickr servers.
Use the WRKDOMSVR command and select option 1 (Start server).
Additional Steps if you have installed Fixpack 8.1.0.3 or 8.1.0.4
An issue was introduced in FixPack 8.1.0.3, this issue is fixed in FixPack 8.1.0.5. If you previously installed either 8.1.0.3 or 8.1.0.4, it is important to perform the following steps after installing FP 8.1.0.7 or a later fixpack:
1. Shut down the Quickr Domino server.
2. Set the following NOTES.INI setting :
QPTOOLREPAIR_TYPE=folder
3. Start your Domino server and run the following commands in the Domino Console. Wait for each command to complete before continuing to the next command :
load qptool unlock –a
load qptool repair –a
4. Shut down your Domino server.
5. Remove the ‘QPTOOLREPAIR_TYPE=folder’ setting from the NOTES.INI file.
6. Start your Domino server and run the following commands:
load qptool upgrade -f -server
load qptool upgrade -f -a
Upgrading your places and other Quickr Domino databases
After upgrading the files on your Lotus Quickr server, you should upgrade the place templates and other Quickr Domino databases so that they reflect the most current changes to the files you’ve upgraded. Complete the following steps on each Quickr server:
· Make sure the Quickr server is running.
· From the Domino Console type the following commands (wait for each of command to finish before proceeding to the next command. You will know that the command has finished when you see a message in the console such as qptool: command finished: {the command performed}
Command / Action It PerformsIMPORTANT – If you are upgrading from Fixpack 8.1.0.3 or 8.1.0.4, please see the additional steps in the previous section of this document.
load qptool unlock –a / Unlock all the places.
load qptool upgrade -f –server / Upgrade all the databases on the server.
load qptool upgrade -f –a –saveformprefs / Upgrade all the places and PlaceTypes.
Upgrading offline installations
When you install a Quickr Domino fixpack, you also receive the latest files needed for your offline installations. Clients taking a place offline for the first time after applying the fixpack will automatically get the latest version of the offline support files installed to their machine.
For client workstations that already have offline places installed on their machine, the following steps are recommended for updating the client with the latest offline support files:
1. Take note of all the subscription names from the Domino Sync Manager.
2. Synchronize all the places to deliver any changes from the offline places.
3. Delete the subscriptions from the Domino Sync Manager.
4. Uninstall the Lotus Domino Sync Manager to remove it from the machine.
5. Go to the online places that were noted and take them offline.
This will ensure that the latest version of the offline support files have been installed on the client machine.
Documentation Updates / Addendums
Applying a Fixpack to Quickr 8.x servers in a cluster
For the Quickr cluster to run properly, each server in the cluster needs to be using the same release and fixpack. To upgrade Lotus Quickr servers in a cluster to the new fixpack, perform the following steps:
*Please note: It is highly recommended that you first backup all places and PlaceTypes.
1. At the Domino console, use the “load qptool unlock -a” command on only one server in the cluster to unlock all the places.
2. Stop every Lotus Quickr server in the cluster.
3. Upgrade all the servers with the Fixpack.
4. Restart each of the servers (cluster replication and qptool replicamaker tasks should remain running).
5. Use the “load qptool upgrade -f -server” command on only one server in the cluster to upgrade the design of databases.
6. Use the “load qptool upgrade -f -a” command on only one server in the cluster to upgrade places and PlaceTypes.
7. Let replication pass the design upgrades to all servers.
Your Quickr 8.x servers should now be upgraded to the latest Fixpack.
Additional Information for special fixes
*Please note: each row in the following table represents a specific issue as described by the SPR / Description column, these special fixes (the Instructions column) only need to be applied if you encounter that specific issue. Applying these fixes if you do not encounter the issue specified may cause unexpected results and is not recommended.
SPR / Description
/Instructions
MMOI7MH576 - IMPORTANTThis fix applies to everyone who is upgrading from either Fixpack 8.1.0.3 or 8.1.0.4. / Please see the “Important information before beginning install” section near the beginning of this document, specifically the section:
2008/12/29 – Please read if you’ve installed Fixpack 8.1.0.3 OR 8.1.0.4
DAMC7F2GF5 - With QuickPlaceHandleWebsphereTokenDNSpecialChar=7, users with “(“ in OU name can't be added to places / Fix requires QuickPlaceHandleWebsphereTokenDNSpecialChar=7 in notes.ini
XSS Protection updates / See xss protection section in qpconfig_sample.xml for this fix.
NXLE79BBG2 - Sign out won't display with TAM LTPA Junction / See <authentication> section in qpconfig_sample.xml for this fix.
KABS785K2A - Connector does not display places for users with umlauts/accented chars in name / Requires Domino Fixpack 801HF376
MPUL7FRLK4 - When ST Enabled, browser Hangs (CPU 100%) when User Clicks On Context menu of locked discussion post / Requires Sametime Fixpack AJMA-7GRMFZ
PMOO7ECMPS - Domino Drag and Drop does not work after Domino Quickr 8.1GA update / Requires Quickr81hf_path_prefix=1 to be set in notes.ini
MMOI7H9VCV - Using the 8.1 theme, user lookup replaces desired results if there are pauses in typing / Requires QuickPlaceLookupTimer=(some amount of time in milliseconds) to be set in notes.ini. The default is 300 (3 tenths of a second).
GAKI7L5MD4 - Added ability to change the default font for the Rich Text Editor / See <rich_text_editor> section in qpconfig_sample.xml for this fix.
DAMC7KWNPC - While adding Members, Members lookup only displays 15 members shown in search results. / See ‘display_max_num_names' in the 'member_lookup_ui' section of <user_directory> in qpconfig_sample.xml for this fix.
ESEO7M9LVH - Groups unable see place in my places or authenticate directly to places with FP8103 and SAM / Requires QuickPlaceThirdPartyDSAPIAuthentication=1 to be set in notes.ini
SHYN7LATXP - Two managers editing the same document can create save/replication conflict with no warning given to the second editor. / Requires QuickPlaceShowConflictWarning=1 to be set in notes.ini
KABS7HMHTX - My Places displays member email addresses as "Unknown" when using Domino Server as non-LDAP user directory. / This will fix newly created places, to correct old places perform the following:
qptool unregister -placecatalog -a
qptool register -placecatalog –a
KABS7MEK5A - Need to support multiple Notes users with the same common name but different domains. / Set <use_whole_dn_for_member_nsf_lookup enabled="true"/> within <user_directory> section of the qpconfig.xml file.
SSHD7P7HG8 - Need option to hide Files link UI for customers who don't support shared files (Quickr Entry places) / Set <file_ui enabled="false"/> within the <my_files> section of the qpconfig.xml file.
PNOT7DZQCG - In Accessibility Mode, changes to color schemes are not retained. / Requires QuickrTimeStamp=1 to be set in notes.ini.
THES7PNQGV - “Find Shared Files” drop down list should be configurable for the amount of entries returned and be able to scroll that list / See <member_lookup_ui> section in qpconfig_sample.xml for this fix.
MMOI75D2LF MMOI7LAP5T -
Offline: Use login passwords (use_login_passwords) not functional when MSSO enabled
Offline password does not synchronize with online password change / See the new section named <password_synchronization> within the <offline> section of the qpconfig_sample.xml.
Additional Information for special fixes continued…
CPRE7PETT3 - MyPlaces portlet owner field shows nothing for full dn of a manager in place. / After applying the Fixpack and starting Domino, perform the following command in the Domino Console:load design -f Placecatalog.nsf
ESEO7PUUTQ - In non-Internet Explorer browser, uploading a file that exceeds the maximum sizes listed in the Domino Server configuration may give a “Connection Interrupted” page. / To limit attachment sizes within Quickr please note the following:
Quickr Admin : Other Options -> Maximum Attachment Size : Set this to the maximum sized attachment you want to allow
Domino config : Internet Protocols Tab- > HTTP Tab -> Maximum size of request content : This must be set to 0, this is a Domino setting. If you set this to an amount, 100 meg for example, and the user tries to upload a file 101 meg, you will get a Connection Interrupted error message. This is by design for Domino
Domino config : Internet Protocols Tab -> Domino Web engine tab -> Maximum POST data : This should be set to the same size of Quickr Admin setting Maximum Attachment Size. If it is smaller than the Maximum Attachment Size, this amount will be the maximum allowed Quickr Attachment Size.
Also, note that the now if your post exceeds the maximum attachment size as defined above, you will get an error page stating "Attachment size exceeds the amount allowed".
KABS7QHMQU - The column_disambiguate setting in qpconfig.xml is not functioning properly for attributes other than "dn" and "mail". / The fix involves setting up a user-defined field in qpconfig.xml. In this example, the field mobile is designated to do the desired disambiguation:
1) This line should be added into qpconfig.xml
<user_defined_field>mobile</user_defined_field>
2) The following two fields in qpconfig.xml should be the same.
qpconfig.xml
<user_directory>
<ldap>
<schema>
<object_class>objectClass</object_class>
<user>
<object_class_value>person</object_class_value>
…
<phone>telephoneNumber</phone>
<user_defined_field>mobile</user_defined_field>
</user>
</schema>
<member_lookup_ui>
<column_disambiguate>
<person>mobile</person>
</column_disambiguate>
</member_lookup_ui>
</ldap>
</user_directory>
Additional Information for special fixes continued…