How to manually install or remove ActiveX upload control in QuickPlace or Quickr

Technote (FAQ)


Question

What does ActiveX do for Lotus QuickPlace or Lotus Quickr services for Lotus Domino? How can you manually install or remove it from your local client machine?

Some organizations do not allow the use of ActiveX on their servers because of security concerns. However, without it, you cannot take advantage of the integration of Lotus QuickPlace or Lotus Quickr with Microsoft® Office, cannot attach multiple files to pages for upload, drag and drop files for upload or download, and a number of other feature advantages.


Answer

(For the Lotus Quickr 8.5x for Domino release, refer to How to deploy ActiveX upload control in Quickr 8.5.x for Domino.)

There are two forms of Upload Control: ActiveX and HTML form input.

The ActiveX Upload Control provides the following features:

Attachment functionality:

  • drag and drop multiple files into the control for uploading as attachments.
  • drag and drop multiple files from the control for downloading attachments.
  • add multiple file attachments using the Windows file browser dialog.
  • remove multiple file attachments from a page.
  • download (save) the attachments into the client file system.
  • opening the attachment launches the application associated with the file and loads the attachment in it.
Microsoft Office integration functionality:
  • round-trip editing of Microsoft Office attachments directly from the control (Word, Excel, Powerpoint).
  • ability to display Microsoft Office documents in the browser (conversion of Microsoft Office documents to HTML at time of publishing the page).

The HTML Upload Control provides the following functionality:

Attachment functionality:
  • add a single file attachment to the page per publish cycle using the Windows file browser dialog.
  • remove multiple file attachments from a page.
  • download (save) the attachments into client the file system.
  • open the attachment: launches the application associated with the file attachment and load the attachment in it.
Microsoft Office integration functionality:
  • none, other than the open application ability listed above. Note: This is an Internet Explorer browser feature, not Upload Control.



How the Active-X Upload Control is Requested, Served, and Installed:

The following is a description of what happens when a browser accesses a document that requires the ActiveX Upload Control:

1. The client machine (the browser's active-x installer) checks if it has the Upload Control installed already. If it does, it extracts the Upload Control's version number.

2. If the server contains a newer version of the Control or if the client has no Upload Control installed, the browser requests to download the Upload Control from the server

3. The server serves the newer Upload Control (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 Active-X control.

5. The control is ready for use by the browser.



The easiest and most automated way to install a new control in a client machine would be to access a place document requiring the control. Normally, the server would automatically provide the control and the browser auto-installs and registers it. However, due to security concerns, this may not be possible. If this is the case, you must install and register the control manually.


TO MANUALLY INSTALL THE ACTIVEX UPLOAD CONTROL

1. The first step is to make sure there is no existing upload control in the browser. Follow step #1 in the procedure T o remove QuickPlace Upload Control from the client machine below.

2. Obtain a copy of the QP2.CAB file. You can download it directly from the Domino server and save it in your system by accessing the following URL:
      <protocol><server.domain>/QP2.CAB and
      <protocol><server.domain>/MSVCRT.CAB
    For example: http://MyQuickPlaceServer.lotus.com/qp2.cab andhttp://MyQuickPlaceServer.lotus.com/msvcrt.cab

    The Upload Control files are housed on the server. The default locations are:
    domino\data \domino\html\QP2.CAB
    domino\data\domino\html\MSVCRT.CAB
    Extract file QP2.DLL from the QP2.CAB to a directory you can access.

3. Open a command prompt (cmd) window, change directories to where you extracted QP2.DLL, and register QP2.DLL by executing the following command:

regsvr32 QP2.DLL

4. Next, check if you already have a version of MSVCRT.DLL under your WINNT\System32 directory. If yes, you are done.

5. If you do not have MSVCRT.DLL under your system directory (WINNT\System32 for Windows), you must extract it from MSVCRT.CAB and copy it there.

Note: If you have installed a HotFix that required you to replace either the QP2.CAB or MSVCRT.DLL files, please see Technote # 4006763 "Replacement .CAB Files for Manually Installing ActiveX Upload Control."


Microsoft Windows Registry Changes Made By Installing the Upload Active-X Control In the Client:

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:/WINNT/Downloaded Program Files/qp2.dll

Created and used by the Upload Control itself to keep track of upload file state for recovery purposes:
    HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\QuickPlace\<URL>




TO REMOVE THE ACTIVEX CONTROL
    NOTE: The information below is presented as a guideline for making relevant changes within the Microsoft Windows Registry. The Windows Registry is central to the operation of Windows, so any changes should be performed with great care. As with any major configuration change, it is highly recommended that customers have complete backups of their computer systems before attempting the following procedure, in order to allow recovery from system file corruption or other failures. If you require instruction about backing up and modifying the Windows Registry, contact your system administrator or reference one of the third-party guides available for advanced Windows topics.

1. Remove the QuickPlace class from browser loaded objects:
    a. From Internet Explorer's Tools menu, select Internet Options, General tab, Settings, View Objects.

    b. Delete the QuickPlace Object called the QuickPlace Class.

    c. Close all browsers in order to remove the Upload Control class from memory and any browser session space.
2. Unregister any Upload Control classes from the Registry. (This should be done automatically when you remove the control from the browser.)
    a. Open the Registry for editing.
      i. Click Start on the Windows Taskbar, select Run.

      ii. In the "Open:" field, type "regedit" (without the quotes) and click OK.

    b. Backup the current Registry. From the Regedit File menu, select Export Registry.

    c. Go to the Registry key HKEY_CLASSES_ROOT / CLSID.

    d. Find and remove QuickPlace Upload Control main class definition:   05D96F71-87C6-11d3-9BE4-00902742D6E0

    e. Find and remove QuickPlace Upload Control interface dispatcher class:  EB189910-87C5-11d3-9BE4-00902742D6E0

    f. Find and remove QuickPlace Upload Control interface events dispatcher class:  05D96F70-87C6-11d3-9BE4-00902742D6E0
     
3. Unregister any Upload Control back-tracking data from the Registry:

    a. Open the Registry for editing.

    b. Backup your current Registry.

    c. Go to the Registry key:  HKEY_LOCAL_MACHINE /  SOFTWARE  / Lotus / QuickPlace.

    d. Remove all URL keys under the QuickPlace key.




TO ENABLE UPLOAD CONTROL LOGGING

You might find it useful to temporarily enable Upload Control logging on the client machine:

1.   Create a system-wide OS environment variable:
    a. From the Windows Taskbar, select Start, Settings, Control Panel, system

    b. From the Advanced tab, click Environment Variables.

    c. Under System Variables, click New.

    d. In the Variable Name field, enter QPCTRLLOG. In the Variable Value field, enter the path and name of the log file you wish to create. For example, c:\lotus\domino\data\quickplace\myplace\

    e. Click OK and exit. Close the browser.

2.   Start a new browser session

3.   To test, upload something to the QuickPlace server (example, create a page and attach a file, then publish). The log file should now contain a sequence of events that occurred in the ACTIVEX UPLOAD CONTROL CODE (e.g. qp2.dll )

NOTE: When no longer needed, remember to remove the environment variable created in step 1 because the log file will grow indefinitely.



For more information on the use of the Regsvr32 command to unregister ActiveX controls, see the Microsoft Web site:

Related information

Deploy ActiveX upload control in Quickr 8.5 for Domino
A simplified Chinese translation is available

Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications Lotus End of Support Products Lotus QuickPlace 7.0, 6.5.1

Rate this page:

(0 users)Average rating

Document information


More support for:

Lotus Quickr for Domino
Installation

Software version:

8.0, 8.1, 8.2

Operating system(s):

AIX, IBM i, Solaris, Windows, i5/OS

Reference #:

1154131

Modified date:

2012-04-10

Translate my page

Machine Translation

Content navigation