Archive for the ‘Documentum’ Category


The following are the Documentum Blogs and Forums which I refer frequently:


Documentum Suggests us to deactivate the user, rather than deleting the user from the repository

Every SysObject or SysObject subtype in the Docbase has an attribute called owner_name that identifies the user who owns the object. We suggest deactivating users, rather than deleting them based on the following issues:

1.  Before deleting a user from a Docbase, you must update the objects created by the deleted user to change the owner_name to identify a different user. You do not need to change the owner_name if you deactivate the user.

2.  When you delete a user, the server does not remove the user’s name from objects in the Docbase such as    groups and ACLs. It is possible to delete a user, and then re-create the user with the same name. However, if you add a new user with the same name as a previously deleted Docbase user, the new user will inherit the group membership and object permissions of the previously deleted user.

3.  You cannot delete the Docbase owner, installation owner, or yourself.

4.  When you no longer need a user account, deactivate the user. Deactivating a user is better than deleting a user. Once a user is deactivated in a Docbase, that user will not be able to log in to that Docbase. You must have Sysadmin or Superuser privileges to deactivate or reactivate a user.

5.  You cannot change the login state of the Docbase owner, installation owner, or yourself. You deactivate and reactivate users by changing the user’s login state using Documentum Administrator, DQL or the API.

6.  By default, users are active when you create them, so you do not need to activate new users. The user’s login state is tracked by the user_state attribute of the dm_user object. If you deactivate a user who is currently logged in, the change takes affect when the user next logs in.

7.  If necessary, a user with Superuser privileges can use a ticket to log in as a deactivated user, and a user with Superuser privileges can add a deactivated user to a group.


One of the administrative tasks of Documentum Administrator is User Management. To access a Docbase, a person must be defined as a user in that Docbase.

The Administration/User Management displays a list of users in the current Docbase. Search for users can be done by their user name in the Docbase, user OS name (name on the operating system), or default group.

How to locate users in Docbase

1.  Connect to the Docbase where we want to locate a particular user.

2.  In the left-hand pane, click Administration.

3.  Click User Management.

4.  Click Users.

5.  To search by user name, user OS name, or default group, type in the information and click   Go

How to create new users

One must have Sysadmin or Superuser privileges to create users.

1.  Connect to the Docbase where we want to create new users.

2.  Click Administration –> User Management.

3.  Click File –> New –> User. (Check Right Hand Side)

4.  Indicate whether the user’s state is active or inactive. An active user can connect to a

Docbase whereas an inactive user cannot.

5.  In the Name field, type the user’s name.

6.  Select a User Source from the drop-down list.

  • UNIX Only: Select this for the default UNIX user authentication.
  • Domain Only: Select this if the Docbase has Windows domain authentication enabled and the user must be authenticated against a domain.
  • UNIX first: Select this if the Docbase has Windows domain authentication enabled and the user must be authenticated first against UNIX, then against a domain.
  • Domain First: Select this if the Docbase has Windows domain authentication enabled and the user must be authenticated first against a domain, then against UNIX.
  • LDAP: Select this if users are authenticated against an LDAP server.

7.  In the E-Mail Address field, type the user’s email address. This is the address to which notifications are sent for workflow tasks and registered events.

8.  In the User OS Name field, type the user’s operating system user name. This is used by the user to login to the docbase.

9.  In the Windows Domain field, type the user’s Windows domain.

10. Select a home Docbase for the user.

11. Designate the user’s default folder which is the default storage place for any object the user creates. To use an existing Docbase folder, click Choose existing folder and to create  a folder with the user’s name, click Choose/Create folder with user name.

12. Click Select Group and select a default group for the user.

13. Click Select Permission Set and select a default permission set for the user.

14. Select the user’s privileges from the drop-down list.

User privileges authorize certain users to perform activities that are required to administer and maintain the system. The privilege levels are:

  • None
  • Create Type
  • Create Cabinet
  • Create Cabinet and Type
  • Create Group
  • Create Group and Type
  • Create Group and Cabinet
  • Create Group, Cabinet, and Type
  • System Administrator
  • Superuser

15. Select the user’s client capability from the drop-down list.

There are four types of users:

  • Consumer
  • Contributor
  • Coordinator
  • System Administrator 

16. Click Finish and new user is created.


Documentum Administrator enables you to monitor, administer, configure, and maintain Documentum servers, repositories, and federations located throughout your company from one system running a web browser.

