Quickr 8.

1 Fixpack Install Instructions

Table of Contents
Installing a Fixpack using the Fixpack Installer
Installing a Fixpack by copying directories and files
Upgrading your places and other Quickr Domino databases
Documentation Updates / Addendums
Additional Information for special fixes
Troubleshooting
Quickr 8.1 Fix List

Installing a Fixpack using the Fixpack Installer

Currently the Lotus Quickr Fixpack Installer will only run on Win32 based systems.

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

How to Install:
The Domino Server is required to be shutdown to run the Lotus Quickr Hot Fix Installer.

The Quickr Domino Hot Fix 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
or
From a command line in the {Domino program directory}\jvm\lib\ext directory, type the following command:
java -jar {Quickr81_FP####.jar}

Once the installer launches, you will be prompted to select the Notes.ini file for 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. Once the original files have been backed up, the
Fixpack files will be installed.

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 it’s value to the drive:\directory to backup to.
Example: QuickrFPInstallerBackupDirectory=d:\fixpackBackup

When the Fixpack installer has completed, you will be prompted to review the installation logs located in the Fixpack back
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.

Page 1 of 7
Installing a Fixpack by copying directories and files
Start by extracting the contents of the Fixpack file from either the Fixpack zip or the Fixpack jar file into a temporary folder /
directory. Both of these archives contain the files needed for upgrade, the difference being the jar file has additional files
used for install on Win32 based systems and that DOES NOT contain the AIX binaries.

Upon extraction, view the temporary directory you created.

Directories created after extracting the zip file:
AllPlatforms
w32
AIX

If using the jar file you will see some files and a directory named QRD_FP####_{FixpackDate}, go into that
directory. You will find the following directories:
AllPlatforms
w32

These directories contain files and directories that will 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

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
• (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
• (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 *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

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

load qptool unlock -a Unlock all the places.
load qptool upgrade -f -server Upgrade all the databases on the server.

Page 2 of 7
 load qptool upgrade -f -a Upgrade all the places and PlaceTypes.

Documentation Updates / Addendums

Upgrading Lotus QuickPlace servers in a cluster to Quickr 8.x
You should upgrade all servers in a cluster to Lotus Quickr 8.x. Lotus Quickr 8.x interoperation with earlier versions of Lotus
Quickr is supported only in non-cluster environments. To upgrade Lotus Quickr servers in a cluster, perform the following
steps:
1. Back up places and PlaceTypes.
2. Stop one Lotus Quickr server in the cluster. If you are using Network Dispatcher, redirect HTTP traffic to the other
cluster members.
3. Upgrade the server that you stopped to Lotus Quickr 8.x.
4. Restart the server, and disable replication between it and other cluster members.
5. Follow steps 1 through 4 with each server in the cluster. Do not allow Lotus QuickPlace 3.0 or higher servers or Lotus
QuickPlace 6.5.1 servers or Lotus QuickPlace 7.0 servers to replicate with Lotus Quickr 8.x servers.
6. When all servers in the cluster are running Lotus Quickr 8.x, re-enable cluster replication and enable qptool replicamaker
between the servers. For more information on qptool replicamaker, see the Lotus Quickr Administrator’s Guide.
7. Use the QPTool upgrade -server command on only one server in the cluster to upgrade the design of databases. Let
replication pass the design upgrades to all servers. At this point you can make the cluster accessible to users again.
8. Use the QPTool upgrade -a command on only one server in the cluster to upgrade places and PlaceTypes. Then delete the
PlaceTypes on all the other servers and let the upgraded PlaceTypes replicate throughout the cluster. After replication,
sign in to each server as an administrator and refresh the list of PlaceTypes.
9. Use the QPTool unregister and register commands on all servers in the cluster to unregister and then re-register all
places.
10. If there are offline users, clear the browser cache on offline clients before installing places offline in Lotus Quickr 8.x
11. Upgrade the on-disk structure of places.
12. Update Lotus Sametime integration features, if used.

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

DAMC7F2GF5 - With Fix requires QuickPlaceHandleWebsphereTokenDNSpecialChar=7 in
QuickPlaceHandleWebsphereTokenDNSpecialChar=7, notes.ini
users with “(“ in OU name can't be added to places
XSS Protection updates See xss protection section in qpconfig_sample.xml for this fix.

NXLE79BBG2 - Sign out won't display with TAM LTPA See <authentication> section in qpconfig_sample.xml for this fix.
Junction
KABS785K2A - Connector does not display places for Requires Domino Fixpack 801HF376
users with umlauts/accented chars in name
MPUL7FRLK4 - When ST Enabled, browser Hangs Requires Sametime Fixpack AJMA-7GRMFZ
(CPU 100%) when User Clicks On Context menu of
locked discussion post
PMOO7ECMPS - DominoDrag and Drop does not Requires Quickr81hf_path_prefix=1 to be set in notes.ini
work after Domino Quickr 8.1GA update
MMOI7H9VCV - Using the 8.1 theme, user lookup Requires QuickPlaceLookupTimer=(some amount of time in
replaces desired results if there are pauses in typing milliseconds) to be set in notes.ini. The default is 300 (3 tenths of a
second).
GAKI7L5MD4 - Added ability to change the default See <rich_text_editor> section in qpconfig_sample.xml for this fix.
font for the Rich Text Editor

Page 3 of 7
Troubleshooting
• If users have unexpected results after applying this update, they should clear their browser’s cache. The user can also clear
the Java cache, which is located in the Control Panel and may be named something like Java Plug-In or Java Control Panel.
Go into this applet and find the Cache settings, there should be a way to clear the cache from there.
• If users are having problems in Internet Explorer, they should remove the Lotus Quickr ActiveX control. The user will be
prompted to install the ActiveX the next time they browse to a Quickr Place.
• To remove the ActiveX control:
1. Close all instances of Internet Explorer
2. From the Windows Control Panel, open Internet Options.
3. Depending on your version of Internet Explorer:
Internet Explorer 6:
• On the General tab, press the Settings button.
• On the Setting dialog, select View Objects…
• Select the Lotus Quickr Class (qp2.dll) and press the Delete key on your keyboard.
Internet Explorer 7:
• On the Programs tab, press the Manage Add-ons button.
• On the Manage Add-ons dialog, select the Lotus Quickr Class (qp2.dll).
• Press the Delete button.

Page 4 of 7
Quickr Domino Release 8.1 Fix List

Page 5 of 7
 FP 8.1.0.3
XZSU73P78A
11/21/2008 TSNG6PW7DX Members that are in multiple groups may get duplicate emails when notifications are sent.
TKAO7LHQ8K

11/21/2008 TKAO7LHQ8K Quickr Entry Entry: Changing a document's properties, then publish will prompt with an error

Images not loading when customizing a theme and drag / drop the image file onto the drag / drop
11/21/2008 KABS7GULJG
target.

11/21/2008 JFLD7JYNDA With versioning enabled, when selecting Notify from the folder view a new version will be created.

When a place uses an older theme, and user is a member of a Domino LDAP group, that user may
11/21/2008 SHYN7L9JDF
not see this place in My Places

Uploading an EXE file into the Library results in "unknown file type" when downloading in the
11/21/2008 MPUL7K2KWM
Library Index View

11/21/2008 MZHA7L9DAX URL is truncated when clicking “Log out” button in Place Administration page

11/21/2008 MZHA7L9BZ6 URL is truncated when clicking Going back to Home button in Place Administration page.

11/21/2008 JHHO7HPEML Wiki history only showing original and last entries

11/21/2008 JRIE7L3MFE Unable to view all folders in Quickr "Save Folder Options" after highlighting a folder

11/21/2008 SHYN7K7U4C Error creating a place type from a place with a external group

11/21/2008 RELS7KUPTF Places with group access do not show in the placatalog

11/18/2008 RELS7L6STY Moving nested folders to a room may corrupt the folder structure.

11/18/2008 MMOI7KURY2 Rich-text formatting lost when posting blog pages using IE

11/18/2008 MMQS7K86B8 Error on page when trying to create link in a table with the Rich Text Editor in IE

11/18/2008 PNOT7LDP7P After qptool upgrade, cannot edit a wiki page.

Moving a post from a top-level folder to a subroom's Table of Contents errors with "Entry not
11/12/2008 QCAO7AJBET
Found"

Clicking "Recommend" link appends sender's mail signature to the document as shown in the
11/12/2008 SORA7KP2QL
resulting Notes client doclink

When adding member LDAP with >20,000 entries, UI temporarily shows wrong result when user
11/12/2008 MMOI7H9VCV
pauses while typing search term.

11/12/2008 DAMC7KGEVR Moving a sub-folder causes it to lose its original default-form setting.

Creating a child place from a placetype that gives access to an external group fails with a garbage
11/12/2008 SHYN7K7U4C
error message.

11/12/2008 PKAY7KPHGT Moving a page from a subroom to parent's TOC moves it to the place index instead of the TOC.

11/12/2008 GMUN7J3DRU Canceling save draft command leaves a stray file (FIELDTITLE_UNTITLE) in the document index

11/12/2008 QCAO7L6ABV Can't download file named with Central European (NLC) character set to a client system using IE6

Running qptool upgrade -server causes warning; "Cannot locate design template
11/12/2008 PNOT7J5J63
'h1_entrytemplate.".

11/12/2008 RELS6Z4PTG Running qptool upgrade -f in a clustered environment causes replication conflicts in the room index.

11/12/2008 AGAI7JQQEU Qptool upgrade converts Wiki "Versions" to "Responses"

11/12/2008 PNOT7KXN7Y Qptool setTheme command not properly resetting all design elements to default theme values.

Pages can no longer display their version lists after a replication/save conflict has occurred in the
11/12/2008 RELS7L3TPX
database.

RELS7GRLJW
11/12/2008 Some themes generating "404 : File not found" errors for js , css, and png filetypes
SHYN7EFKLW

11/12/2008 GAKI7L5MD4 Added ability to change the default font for the Rich Text Editor

Exception thrown on qptool register -install when include_anonymous setting enabled in

11/04/2008 PNOT7KGKDE
qpconfig.xml

11/04/2008 ESEO7KLUK4 qptool placecatalog -push -a command times out with very large (>1.7GB) place catalogs
Page 6 of 7
11/04/2008 MPUL7K8J9P Invalid Document Identifier error accessing a folder renamed after copying it with connectors

11/04/2008 MMOI75D2LF Offline login password doesn't work when MSSO is enabled
Page 7 of 7