Server Documentum

De EjnTricks

Hand-icon.png Votre avis

Current user rating: 72/100 (1 votes)

 You need to enable JavaScript to vote


Installation

6.5

L'installation de la version 6.5 nécessite une version particulière de Oracle. Dans le cadre d'étude, il est intéressant de prendre une version Oracle Express. Or celle ci n'est pas supportée et l'installation du produit n'aboutie pas, car la version de Oracle n'est pas validée. Une astuce, trouvé sur powerlink à l'adresse https://community.emc.com/message/64538, permet de s'affranchir de ce test à l'installation. Il faut remplacer le binaire se trouvant à l'emplacement $DM_HOME/bin/dmdbtest, par un script qui retourne toujours 0. Le contenu de ce script ressemble a ceci:

#!/bin/sh
 
exit 0


Administration

Execution scripts

DQL

Sur un serveur Unix, pour lancer un script DQL, la commande est la suivante:

$DOCUMENTUM/product/6.5/bin/idql <DOCBASE> -U<LOGIN> -P<PASSWORD> -R<SCRIPT_PATH>

API

Sur un serveur Unix, pour lancer un script DQL, la commande est la suivante:

$DOCUMENTUM/product/6.5/bin/iapi <DOCBASE> -U<LOGIN> -P<PASSWORD> -R<SCRIPT_PATH>

Requête SQL

Il n'est pas rare qu'une équipe de nos clients nous demande les requêtes SQL générées par Documentum. Pour cela, le moyen le plus courant est d'ouvrir un Documentum Administrator, d'aller dans le composant dql et de cocher la case "Show last SQL". Mais pour les fans de la ligne de commande, cela est assez fastidieux.

En regardant le code du DA, classe com.documentum.webcomponent.admin.utilities.DqlEditor, nous pouvons extraire très facilement la logique. En prenant un éditeur de DQL/API, Samson est le parfait exemple, voici les actions:

Exécuter sa requête DQL. Puis passer sous l'éditeur API et lancer les instructions suivantes:

API> apply,c,NULL,GET_LAST_SQL
...
q0
API> next,c,q0
...
Ok
API> get,c,q0,result
...
select ....

L'instruction get,c,q0,result permet de récupérer la requête SQL. Comme l'instruction apply a ouvert une nouvelle collection, il est impératif de la fermer après avoir récupérer le SQL attendu.

API> close,c,q0
...
Ok

Pour rappel, l'alias c pour l'identifiant de session correspond à la session courante. Nous utilisons également q0 comme identifiant de collection car c'est celui ci qui nous est retourné par l'instruction apply. Si celle-ci avait retournée q1, il aurait fallu mettre cette valeur dans le next, get et close.


Gestion des audits

La mise en place des audits peut être réalisée par un simple script API.

Ajout

L'exemple suivant permet de rajouter un audit sur l'évènement de suppression sur tous les types:

audit,c,,dm_destroy

Suppression

L'exemple suivant permet de supprimer l'audit sur l'évènement de suppression sur tous les types:

unaudit,c,,dm_destroy


Gestion des sessions

Liste

Afin de lister toutes les sessions actives sur le content server, il faut exécuter le DQL suivant:

execute show_sessions


Gestion des Workflows

Etat des workflows

L'état d'un workflow, instance d'objet dm_workflow, est porté par l'attribut r_runtime_state. Les valeurs possibles sont:

Valeur Description
0 En attente de traitement, dormant.
1 En cours, running.
2 Clos, finished.

Ne semble plus être utilisé. Du moins aucune action n'est présentée dans Webtop pour atteindre ce niveau. Il est préférable de considérer la valeur 4.

3 Suspendu, halted.
4 Terminé, terminated.

Récupération de la liste des workflows terminés

En interrogeant la propriété r_runtime_state sur la valeur 4, il est possible de lister l'ensemble des workflows qui sont à l'état terminé.

select * from dm_workflow where r_runtime_state=4;