Using Documentum Administrator you can:

• Monitor repository system and resource usage
• Configure a repository
• Create or modify repository users and groups
• Create or modify repository object types
• Create or maintain permission sets (also known as access control lists, or ACLs)
• Create or modify repository federations
• Create or modify formats
• Monitor repository sessions
• Monitor and configure Documentum system resources
• Run server APIs and issue DQL queries
• Create or modify storage areas
• Create and run methods and jobs
• Administer full‑text indexing
• Administer privileged clients
• Administer EMC Documentum Site Caching Services
• Administer EMC Documentum Content Intelligence Services
• Administer EMC Documentum Content Transformation Services

To log in to Documentum Administrator:

1. Start a web browser on a client machine.

2. Connect to the URL: http://host:port-number/da/

3. Type your login name and password on the Documentum Administrator Login page.

(Check with your company’s Documentum Administrator for credentials)

4. Select a repository from the list box.

5. Login.

Definitions in Documentum

Posted: April 18, 2011 in Documentum
Tags:

Though many of us are familiar with almost all the terminologies in Documentum, here I’m going to provide some of the basic definitions that I know regarding Documentum.

Here we go…

ACLs
An ACL (Access Control List) is a list that contains the names of individual users and/or groups and the object-level permission assigned to each. If the docbase is running with ACL security, then every SysObject has one associated ACL that defines who can access the object and at what level. Additionally, users and type definitions have ACLs. These exist as potential default ACLs for objects created by users.

Attribute
The descriptive characteristics that are part of object type definitions and are automatically assigned to every object of that type. Each object type has its own set of attributes. Attributes are divided into two categories: base attributes and custom attributes. When a new object type is based on an existing type, the new object type (called a subtype) automatically inherits all of the attributes, both base and custom, defined for the object type on which it is based. To review the attributes that are part of an object type, use the Object Types dialog box. To review the values assigned to an object’s base attributes, use the Attributes dialog box.

Branch Version
A variation of a document in the docbase that results when you revise an immutable (unchangeable) iteration of the document.

Cabinet
The highest level at which objects in a docbase are organized. Documents, folders, routers, and other objects you create must be stored in a cabinet. Like the file cabinets in an office, cabinets can contain a mixture of objects. A cabinet can be marked private in the Attributes dialog box. A private cabinet is visible in the docbase window only to the owner of the cabinet. But any user with BROWSE permission for a private cabinet can see it in the results area of the Find window.

Check In
To store the content of an object in the docbase. Check in also unlocks the object in the docbase. If the object is one you just created, checking it in stores the working file in the docbase as the new object’s content. If the object is one that already existed, checking it in can overwrite what is in the docbase or create a new version. Usually the person who checked the object out is the only person who can check it in.

Create
The ability to spawn any object in the Docase.

Check Out
To lock an object in the docbase. Only one person at a time can check an object out. When you complete the check out process, the system displays the object in your Work Area window.

Copy
To duplicate an object. Copying a folder does not copy any documents in the folder.

Delete
Use Delete to remove an object from the docbase or unlink it from the cabinet or folder to which it is linked. Selecting Delete displays the Delete dialog box.

Docbase
The repository for all objects created and managed using Documentum. One system can include multiple docbases.

Docbase Window
The window that represents the docbase to which you are connected. The cabinets that appear in the Docbase window are the cabinets in the docbase that are accessible to you. The Docbase window opens automatically the first time you connect to a docbase. The next time you connect to the docbase, the window opens if it was open when you disconnected. If it was closed when you disconnected, it does not open automatically when you reconnect to the docbase. You can open the Docbase window after you connect to a docbase using the Docbase command on the Window menu. The name of the docbase displays in the title bar.

Document
A single unit of information. What constitutes a unit is up to you–it can be one chapter in a book, one page in an article, or an entire book. A document does not have to contain text. It can also be a graphic, an image, or a spreadsheet, for example. Documents are simple or virtual. A simple document can only include information in one file format. A virtual document can contain information in multiple formats. The same document can go into more than one folder through linking.

Edit
Use Edit to edit the content of a selected object. Selecting Edit automatically checks out the object and opens its content for editing.

Event
A specific action performed on a specific object. The action can be performed by a user or by the system. For example, when someone checks an object out or checks it back in, that is an event. When the system locks or unlocks an object, that is also an event.

