Quickr 8.5.1Fixpack Install Instructions

Quickr 8.5.1Fixpack 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

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

Additional Information for specialfixes

Additional Information for specialfixes before Quickr 8.5.1.25

Merging NotificationTemplate Updates

Troubleshooting

Quickr Domino Release 8.5.1 FixList

Important information before beginning install

Information for customers with locked down client environments:

This current build, 8.5.1.26-004b dated 2012/03/16doesnot have an updated qp2.cab.

The previous most recent update to qp2.cab was in 8.5.1.25-007a dated 2011/02/14.

Previous to that was 8.5.1.1-001c dated 2011/01/21.

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

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

Prerequisites:

AIXorLinux 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
aixor 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

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.

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 PowerPointpresentation, 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.jsfile inyour 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 filewidgetRegistryConfig_ext.js_ACTIVEX, which located in the same directory, directly to widgetRegistryConfig_ext.jsoverwriting 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_ACTIVEXis located in the same directory as the widgetRegistryConfig_ext.js file.
Enable the following settings in the qpconfig.xml

<unsafe_filetypes>unknown</unsafe_filetypes>

</security>

<preview_feature enabled="true">

<preview_activex enabled="true"</preview_activex>

</preview_feature>

<server_messages>

<updated_by_connector>

<![CDATA[

Edit and Save in Internet Explorer to update the Web preview.

]]>

</updated_by_connector>

</server_messages>

Restart your Quickr server and empty your web browser's cache.

*please refer to the TroubleShooting section if you have any unexpected results.

How to activate Roundtrip Editing using the ActiveX control

To use the ActiveX control for roundtrip editing a document using Internet Explorer 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_ROUNDTRIP_EDIT, 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_ROUNDTRIP_EDIT into widgetRegistryConfig_ext.js. widgetRegistryConfig_ext.js_ROUNDTRIP_EDIT is located in the same directory as the widgetRegistryConfig_ext.js file.
Enable the following settings in the qpconfig.xml

</connectors>

Restart your Quickr server and empty your web browser's cache.

*please refer to the TroubleShooting section if you have any unexpected results.

How to activate the Folder Navigator

To activate the Folder Navigator, 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_FOLDERNAV, 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_FOLDERNAV into widgetRegistryConfig_ext.js. widgetRegistryConfig_ext.js_FOLDERNAV is located in the same directory as the widgetRegistryConfig_ext.js file.
Restart your Quickr server and empty your web browser's cache.

*please refer to the TroubleShooting section if you have any unexpected results.

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

A feature was added to allow a place owner or manager the ability to set whether Authors and Editors have the rights to create a folder.

To allow a place owner or manager the ability to disable create folder rights for Authors and Editors, please set the following qpconfig.xml setting:

<server_settings>
<folder_create enabled="true" />
</server_settings>
After restarting your server and clearing your browser's cache, log into a place and go into the Customize / Basics page and uncheck the option "Folder Creation : Allow Place Editor or Place Author", that place will no longer allow an Author or Editor the ability to create folders.
To disable folder creation for Authors and Editors in a room, go into that room's Customize / Basics page and uncheck the option " Folder Creation : Allow Room Editor or Room Author".
Please note, to also prevent Authors and Editors from creating folders in a room's Table of Contents via the Connectors, you must also set the following qpconfig.xml setting.
<server_settings>
<connectors>
<checkFolderToTOC enabled="false" />
</connectors>
</server_settings>

CRAY87TRS5 - Enable the browser client to remember View preferences, such as how many items to show per page.

To enable this feature, please set the following qpconfig.xml setting

<server_settings>
<cookies>
<folder enabled="true" />
</cookies>
<server_settings>

When Quickr is configured to be used in a cluster and Domino Internet Site Documents are in use, notifications sent may use a different hostname than the cluster hostname

/ To specify which server notifications should be coming from, please set the new qpconfig.xml setting hosturl_notification:
<cluster>
<master virtual="true" ssl="false">
<port>80</port>
<hostname>qp.ibm.com</hostname>
<path_prefix</path_prefix>
</master>
<hosturl_notification>

</cluster>

When using Tivoli Access Manager (TAM) the username and password fields are not needed when a user creates a place since the user is already logged in.

To enable this feature, please set the following notes.ini setting:

QuickPlaceTAM=1

By default qptool repair repairs all issues found when parsing through a place. Those being folderEnhance,page,database,dn.

folderEnhance fixes Folders
page fixes Document issues
database fixes Database issues
dn fixes DN and Name issues /

A new notes.ini setting has been added to allow you to selectively choose which type of repair 'qptool repair' should run.