IN EMC DOCUMENTUM WEBTOP

(1)

White Paper

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

AND DROP ISSUES

TROUBLESHOOTING DRAG

IN EMC DOCUMENTUM WEBTOP

(2)

2 Troubleshooting Drag and Drop Issues in EMC Documentum Webtop

tion is accurate of is subject to change

d “as is”. EMC or warranties of any kind

ion, and

merchantability or fitness for a particular purpose.

software described in

uct names, see EMC rporation Trademarks on EMC.com.

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.

Troubleshooting Drag and Drop Issues in EMC Documentum Webtop

White paper

Part Number h8927

Published September, 2011

EMC believes the information in this publica its publication date. The information

without notice.

The information in this publication is provide Corporation makes no representations

with respect to the information in this publicat specifically disclaims implied warranties of

Use, copying, and distribution of any EMC

this publication requires an applicable software license. For the most up-to-date listing of EMC prod

Co VMware

(3)

White Paper

... 4

Audience... 5

configured in 8 ... 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

Executive summary

This whitepaper provides comprehensive information to handle the Drag and Drop ts.

Drop plug-in for non-des information ebtop, with SSL cat App Server.

This document also highlights conditions that are not supported by the Drag and Drop lso provides information about known issues in the plug-in applications

es an ActiveX and Drop function to the user’s local PC and permits the

to Webtop s to the desktop

Collaboration Services Rich Text Editor for Windows Internet

ing system with ad. Users can turn d 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.

plug-in in the EMC Documentum Webtop application. It also provides information to enable Drag and Drop support in local, global, and Citrix thin clien

This document describes the offline installation of the Drag and admin users with the 32-bit and 64-bit operating system. It also provi about the configuration support of the Drag and Drop plug-in for W configured in the Tom

plug-in. It a

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 utiliz

plug-in and http.

The plug-in extends the Drag llowing operations:

fo

o Import of desktop files o Import of Webtop file

o Drag and drop files within Webtop It also supports the following functions:

o Spell check in the

Explorer, Mozilla, and Netscape 7 o Drag and drop of multiple files

The Drag and Drop feature is supported for the Windows operat Internet Explorer browser. The plug-in requires a one-time downlo on the Drag and Drop features only when the server is configure

(5)

White Paper

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 plug-in.

rag and Drop support for local machines

p support in Webtop on individual local client machines, do

Preferences.

3. Select the Use the Drag and Drop in check-box on the General Tab. The

plug-ne.

-in to be

Drag and Drop support for global machines

op support in Webtop for all users, on the application Server do

on by default -->

lement to True in app.xml, as follows:  <enhanced_plugin>

<enabled>true</enabled>

<initial_user_state>true</initial_user_state>

Enabling Drag and Drop Support in Webtop

Configuring D

To enable Drag and Dro the following:

1. Login to Webtop. 2. Click on Tools >

in will be downloaded on the client machi

Note: You may need to exit from all open browsers for the plug downloaded accurately.

Configuring

To enable Drag and Dr 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:

<!-- Drag and Drop is turned <enabled>true</enabled> </DragDrop>

3. Change the initial_user_state e

(6)

White Paper </enhanced_plugin>

</plugins>

the user before a t to False, the user must set a preference to enable the plug-in download. If it has been set to True, all ll ActiveX plug-ins. When users log into Webtop on their client, they will be forced to download the

select the Drag and Drop option. e changes are in effect.

support in Citrix thin clients, do the following: vers with an admin account.

Webtop.

g out and close your browser.

l be enabled on thin he ActiveX plug-in option in the Internet Explorer

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

The <initial_user_state> element sets the initial plug-in state for preference is set. If the default value of the element has been se users will have the relevant privileges, which allow them to insta

in without having to navigate to preferences and Note: Stop and restart the app server to ensure that th

Configuring Drag and Drop support for thin client machines To enable Drag and Drop

1. Log into the Citrix ser 2. Login into

3. Click Preferences and enable the Drag and Drop option.

4. Lo

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 wil

clients.

Note: Ensure that you have enabled t browser settings.

(7)

White Paper Installing the Drag and Drop plug-in for a 32-bit Windows m

1. Push the cabfile to the c:\<windows>downloade

achine

d program files location. Ensure ccess this folder.

e the XceedZip.dll and ExJNIAPI.dll files in the %windir%\system32 directory. h dll with the regsvr32 utility. Run the following command to register

For example, regsvr32 wdkplugin.dll, regsvr32 XceedZip.dll

ls > Preferences. Ensure that

indows Machine the cabfile (WdkPluginCabx64.CAB) to the c:\<windows>downloaded

