Chapter 9. Setting Up Documentum Administrator and Web Publisher

Documentum Administrator (DA) is a web-based tool that allows administrators to perform system administration and monitoring activities on Documentum Docbases, servers, federations, etc.

To access Documentum Administrator and connect to the respective Docbase and configure/monitor the various Docbase objects, all that a system administrator requires is a web browser. DA is an extremely powerful tool that assists an administrator in performing routine administrative tasks and scores of other activities.

A few of the tasks that can be carried out using Documentum Administrator are:

  • System monitoring of Docbase, Docbase sessions, and resources
  • Running DQL and Server API commands
  • Creation and modification of Docbase objects like Methods, Jobs, Object types, formats, ACLs (permission sets), storage areas, and site publishing configurations (for Site Caching Services)
  • Executing Methods and Jobs

It is worth mentioning that Documentum Administrator has been developed using the WDK framework. We will explore Documentum Administrator further in the subsequent chapters of this book. For now, simply understand that it is a browser-based application used for Content Server administrative tasks.

9.1 Documentum Administrator

Documentum Administrator software is installed as a web application on supported application server platforms such as Tomcat, BEA WebLogic, WebSphere, and Oracle AS. In this chapter, we will install Documentum Administrator and Web Publisher on Apache Tomcat.

Please keep the following prerequisites in mind before we proceed with the installation and configuration of Documentum Administrator.

9.1.1 Prerequisites

The table shown in figure 9.1 lists some of the prerequisites for installing Documentum Administrator:

Entity

Comments

Content Server and DocBroker

The Application server machine hosting DA should be able to access the DocBroker host for the Docbase in question.

Installation owner

Documentum recommends using the same installation owner to install application server and DA.

Limitations for installation owner's user name:

  • Consists of numbers, letters, hyphens (-) and underscores (_)
  • The first character should be a letter
  • All characters must be ASCII
  • User should have 'Write' permission on the content transfer directory
  • Password should consist of numbers, letters, periods (.), hyphens (-), and underscores (_)

Application Server

Before installing DA, the supported Application Server should be installed and configured properly.

Application Server machine

600 MB hard disk space, 1 GB RAM and minimum 800 MHz CPU. (Documentum does not recommend installing DA on the Content Server host due to security reasons)

Browser machine

The Browser Windows machine accessing DA should have 5 MB hard disk space, 128 MB Free RAM, and an 800 MHz CPU.

Others

For supported combinations of Windows OS, Browser versions and JRE, Application Server versions and JDK, please refer to Release Notes from Documentum.

To begin, download the following:

  • Documentum Administrator 5.2.5 SP2 software installer (Administrator_5.2.5_SP2_windows.exe) from the Documentum site.
  • jakarta-tomcat-4.1.30.exe from the Apache Jakarta Tomcat homepage (http://jakarta.apache.org/tomcat/)

9.1.2 Installing Documentum Administrator 5.2.5 SP2

We will now mention the steps involved in installing Documentum Administrator 5.2.5 SP2:

  1. Log in to the application server host as the application server installation owner and install Apache Tomcat 4.1.30 Servlet container before installing DA. For details on the installation of Tomcat, please refer to Tomcat documentation available from the Apache Jakarta site.
  2. After Tomcat 4.1.30 has been installed on the application server host, the following system environment variables need to be set:
    • JAVA_HOME: This is the Java installation directory, for example, C:j2sdk1.4.2
    • CATALINA_HOME: This is the Tomcat installation directory, for example, C:Tomcat 4.1
  3. Startup Tomcat 4.1.30 to ensure that it has been installed correctly before proceeding with DA installation.

    Run the batch file startup.bat located under %CATALINA_HOME%in.

    Once Tomcat has started up, open the default Tomcat page by invoking the following URL from your web browser: http://<app server host>:<port>/index.jsp.

    9.1.2 Installing Documentum Administrator 5.2.5 SP2

    Figure 9.2: Tomcat home page

  4. Stop Tomcat server before beginning the installation of Documentum Administrator 5.2.5 SP2. Extract Administrator_5.2.5_SP2_windows.exe on the application server host as the application server installation owner. Run the daWinSetup.exe executable.
  5. Click the Next button.
    9.1.2 Installing Documentum Administrator 5.2.5 SP2

    Figure 9.3: DA Installer components to be installed

  6. Accept the License agreement terms and conditions and click the Next button.
  7. Optionally choose to install Developer Documentation and click the Next button.
  8. If Documentum already exists on the machine, the Documentum Destination directory screen will not be shown. If Documentum is being installed for the first time on the application server host, the default destination directory (C:Program FilesDocumentum) is shown. Either choose a different destination directory or continue with the default and click the Next button.
  9. If Documentum already exists on the machine, the Documentum user directory screen will not be shown. If Documentum is being installed for the first time on the app server host, the default user directory (C:Documentum) is shown. Either choose a different user directory or continue with the default and click the Next button.
  10. If Documentum already exists on the machine, the primary DocBroker info screen will not be shown. If Documentum is being installed for the first time on the app server host, provide the name of the primary DocBroker host, and the port number (the default port number is 1489), and click the Next button.
  11. Select the application server on which DA will be installed. Click the Next button.
    9.1.2 Installing Documentum Administrator 5.2.5 SP2

    Figure 9.4: Selecting application server for installing DA

  12. Ensure that you have stopped Apache Tomcat application server before continuing with the installation setup. Click the Next button.
  13. Provide the Tomcat app server home directory and the name of the DA web application (virtual directory). Choose the defaults shown on the screen and click the Next button.
    9.1.2 Installing Documentum Administrator 5.2.5 SP2

    Figure 9.5: Specifying Tomcat server information

  14. Choose the default content transfer folder or provide a new one. Click the Next button. The default folder shown on the screen is C:DocumentumcontentXferda.
  15. Do not select the option for installing virtual link support and click the Next button. DA does not require virtual link support to function.
  16. 16 The list of products/supported components to be installed with the DA installation will be shown. Click the Next button and finish the installation by pressing the Finish button.
  17. Start Tomcat and invoke the following URL from your web browser to ensure that DA has been installed correctly: http://<app server name>:<port>/da.

    If you have specified a virtual directory other than da, then substitute da in the above URL with the name you have specified.

We have reached the last rung of the ladder as far as Documentum WCM software installation is concerned for our purposes. Having installed Documentum Administrator, we can now go ahead and install Web Publisher 5.2.5 SP2 on the same application server host that is hosting DA.

..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset
3.141.42.5