Gérer le référentiel du projet

Les référentiels de projet, situés sous le répertoire ProjRep, sont constitués des fichiers physiques stockés dans le système de fichiers et des tables de base de données qui indexent les fichiers. Vous pouvez nettoyer les référentiels du projet, parcourir et modifier les référentiels du projet en utilisant les clients FT, et réaligner les référentiels du projet.

Dans cette rubrique :

Présentation

Les fichiers de ce répertoire sont stockés dans une structure de dossiers optimisée qui permet un espace de stockage maximal. En outre, deux fichiers au contenu identique ne sont stockés qu’une seule fois dans le répertoire ProjRep. Par exemple, si vous joignez le même fichier à plusieurs enregistrements, le fichier n’est stocké qu’une seule fois dans le référentiel du projet. Il en résulte une réduction significative de l’espace disque, et une réduction du temps des opérations de copie.

Lorsque vous ajoutez un fichier à une entité, le système vérifie si un fichier identique existe dans le référentiel du projet. Si un fichier identique est localisé, aucun fichier physique n’est ajouté au référentiel.

Lorsque vous supprimez un fichier d’une entité, le fichier n’est pas immédiatement supprimé du répertoire du projet, car il peut encore être utilisé par d’autres entités.

Si vous restaurez un projet à partir d’une sauvegarde effectuée alors que le projet était actif, vous devez réaligner les tables du système de fichiers et de la base de données.

Retour en haut

Définir le nettoyage du référentiel de projet

À intervalles réguliers, le référentiel du projet est scanné pour détecter les fichiers obsolètes qui ne sont plus référencés par aucune entité. Si les fichiers ne sont pas référencés pendant une période déterminée, ils sont retirés du référentiel du projet.

Pour réguler le nettoyage du référentiel du projet :

Les intervalles de nettoyage sont définis par défaut sur sept jours. Vous pouvez réguler le processus de nettoyage du référentiel du projet à l’aide des paramètres de configuration du site suivants.

Pour plus de détails sur les paramètres, voir Définir les paramètres de configuration.

REPOSITORY_GC_PROJECT_CLEANUP_INTERVAL

Définit l’intervalle de temps entre les processus de nettoyage de chaque référentiel du projet.
REPOSITORY_GC_DELAY_CANDIDATE_TIME Définit le temps qui s’écoule après que des fichiers obsolètes aient été détectés lors d’une analyse, et avant que les fichiers obsolètes soient supprimés.
REPOSITORY_GC_JOB_PRIORITY Définit la vitesse à laquelle le processus de nettoyage est effectué.
SUSPEND_REPOSITORY_GC Permet d’arrêter le processus de nettoyage du référentiel du projet.

Pour promouvoir ou reporter le nettoyage d’un référentiel de projet :

Cliquez sur Promouvoir le nettoyage du référentiel dans l’onglet détails d’un projet pour nettoyer le référentiel du projet dès que possible.

Cliquez sur Différer le nettoyage du référentiel pour différer le nettoyage ou arrêter un nettoyage en cours.

Pour plus d’informations, voir Afficher et modifier les détails du projet.

Retour en haut

Parcourir et modifier le référentiel du projet

Vous pouvez parcourir et modifier les fichiers dans le référentiel du projet en utilisant un client FTP. La plupart des clients FTP standard qui prennent en charge le codage des caractères UTF-8 sont compatibles.

Avant de modifier des fichiers via des clients FTP

Comprendre ce qui suit avant d’apporter des modifications aux fichiers du référentiel via un client FTP.

Clients FTP pris en charge

La plupart des clients FTP standard qui prennent en charge le codage des caractères UTF-8 sont compatibles.

Les clients suivants sont vérifiés :

  • Filezilla

  • Client FTP Total Commander intégré

  • FlashFXP.
Ne pas effectuer de modifications directement dans le répertoire ProjRep Nous vous recommandons de ne pas modifier les dossiers, les fichiers ou le contenu des fichiers directement dans le répertoire ProjRep, ce qui endommagera de façon irréversible le référentiel de projet.
Supprimer des fichiers

