TROUBLESHOOTING DRAG AND DROP ISSUES IN EMC DOCUMENTUM WEBTOP EMC INFORMATION INTELLIGENCE GROUP Abstract This white paper provides information to handle issues arising out of the use of the Drag and Drop plug-in in EMC Documentum Webtop. It also provides information about the configuration of the plug-in in various environments. September 2011
Copyright 2011 EMC Corporation. All Rights Reserved. Published September, 2011 EMC believes the information in this publication is accurate of its publication date. The information is subject to change without notice. The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. VMware is a registered trademark of VMware, Inc. in the United States and/or other jurisdictions. All other trademarks used herein are the property of their respective owners. White paper Part Number h8927 2
Table of Contents Executive summary...... 4 Introduction... 4 Audience... 5 Configuring support of Drag and Drop plug-in for Webtop with SSL configured in Tomcat... 8 Conditions not supported by the Drag and Drop plug-in...... 8 Drag and Drop plug-in with Microsoft Vista... 8 Configuring object/classid tag settings for JAVA ActiveX Plug-in in Webtop... 9 Conclusion... 10 3
Executive summary This whitepaper provides comprehensive information to handle the Drag and Drop plug-in in the EMC Documentum Webtop application. It also provides information to enable Drag and Drop support in local, global, and Citrix thin clients. This document describes the offline installation of the Drag and Drop plug-in for non- information admin users with the 32-bit and 64-bit operating system. It also provides about the configuration support of the Drag and Drop plug-in for Webtop, with SSL configured in the Tomcat App Server. This document also highlights conditions that are not supported by the Drag and Drop plug-in. It also provides information about known issues in the plug-in applications and the relevant resolutions. Introduction Webtop's Drag and Drop plug-in was created to enable the drag and drop function between Webtop and the file system. The Drag and Drop feature utilizes an ActiveX plug-in and http. The plug-in extends the Drag and Drop function to the user s local PC and permits the following operations: o Import of desktop files to Webtop o Import of Webtop files to the desktop o Drag and drop files within Webtop It also supports the following functions: o Spell check in the Collaboration Services Rich Text Editor for Windows Internet Explorer, Mozilla, and Netscape 7 o Drag and drop of multiple files The Drag and Drop feature is supported for the Windows operating system with Internet Explorer browser. The plug-in requires a one-time download. Users can turn on the Drag and Drop features only when the server is configured as follows: o Support for Drag and Drop is on o Support for the plug-in is on Support for the Drag and Drop feature is enabled by default, but can be disabled if required. If the plug-in support option is disabled, users will not be able to take advantage of it even if the support files have been downloaded. The Drag and Drop plug-in is packaged in a CAB file. The Windows tool to push out software will know how to install it directly. Since it is an ActiveX control, it will need to be registered. The installer does not have to add a registry entry for the Drag and Drop plug-in, and no other keys need to be created. 4
Audience This white paper is intended for IT architects, engineers, support professionals, and customers. The document provides basic directions for using the Drag and Drop plugin. Enabling Drag and Drop Support in Webtop Configuring Drag and Drop support for local machines To enable Drag and Drop support in Webtop on individual local client machines, do the following: 1. Login to Webtop. 2. Click on Tools > Preferences. 3. Select the Use the Drag and Drop plug-in check-box on the General Tab. The plug- Note: You may need to exit from all open browsers for the plug-in to be in will be downloaded on the client machine. downloaded accurately. Configuring Drag and Drop support for global machines To enable Drag and Drop support in Webtop for all users, on the application Server do the following: 1. Navigate to the <web-app-root>/wdk directory. 2. Modify the Drag and Drop enabled option to True in the app.xml file, as follows: <DragDrop> <!-- Drag and Drop is turned on by default --> <enabled>true</enabled> </DragDrop> 3. Change the initial_user_state element to True in app.xml, as follows: <plugins> <!-- Documentum Drag and Drop and spell checkin active X plugin --> <enhanced_plugin> <!-- plugins are turned on by default --> <enabled>true</enabled> <classid>759fd3de-f0ef-4a76-909c-88cf840d4173</classid> <min_version>6,5,0,301</min_version> <initial_user_state>true</initial_user_state> 5
</enhanced_plugin> </plugins> The <initial_user_state> element sets the initial plug-in state for the user before a preference is set. If the default value of the element has been set to False, the user must set a preference to enable the plug-in download. If it has been set to True, all users will have the relevant privileges, which allow them to install ActiveX plug-ins. When users log into Webtop on their client, they will be forced to download the plugselect the Drag and Drop option. in without having to navigate to preferences and Note: Stop and restart the app server to ensure that the changes are in effect. Configuring Drag and Drop support for thin client machines To enable Drag and Drop support in Citrix thin clients, do the following: 1. Log into the Citrix servers with an admin account. 2. Login into Webtop. 3. Click Preferences and enable the Drag and Drop option. 4. Log out and close your browser. 5. Login to a thin client machine. 6. Login to Webtop. 7. Enable the Drag and Drop option. 8. Log out and close your browser. Drag and Drop support will be enabled on thin clients. Note: Ensure that you have enabled the ActiveX plug-in option in the Internet Explorer browser settings. SMS Push method for installing the Drag and Drop plug-in SMS Push Method is used to install the Drag and Drop plug-in for non-admin users. For non-admin users where permissions to access Program Files locations are restricted, admin users can perform an SMS Push operation of the CAB file under wdk/native to user machines. Location of the Documentum plug-in is: webapps\webtop\wdk\native\wdkplugincab.cab 6
Installing the Drag and Drop plug-in for a 32-bit Windows machine 1. Push the cabfile to the c:\<windows>downloaded program files location. Ensure that the user has the required permission to access this folder. 2. Extract all dll files (including wdkplugin.dll) from the cab file. 3. Place the XceedZip.dll and ExJNIAPI.dll files in the %windir%\system32 directory. 4. Register each dll with the regsvr32 utility. Run the following command to register each dll: regsvr32 dllname For example, regsvr32 wdkplugin.dll, regsvr32 XceedZip.dll 5. Access the Webtop application and navigate to Tools > Preferences. Ensure that the Drag and Drop plug-in check box is enabled. Installing the Drag and Drop plug-in for a 64-bit Windows Machine 1. Push the cabfile (WdkPluginCabx64.CAB) to the c:\<windows>downloaded program files location. Ensure that the user has the required permission to access this folder. 2. Extract all dll files (including WdkPluginx64.dll) from the cab file. 3. Place the XceedZip.dll and ExJNIAPI.dll files in the %windir%\syswow64 directory. 4. Register each dll with the regsvr32 utility. Run the following command to register each dll: regsvr32 dllname For example, regsvr32 WdkPluginx64.dll, regsvr32 XceedZip.dll 5. Access the Webtop application and navigate to Tools > Preferences. Ensure that the Drag and Drop plug-in check box is enabled. The Drag and Drop plug-in will be enabled on users PCs. The DmDragDrop class can be viewed under C:\WINNT\Downloaded Program Files. Note: The 32-bit WDK plug-in can be registered on the 64-bit machine as well. It would work exactly the same as the 64-bit plug-in. Verifying the accurate installation of the Drag and Drop plug-in 1. Navigate to the Windows or WinNT directory of the Application Server and/or the client machine. 2. Verify if the Downloaded Program Files folder contain the DmDragDrop Class file. If the file is not present, it indicates that the plug-in has not been installed correctly. 7
Configuring support of Drag and Drop plug-in for Webtop with SSL configured in Tomcat In Tomcat 5.5.x and 6.x, a Pragma: no-cache HTTP header is added when using SSL. This prevents Internet Explorer from caching the ActiveX and does not allow the installation of the Drag and Drop plug-in for Webtop with SSL configured. Enable caching to activate the Drag and Drop plug-in support. Follow the procedure below to configure Tomcat with SSL, which would allow the Drag and Drop plug-in to be installed. 1. Navigate to the <Tomcat_HOME>/conf directory. 2. Go to the file context.xml. 3. Add the following line to the context.xml file: <Valve classname="org.apache.catalina.authenticator.basicauthenticator" disableproxycaching="false" /> 4. Restart the App Server. Conditions not supported by the Drag and Drop plug-in The Drag and Drop plug-in is not supported for the following conditions: o Accessibility mode is turned on by the user o A window is created by launching the browser again and a new WDK application session appears Note: You can Drag and Drop with a WDK window that is created with the WDK New Window menu item. o XML documents are dragged to or from the desktop o Virtual documents are dragged to or from the desktop o OLE compound documents need to be dragged or dropped Though Java 1.4 is recommended in the Release Notes, some known issues have been known to exist with the use of Java 1.4. Hence, Java 1.5 and higher versions are recommended for the Drag and Drop plug-in to work properly. Drag and Drop plug-in with Microsoft Vista The Drag and Drop ActiveX does not work on Microsoft Vista with Internet Explorer 7, if the user does not have the required admin rights. A warning message appears on Internet Explorer 7 when you attempt to enable the Drag and Drop plug-in. The warning message states that ActiveX plug-in has not been 8
signed and the Drag and Drop plug-in will not work. This issue occurs only with Windows Vista as Microsoft has changed the security policies for Vista. To overcome this issue, you must configure the settings for managing the trusted root certification store in Windows Vista. With these settings, the user can choose to trust only the company's root certifications, or can choose to trust the company's root certifications along with other root certifications. After allowing the store to trust the root certifications of others, Internet Explorer 7 accepts ActiveX as a signed plug-in. To manage the root certification store, do the following: 1. Login to the Windows Vista machine with the required administrative rights. 2. Open Run and execute the "gpedit.msc" command. The Local Group Policy Editor window appears. 3. In the console tree, navigate to Local Computer Policy > Computer Configuration > Windows Settings > Security Settings and then click Public Key Policies. 4. Double-click Certificate Path Validation Settings, and then click the Stores tab. 5. Select the Define these policy settings check-box. 6. Under Per User Certificate Stores, select the Allow user trusted root CAs to be used to validate certificates and Allow users to trust peer trust certificates options. 7. Under Root certificate stores, select the root CAs that the client computers can trust, and then click OK to apply the new settings. The system reboots. Configuring object/classid tag settings for JAVA ActiveX Plug-in in Webtop If many versions of the Java ActiveX plug-in are installed in the browser with the object tag configuration, the version of the Java plug-in to be used by Internet Explorer (for the Drag and Drop plug-in) can be controlled on Windows clients. To configure object tag settings in Webtop, do the following: 1. Navigate to the <web-app-root>/wdk directory. 2. Navigate to the file app.xml file. 3. In the app.xml file, go to the applet tag and make the following changes: <applet-tag> <mode>object</mode> <plugin-manual-install></plugin-manual-install> <activex-classid>cafeefac-0016-0000-0010-abcdeffedcba </activex-classid> <activex-install></activex-install> </applet-tag> 9
Note: Different versions of the Java ActiveX plug-in can be enforced by modifying the "0016-0000-0010" value in the activex-classid element. Conclusion This document is a guide to enable and use the Drag and Drop plug-in. It also describes the method to install the plug-in directly. This document will also help users in configuring the Drag and Drop plug-in in Windows Vista. 10