In some customer’s contexts you cannot install whatever you want. For policy reasons, or security. And documentum components really love to install client softwares to interact with them. In this blog we will discuss about the Documentum Administrator tool and the plugins it asks to install in order to gain full access to its functionalities.
Documentum Administrator’s plugins
DA requires at least 3 things to be installed on client machines in order to have the file transfer working:
- The browser extension (IE, Chrome, Firefox, aso)
- The NativeSetup.exe
- You will have to change some settings in the browsers as well, in order to allow the execution of some scripts for these sites, white list it, and so on
These two programs allow to transfer and view files from the Documentum Administrator web application. I think it should be the same for Webtop as it’s based on the same. Unfortunately, some customers cannot allow users, even administrators to run specific exe files on their machines. So we tried to install them manually with some policies allowance and some elevated rights but it didn’t work very well as our policies were too restrictive.
In addition we were not allowed to change some parameters in the browsers as it was managed by the security team. So what can we do?
Setup Documentum Administrator in HTTP mode
Depending on what you need to do with the DA, you can enable the HTTP mode. This mode allows to use the default browser/http transfer protocols, hence it will not require anything to be installed on the end user machine. However this mode has some drawbacks and limitations.
Here is how to enable the HTTP mode:
- Login to the web server and navigate to the exploded war file folder
- Locate the file: da/wdk/app.xml
- Change <default-mechanism> in <contentxfer> to http
- Save the file and restart the web application server
- Allow popups in the browser
Now the content transfer has been set to http mode.
Limitations
HTTP content transfer is supported for XML files but only for a single file used with the Default XML Application. For virtual documents, only the root (parent) file is transferred. The browser handles the launch of viewing and editing applications.
The checkout directory is not configurable. To checkout a document, users must select Edit, then either save the document or open and save it. On checkin, the user must navigate to the location in which the document was saved. User preferences are not supported in this mode.
Feature | UCF | HTTP |
Download to client | UCF Deployment at client side | No client-side deployment |
Drag and drop | Supported on IE Browser | Not supported |
Viewing or editing application | Configurable | Controlled by browser |
ACS support | Supported | Limited support for export or edit; not supported for view with relative links |
Progress display | Supported | Supported only by certain browser |
Preferences | Supported | Not supported |
Restart interrupted operation | Supported | Not supported |
Checkout | Supported | Limited support. User must save and select checkout location |
Edit | Supported | Limited support. User must save and select checkout location |
Checkin | Supported | Limited support. User must navigate to saved document |
View | Supported; does not transfer content if file is up to date on client | Supported; always transfers content |
Export | Supported | Supported |
Import | Supported | Limited support. Single file selection at a time, no folder import |
Client xfer tracing | Supported | Not supported |
Server xfer tracing | Supported | Supported |
File compression | Supported, with configurable exceptions | Turn on HTTP compression in web.xml |
XML application | Supported | Import single file against Default XML Application |
Virtual document | Supported | Root only |
Temp working directory for upload/download | temp.working.dir | None |
Checked out files | checkout.dir | User must save file, then check in from file |
Exported files | export.dir or user choice | Browser specific UI to select a download location |
Viewed files | viewed.dir | Browser temporary internet files location, for example, $java{user.home}Local SettingsTemporary Internet Files |
User location (base for other locations) | user.dir (defined in config file) | None |
Registry file location | registry.file | None |
Registry mode | registry.mode | None |
Log file location | logs.dir | None |
Tracing/debug | tracing.enabled | None |
File polling | file.poll.interval | None |