La suppression d’un fichier entraînera l’absence de contenu dans les entités.
Renommer des fichiers et des dossiers

Renommer des dossiers et des fichiers peut entraîner l’absence de contenu dans les entités.

Activer les connexions FTP sécurisées

Vous pouvez vous connecter au serveur FTP en utilisant une connexion sécurisée.

Pour activer une connexion FTP sécurisée :

  1. Sur la machine du serveur, accédez à <chemin d’installation>\java\bin et utilisez la commande suivante pour générer un magasin de clés et un fichier de clés.

    Notez que client et changeit sont utilisés à titre d’exemple.

    Pour générer un fichier de magasin de clés

    keytool -genkey -keyalg RSA -alias client -keystore client.keystore -storepass changeit -storetype jks

    Pour générer un fichier de clé

    keytool -certreq -alias client -keyalg RSA -file client.csr -keystore client.keystore

  2. Créez un fichier XML en spécifiant les attributs suivants et enregistrez le fichier XML sous le nom sslkeystore.xml.

    • keystore file. Répertoire et nom du fichier de magasin de clés.

    • password. Mot de passe que vous avez défini pour le magasin de clés.

    • protocols. Protocoles TSL/SSL.

    • cipherSuites. Suites d'algorithmes de chiffrement utilisées par les connexions TLS.

    Par exemple :

    Copy code 
    <ssl>                          
       <keystore file="<keystore file path>" 
       password="<keystore password>"/>
       protocols="TLS1.3,TLS1.2" 
       cipherSuites="TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
    </ssl>

  3. Placez le fichier sslkeystore.xml dans le répertoire suivant : C:\ProgramData\Micro Focus\ALM\webapps\qcbin.

  4. Reconfigurez le paramètre de site FTP_PORT.

  5. Redémarrez le serveur FTP en redémarrant le service.

  6. Dans le client FTP, sélectionnez l’option FTPS ou SSL. Si vous utilisez FileZilla, accédez à File > Site Manager (Fichier > Gestionnaire de sites) et cliquez sur New Site (Nouveau site). Sous Protocole, sélectionner FTP-Protocole de transfert de fichiers, et sous Chiffrement, sélectionner Solliciter FTP implicite via TLS, puis cliquer sur Connexion.

Pour parcourir et modifier le référentiel du projet :

  1. Définir le paramètre FTP_PORT pour démarrer le service FTP sur le port spécifié.

    Pour plus d’informations, voir Définir les paramètres de configuration.

  2. Connectez-vous au serveur FTP.

    Dans un client FTP, utilisez les valeurs de connexion suivantes :

    Champ

    Valeur

    Hôte

    Nom ou adresse IP du serveur OpenText Application Quality Management auquel vous souhaitez vous connecter.

    Port

    Port FTP. Cette valeur doit être identique à celle utilisée pour le paramètre de site FTP_PORT.

    Utilisateur

    Nom d’utilisateur ou clé API d’un administrateur de site OpenText Application Quality Management.

    En mode SSO, vous pouvez saisir uniquement la clé API.

    Mot de passe

    Si vous utilisez le nom d’utilisateur dans le champ Utilisateur, saisissez le mot de passe de l’administrateur du site.

    Si vous utilisez la clé API dans le champ Utilisateur, saisissez le secret de clé API de l’administrateur du site.

  3. Recherchez et modifiez les fichiers du référentiel.

    Après avoir établi une connexion avec le service FTP, une liste des domaines du site s’affiche. Sélectionnez un domaine, puis sélectionnez un projet. Le client FTP affiche les répertoires du référentiel du projet.

Retour en haut

Réaligner un référentiel

Lorsque vous créez une sauvegarde d’un projet alors que le projet est actif, l’intervalle de temps entre les sauvegardes de la base de données et du système de fichiers peut entraîner des divergences entre l’index des fichiers de base de données et les fichiers physiques. Si vous restaurez le projet à partir de la sauvegarde, vous devez réaligner le système de fichiers et les tables de la base de données.

