EMC ® Documentum ® Mobile Version 1.0
Installation Guide
EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com
EMC believes the information in this publication is accurate as 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. All other trademarks used herein are the property of their respective owners. © Copyright 2011 EMC Corporation. All rights reserved.
Table of Contents
Preface Chapter 1
.................................................................................................................................
7
......................................................................................................
9
What is EMC Documentum Mobile? ...................................................................
9
Overview
Components of EMC Documentum Mobile ......................................................... 9 EMC Documentum Mobile App .................................................................... 10 EMC Documentum Mobile WAR ................................................................... 10 Other components ........................................................................................ 10 Chapter 2
Chapter 3
Chapter 4
Chapter 5
........................................................... Preparing for installation .................................................................................. Installation considerations............................................................................. Install a Thumbnail Server patch ................................................................... Modifications to Content Transformation Services products ............................ Understanding the modification procedure ................................................ Media Transformation Services — System Profiles ...................................... Advanced Document Transformation Services — System Profiles ................ Audio/Video Transformation Services — Command Line Files ................... Deploy DAR files .......................................................................................... Collaboration Services DAR ...................................................................... Mobile BPM DAR ..................................................................................... Installing a DAR file with the DAR Installer ............................................... Deploying a DAR using an Ant Task .......................................................... Install the application server.......................................................................... JBoss ........................................................................................................ Tomcat ..................................................................................................... Download the EMC Documentum Mobile WAR ............................................. Verify the connection broker.......................................................................... Identifying a Connection Broker in dfc.properties ....................................... Checking Connection Broker and repository services .................................. Secure Sockets Layer (SSL) ................................................................................ Using a proxy server ......................................................................................... Deploying the EMC Documentum Mobile WAR ................................................. Verifying the server deployment ........................................................................
Installing EMC Documentum Mobile
Configuration
13 13 13 14 14 14 15 16 16 17 17 17 18 19 20 20 20 21 21 21 21 22 22 22 24
.............................................................................................. 25
Disabling Keep and Email in the client ............................................................... Mobile server configuration options ...................................................................
25 26
Uninstalling EMC Documentum Mobile ....................................................... Uninstalling the server component from JBoss ....................................................
29 29
Uninstalling the server component from Tomcat .................................................
29
Technical Notes
........................................................................................... 31
EMC Documentum Mobile Version 1.0 Installation Guide
3
Table of Contents
Case sensitive searches......................................................................................
4
31
EMC Documentum Mobile Version 1.0 Installation Guide
Table of Contents
List of Tables
Table 1.
DAR installer fields ..............................................................................................
EMC Documentum Mobile Version 1.0 Installation Guide
18
5
Table of Contents
6
EMC Documentum Mobile Version 1.0 Installation Guide
Preface
This guide provides step-by-step procedures for installing the EMC Documentum Mobile server component. It lists installation prerequisites and provides step-by-step instructions for installing and uninstalling the server component. In addition, this manual includes a brief overview of the EMC Documentum Mobile architecture. The following documents are also available for EMC Documentum Mobile: • EMC Documentum Mobile Release Notes: Includes detailed requirements and certifications for this version. This document also references some known problems and limitations. • EMC Documentum Mobile Help: The in-App Help for EMC Documentum Mobile is accessible through the Help button located in the top left corner of the App. The Help contains useful information for users such as configuring a profile and settings, browsing the library, searching, viewing assets and properties, commenting, completing tasks, and keeping local copies of assets.
Intended audience This guide is intended for the person who installs and configures system products, often called the system administrator or system operator. It is assumed that the system operator has a basic understanding of the chosen operating system, as well as application server deployment.
Revision history The following changes have been made to this document. Revision Date
Description
August 2011
Initial publication
EMC Documentum Mobile Version 1.0 Installation Guide
7
Preface
8
EMC Documentum Mobile Version 1.0 Installation Guide
Chapter 1 Overview
This chapter contains the following sections: • What is EMC Documentum Mobile?, page 9 • Components of EMC Documentum Mobile, page 9
What is EMC Documentum Mobile? EMC Documentum Mobile is the take-anywhere access to EMC Documentum repositories. Available for anyone with an Apple iPad the EMC Documentum Mobile App allows Documentum repository users to perform common tasks from virtually anywhere that they have internet access. Use this application to perform common tasks in an EMC Documentum repository such as: • Browsing a repository library • Quick access to favorite and watched items, among others, using Home Screen icons • Searching for items • Viewing items (properties and files) • Emailing items • Downloading local copies of items • Commenting on items and tasks • Completing workflow tasks • Access to CenterStage Spaces, including Collaboration Wikis, Blogs, and Discussions
Components of EMC Documentum Mobile This section details the components that make up an installation of EMC Documentum Mobile.
EMC Documentum Mobile Version 1.0 Installation Guide
9
Overview
EMC Documentum Mobile App The EMC Documentum Mobile iPad App is available through the Apple App Store (accessible in iTunes or the App Store on your iPad device). You may access the App Store through the EMC Documentum Mobile web site: http://www.EMC.com/DocumentumMobile
EMC Documentum Mobile WAR The EMC Documentum Mobile WAR file is deployed on the application server. You can deploy the WAR on the following application servers: • Red Hat JBoss • Apache Tomcat
Other components It is assumed that you have the following products or components already installed and running successfully in your Documentum system. Required: • EMC Documentum Content Server • One or more Documentum clients: — EMC Documentum CenterStage — EMC Documentum Media WorkSpace — EMC Documentum Webtop — EMC Documentum Digital Asset Manager • Mobile BPM DAR to support Quickflow tasks created in repositories that do not have BPM installed. It is an optional component, but required if you use Quickflows in other Documentum clients. (See Deploy DAR files, page 17.) • EMC Documentum Thumbnail Server to serve format icons and thumbnails to the App. As of version 6.5, Thumbnail Server is included as part of the Documentum Platform Bundle in the Documentum Download Center.
10
EMC Documentum Mobile Version 1.0 Installation Guide
Overview
Optional: • Collaboration Services DAR to support commenting in the application. (See Deploy DAR files, page 17.) • EMC Documentum Content Transformation Services products (for example, Document Transformation Services, Advanced Document Transformation Services, Media Transformation Services, or Audio/Video Transformation Services) to produce renditions and thumbnails of assets.
EMC Documentum Mobile Version 1.0 Installation Guide
11
Overview
12
EMC Documentum Mobile Version 1.0 Installation Guide
Chapter 2 Installing EMC Documentum Mobile
This chapter contains the following sections: • Preparing for installation, page 13 • Secure Sockets Layer (SSL), page 22 • Using a proxy server, page 22 • Deploying the EMC Documentum Mobile WAR, page 22 • Verifying the server deployment, page 24
Preparing for installation The following sections detail the tasks that must be completed before running the EMC Documentum Mobile server component. • Installation considerations, page 13 • Install a Thumbnail Server patch, page 14 • Modifications to Content Transformation Services products, page 14 • Deploy DAR files, page 17 • Install the application server, page 20 • Download the EMC Documentum Mobile WAR, page 21 • Verify the connection broker, page 21
Installation considerations The following should be considered before beginning installation: • The EMC Documentum Mobile server component is a web application and can be deployed on any host that supports a certified application server and can see the Documentum Content Server serving the repositories that will be viewed through the Mobile app. • If load balancing is required, the application server can be hosted behind a load balancer without the need for sticky sessions.
EMC Documentum Mobile Version 1.0 Installation Guide
13
Installing EMC Documentum Mobile
Install a Thumbnail Server patch EMC Documentum Mobile requires new default icons to accommodate the iPad viewing area. To deploy these icons perform the following procedure: Caution: Ensure that all thumbnails in the repository are backed up prior to executing these steps. 1.
Download the file Mobile_Application_Thumbnails.zip from the Documentum Mobile area in the Documentum Download Center to a temporary location on the Content Server.
2.
Stop the Thumbnail Server (it is a service on Windows or a batch file on Unix).
3.
Using Documentum Administrator, login to the repository as an Admin user (do this for all repositories that the mobile application will connect to).
4.
Navigate to \System\ThumbnailServer\thumbnails
5.
Delete the “formats” and “types” folders, including all subfolders and versions.
6.
On the Content Server, extract the contents of Mobile_Application_Thumbnails.zip to the following location, choosing to overwrite existing folders and files if prompted: \product\\thumbsrv\container\webapps\thumbsrv
7.
Start the Thumbnail Server.
Note: Display of default thumbnails in the repository will be delayed while all thumbnails are reloaded into the repository.
Modifications to Content Transformation Services products It is recommended to make changes to applicable Content Transformation Services products for best viewing with the EMC Documentum Mobile client. The following sections detail how to make the changes as well as the specific changes that are necessary for each product.
Understanding the modification procedure All transformation profiles can be found in the System cabinet of your repository. Use an application such as Documentum Administrator to access the folders that contain Content Transformation Services profiles. When you need to modify profiles, check out the files from these folders. The transformation profile components are stored in these locations in the repository: • /System/Media Server/Command Line Files This folder stores command-line files as dm_sysobject objects. If you want to modify command-line files, you must hold a developer’s license. • /System/Media Server/Profiles
14
EMC Documentum Mobile Version 1.0 Installation Guide
Installing EMC Documentum Mobile
This folder stores profiles as dm_media_profile objects. These are the user profiles that are exposed by the client application, such as Digital Asset Manager. • /System/Media Server/System Profiles This folder stores profiles as dm_media_profile objects. These are the system profiles that are only used internally by Content Transformation Services, and are not exposed through the client application. Note: If multiple Content Transformation Services products are configured for a repository, these folders will contain profiles for all the products. For example, if both Document Transformation Services and Media Transformation Services are configured for the same repository, the Profiles folder will contain all user profiles for both products. The files are not segregated by product; they are simply listed alphabetically. Caution: The profile folder locations listed above indicate where the profiles are placed when you install your CTS product(s). The paths to these profiles are coded in all files that invoke other profiles. For example, the register profile may invoke other system profiles, and many system profiles invoke command-line files. If you change the location of these folders, you must modify the paths within the profile files accordingly. Otherwise, transformations will fail. After you modify a dm_media_profile object and check it in, CTS automatically refreshes the profile without the need for a restart.
To modify a transformation profile: 1.
Log in to the repository using an appropriate application.
2.
Check out the profile you want to modify. Note: If these files are not immediately visible, select Show All Objects and Versions from the Show list box.
3.
Open the profile in an XML or text editor. Make the necessary changes and save the file.
4.
Check in the profile.
The profile has now been modified.
Media Transformation Services — System Profiles Change the following values in the register.xml System Profile to enhance the quality and maintain the appropriate aspect ratio of the renditions used for PowerPoint files that are imported into the Documentum repository:
LocalProfileToken="200" InnerProfileToken="doc_token_width_tn_large" LocalProfileToken="200" InnerProfileToken="doc_token_height_tn_large" LocalProfileToken="600" InnerProfileToken="doc_token_width_lressb" LocalProfileToken="600" InnerProfileToken="doc_token_height_lressb"
To:
EMC Documentum Mobile Version 1.0 Installation Guide
15
Installing EMC Documentum Mobile
LocalProfileToken="200" InnerProfileToken="doc_token_width_tn_large" LocalProfileToken="150" InnerProfileToken="doc_token_height_tn_large" LocalProfileToken="1500" InnerProfileToken="doc_token_width_lressb" LocalProfileToken="1125" InnerProfileToken="doc_token_height_lressb"
Change the following values in the pdf_processing.xml System Profile to generate a large preview rendition for every page in a document:
To:
Advanced Document Transformation Services — System Profiles Change the following values in the pdf_processing.xml System Profile to generate a large preview rendition for every page in a document:
To:
Audio/Video Transformation Services — Command Line Files The iPad requires a new video rendition to preview video content. To generate a playable video preview format, remove the comment tags around the MPEG4 PROXY section of the file and then change the following lines within the file telestream_registration.xml: 320 240
To: 720 480
16
EMC Documentum Mobile Version 1.0 Installation Guide
Installing EMC Documentum Mobile
Deploy DAR files EMC Documentum Mobile requires two DAR files in your system: • Collaboration Services DAR, page 17 • Mobile BPM DAR, page 17 Two options are available for deploying DAR files: • Installing a DAR file with the DAR Installer, page 18 (recommended) • Deploying a DAR using an Ant Task, page 19 For more information about deploying DAR files, see the Documentum Composer User Guide.
Collaboration Services DAR To enable commenting within the EMC Documentum Mobile application, install the Collaboration Services DAR file that is compatible with your Documentum Content Server or with the Documentum Client that you may also enable for commenting capabilities. The Collaboration Services DAR file can be obtained from one of the following locations of the Documentum Download Center: • Documentum Collaborative Services 6.6 • Documentum Collaborative Services 6.7 • Documentum Media WorkSpace, Version 6.5 SP3 • CenterStage Pro Multi Server, Version 1.2 Install the Collaboration Services.DAR file on the global repository and any working repository to be accessed by EMC Documentum Mobile. If the Collaboration Services DAR file has already been deployed, you do not have to do it again. This can be verified through Documentum Administrator.
Mobile BPM DAR The Mobile BPM DAR needs to be run if you are using Quickflow tasks without having BPM configured. The file Mobile-BPM.dar is available from the EMC Documentum Mobile area in the Documentum Download Center. Install the Mobile BPM.DAR file on the global repository and any working repository to be accessed by EMC Documentum Mobile.
EMC Documentum Mobile Version 1.0 Installation Guide
17
Installing EMC Documentum Mobile
Installing a DAR file with the DAR Installer You can use the DAR Installer to install the Collaboration Services.DAR to a repository if you do not want to use the interface within Composer. The DAR Installer requires Composer to be installed, but does not launch the full Composer IDE. When you open the DAR Installer, it creates three folders in your Composer installation directory: • darinstallerconfig – contains configuration files for the DAR Installer Plugin • darinstallerlogs – the default location of the log files • darinstallerworkspaces – workspaces that are created and used by the DAR Installer Plugin. The DAR Installer Plugin does not delete these workspaces automatically after installation of the DAR file. The workspace directories are named in the following form: darinstaller_workspace_yyyy-mm-dd-hh-mm-ss. Moving, deleting, or adding projects manually to the workspace might have adverse effects on DAR installations. The DAR Installer requires you to fill in certain values that are marked with an asterisk (*). All other fields are optional. For a description of the fields for the DAR Installer plug-in, see Table 1, page 18.
To install a DAR file: 1.
Run dardeployer.exe, which is located in the Composer root directory, to start the DAR Installer.
2.
In the DAR Details section, specify values for the fields.
3.
In the Connection Broker Details section, specify values for Connection Broker Host and Connection Broker Port and click Connect.
4.
In the Repository Details section, specify values for the fields and click Install to install the DAR file to the repository.
You can view the log for the DAR installation by selecting the log file from the Log File drop down menu and clicking Open. Table 1. DAR installer fields
Parameter
Required
Description
DAR
Yes
The absolute file path to the .dar file that you want to install. The file path cannot contain any international characters or the installation will fail.
Input File
No
The absolute file path to the install-based parameter file.
Local Folder
No
The absolute file path to localized .properties files. If you want to make your application available in other languages, localize the project data such as labels, tabs, and descriptions.
18
EMC Documentum Mobile Version 1.0 Installation Guide
Installing EMC Documentum Mobile
Parameter
Required
Description
Log File
No
The file to save the log to. If this is not specified, the file defaults to .log.
Connection Broker Host
Yes
The address of the Connection Broker.
Connection Broker Port
Yes
The port of the Connection Broker Repository.
Repository
Yes
The name of the repository that you want to install the DAR file to. Click the Connect button after entering the Docbroker host and port to retrieve the available repositories.
User Name
Yes
The login name for the repository.
Password
Yes
The password for logging in to the repository.
Domain
No
The domain of the user.
Locale Folder
No
The absolute file path to localized .properties files.
Deploying a DAR using an Ant Task You can deploy a DAR using the Ant task emc.install. Create an XML file that sets the following parameters. Parameter
Required
Description
dar
Yes
The absolute file path to the .dar file.
inputfile
No
The absolute file path to the install-based parameter file.
docbase
Yes
The name of the repository into which the .dar file is installed.
username
Yes
The login name for the repository.
password
Yes
The password for logging in to the repository.
EMC Documentum Mobile Version 1.0 Installation Guide
19
Installing EMC Documentum Mobile
Parameter
Required
Description
domain
No
The domain in which the repository resides.
localesFolder
No
The absolute file path to localized .properties files.
The following example XML file installs the DAR file Collaboration Services.DAR in the testrepo repository. This is ant script code used to install a DAR in a repository.
Install the application server Install the application server on the EMC Documentum Mobile server host, according to the application server’s instructions. For this release, Red Hat JBoss and Apache Tomcat are supported as application servers. Please refer to the EMC Documentum Mobile Release Notes for specific versions.
JBoss Red Hat JBoss is a third-party product. For installation information, visit the Red Hat web site. At the time of publishing this guide, the link to the 4.3 installation guide is http://docs.redhat.com/docs/enUS/JBoss_Enterprise_Application_Platform/4.3/html/Installation_Guide/index.html. You can find the Jboss 5 installation guide at http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Application_ Platform/5/html/Installation_Guide/index.html.
Tomcat Apache Tomcat is an open source product. For installation information, visit the Apache Software Foundation web site. At the time of publishing this guide, the link to the setup instructions is http://tomcat.apache.org/tomcat-6.0-doc/setup.html. For a discussion of load balancing for Apache Tomcat, see http://tomcat.apache.org/connectors-doc/ generic_howto/loadbalancers.html.
20
EMC Documentum Mobile Version 1.0 Installation Guide
Installing EMC Documentum Mobile
Download the EMC Documentum Mobile WAR Before beginning the installation process, it is best to have the installer ready and available on your host. The EMC Powerlink site (http://powerlink.emc.com) provides access to the EMC Software Download Center https://emc.subscribenet.com where a complete listing of products is available for download. Download the EMC Documentum Mobile server installer to a temporary directory on your host. Unzip any zipped files before you proceed with the installation.
Verify the connection broker Prior to installation, verify the following: • If you already have a dfc.properties file, it is pointing to the correct Connection Broker. Identifying a Connection Broker in dfc.properties, page 21 provides instructions. • The Connection Broker and repository services are running on your Content Server. Checking Connection Broker and repository services, page 21 provides more information on this topic.
Identifying a Connection Broker in dfc.properties If you already have Documentum Foundation Classes (DFC) installed on your host, you will have a dfc.properties file. Follow this procedure to ensure that the correct Connection Broker is specified If you are installing on a clean host, you will not have a dfc.properties prior to installation; in this case, the following procedure is not required. For more information on the Connection Broker, see the Content Server Administration Guide.
To identify the correct Connection Broker in dfc.properties: 1.
Search for the dfc.properties file on your host. The file is usually located in the Windows (C:\Documentum\config.) folder.
2.
Open dfc.properties in a text editor.
3.
Find the line indicating the Connection Broker. Ensure that the specified Connection Broker is the one that contacts the repository. Change it if necessary.
4.
Save and close the dfc.properties file.
Checking Connection Broker and repository services The Connection Broker and repository services must be running properly on the Content Server host before you install the product. The Content Server Administration Guide can be referenced for information and instructions pertaining to Connection Broker and repository services.
EMC Documentum Mobile Version 1.0 Installation Guide
21
Installing EMC Documentum Mobile
Secure Sockets Layer (SSL) The EMC Documentum mobile client passes the username and password to the Mobile Server unencrypted. This limitation requires that the Mobile server be implemented over HTTP using SSL to encrypt passwords during communication from the client. EMC Documentum Mobile supports SSL and requires no special configuration. For more information, see the Documentum Administrator User Guide, Managing User Authentication.
Using a proxy server Proxy servers can be integrated into the distributed content architecture to provide additional security to customer deployments. They can also provide caching benefits and traffic monitoring. Reverse proxy servers provide protection to the back end environments. They work in parallel with firewall configurations so that only the reverse proxy host has access to the back end environment. HTTP requests from the outside world are intercepted by the reverse proxy server and passed to the back end servers. If you are using a proxy server, ensure the following are accessible through the firewall: • Application Server port • Thumbnail Server url • ACS (Accelerated Content Store) url For more information about configuring ACS using a reverse proxy, see the Distributed Content Configuration and Troubleshooting Guide.
Deploying the EMC Documentum Mobile WAR If you have satisfied all of the pre-installation requirements in Preparing for installation, page 13 then you are ready to deploy the EMC Documentum Mobile server component (WAR).
To deploy the EMC Documentum Mobile WAR on JBoss: 1.
Ensure the file emc-documentum-rs-mobile.war is in a temporary directory on your EMC Documentum Mobile server host.
2.
Stop the JBoss application server.
3.
Extract the emc-documentum-rs-mobile.war to a folder called mobile.war.
4.
Navigate to the folder mobile.war\WEB-INF\classes.
5.
Open the dfc.properties file using a text editor and enter the correct values for the following properties: • dfc.docbroker.host[0] • dfc.docbroker.port[0]
22
EMC Documentum Mobile Version 1.0 Installation Guide
Installing EMC Documentum Mobile
• dfc.globalregistry.repository • dfc.globalregistry.username • dfc.globalregistry.password 6.
Save and close the file.
7.
Copy the mobile.war folder and its contents to the deploy folder on the JBoss instance.
8.
Start the JBoss server.
To deploy the EMC Documentum Mobile WAR on Tomcat: 1.
Ensure the file emc-documentum-rs-mobile.war is in a temporary directory on your EMC Documentum Mobile server host.
2.
Stop the Tomcar application server.
3.
Extract the emc-documentum-rs-mobile.war to a folder called mobile.
4.
Navigate to the folder mobile\WEB-INF\classes.
5.
Open the dfc.properties file using a text editor and enter the correct values for the following properties: • dfc.docbroker.host[0] • dfc.docbroker.port[0] • dfc.globalregistry.repository • dfc.globalregistry.username • dfc.globalregistry.password
6.
Save and close the file.
7.
Copy the mobile folder and its contents to the webapps folder on the Tomcat instance..
8.
Start the Tomcat server.
EMC Documentum Mobile Version 1.0 Installation Guide
23
Installing EMC Documentum Mobile
Verifying the server deployment After deploying the EMC Documentum Mobile server component, you can verify that the installation was successful.
To verify that the server is running: 1.
You can validate that the application is running by accessing the following URL in a browser: http://:/mobile You will see a page titled "EMC Documentum Mobile RESTful Services".
24
EMC Documentum Mobile Version 1.0 Installation Guide
Chapter 3 Configuration
This chapter details any configuring options for EMC Documentum Mobile. • Disabling Keep and Email in the client, page 25 • Mobile server configuration options, page 26
Disabling Keep and Email in the client The ability to Keep (save) or Email (share) files within the mobile application can be disabled globally by modifying a properties file on the Mobile Server deployment. When disabled, the options to Keep (save) or Email (share) an item will no longer appear in the EMC Documentum Mobile App.
To disable the Keep and/or Email menu items in the EMC Documentum Mobile App: 1.
Stop the application server.
2.
Navigate to: MOBILE_HOME\WEB-INF\classes
3.
Open the file mobile-client-settings.properties in a text editor.
4.
The default settings are: disable.local.save=false disable.local.share=false
5.
Set the options to true to disable them.
6.
Save and close the file.
7.
Clear the application server caches (work and tmp directories).
8.
Restart the application server.
EMC Documentum Mobile Version 1.0 Installation Guide
25
Configuration
Mobile server configuration options In the EMC Documentum Mobile app server, the file mobile-server-settings.properties contains a number of configuration options: • The formats that will be identified within the application as video content by adding/removing the Documentum Format names to the list for “video.format.strings”. The default values are: quicktime, mp3, mpeg-4a, mpeg-4v, f4v, wmv • The preference order for previewing video formats by adding/removing the Documentum Format names to the list for “video.preview.format.lookup.order”. The default values are: quicktime, mp3, mpeg-4a, mpeg-4v, f4v • The preference order for previewing single page content formats (that is, Images) by adding/removing the Documentum Format names of the renditions to the list for “singlepage.content.preview.format.lookup.order”. The default values are: jpeg_preview, jpeg_lres • The preference order for previewing multi page content formats (that is, Documents and PowerPoint files) by adding/removing the Documentum Format names of the renditions to the list for “multipage.content.preview.format.lookup.order”. The default values are: jpeg_preview, jpeg_lres, jpeg_story • The flag to control whether image previews (that is, storyboard images) will be used for video content in the absence of a playable video preview format by updating the true/false value for “video.preview.fallback.enable”. The default is true. • The list of audio formats used when filtering searches based on audio can be configured by adding/removing the Documentum Format names for “search.filter.audio.formats”. The default values are: aiff, aiff-c, hcom, mod, mp3, mpeg-4a, snd, ra, wma, wax, wave, a-law, au, u-law • The list of video formats used when filtering searches based on audio can be configured by adding/removing the Documentum Format names for “search.filter.video.formats”. The default values are: asf, asx, mpeg, mpeg-4v, mpeg2, quicktime, rm, ram, rmm, rnx, rv, scam, wmv, wvx, avi, f4v • The list of image formats used when filtering searches based on audio can be configured by adding/removing the Documentum Format names for “search.filter.image.formats”. The default values are: bmp, dib, dng, eps, freehand1image, freehand1template, freehand2image, freehand2template, freehand3image, gif, hpgl, iges, illustrator1, illustrator, illustrator5, illustrator88, illustrator11, image, indesign2, indesign3, indesign4, jpeg2000, jpeg, jpeg_lres, jpeg_lres_xl, jpeg_preview, jpeg_story, jpeg_th, pcd, macdrawp, macdraw, pgm, ppm, pcx, pict, photoshop, photoshop3, photoshop6, photoshop7, photoshop8, pbm, png, quark, quark4, quark4_report, quark5, quark5_report, quark6_report, quark6, svg, sct, sgi, ras, sun, tif, tiff, tga, wbmp • The list of document formats used when filtering searches based on audio can be configured by adding/removing the Documentum Format names for “search.filter.document.formats”. The default values are: pdf_oct, pdf, pdftext, dxf, acad, dwf, exceltextreport, csv, filemaker2, filemakerpro, filemakerpro3, filemakerpro4, richtext, freehand1image, freehand1template, freehand2image, freehand2template, freehand3image, indesign2, indesign3, indesign4, indesign5, indesign6, indesign7, lotus123w, excel2sheet, excel, excel4book, excel4sheet, excel12bbook, excel12mebook, excel12metemplate, excel8template, excel12book, excel12template, excel8book, excel5book, ppt_mac3, ppt_win3, ppt_mac4, ppt_win4, ppt_win7, ppt12me, ppt12meslideshow,
26
EMC Documentum Mobile Version 1.0 Installation Guide
Configuration
ppt12metemplate, ppt12, ppt8, ppt12_slide, ppt8_slide, ppt8slideshow, ppt12slideshow, pps, ppt12template, ppt8_template, powerpoint, msproject_calendar, msproject, msproject_view, mps, mpt, mpw, vsd1, vsd2, vsd3, vsd4, vsd, vss, vst, vsw, mswm1, msww, msw3, msw, mswm, msw6, msw6template, msw12, msw8, msw12me, msw12metemplate, msw12template, msw8template, pagemaker1pub, pagemaker2pub, pagemaker3pub, pagemaker3template, pagemaker4pub, pagemaker4template, pagemaker, pagemaker5template, ps, quark, quark4, quark5, quark6, rtf, mactext, text, crtext, wpmac1, wp10+, wpmac, wpmac3, wp, wpw, wp5, wp6, wp7, wp8, wordstar, wordstar2000, xml, att, rls, rlx, ctm, hhf, mcr, tbr, zip_pub_html, zip_html
To change any configuration options in the EMC Documentum Mobile App: 1.
Stop the application server.
2.
Navigate to: MOBILE_HOME\WEB-INF\classes
3.
Open the file mobile-server-settings.properties in a text editor.
4.
Change any options as required.
5.
Save and close the file.
6.
Clear the application server caches (work and tmp directories).
7.
Restart the application server.
EMC Documentum Mobile Version 1.0 Installation Guide
27
Configuration
28
EMC Documentum Mobile Version 1.0 Installation Guide
Chapter 4 Uninstalling EMC Documentum Mobile
This chapter details the procedures required to uninstall EMC Documentum Mobile from your application server. • Uninstalling the server component from JBoss, page 29 • Uninstalling the server component from Tomcat, page 29
Uninstalling the server component from JBoss To remove the EMC Documentum Mobile WAR from JBoss: 1.
Stop the application server.
2.
Delete the mobile.war folder and its contents from the deploy folder on the app server instance.
3.
If reinstalling, delete the work and tmp folders from the app server instance.
Uninstalling the server component from Tomcat To remove the EMC Documentum Mobile WAR from Tomcat: 1.
Stop the application server.
2.
Delete the mobile folder and its contents from the webapps folder on the app server instance.
3.
If reinstalling, delete the work folder from the app server instance.
EMC Documentum Mobile Version 1.0 Installation Guide
29
Uninstalling EMC Documentum Mobile
30
EMC Documentum Mobile Version 1.0 Installation Guide
Chapter 5 Technical Notes
This chapter details some technical or usability notes that may help with installing or configuring the EMC Documentum Mobile server component. • Case sensitive searches, page 31
Case sensitive searches Like any Documentum client, searches that are performed using EMC Documentum Mobile are always case sensitive unless a search indexing service is running on the server host.
EMC Documentum Mobile Version 1.0 Installation Guide
31
Technical Notes
32
EMC Documentum Mobile Version 1.0 Installation Guide
Index
A
D
Advanced Document Transformation Services, 11 modifications, 16 Apache Tomcat. See Tomcat application server deploying WAR, 22 installing, 20 uninstalling WAR, 29 Audio/Video Transformation Services, 11 modifications, 16
DAR file installation, 10 to 11, 17 DAR files Ant task deployment, 19 installing using the DAR Installer, 18 DAR Installer Plug-in, 18 description product, 9 DFC and dfc.properties, 21 dfc.properties identifying a Connection Broker, 21 Digital Asset Manager, 10 Document Transformation Services, 11 documentation product, 7 Documentum CenterStage, 10 Documentum Digital Asset Manager, 10 Documentum Media WorkSpace, 10 Documentum Webtop, 10
C CenterStage, 10 client configuring, 25 Collaboration Services DAR installation, 17 components Collaboration Services DAR, 11 Content Server, 10 Content Transformation Services, 11 Documentum client, 10 EMC Documentum Mobile App, 10 EMC Documentum Mobile WAR, 10 Mobile BPM DAR, 10 product, 9 to 10 Thumbnail Server, 10 configuring EMC Documentum Mobile App, 25 to 26 Connection Broker checking services, 21 identifying in dfc.properties, 21 verifying, 21 Content Server, 10 Connection Broker, 21 repositories, 21 Content Transformation Services, 11 modifications, 14
EMC Documentum Mobile Version 1.0 Installation Guide
E email files disabling, 25
G global repository, 17
I installation components, 9 considerations, 13 Content Transformation Services, 14 installers downloading, 21 installing DAR file using the DAR Installer, 18
33
Index
DAR files using Ant task, 19 Thumbnail Server, 14
J JBoss deploying WAR, 22 installing, 20 removing WAR, 29
K keep files disabling, 25
M Media Transformation Services, 11 modifications, 15 Media WorkSpace, 10 Mobile BPM DAR installation, 17
T Thumbnail Server, 10 install patch, 14 Tomcat deploying WAR, 23 installing, 20 load balancing, 20 removing WAR, 29
U
P
uninstalling EMC Documentum Mobile, 29 user profiles locating, 14
proxy server support, 22
V
Q Quickflows, 10, 17
R Red Hat JBoss. See JBoss repository checking, 21
S searching case sensitive, 31
34
Secure Sockets Layer. See SSL server configuring, 26 SSL support, 22 system profiles locating, 15
verification Connection Broker, 21 verifying deployment of WAR, 24
W WAR, 10 deploying, 22 downloading, 21 verifying deployment, 24 Web Archive files (WARs). See WAR Webtop, 10
EMC Documentum Mobile Version 1.0 Installation Guide
