Quickr 8.5.1 for Domino 8.5.3 Fixpack Install Instructions

Quickr 8.5.1 for Domino 8.5.3 FixPack Install Instructions

Table of Contents

Installing a Fixpack using the Fixpack Installer for Win32

Installing a Fixpack using the FixpackInstaller forAIX / Linux

Installing a Fixpack by copying directoriesand files

Installing and Upgrading Quickr to Domino 8.5.3

Upgrading your places and other Quickr Dominodatabases

Applying a Fixpack to Quickr 8.5.x serversin a cluster

How to activate ActiveX to importdocuments

How to activate Roundtrip Editing usingthe ActiveX control

How to activatethe Folder Navigator

CSRF protection in Quickr

Additional Information forspecialfixes

Additional Information forspecialfixesbefore Quickr 8.5.1.25

Merging NotificationTemplate Updates

Troubleshooting

Quickr DominoRelease8.5.1for Domino8.5.3FixList

Important information before beginning install

Information for customers with locked down client environments:

This current build, 8.5.1.40-301a dated 2013/06/19 does nothave an updated qp2.cab.

Please Note the following recent update to qp2.cab:

The previous most recent update to qp2.cab was in 8.5.1.39-302a dated 2013/05/23.

Previous to that was 8.5.1.25-007a dated 2011/02/14.

2012/12/03 - Domino 8.5.3 support

This FixPack supports Domino 8.5.3, but does NOT support any version of Domino lower than 8.5.3. Quickr will maintain 2 sets of FixPacks, one for Quickr for Domino 8.5.3 and one for Quickr for Domino 8.5.1FP5 but will stop hotfixing the Quickr for Domino 8.5.1FP5 version as demand decreases.

Please Note: Instructions for Installing and Upgrading Quickr to Domino 8.5.3 are available in the section Installing and Upgrading Quickr to Domino 8.5.3.

2012/12/03 - Internet Explorer 9 compatibility mode support

This FixPack provides support for Internet Explorer 9 in compatibility mode.

2012/04/30 - Cross Site Request Forgery (CSRF) Protection

Additional CSRF protection was added to Quickr and new settings added to enable it. Please see the section CSRF protection in Quickrin this document

2012/01/16 - Quickr 8.5.1.25 and above

The FixPack version number has skipped a number of versions and is now FixPack 25 (or above). This was done as a way to highlight that this FixPack version has re-introduced some features that were in previous versions of Quickr such as using the ActiveX to import documents and the Folder Navigator. This FixPack adds support for Microsoft Office 2010 when importing through the ActiveX control. Please see additional fixes and updates in the Additional Information for special fixes section.

For more information about the 8.5.1.25 FixPack release, please refer to the Quickr Wiki.

2011/09/07 - Notification Template Updates

As of 2011/09/07, a new section has been added to describe how to merge updates to Notification Templates. This section will also list each fix that contains an updated template along with the template files that should be merged to get the updated functionality.

2010/09/29 – Fix List information

As of 2010/09/09, 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.

Installing a Fixpack using the Fixpack Installer for Win32

If you are upgrading your Domino 8.5.1FP5 Installation to Domino 8.5.3, please review the section