Autorisation :

Pour réaligner un référentiel, vous devez être administrateur du site.

Avant de réaligner un référentiel

Comprendre ce qui suit avant de réaligner un référentiel.

Activer le réalignement du projet

Pour activer le réalignement du projet, définir le paramètre SHOW_REALIGNMENT sur Y.

Pour plus d’informations, voir Définir les paramètres de configuration.
Processus de réalignement

Le processus de réalignement exécute les actions suivantes :

  • Si un fichier est indexé dans la base de données, mais ne figure pas dans le système de fichiers, l’index du fichier est supprimé de la base de données.

  • Si un fichier est stocké dans le système de fichiers, mais n’est pas indexé dans la base de données, le fichier est supprimé du système de fichiers.

  • Vérifier l’intégrité de la relation entre les tables de bases de données logiques et physiques.
Activation/désactivation de projets

Les projets sont désactivés pendant le réalignement, et réactivés une fois le réalignement terminé.

Pour réaligner le référentiel d’un seul projet :

  1. Accédez à l’onglet Projets d’Administration du site.

  2. Dans la liste des projets, sélectionner le projet, puis cliquer sur Gérer le projet > Outil de récupération > Réaligner le référentiel.

  3. Pour exécuter le processus de réalignement sans aucune intervention de la part de l’utilisateur, sélectionner Exécuter en mode silencieux.

  4. Pour démarrer le processus, cliquer sur Réaligner le projet.

    Si le projet est toujours actif, vous êtes d’abord invité au désactiver.

    Si une erreur se produit pendant l’exécution du processus, une boîte de message s’affiche. Cliquer sur Abandonner ou Réessayer en conséquence.

    Pour interrompre le processus de vérification, cliquer sur Abandonner et cliquer sur Oui dans la boîte de dialogue de confirmation.

    Pour interrompre le processus de vérification, cliquer sur Pause. Pour continuer, cliquer sur Reprendre.

  5. Attendre que le processus de réparation soit terminé.

    Pour exporter le journal de réparation vers un fichier texte, cliquer sur Exporter le journal.

    Pour effacer le journal des réparations, cliquer sur Effacer le journal.

Pour réaligner le référentiel de tous ou de plusieurs projets dans un domaine :

  1. Accédez à l’onglet Projets d’Administration du site.

  2. Dans la liste des projets, sélectionner le domaine cible, puis cliquer sur Gérer le domaine > Outil de récupération > Réaligner le référentiel.

  3. Configurer Préparer les paramètres.

    Mode de réalignement

    Sélectionnez les options suivantes :

    • Exécuter en mode silencieux. Cette option exécute le processus sans aucune interaction de la part de l’utilisateur.

    • Passer au projet suivant en cas d’échec. Passe au projet suivant si le processus échoue. Cette option est utilisée par défaut.
    Après le réalignement

    Sélectionnez l’une des options suivantes :

    • Laisser tous les projets désactivés. Laisse tous les projets désactivés une fois le processus terminé.

    • Activer tous les projets. Active tous les projets une fois le processus terminé.

  4. Sélectionner les projets cibles ou cliquer sur la case à cocher dans la colonne Nom du projet pour sélectionner tous les projets.

  5. Cliquer sur Réaligner le référentiel.

    Si l’un des projets sélectionnés est encore actif, vous êtes invité à le désactiver d’abord.

    Si une erreur se produit pendant l’exécution du processus, une boîte de message s’affiche. Cliquer sur Abandonner ou Réessayer en conséquence.

    Pour interrompre le processus de réparation, cliquer sur Abandonner et cliquer sur Oui dans la boîte de dialogue de confirmation.

    Pour interrompre le processus de réparation, cliquer sur Pause. Pour continuer, cliquer sur Reprendre.

  6. Attendre que le processus de réparation soit terminé.

    Pour exporter le journal de réparation vers un fichier texte, cliquer sur Exporter le journal.

    Pour effacer le journal des réparations, cliquer sur Effacer le journal.

Retour en haut

Voir aussi :