Activation d'un référentiel de contenu externe pour le contrôle des sources
Vous pouvez utiliser la page Administration dans le client Web afin d'activer un référentiel de contenu externe pour le contrôle des sources. Si vous effectuez cette activation, le contenu de contrôle des sources dont le volume dépasse le seuil configuré est stocké dans le référentiel de contenu externe au lieu de la base de données de l'application.
Avant de commencer
A propos de cette tâche
Jazz Source Control peut stocker du contenu de façon externe, soit sur un serveur qui prend en charge le protocole WebDAV, soit sur le système de fichiers local du serveur d'applications. Si vous configurez un serveur WebDAV externe, vous devez fournir des informations d'identification que l'application Engineering Workflow Management peut utiliser pour accéder à ce serveur.
Procédure
Modification du référentiel de contenu externe configuré
Vous pouvez modifier les valeurs de configuration du référentiel de contenu externe. Les modifications affectent l'emplacement de stockage du nouveau contenu ; elles n'affectent pas le mode de stockage ou d'extraction du contenu existant.
Procédure
Modification des données d'identification d'accès de WebDAV
IBM® Engineering Workflow Management stocke les identifiants d'accès pour chaque valeur URI (Versioned Content External Repository) que vous saisissez. Si vous modifiez la valeur URI du Référentiel externe de contenu versionné et les informations d'identification qui lui sont associées, l'ancien URI et les anciennes informations d'identification sont stockés afin que Engineering Workflow Management puisse continuer à récupérer du contenu sur ce serveur tout en utilisant les nouvelles informations d'identification pour accéder au référentiel de contenu externe actuellement configuré.
Procédure
Déplacement de contenu
Vous pouvez utiliser la commande moveContent des outils
de référentiel pour déplacer un contenu précédemment stocké de trois manières.
A propos de cette tâche
Vous pouvez utiliser la commande moveContent des outils de
référentiel pour déplacer un contenu précédemment stocké de l'une des manières suivantes :
- De la base de données du serveur Engineering Workflow Management vers un référentiel de contenu externe
- D'un référentiel de contenu externe vers la base de données du serveur Engineering Workflow Management
- D'un ancien référentiel de contenu externe vers celui actuellement configuré
La commande moveContent possède des arguments permettant de spécifier
les référentiels de contenu source et cible, ainsi que la taille minimale ou maximale du
contenu à déplacer. Pour plus d'informations sur l'exécution de la commande avec différents arguments, consultez la documentation de référence sur la ligne de commande des outils du référentiel.
Suppression de contenu
A propos de cette tâche
Lorsque du contenu stocké dans un référentiel de contenu externe est supprimé à partir de Engineering Workflow Management, le serveur tente également de supprimer le contenu du référentiel de contenu externe. Le serveur tente d'effectuer la suppression mais la réussite de cette opération n'est pas garantie. Pour plus d'informations, consultez : Suppression de contenu du contrôle de source
Si un problème se produit lors de la suppression de contenu du référentiel externe, ce problème est consigné sur le serveur, mais il n'entraîne pas l'échec de la suppression.
Production de rapports à l'aide de beans gérés JMX
Dans « Engineering Workflow Management », vous pouvez surveiller le contenu stocké dans SCM à l'aide des beans gérés (MBeans) de l'interface « Java Management Extensions » ( JMX ).
A propos de cette tâche
Procédure
Bean géré Métrique du référentiel de contenu
Si le bean géré Métrique du référentiel de contenu est activé, un bean géré
contenant une liste des référentiels de contenu dans lesquels un contenu a été stocké est
publié. La base de données Engineering Workflow Management est représentée par un référentiel dont l'URI est 'DATABASE
A propos de cette tâche
Le nom du MBean a la forme " com.ibm.team.scm.content:name="<app-context>",type=repositoryMetrics. Le
bean géré contient une liste de référentiels. Pour chaque référentiel de contenu, les
informations suivantes sont publiées :
| Nom de la propriété | Description |
|---|---|
| externalURI | URI du référentiel de contenu externe ou DATABASE
pour le référentiel de base de données par défaut. |
| totalNoOfContent | Nombre d'objets de contenu uniques stockés dans le référentiel de contenu. |
| compressedDBSize | Nombre total d'octets stockés dans la base de données pour ce référentiel de
contenu. Pour le référentiel DATABASE par défaut, il s'agit de la
taille compressée du contenu. Les référentiel de contenu externes stockent des
métadonnées dans la base de données. |
| totalSize | Taille totale non compressée du contenu stocké dans le référentiel de contenu. |
Bean géré Métrique du composant
Si le bean géré Métrique du composant est activé, un bean géré est publié pour chaque composant SCM.
A propos de cette tâche
Les noms des MBean ont la forme " com.ibm.team.scm.content:name="<app-context>",type=componentContent,componentNameAndId="<componentName>_<componentUUID>". Pour chaque référentiel de contenu, les
informations suivantes sont publiées :
| Nom de la propriété | Description |
|---|---|
| componentName | Nom du composant. |
| componentId | Identificateur unique universel du composant. |
| ownerName | Nom du propriétaire du composant. Il s'agit du nom de la zone de projet conteneur si le composant appartient à une zone de projet ou d'équipe ou du nom du contributeur propriétaire. |
| ownerId | Identificateur unique universel du propriétaire du composant. Il s'agit de l'identificateur unique universel de la zone de projet conteneur si le composant appartient à une zone de projet ou d'équipe ou de l'identificateur unique universel du contributeur propriétaire. |
| totalNoOfContent | Nombre d'objets de contenu uniques demandés par les fichiers de ce composant. |
| dbSize | Nombre total d'octets stockés dans la base de données pour le contenu demandé par les fichiers de ce composant. |
| totalSize | Taille totale non compressée du contenu demandé par les fichiers de ce composant. |
| externalStores | Liste des référentiels de contenu externes dans lesquels un contenu est stocké pour ce composant. Cette valeur sera vide si tout le contenu est stocké dans la base de données Engineering Workflow Management Pour chaque référentiel de contenu externe, voir le tableau suivant : |
| Nom de la propriété | Description |
|---|---|
| externalURI | URI du référentiel de contenu externe. |
| totalSize | Nombre total d'octets stockés dans le référentiel de contenu externe. |
| totalNoOfContent | Nombre d'objets de contenu uniques demandés par les fichiers de ce composant stockés dans ce référentiel de contenu externe. |
Engineering Workflow Management utilise un mécanisme de stockage basé sur le hachage pour éviter de stocker plusieurs copies d'un contenu identique. Si un contenu identique est restitué plusieurs fois, une seule copie de ce contenu est stockée physiquement et chaque projet, composant ou fichier qui y est associé pointe vers cette copie unique conservée. La transparence vis-à-vis des utilisateurs s'applique à la fois au contenu stocké dans la base de données du serveur Engineering Workflow Management et au contenu stocké dans des référentiels de contenu externes.
Le total combiné de tous les beans des métriques de composant peut être supérieur au nombre réel d'octets physiquement stockés dans la base de données ou les référentiels de contenu externes.
Bean géré Tailles des plus gros fichiers
Le nombre de fichiers rapportés par le MBean Top File Sizes est contrôlé par la propriété avancée du serveur Engineering Workflow Management File Sizes MBean - Number of Files to report sous 'VersionedContentMetricsTask. Si le bean géré Tailles des plus gros
fichiers est activé, un bean est publié pour chacun des fichiers les plus volumineux dont
la taille est supérieure à celle spécifiée par la propriété Bean géré Tailles des
fichiers - seuil de taille (en octets).
A propos de cette tâche
Les noms des MBean ont la forme " com.ibm.team.scm.content:name="<app-context>",type=topContent,rank="<N>". Pour
chacun des fichiers les plus volumineux, les informations suivantes sont publiées :
| Nom de la propriété | Description |
|---|---|
| contentSize | Taille compressée de ce contenu s'il est stocké dans la base de données ; taille complète du contenu si ce dernier est stocké en externe. |
| externalURI | L'URI du référentiel de contenu externe dans lequel ce contenu est stocké, ou " DATABASE s'il est stocké dans la base de données du serveur Engineering Workflow Management |
| contentClaimer | Pour chaque référentiel de contenu externe, consultez le tableau ci-après. |
| componentName | Nom du composant conteneur. |
| itemId | Identificateur unique universel de l'élément du fichier demandeur. |
| stateId | Identificateur unique universel de l'état du fichier demandeur. |
| approximatePath | Chemin d'accès approximatif ou le plus courant de ce fichier. Le chemin d'accès
d'un fichier est déterminé par la structure de répertoires de chaque flux ou
espace de travail de référentiel dans lequel il apparaît et, en général, il ne peut pas
être déterminé sans spécifier d'espace de travail ou de flux. Le fichier peut ne pas
exister réellement dans la propriété approximatePath d'un espace de
travail spécifique, en particulier si chaque espace de travail ou flux qui contient ce fichier
possède un chemin d'accès différent. |
Considérations sur le regroupement de laEngineering Workflow Management
Vous pouvez utiliser Engineering Workflow Management dans un environnement en grappe.
A propos de cette tâche
- Votre référentiel de contenu externe doit être accessible à tous les noeuds du cluster. Ce principe s'applique à la fois aux référentiels de contenus basés sur des fichiers et basés sur WebDAV.
Si le contenu se trouve dans plusieurs référentiels WebDAV et que vous devez éditer manuellement les fichiers des données d'identification, vous devez mettre à jour le fichier des données d'identification sur chaque noeud du cluster.
Sauvegarde
Lorsque vous sauvegardez une configuration de Engineering Workflow Management qui utilise des référentiels de contenu externes, il est important de sauvegarder d'abord la base de données de Engineering Workflow Management, puis les référentiels externes. Lorsque les données sont restaurées, le serveur reflète l'état dans lequel il se trouvait immédiatement après la sauvegarde de la base de données, quel que soit le moment où les référentiels de contenu externes sont sauvegardés.
A propos de cette tâche
Si vous réinitialisez le serveur, vous ne devez réinitialiser que la base de données Engineering Workflow Management Vous n'avez pas besoin de restaurer la version antérieure des référentiels de contenu externes. Dans ce type de scénario, les référentiel de contenu externes conservent tout contenu orphelin ajouté avant le rétablissement de la version antérieure de la base de données et l'intégrité des données n'est pas affectée. Le contenu orphelin est automatiquement récupéré si le contenu est restitué sur le serveur.
La procédure de sauvegarde d'un référentiel de contenu externe dépend du type de référentiel. Pour un magasin de contenu WebDAV, reportez-vous à la documentation du produit pour obtenir des instructions spécifiques. Pour un magasin de contenu basé sur un système de fichiers, vous pouvez utiliser une procédure de sauvegarde sur un système de fichiers standard.
Entre la fin de la sauvegarde de la base de données et la fin des sauvegardes des
référentiels externes, n'utilisez pas la fonction de suppression de contenu ou la
commande moveContent des outils de référentiel. La fonction de suppression de contenu est une action rare effectuée par un administrateur qui supprime des octets de contenu de Jazz Team Server: elle ne fait pas référence à l'action courante de vérification des suppressions de fichiers. La plupart des utilisateurs n'exécutent jamais la fonction de suppression de contenu.
Si des suppressions de contenu sont effectuées entre deux sauvegardes, elles doivent être réappliquées après la restauration des données afin de rétablir la base de données dans un état cohérent pour ces éléments. Les suppressions de contenu, si elles ont été effectuées à l'origine, doivent également être réappliquées si la base de données de Engineering Workflow Management est rétablie alors que le magasin de contenu externe ne l'est pas.
Pratiques recommandées
Tenez compte des pratiques recommandées suivantes lorsque vous configurez des référentiels de contenu externes :
A propos de cette tâche
- Pour utiliser la fonctionnalité de référentiel de contenu externe avec certains serveurs WebDAV strictement conformes, tels que Microsoft IIS, veillez à installer la version 6.0.6 de Rational® Team Concert® iFix003 ou une version ultérieure.
- Divers serveurs WebDAV pouvant avoir une configuration requise spécifique, veillez à bien lire la documentation du serveur avant de configurer ce dernier.
- Pour vérifier que le serveur WebDAV fonctionne correctement, exécutez les commandes curl PUT et curl GET.
- Avant de configurer le serveur WebDAV, procurez-vous les informations suivantes :
- Taille maximale des téléchargements de fichier imposée par le serveur WebDAV
- Configuration des types de fichier et des types de contenu du serveur
- Si l'authentification de base est installée et activée sur le serveur
- Configurez le serveur WebDAV afin qu'il utilise
HTTPS. Engineering Workflow Management utilise l'authentification de base pour envoyer les identifiants de connexion WebDAV. La configuration du serveur WebDAV pour qu'il utilise HTTPS permet de s'assurer que ces données d'identification sont chiffrées et qu'elles ne sont pas transmises sous forme de texte en clair. - Ne pas utiliser de très petites valeurs pour la propriété "
Versioned Content External Content – Artifact Minimum SizeLe temps système supplémentaire résultant de l'envoi de demandes HTTP à un serveur WebDAV a un impact négatif sur les performances si le système doit accéder à un très grand nombre de petits fichiers. La fonction de dépôt de contenu externe a été conçue pour déplacer des fichiers volumineux de la base de données du serveur Engineering Workflow Management vers des dépôts de contenu externes : elle n'est pas destinée à déplacer tous les fichiers SCM de la base de données du serveur CCM.
Si vous utilisez un serveur Microsoft IIS, vous pouvez rencontrer les problèmes suivants :
| Problème | Solution |
|---|---|
| La fonction d'authentification de base d'IIS n'est pas installée ou activée par défaut | Installez la fonction d'authentification de base d'IIS à l'aide du Panneau de configuration de Windows et activez l'authentification dans le gestionnaire des services IIS. Pour plus d'informations, consultez l'aide d' Microsoft IIS concernant l'authentification de base. |
| IIS ne parvient pas à renvoyer un contenu sans extension de fichier. | Ajoutez un mappage de type MIME pour les fichiers sans extension. Vous pouvez configurer le type MIME au niveau du répertoire virtuel pour le répertoire virtuel qui inclut le contenu externe. Configurez le type MIME dans le gestionnaire des services IIS. Pour plus d'informations, consultez l'aide d' Microsoft IIS e sur la configuration des types MIME dans IIS 7. |
| La taille maximale par défaut des téléchargements de fichier pour IIS n'est que de 30 Mo. | Vous pouvez l'augmenter au niveau du site Web dans le gestionnaire des services IIS. Pour plus de détails, consultez l'aide Microsoft IIS concernant la configuration du filtrage des requêtes dans IIS. |
| IIS autorise une taille maximale de téléchargement de 4 Go. | Si vous devez gérer des fichiers plus volumineux, vous devez sélectionner un autre serveur, tel qu'Artifactory, ou utiliser un magasin de contenu de type Fichier. Si vous configurez une taille maximale de téléchargement de fichiers sur votre serveur WebDAV, vous devez définir la propriété du serveur avancé Engineering Workflow Management "Versioned Content Maximum Size" à la même valeur. Si vous définissez une valeur et que vous enregistrez un fichier dont la taille est supérieure à la valeur définie, le client Engineering Workflow Management affiche un message d'erreur au lieu d'essayer de télécharger le fichier sur le serveur WebDAV. |
- Désactivez l'accès anonyme dans Artifactory pour empêcher les utilisateurs non authentifiés d'extraire le contenu du serveur Artifactory.
- Si vous utilisez la fonction de suppression de contenu dans Engineering Workflow Management pour supprimer du contenu SCM sensible, vous devez vider votre dossier poubelle Artifactory ou configurer Artifactory pour qu'il n'utilise pas de dossier poubelle.
- Les chemins UNC ne sont pas pris en charge. Si vous souhaitez utiliser un stockage réseau pour un référentiel de contenu externe de type FILE, vous devez le monter sur le système de fichiers local sous Linux ou le mapper en tant qu'unité réseau sous Windows.
- Utilisez des chemins canoniques lorsque vous configurez l'URI du référentiel de contenu. Les chemins
d'accès qui contiennent des espaces doivent être précédés d'un caractère
d'échappement (par exemple,
file:////C:/Content%20Repository).