Quickr 8.1 Fixpack Install Instructions
Table of Contents Important information before beginning install 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
Important information before beginning install 2008/12/29 – 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 the following: 1. Install FixPack 8.1.0.5 or newer. 2. With your Domino server down, set the following NOTES.INI setting : QPTOOLREPAIR_TYPE=folder 3. Start your Domino server and run the following commands in the Domino Console waiting 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 6. Start your Domino server and run the following commands : load qptool upgrade -f -server load qptool upgrade -f -a
Page 1 of 8 1.
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 2 of 8 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 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 Upgrade all the places and PlaceTypes. Page 3 of 8 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. 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 - IMPORTANT Please see the “Important information before beginning install” This fix applies to everyone who is upgrading from section near the beginning of this document, specifically the section: either FixPack 8.1.0.3 or 8.1.0.4. 2008/12/29 – Please read if you’ve installed FixPack 8.1.0.3 OR 8.1.0.4 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 LTPASee
Page 4 of 8 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 5 of 8 Quickr Domino Release 8.1 Fix List
Page 6 of 8 FP 8.1.0.5 01/07/2009 RELS7MGP7F Performing a qptool refresh -r on a Wiki place may cause Domino to crash.
01/07/2009 JRIE7MTJ4T When using long place names, Comment Box in email notification is too long. 01/07/2009 DAMC7KWNPC While adding Members, Members lookup only displays 15 members shown in search results.
12/23/2008 MMOI7MH576 Documents show up in multiple folders after applying 8.1.0.4 hotfix 12/22/2008 CBJW7JA93W In Symphony Connector, Entry Place owned by signed in user is not blue.
12/22/2008 MMOI7MH576 Documents may appear in multiple folders. 12/22/2008 RELS7LARKR Server crash when deleting items in connectors
12/22/2008 RELS7DKVS8 "My Files" doesn't work with non-standard ports 12/22/2008 MPUL7KHLPR Author & Editor users cannot select content In Folder View
12/17/2008 RTIN7LKKW7 Some columns for shared documents are too small, so they seem cramped. Folder's favored form action button does not appear for non-managers unless the Create... link is 12/17/2008 MBAM7KVNFD hidden Domino Quickr libraries feed does not provide detailed place listing that appears in the 12/17/2008 DDUT7D2LAH corresponding J2EE feed. 12/17/2008 BBAR7L6KS4 Navigating to http://server.name.com/index.htm displays non-functional Admin console.
"From" field in qptool newletter mail shows server name instead of place name when user 12/17/2008 DAMC7LYG7S directory is configured to Domino Server.
12/17/2008 AGOR7ELN8R In Connectors, attachments in virtual folders show only the first 32 files. 12/17/2008 GMUN7LBL9D In Connectors, can't drag/drop email documents with long subject lines
12/17/2008 SHYN7LRTE3 Creating a folder with a long name in Connectors gives an error. 12/17/2008 SHYN7LRQDA Member UI lookup results shows "givenName" instead of member's actual given name
12/17/2008 DAMC7LSC3T Progress bar in large file uploads shows progress erratically, does not complete at 100% Basic place search with multiple search terms defaults to "matches any" rather than "matches all" 12/17/2008 SORA7LAME5 terms. FP 8.1.0.4
12/10/2008 XZSU7E94K5
12/10/2008 MPUL7LHLVX User Cannot Edit A Post that is Mailed Into A Place 12/10/2008 SHYN78RVV2 File does not exist error when upgrading PlaceTypes
12/10/2008 MMQS7K86B8 Error when trying to create link on table cell, edit table or insert link on a image in IE7 12/03/2008 JCHG7F7CVS Place Administration / Create New Policy user interface contains untranslated text.
12/03/2008 DYLU79J7UT My Places view: sort by owner sorts by title instead. 12/03/2008 MMOI7LAP5T Offline password does not synchronize with online password when the latter is changed.
12/03/2008 TPSG7JDELV When creating a table in the rich text editor, the table borders disappear after check in. 12/03/2008 MPUL7HUJSB Modifying a Quickr File Without Checking Out Results in Check Out On Save
12/03/2008 RELS7A3PH2 Pressing “Enter” in the rich text editor causes a double spaced line. SHYN7KXSS8 12/03/2008 Rich text editor style dropdown initially blank PNOT7BMRJ2 12/03/2008 MZHA7LACZ2 When using TAM, the logged in user’s name is proceeded by an “=”. 12/03/2008 TSNG7JRFLR Document delete does not delete the document’s versions. Page 7 of 8 12/03/2008 PKAY699P37 After signing a Placebot a draft version of the Placebot document remains in the data base
12/03/2008 SHYN7JESYV Cannot import HTML documents with Meta tags. Page 8 of 8