Export
To copy a content file in the docbase to an external file. Exporting a file does not destroy the file in the docbase.

Find
Use Find to define a single- or multiple-condition query to run against the docbase. Selecting Find displays the Find dialog box.

Format
Use the Format command to set the file formats that you will use for viewing and editing content files.

Folder
The lowest level at which objects in a docbase are organized. Folders organize the objects assigned to a cabinet. Folders can contain other folders, routers, documents, and virtual documents. The same folder can be stored in more than one cabinet or folder through linking.

Inbox
The window that displays any objects requiring your action or attention. These objects are tasks, notifications of events, or items that another user sent you through a custom application.

Import
To create a new document and incorporate a file external to the docbase as the content of the document. Importing does not destroy the external file. The file still exists independent of Documentum.

Link
To associate objects logically. An object is automatically linked to the cabinet in which it is stored when it is first created. (This cabinet is called the objects primary storage cabinet). You can link folders, documents, compound documents, or routers to additional folders and cabinets. When a cabinet or folder is opened, the contents include the linked object.

Lock
To write-protect an object in the docbase. The system locks an object when it is checked out to protect the data in the docbase. A locked object can only be overwritten and unlocked by the person who checked the object out or a superuser.

Locator
An object in a docbase that you can use to find documents or other objects. Each locator has a Docobject Resource Locator (DRL) as one of its attributes. A DRL is the address of an object in a docbase.

Locator File
A file on your personal computer (local file system) that you can use to find objects in a docbase. Each locator file contains a Docobject Resource Locator (DRL). A DRL is the address of an object in a docbase.

Move
To relocate an object. Moving an object unlinks it from the initial location and links it to the new location.

Object
A single entity in the docbase. Every object is categorized by object type. How the Documentum system displays and processes the object depends on the object’s type.

Operation
A procedure created by a system administrator to customize workflows. For example, an operation called Purchase might automatically send a purchase request to user1 if the expense is less than $1,000 and to user2 if the expense is more than $1,000.

Permissions
The permits associated with an object that control which users and groups can access an object and the level of access given to them. In a docbase using ACL security, object-level permissions are applied using ACLs, which define permissions for individual users or groups. In a docbase using Unix-based security, the permissions are applied to three categories of users: owner (the person who created the object), group (the members of a user group defined for the object), and world (everyone who uses the docbase). The permissions are not mutually exclusive. To review or change the permissions for an object, use the Permissions dialog box.

Preferences
Selections that determine default system behavior for a user in certain very specific situations. Preferences control system behavior in four categories. General preferences determine such behavior as the directory in which working files are stored by default. Format preferences determine what application the system runs when the user opens an object to view or edit it. They also determine the format in which the object is displayed. Font preferences determine the font the system uses to display the contents of a window. View preferences let you choose which attributes are shown in a list view and the order in which they are listed. To see how your General, Format, and Font preferences are set, use the Preferences command on the Edit menu. This displays a submenu of Preferences categories. Select the category in which you interested to display your current choices. To see how your View preferences are set, use the Window Settings command on the View menu.

Primary Storage Cabinet
The cabinet in which an object is stored when it is created. Unless you specify an alternate cabinet before you save a newly created object, the object is stored by default in your home cabinet. To find out which cabinet is your home cabinet, select the Users command from the Docbase Info submenu on the Window menu. This displays the Users dialog box.

Query
If you want to find all the objects in a docbase or cabinet that have certain attributes or contain certain words, you can use the Documentum query facility. The query facility has two commands:Find and DQL Query. Find lets you specify a single condition query or a multiple condition query by entering values in fields. You don’t have to know how to write a DQL query. Find does it for you, to make it easy. Find searches for all objects that meet certain conditions. DQL Query lets you write a query that is as simple or complex as you like. You must know the syntax of DQL commands, such as the Select command, to use the DQL Query command.

Session
The period of time during which you are connected to the Documentum system. A session begins when you log on to Documentum. It ends when you quit. Every time you log on, you start a new session.

Signoff
The Forward Task dialog box lets you confirm that you are forwarding a router. You can also sign off on the task and send a message to the person who is responsible for the next task. Both signing off and sending the message are optional. Regardless of whether you do either one, when you click OK, the system marks your task complete and the router goes to the next person. The Forward Task dialog box displays when you click the Forward button on your inbox and there is another task on the router. If the task you just completed is the last task on the router, you will see the Last Task dialog box instead.
The Last Task dialog box lets you confirm that you have completed the last task defined by a router. You can also sign off on the task and delete the router. Both signing off and deleting the router are optional. Regardless of whether you do either one, when you click Yes or No, the system marks your task complete and the router goes to the next person. The Last Task dialog box displays when you click the Forward button on your inbox and there is no other task on the router.

