ShowTable of Contents
Introduction
Lotus Quickr for Domino makes use of an ActiveX control to provide functions such as uploading and downloading file attachments, previewing file attachments, and general integration with Microsoft Office when using a web browser.
With the Lotus Quickr ActiveX control, you can do tasks such as:
-
import a Microsoft Office file (Word document, Excel spreadsheet, PowerPoint presentation), HTML file, or JPEG / GIF image
-
preview Microsoft Office files
-
round-trip edit of Microsoft Office files
-
drag-n-drop to upload or download files to and from Quickr
For Lotus Quickr 8.5 places using the new 8.5 theme and user interface, the dependency on ActiveX and the DnD (drag-and-drop) applet was removed (see Upgrade Overview). However, based on customer requests, 8.5.1 Fix Pack 25 (8.5.1.25) introduced ActiveX again for the 8.5x release.
How to install
To enable ActiveX, administrators, place owners, and users must take certain steps.
Steps for administrators
First, make sure you have downloaded and applied Lotus Quickr 8.5.1 for Domino fix pack 25 or later from IBM Fix Central.
To allow ActiveX to be used, the Quickr administrator must take the following steps to make ActiveX available on the Quickr server:
1. Locate the widgetRegistryConfig_ext.js file in your widgets\resources directory.
Windows default path:
c:\Domino\data\domino\html\qphtml\widgets\resources\widgetRegistryConfig_ext.js
UNIX default path:
/local/notesdata/domino/html/qphtml/widgets/resources/widgetRegistryConfig_ext.js
2.Check for modifications to widgetRegistryConfig_ext.js, as described below, then copy the file as noted.
The widgetRegistryConfig_ext.js file is shipped as an empty file.
a)If there are no modifications to this file (namely, the file is still empty), you can copy the file widgetRegistryConfig_ext.js_ACTIVEX, which is located in the same directory, directly to widgetRegistryConfig_ext.js overwriting the old one.
b)If this file is not empty, 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.
3. Enable the following settings in the qpconfig.xml file:
unknown
Edit and Save in Internet Explorer to update the Web preview.
]]>
4.Restart your Quickr server.
5.(Optional) As a good practice, clear the caches to minimize the chance of unexpected results due to cached data.
a)server-side cache. At the server's operating system level, delete all files in the "/data/domino/cache" and "/data/domino/quickplace/cache" directories to remove all server-side cache
b)browser cache. Clear all cookies and cache in your browser.
Steps for place owners or managers
Owners and managers can disable or enable the ActiveX setting using a place's basic configuration (Customize > Basics). The default is for ActiveX to be enabled.
Screen capture of ActiveX setting:
Steps for users
When you first access a Lotus Quickr place document that requires the control, you are prompted to install the ActiveX control in your browser.
Example of screen capture prompt in Internet Explorer:
Screen capture of add-on dialog box
Security warning dialog
Once you click Install, your action is complete. The server automatically provides the control, and your browser auto-installs and registers it.
(The exception is a locked-down client environment, described below.)
Behind the scenes
When a browser accesses a document that requires the Quickr ActiveX Control, the following happens:
1. The client machine (the browser's ActiveX installer) checks if it has the Control installed already. If it does, it extracts the Control's version number.
2. If the server contains a newer version of the Control or if the client has no Control installed, the browser requests to download the Control from the server
3. The server serves the newer Control (file name of qp2.cab) from the domino\data\html directory in the server machine. The browser receives it after the user accepts the security certificate.
4. The browser then auto-installs the control and registers it as an ActiveX control.
5. The Control is ready for use by the browser.
Manual install for locked-down desktops
Some companies implement a locked-down client environment, for security or control reasons. If this is the case, then administrators, or someone with privileges to install software for that machine, must install and register the ActiveX control manually because an auto-install is not possible. A procedure to do so is outlined below. There are other ways to have a new ActiveX control installed in a client machine. For example, the technote “Installing ActiveX through Group Policies for a secured environment (1214819)” describes another approach for secured environments implementing the Lotus iNotes ActiveX control. Select a procedure that works for your environment.
Steps:
1. Make sure there is no existing Quickr ActiveX control in the browser. If needed, follow the steps to remove the control in Troubleshooting below.
2. Obtain a copy of the qp2.cab file. You can download it directly from the server and save it in your system by accessing the following URL:
/qp2.cab
For example: http://example.ibm.com/qp2.cab
The file is housed on the server, with the default location being
domino\data \domino\html\qp2.cab
3. Extract all files from the qp2.cab file to a directory you can access.
4.Open a command prompt. Change directories to where you extracted qp2.dll.
5.Register qp2.dll by running the following command:
regsvr32 qp2.dll
6.Next, check if you already have a version of msvcr71.dll under your Windows System32 directory. If yes, you are done.
7.If you do not have msvcr71.dll under your system directory, copy the one extracted from qp2.cab in Step 3 to the System32 directory
Installing the control makes the following changes in the Microsoft Windows registry:
Created by the ActiveX installer:
HKEY_CLASSES_ROOT\CLSID\{05D96F71-87C6-11d3-9BE4-00902742D6E0}
HKEY_CLASSES_ROOT\Interface\{05D96F70-87C6-11D3-9BE4-00902742D6E0}
HKEY_CLASSES_ROOT\Interface\{EB189910-87C5-11D3-9BE4-00902742D6E0}
HKEY_CLASSES_ROOT\QuickPlace.QuickPlace
HKEY_CLASSES_ROOT\QuickPlace.QuickPlace.1
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID
\{05D96F71-87C6-11d3-9BE4-00902742D6E0}
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Interface
\{05D96F70-87C6-11D3-9BE4-00902742D6E0}
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Interface
\{EB189910-87C5-11D3-9BE4-00902742D6E0}
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\QuickPlace.QuickPlace
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\QuickPlace.QuickPlace.1
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Code Store Database\Distribution Units\{05D96F71-87C6-11d3-9BE4-00902742D6E0}
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
\ModuleUsage\C:/WINDOWS/Downloaded Program Files/qp2.dll
Created and used by the Quickr Control itself to keep track of upload file state for recovery purposes:
HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\QuickPlace\
Fix Pack install
Occasionally, a fix for a defect requires an update to the ActiveX control. If this is so, the fix pack's readme section “Important information before beginning install” will note when the qp2.cab file, the file associated with ActiveX control, was last updated.
If the fix pack does have an updated qp2.cab file, you as the administrator need to inform your users to accept the updated control next time they access a place. The Install prompt they will see is the same one as when first installing the control. See technote "ActiveX Control change in Lotus Quickr for Domino Fix Pack requires users to accept update" (1459505).
Troubleshooting
Use the following options to troubleshoot problems with the ActiveX control:
Clear the browser cache
If users have unexpected results after applying this update, clear their browser’s cache. Check your browser's help for how to do so.
Clear the Java cache
The user can also clear the Java cache. To do so, open the Microsoft Windows Control Panel. Look for an item named something like Java Plug-In or Java Control Panel. Open this item, find the Cache or Temporary Internet Files settings, and clear the cache.
Remove the ActiveX control
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 control the next time he or she browses to a Quickr place.
The steps to remove a control vary by browser and operating system. Example steps are provided below for Internet Explorer running on Windows XP. Depending on the browser type, the Quickr ActiveX Control might be listed as Lotus Quickr Class or as the file name qp2.dll and qp2.inf.
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.
Internet Explorer 8:
On the Programs tab, press the Manage Add-ons button.
On the Manage Add-ons dialog, find the Lotus Quickr Class (qp2.dll). If you do not see it, make sure you select to show all add-ons.
Right mouse click on the Lotus Quickr Class (qp2.dll) and select More Information.
Click the Remove button.
(For Windows Vista, first disable the control, then you can re-select and remove it.)
Removing the control
To remove the control, refer to the steps in Troubleshooting above, and if needed, clean up the Windows registry.
Resources
The following resources were used in writing this article:
Fix Pack 25 readme file, available with the fix on IBM Fix Central
What's enhanced in Lotus Quickr Fix Pack 8.5.1.25 for Domino?
http://www.lotus.com/ldd/lqwiki.nsf/dx/Whats_enhanced_in_Lotus_Quickr_Fix_Pack_85125_for_Domino
How to manually install or remove ActiveX upload control in QuickPlace or Quickr
http://www.ibm.com/support/docview.wss?uid=swg21154131
About the authors
Tate Joyner is an IBM Support engineer, currently providing support for Lotus Quickr for Domino.
Jeanmarie White is a Knowledge Manager in IBM Support. |