Installing and Upgrading Quickr to Domino 8.5.3

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 {Quickr85_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 / Linux

If you are upgrading your Domino 8.5.1FP5 Installation to Domino 8.5.3, please review the section

Installing and Upgrading Quickr to Domino 8.5.3

Prerequisites:

AIX orLinux 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 {Quickr85_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 {Quickr851_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/ for aix

/opt/ibm/lotus/notes/latest/linux/ for linux)

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 or linux / contains backup files of platform dependant 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

If you are upgrading your Domino 8.5.1FP5 Installation to Domino 8.5.3, please review the section

Installing and Upgrading Quickr to Domino 8.5.3

Start by extracting the contents of the Fixpack file from the Fixpack zip or the Win32, AIX or linux 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

linux

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

For Linux Fixpack jar:

AllPlatforms

linux

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
linux If you are using linux, copy all of the files in the linux directory directly into your Domino Program Directory, IE: /opt/ibm/lotus/notes/latest/linux

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.

Installing and Upgrading Quickr to Domino 8.5.3

This FixPack supports Lotus Domino 8.5.3. It does NOT support any version lower than Lotus Domino 8.5.3.
FixPacks for Lotus Quickr on Lotus Domino 8.5.3 are delivered through a different set of FixPacks than Lotus Quickr on Lotus Domino 8.5.1FP5.
To differentiate between a FixPack for Lotus Quickr on Lotus Domino 8.5.1FP5 and a FixPack for Lotus Quickr on Lotus Domino 8.5.3 FixPack, note the following build number difference:

Lotus Quickr on Lotus Domino 8.5.1FP5:8.5.1.##-0##a

Lotus Quickr on Lotus Domino 8.5.3:8.5.1.##-3##a

FixPacks whose interim build number begins in the 300s are for Lotus Quickr on Lotus Domino 8.5.3.

The following is instructions on installing and upgrading Quickr to Domino 8.5.3

For a New Install of Domino 8.5.3 With Quickr:

Install Lotus Domino 8.5.3 FP1 and the hotfix listed at the bottom of this page.
Add "QuickPlaceEnableVersionCheck=0" to the notes.ini

Location of the notes.ini:

- Windows:

- The Lotus Domino directory

- AIX / Linux / IBM i:

- The Lotus Domino Data directory

Install Quickr Domino 8.5.1 (See the installation guide on the Quickr Wiki)
Install the latest Lotus Quickr FixPack for Quickr for Domino 8.5.3

- Windows / Linux / AIX:

- Install the FixPack using the FixPack Installer jar.

- IBM i:

- Enter the following commands to load and apply the Quickr PTF:

LODPTF LICPGM(5724S31) DEV(*SAVF) SAVF(MYLIB/LQXXXX)

APYPTF LICPGM(5724S31) SELECT(LQXXXX)

ADDLQPDOM

To Upgrade an Existing Domino 8.5.1FP5 With Quickr to Domino 8.5.3:

Upgrade your Lotus Domino 8.5.1FP5 server to Lotus Domino 8.5.3 FP1 and the hotfix listed at the bottom of this page.
Install the latest Lotus Quickr for Domino FixPack

- Windows / Linux / AIX

- Install the FixPack using the FixPack Installer jar.

- IBM i:

- End any active Quickr servers:

Enter the following command:

WRKDOMSVR

Select 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.

- Determine if any Quickr hot fixes are currently installed by entering the following command:

DSPPTF LICPGM(5724S31)

- If any PTFs are currently applied, remove them by entering the following command:

RMVPTF

- Enter the following commands to load and apply the Quickr PTF:

LODPTF LICPGM(5724S31) DEV(*SAVF) SAVF(MYLIB/LQXXXX)

APYPTF LICPGM(5724S31) SELECT(LQXXXX)

Start the Lotus Quickr for Domino server.

Required Domino 8.5.3FP1 Interim Fix:

Windows853FP1HF618

AIX853FP1HF619

Linux853FP1HF620

IBM IQL603995(for v6r1)

QL503996(for v5r4)

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.
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.

Applying a Fixpack to Quickr 8.5.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, The Lotus Quickr service is not available when FixPack installation is in progress, once the servers have been started, the service is available, but places may be locked during upgrade.

(optional) 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 updates to all servers.

When replication has finished passing the design updates to the other servers, your Quickr cluster will then be upgraded to the latest Fixpack.

How to activate ActiveX to import documents

To import a Microsoft Word document, Microsoft Excel spreadsheet, Microsoft PowerPoint presentation, HTML file, or JPEG / GIF image using the ActiveX control as was available in previous versions of Quickr, do the following:

Locate the widgetRegistryConfig_ext.js file in your widgets\resources directory:

eg:(windows)c:\Domino\data\domino\html\qphtml\widgets\resources\widgetRegistryConfig_ext.js

(unix)/local/notesdata/domino/html/qphtml/widgets/resources/widgetRegistryConfig_ext.js

The widgetRegistryConfig_ext.js file is shipped as an empty file.
If there are no modifications to this file (the file is still empty), you can copy the file widgetRegistryConfig_ext.js_ACTIVEX, which located in the same directory, directly to widgetRegistryConfig_ext.js overwriting the old one.
If this file is not empty, you will have to merge the contents of the file widgetRegistryConfig_ext.js_ACTIVEX into widgetRegistryConfig_ext.js. widgetRegistryConfig_ext.js_ACTIVEX is located in the same directory as the widgetRegistryConfig_ext.js file.
Enable the following settings in the qpconfig.xml