Superuser
The privilege that exempts someone from the restrictions imposed by Documentum security. For example, a user with Superuser privilege has READ permission for every object in the system, regardless of the object-level permissions, and can also change the permissions for any object.

Sysadmin
The privilege that entitles someone to perform certain administrative activities and exempts the user from some of the restrictions imposed by Documentum security.

Task
A discrete unit of work performed by an individual as part of a business process. Each task description specifies who is responsible for the task, what work is required (for example, “review the attached,”) and when the task must be completed. The object on which the work must be performed is attached to the task.

Toolbar
A feature that contains buttons that correspond, generally, to commands on the menus. You can turn off the toolbar.

Version
A variation of a document in the docbase resulting from revisions to a previous iteration of the document. When a variation to a document is checked in as a new version of the document, the previous version remains in the docbase. The new version is added. Each version carries a version label. The first edition (the original) is always labeled 1.0.

View
Use View to view the content of an object. Selecting View opens the document or object for viewing only; you cannot make any changes to the object’s content. The object is not checked out of the docbase.

Virtual
A document that contains other documents. The contained documents are ordered within the virtual document and can be simple documents or other virtual documents. The individual documents that make up a virtual document, its components, can have any mixture of file formats.

Unlock
To remove write-protection from an object in the docbase. The system unlocks an object when it is checked in (or when the checkout is canceled), making it accessible to anyone with the proper object-level permissions.

User privileges
Authorizations associated with an individual user that allow that user to perform additional tasks, such as creating cabinets, that are required to administer and maintain the system. To see your user privileges, use the Users dialog box.

Workflow
A process in which a group of people collectively share, manage, and operate on information. Workflow is typically a multiuser, multistage process.

Working File (i.e.)Checked Out File
The file on your local file system that contains a copy of the content of a document that you have checked out. When you open the document, the system copies the content to a file external to the docbase. You make changes to the checked out file, rather than the content in the docbase. The content in the docbase can only be changed when the object is checked in. When you create a new document, the system opens an empty working file in which to enter content. The content is not added to the docbase until you check in the new document. Checked out files are usually stored in your checkout directory.

Work Area Window
The window that represents your private work area. Objects that appear in the Work Area window are objects that you have checked out and which are locked or new objects that you have created but not yet saved to the docbase. The Work Area window opens automatically when you connect to a docbase. If you wish, you can minimize the Work Area window. To restore the Work Area window, choose Work Area from the Window menu or click the Work Area button.


Content Server is the foundation of the Documentum platform and provides the following standard services:

  1. Content management services
  2. Process management services
  3. Security services
  4. Distributed services
  5. Trusted Content Services
  6. Content Services for EMC Centera
  7. Content Storage Services
  8. Retention Policy Services
  9. Collaborative Services

Content management services

Content management services primarily deal with storage and retrieval, versioning, data dictionary, assembly and publishing, and search functionality. Content Server uses an object-oriented model and stores everything as objects in the
repository.

Library services (checkin and checkout of objects stored in the repository) enable making changes to content in a safe manner. Content Server inherently provides versioning for objects. As users work with objects they can create new versions while keeping
older versions intact. Content Server also provides indexing and search capabilities, which include the ability to search within content and to add third-party search providers to the installation.

Process management services
Process management features include workflows and lifecycles. Workflows typically represent business processes and model event-oriented applications. Workflows can be defined for documents, folders (representing the contained documents), and virtual documents. A workflow definition acts like a template and multiple workflow instances can be created from one workflow definition. Many documents created by an enterprise go through different stages during the lifetime of that document. For example, a document may be a draft when initially created, can be approved after successful review, and archived when no longer needed. Lifecycles define business rules that can be applied to different types of documents.

Documentum Architecture

Posted: March 24, 2011 in Documentum

• At the top level, client applications allow users to create, edit, and view documents and modify metadata.

• At the middle level, Content Server handles requests from Documentum client applications. Application logic is located on the server, and RDBMS calls are made using server API calls.

• At the bottom level, the RDBMS server and the operating system handle requests from Content Server and store information on the file system or in RDBMS tables