permission to access folder.

ll files (including WdkPluginx64.dll) from the cab file.

%\SysWOW64

ommand to register

For example, regsvr32 WdkPluginx64.dll, regsvr32 XceedZip.dll

erences. Ensure that d Drop plug-in will be enabled on users PCs. The DmDragDrop class can 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. that the user has the required permission to a

2. Extract all dll files (including wdkplugin.dll) from the cab file.

3. Plac

4. Register eac

each dll:

regsvr32 dllname

5. Access the Webtop application and navigate to Too

the Drag and Drop plug-in check box is enabled.

Installing the Drag and Drop plug-in for a 64-bit W

1. Push

program files location. Ensure that the user has the required this

2. Extract all d

3. Place the XceedZip.dll and ExJNIAPI.dll files in the %windir

directory.

4. Register each dll with the regsvr32 utility. Run the following c

each dll:

regsvr32 dllname

5. Access the Webtop application and navigate to Tools > Pref

the Drag and Drop plug-in check box is enabled. The Drag an

(8)

White Paper

Configuring support of Drag and Drop plug-in for Webtop with

dded when using SSL. not allow the L 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

.

3. Add the following line to the context.xml file:

tor.BasicAuthenticator"

Conditions not supported by the Drag and Drop plug-in

The Drag an

user

ser again and a new WDK

eated with the WDK New Window menu item.

om the desktop

d

wn 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

SSL configured in Tomcat

In Tomcat 5.5.x and 6.x, a Pragma: no-cache HTTP header is a This prevents Internet Explorer from caching the ActiveX and does installation of the Drag and Drop plug-in for Webtop with SS

installed.

1. Navigate to the <Tomcat_HOME>/conf directory. 2. Go to the file context .xml

4. Restart the App Server.

d Drop plug-in is not supported for the following conditions: o Accessibility mode is turned on by the

o A window is created by launching the brow application session appears

Note: You can Drag and Drop with a WDK window that is cr o XML documents are dragged to or fr

o Virtual documents are dragged to or from the desktop OLE compound documents need to be dragged or droppe o

(9)

White Paper signed and the Drag and Drop plug-in will not work. This issue occurs only with

Vista.

anaging the trusted root r can choose to trust company's root ations. After allowing the store to trust the

X as a signed plug-in. istrative rights. e Local Group Policy Editor

mputer Configuration > Policies.

lick the Stores tab. d root CAs to be used

options. client computers can

eboots.

ag settings for JAVA ActiveX Plug-in

the browser with the

figuration, the version of the Java plug-in to be used by Internet Explorer plug-in) can be controlled on Windows clients.

top, do the following: 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>

Windows Vista as Microsoft has changed the security policies for To overcome this issue, you must configure the settings for m certification store in Windows Vista. With these settings, the use only the company's root certifications, or can choose to trust the certifications along with other root certific

root certifications of others, Internet Explorer 7 accepts Active To manage the root certification store, do the following:

1. Login to the Windows Vista machine with the required admin 2. Open Run and execute the "gpedit.msc" command. Th

window appears.

3. In the console tree, navigate to Local Computer Policy > Co Windows Settings > Security Settings and then click Public Key 4. Double-click Certificate Path Validation Settings, and then c 5. Select the Define these policy settings check-box.

6. Under Per User Certificate Stores, select the Allow user truste

to validate certificates and Allow users to trust peer trust certificates 7. Under Root certificate stores, select the root CAs that the

trust, and then click OK to apply the new settings. The system r

Configuring object/classid t

in Webtop

If many versions of the Java ActiveX plug-in are installed in object tag con

(for the Drag and Drop

To configure object tag settings in Web

1. Navigate to the <web-app-root>/wdk directory. 2. Navigate to

(10)

White Paper plug-in can be enforced by modifying the "0016-0000-0010" value in the activex-classid element.

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.

Note: Different versions of the Java ActiveX

IN EMC DOCUMENTUM WEBTOP

EMC INFORMATION INTELLIGENCE GROUP

AND DROP ISSUES

TROUBLESHOOTING DRAG

IN EMC DOCUMENTUM WEBTOP

Table of Contents

Executive summary

Introduction

Audience

Enabling Drag and Drop Support in Webtop

SMS Push method for installing the Drag and Drop plug-in

Configuring support of Drag and Drop plug-in for Webtop with

Conditions not supported by the Drag and Drop plug-in

Drag and Drop plug-in with Microsoft Vista

SSL configured in Tomcat

ag settings for JAVA ActiveX Plug-in

Configuring object/classid t

in Webtop

Conclusion