Quickr 8.2Fixpack Install Instructions

Quickr 8.2Fixpack Install Instructions

Table of Contents

Important information before beginning install

Installing a Fixpack using the Fixpack Installer for Win32

Installing a Fixpack using the Fixpack Installer forAIX

Installing a Fixpack by copying directoriesand files

Upgrading your places and other Quickr Domino databases

Upgrading offline installations

Documentation Updates / Addendums

Additional Information for special fixes

Quickr 8.2Fix List

Important information before beginning install

Information for customers with locked down client environments:

This current build, 8.2.0.10-003 dated 2010/03/03, doesnothave an updated qp2.cab.

The previous most recent update to qp2.cab is in Quickr 8.2.0.10-001 dated 2010/02/09.

2009/08/01 - QuickPlace 6.5.1 and 7.0 migration to Quickr 8.2

Migration from QuickPlace 6.5.1 and 7.0 to Quickr 8.2 is now supported using Quickr Fixpack version 8.2.0.2 dated 07/20/2009. The detailed documentation for migration is available in the Lotus Quickr Wiki located at

2009/07/01 – 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

Installing a Fixpack using the Fixpack Installer for Win32

Prerequisites:

Win32 based system
Java JRE 1.5 or above must be installed on the host OS of the server.
The Domino program directory (eg: c:\Program Files\IBM\Domino) must be in the System PATH variable. To Access: Right Click on My Computer/Properties/Advanced/Environment Variables:
If the Domino Program directory is not listed, Click Edit and append it to the list.

Location of the Fixpack jar file:

Place the Fixpack jar file on the Domino server in the following location:

{Domino Program directory}\jvm\lib\ext

To avoid confusion and mistakes, please be sure to remove any existing Quickr FixPack jar files from this directory before placing and installing the new FixPack. This will ensure you are installing the correct FixPack version.

How to Install:

The Domino Server is required to be shutdown to run the Lotus Quickr Fixpack Installer.

The Quickr Domino Fixpack Installer can be launched in the by either:

Double clicking on the Fixpack jar file located in the {Domino program directory}\jvm\lib\ext directory

From a command line in the {Domino program directory}\jvm\lib\ext directory, type the following command:

java -jar {Quickr82_FP####.jar}

Once the installer launches, you will be prompted to select the notes.ini file of the Domino server that you wish to upgrade.

The Fixpack Installer will backup the original files to the directory:

{Domino Program directory}\QRD_FP####_{FixpackDate}_Backup.

To change the default backup directory from the Domino Program directory to a different drive \ directory, create a notes.ini variable named QuickrFPInstallerBackupDirectory and set its value to the drive:\directory to backup to.

Example: QuickrFPInstallerBackupDirectory=d:\FixpackBackup

Once the original files have been backed up, the Fixpack files will be installed.

When the Fixpack installer has completed, you will be prompted to review the installation logs located in the Fixpack backup directory {Domino Program directory}\QRD_FP####_{FixpackDate}_Backup which will have the following files and directories:

AllPlatforms / contains backup files
W32 / contains backup files
Backup.log / List of files that were backed up during the Fixpack installation
Error.log / List of errors (if any) that were encountered during the Fixpack installation
FP.log / List of files that were installed by the Fixpack Installer

The Lotus Quickr Fixpack installation is complete.

Installing a Fixpack using the Fixpack Installer for AIX

Prerequisites:

AIX based system
Java JRE 1.5 or above must be installed on the host OS of the server.

Location of the Fixpack jar file:

The Fixpack jar file doesn’t have to be located in any specific directory

How to Install:

The Domino Server is required to be shutdown to run the Lotus Quickr Fixpack Installer.

You must be logged in as root in order to install.

From a command line in the directory that contains the Fixpack jar, type the following command:

java -jar {Quickr82_FP####.jar}

Once the installer launches, you will be prompted to enter the location of the notes.ini file of the Domino server that you wish to upgrade.

To override being prompted for the location of the notes.ini file, you can enter the location of the notes.ini on the commandline by using the -ini parameter:

java -jar {Quickr81_FP####.jar} -ini /local/notesdata

The Fixpack Installer will backup the original files to the directory:

{Domino Program directory}/QRD_FP####_{FixpackDate}_Backup.

(Domino Program directory typically being /opt/ibm/lotus/notes/latest/ibmpow/)

To change the default backup directory from the Domino Program directory to a different directory, create a notes.ini variable named QuickrFPInstallerBackupDirectory and set its value to the directory to backup to.

Example: QuickrFPInstallerBackupDirectory=/local/FixpackBackup

Once the original files have been backed up, the Fixpack files will be installed.

When the Fixpack installer has completed, you will be reminded to review the installation logs located in the Fixpack backup directory {Domino Program directory}/QRD_FP####_{FixpackDate}_Backup which will have the following files and directories:

AllPlatforms / contains backup files
aix / contains backup files
Backup.log / List of files that were backed up during the Fixpack installation
Error.log / List of errors (if any) that were encountered during the Fixpack installation
FP.log / List of files that were installed by the Fixpack Installer

The Lotus Quickr Fixpack installation is complete.

Troubleshooting:

If, when launching the installer, you receive an error message “Do not run Domino as root”, then you have the /opt/ibm/lotus/bin directory in your path and java is running from this directory. This java binary cannot be used to launch the installer, please add a different java installation to the beginning of your path before launching.

Installing a Fixpack by copying directories and files

Start by extracting the contents of the Fixpack file from either the Fixpack zip or the Win32 or AIX Fixpack jar file into a temporary folder / directory. These archives contain the files needed for upgrade, the difference being the jar file has additional files used for installation that are not necessary if upgrading via manual copy.

Upon extraction, view the temporary directory you created.

Directories created after extracting the zip file:

AllPlatforms

w32

AIX

If using the jar file, from the root of the jar go into the directory named FixPackFiles and then go into the directory named Quickr_FP####_{FixpackDate}, within this directory you will find the following directories:

For Win32 Fixpack jar:

AllPlatforms

w32

For AIX Fixpack jar:

AllPlatforms

AIX

These directories contain files and directories that can be easily copied to their final destination.

Let’s start with your OS:

Win32 If you are using a Win32 based system copy all of the files in the w32 directory directly into your Domino Program directory, IE: C:\Program Files\Lotus\Domino
AIX If you are using AIX, copy all of the files in the AIX directory directly into your Domino Program Directory, IE: /opt/ibm/lotus/notes/latest/ibmpow

Now go into the AllPlatforms directory you will find the following:

(file) quickplace.jar – Copy this file directly into your Domino Program directory
(directory) data – Copy the contents of this directory including all of its files and subdirectories to your Domino Data directory IE: C:\Program Files\Lotus\Domino\Data or /local/notesdata
(directory) html – Copy the contents of this directory including all of its files and subdirectories to your Domino Data\Domino\html directory IE: C:\Program Files\Lotus\Domino\Data\Domino\html or /local/notesdata/domino/html
(directory) LotusQuickr – Copy the contents of this directory including all of its files and subdirectories to your Domino Data\LotusQuickr directory IE: C:\Program Files\Lotus\Domino\Data\LotusQuickr or /local/notesdata/LotusQuickr

*Please Note: if you have upgraded from a previous version of QuickPlace, you may not have a LotusQuickr directory. If you do not then copy the entire contents to your Domino Data\QuickPlace directory IE: C:\Program Files\Lotus\Domino\Data\QuickPlace

(directory) QuickPlace – Copy the contents of this directory including all of its files and subdirectories to your Domino Data\QuickPlace directory IE: C:\Program Files\Lotus\Domino\Data\QuickPlace or /local/notesdata/QuickPlace

Once these files have been copied, the Lotus Quickr Fixpack installation is complete.

Upgrading your places and other Quickr Domino databases

After upgrading the files on your Lotus Quickr server, you may need to upgrade the place templates and other Quickr Domino databases so that they reflect the most current changes of the files you have upgraded.

To upgrade follow these steps:

Make sure the Quickr Server is running
From the Domino Console type the following commands :

*Note that you must wait for each of these commands 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 Performs
IMPORTANT – If you are upgrading from 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.
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 will also get 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 machines that already have offline places installed to their machine, the recommended way to update their machine with the latest offline support files is to:

Take note of all the subscription names from the Domino Sync Manager.
Synchronize all the places to deliver any changes from the offline places.
Delete the subscriptions from the Domino Sync Manager.
Uninstall the Lotus Domino Sync Manager to remove it from the machine.
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 on the same Fixpack. To do that, perform the following steps:

*Please note: It is highly recommended that you backup all places and PlaceTypes.

At the Domino console, use the “load qptool unlock -a” command on only one server in the cluster to unlock all the places.
Stop every Lotus Quickr server in the cluster.
Upgrade all the servers with the Fixpack.
Restart each of the servers (cluster replication and qptool replicamaker tasks should remain running).
Use the “load qptool upgrade -f -server” command on only one server in the cluster to upgrade the design of databases.
Use the “load qptool upgrade -f -a -saveformprefs” command on only one server in the cluster to upgrade places and PlaceTypes.
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

WBSI7DL3R9 - With Quickr’s embedded Sametime support, “In A Meeting” is not offered as one of the Sametime statuses.

To apply this fix, you will have to copy the peopleonline31.jar file to the Sametime server as specified in the “Enabling Lotus Sametime features in places” section in Quickr’s documentation.

DAMC7AEGQU - In connectors, if “Show Views” is selected on a place, checked out and draft documents in subrooms are not shown, only those documents in the main room are shown.

Please see new section in qpconfig_sample.xml, be sure to read about this fix in the description above the webservices section:

<webservices>

<connector>

<views_include_rooms enabled="false" />

</connectors>

</webservices>

YXIO7QBBKL - Daily news update email is not sent to all group members. / The following qpconfig.xml settings need to be applied if applying this fix:
If using LDAP as your directory, set the following
<notifications>
<recipient_rules>
<send_news_to_groups enabled="true" />
<expand_external_groups enabled="true"/>
</recipient_rules>
</notifications>
If using Domino Directory as your directory, set the following
<notifications>
<recipient_rules>
<send_news_to_groups enabled="true" />
<expand_external_groups enabled="false"/>
</recipient_rules>
</notifications>
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 - DominoDrag 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.
MMOI75D2LFMMOI7LAP5T -
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.
TJOR7W7NWZ - Adding approval process to a custom form causes previouslysubmitted documents to become unusable. / After applying the FixPack, existing Work Flow documents will have to be checked out and then checked in for the functionality to be restored. New Work Flow documents will function correctly.
KABS7XGLGZ- Form fields are being scrubbed automatically with the new XSS code, need a way to allow live HTML in some fields. / See the <xss_whitelist attribute in the <security> section of the qpconfig_sample.xml for this fix.
CWIR7XUV8C - Using Domino Native Authentication, cannot search for member based on last name. / See the new section in qpconfig_sample.xml for this fix:
<user_directory>
<domino>
<member_lookup_ui>
<search_by_first_and_last_name enabled="false"/>
<search_by_last_name_only enabled="false"/>
</member_lookup_ui>
</domino>
</user_directory>
PNOT7XYQUZ - Enhancement: Optional hyperlink at bottom of place invitation to allow adding the place to the new member's connectors. / Please see new configuration section <add_to_connectors_message> within the <notifications> section of the qpconfig_sample.xml for this enhancement.
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".
CWIR7WNN9Z - Place manager's id as shown in place invitation should be configurable to use cn instead of displayName. / To enable this fix, please set the following notes.ini variables:
QuickPlaceGetInviteSenderNameFromDN=1
QuickPlaceGetInviteRecipientNameFromDN=1
RELS7KNUHE - With versioning enabled, searching for content returns all versions of any document that matches the search criteria. / To enable this fix, please add the following notes.ini variable:
h_DisplayNoVersions=1

Troubleshooting