Avant de pouvoir lancer un balayage des mises en attente, il vous faut configurer les valeurs adéquates. Par exemple, vous pouvez spécifier le nom du serveur Content Platform Engine qui contient les enregistrements. Vous pouvez limiter le balayage à une seule librairie de plan de fichiers.
Pourquoi et quand exécuter cette tâche
- Si IBM® Enterprise
Records est déployé sur IBM WebSphere Application Server, tout outil IBM Enterprise
Records s'appuyant sur le protocole de transport EJB JACE
utilise l'environnement d'exécution Java fourni avec WebSphere Application
Server de la même version ou avec le client d'application WebSphere.
- Si IBM Enterprise
Records est déployé sur JBoss Application Server ou WebLogic
Application Server, tout outil IBM Enterprise
Records s'appuyant sur le protocole de transport EJB JACE utilise l'environnement d'exécution Java fourni avec le serveur d'application de la même version.
- Editez la variable d'environnement JAVA_HOME dans la section du serveur d'application appropriée des fichiers BAT et SH, de façon à ce qu'elle pointe vers la même version d'environnement d'exécution Java que le serveur d'application sur lequel le logiciel IBM Enterprise
Records
est installé. Par exemple, l'entrée WebSphere Application
Server doit se présenter de la façon suivante : set JAVA_HOME=%WS_DIR%/java.
- Les profils permettent d'enregistrer différentes configurations et d'exécuter un balayage des mises en attente à l'aide de ces configurations sans qu'il soit nécessaire de les reconfigurer.
Vous pouvez créer un profil ou modifier un profil existant en exécutant la commande configurer et en indiquant le nom de profil. Une fois le profil créé, vous pouvez l'utiliser pour exécuter le balayage des mises en attente. Les noms de profils sont composés de caractères, de chiffres, de périodes, de traits de soulignement ou de tirets et obéissent aux mêmes contraintes que celles imposées aux noms de fichier sur le système d'exploitation actuel. Chaque nom de profil est enregistré sous un fichier _RMHoldSweepConfiguration ajouté au nom de fichier d'origine. Par exemple, si le nom de profil est Profil1, le nom de fichier résultant sera Profil1_RMHoldSweepConfiguration.xml.
Si aucun nom de profil n'est fourni, le balayage des mises en attente utilise par défaut le profil par défaut d'origine de RMHoldSweepConfiguration.xml.
Important : Un nom de fichier journal est maintenant associé à chaque profil.
Par conséquent, lorsqu'un balayage est exécuté, un fichier journal distinct est créé pour chaque profil et un nom approprié lui est affecté, par exemple, Profile1_RMSweepHoldConfiguration.log.
Restriction : Si vous avez l'intention d'exécuter l'outil de balayage des mises en attente
IBM Enterprise
Records dans le système d'exploitation Windows, appliquez les paramètres suivants à partir de l'invite de commande avant d'exécuter l'outil pour que les informations s'affichent correctement dans les langues européennes (à l'exception de l'anglais) :
- Affectez la valeur Lucida Console à la propriété de police.
- Remplacez la page de codes par une page de codes Windows ANSI relative (de 1250 à 1257). Par exemple, si vous souhaitez afficher le contenu des fenêtres du système DOS en français, exécutez chcp 1252 pour accéder à la page de codes 1252. La page de codes 1252 correspond à la page de codes Windows ANSI pour les langues latines de l'Europe occidentale. Pour obtenir une liste complète des pages de codes, voir la rubrique Tableau des identificateurs des pages de codes.
Procédure
Pour configurer le balayage des mise en attente :
- Dans IBM Administration
Console for Content Platform Engine,
ouvrez la page de propriétés du domaine FileNet P8. Cliquez avec le bouton droit sur le premier noeud et sélectionnez Propriétés.
- Sélectionnez l'onglet Propriétés.
- Dans le menu de configuration du sous-système, sélectionnez Server Cache Configuration (Configuration du cache du serveur).
- Sélectionnez l'onglet Propriétés et modifiez
la valeur de la propriété [QueryPageMaxSize] de 1000 à 100 000.
Important : Query Page Max Size est un paramètre à l'échelle du système
qui affecte l'ensemble des performances de Content Platform Engine. La valeur documentée de IBM Enterprise
Records est prévue pour des performances optimales des processus de balayage IBM Enterprise
Records. Cependant, vous devrez peut-être ajuster la valeur de paramètre en fonction de l'utilisation globale de Content Platform Engine et des performances de votre système.
- Recherchez et cliquez avec le bouton droit sur la librairie de plan de fichiers puis sélectionnez Propriétés.
- Dans la boîte de dialogue des propriétés, cliquez sur l'onglet Query (Requête).
- Définissez le délai maximal de requête (Max Query Time Limit) à 0.
- Sauvegardez les paramètres et quittez IBM Administration
Console for Content Platform Engine.
- A partir d'une invite de commande sur le serveur où vous avez installé le balayage des mises en attente, accédez au dossier RecordsManagerSweep.
- Saisissez l'une des commandes suivantes :
Option |
Description |
AIX, HP-UX, Linux et Solaris |
./RecordsManagerSweep.sh -HoldSweep -configure
[-profile "nom_profil"] |
Windows |
RecordsManagerSweep.bat -HoldSweep -configure [-profile
"nom_profil"] |
- Spécifiez les valeurs appropriées pour les champs suivants.
Les champs marqués d'un astérisque (*) sont obligatoires. (Vous pouvez supprimer les valeurs existantes en cliquant sur Réinitialiser.)
- En haut de la fenêtre de la console de configuration se trouve un libellé Profil : nom_profil qui indique le profil que vous allez configurer. Le profil par défaut est Profil : RMHoldSweepConfiguration.
- Connexion : Sélectionnez http ou https pour indiquer le protocole de communication avec le serveur Content Platform Engine. Le protocole par défaut est http. Pour une communication sécurisée, sélectionnez https.
- Nom de serveur* : Indiquez le nom ou l'adresse IP du serveur Content Platform Engine.
- Numéro de port WSI* : Indiquez le numéro de port WSI utilisé par votre serveur Content Platform Engine. Par exemple, le port par défaut pour Content Platform Engine s'exécutant sous un serveur d'applications WebLogic est 7001. Pour Content Platform Engine s'exécutant sous WebSphere Application
Server, le port par défaut est 9080.
- URL : Indiquez l'adresse URL configurée par l'utilisateur pour la communication entre l'outil et le serveur Content Platform Engine. Par exemple, /wsi est l'adresse URL généralement utilisée. C'est aussi le chemin par défaut.
- Nom de la librairie de plans de fichiers : Indiquez l'identificateur global unique ou le nom de la librairie de plans de fichier (FPOS) sur laquelle vous voulez exécuter le balayage des mises en attente. Si vous n'indiquez aucune valeur, le processus de balayage des mises en attente s'exécute sur toutes les librairies de plan de fichiers associées au serveur Content Platform Engine spécifié. Si le nom de la librairie comporte des caractères étendus, utilisez l'identificateur global unique (GUID) en lieu et place du nom.
- ID utilisateur* : Indiquez le nom d'utilisateur utilisé par le balayage des mises en attente pour se connecter à Content Platform Engine afin d'effectuer des calculs. L'utilisateur doit détenir des droits d'administration sur les librairies de plans de fichiers, ainsi que des privilèges d'administrateur d'enregistrements.
- Mot de passe* : Indiquez le mot de passe pour l'ID utilisateur.
- Mode FIPS 140-2 : Sélectionnez Activé ou Désactivé.
En mode FIPS 140-2, lorsque IBM Enterprise
Records utilise les fournisseurs cryptographiques approuvés par la norme FIPS 140-2 pour la cryptographie : IBMJCEFIPS (certificat
376), IBMJSSEFIPS (certificat 409), et IBM Crypto for C (ICC (certificat
384). Les certificats sont répertoriés sur le site Web NIST.
Si vous sélectionnez Activé alors que l'administrateur de sécurité n'a pas configuré le système en mode FIPS 140-2, IBM Enterprise
Records affiche un message d'erreur.
L'administrateur de sécurité doit modifier le fichier java.security.
Pour plus d'informations, voir la rubrique Configuration du mode FIPS 140-2. IBM Enterprise
Records ne prend en charge le chiffrement FIPS
140-2 que sur WebSphere Application
Server.
- Noms/GUID de mise en attente : Indiquez au maximum cinq noms ou identifiants GUID de mise en attente, séparés par le caractère "|". Le processus de balayage utilise exclusivement les mises en attente spécifiées. Si aucune mise en attente n'est fournie, le balayage des mises en attente traite toutes les mises en attente actives. Si vous effectuez une mise à niveau à partir d'une version antérieure dans laquelle vous pouviez créer plusieurs mises en attente de même nom, l'utilisation de ce nom traite toutes les mises en attente créées sous ce nom. Si le nom de la mise en attente comporte des caractères étendus, utilisez l'identifiant global unique (GUID) en lieu et place du nom.
- Taille lot/MAJ : Indiquez le nombre d'entités à traiter par lot à l'aide du processus de balayage des mises en attente. Par défaut, cette valeur est définie sur 1000. Par exemple, si la valeur est définie sur 1000 et si 20 000 entités doivent être traitées, alors le balayage des mises en attente traite toutes les entités en 20 lots contenant chacun 1000 entités.
- Taille lot/extraction : Indiquez le nombre d'entités à extraire par lot à l'aide du processus de balayage des mises en attente. Par défaut, cette valeur est définie sur 100 000. Par exemple, si la valeur est définie sur 100 000 et si 1 000 000 d'entités doivent être traitées, alors toutes les entités sont extraites dans 10 lots contenant chacun 100 000 entités.
- Nombre d'unités d'exécution : Indiquez le nombre d'unités d'exécution qu'IBM Enterprise
Records utilise lors du balayage des mises en attente. Indiquez une unité d'exécution pour chaque processeur logique sur le serveur Content Platform Engine. Par exemple, entrez 8 s'il y a huit processeurs logiques sur votre serveur Content Platform Engine.
La valeur par défaut est 1.
- Nom du fichier journal : Indiquez le nom et le chemin du fichier d'erreur créé par le balayage des mises en attente ou acceptez la valeur par défaut. Par défaut,
un fichier appelé HoldSweepActivity.log est créé dans le dossier ../EnterpriseRecords/RecordsManagerSweep.
Si le balayage des mises en attente se passe sans erreur, la taille du fichier d'erreur est de zéro octet.
- Cliquez sur Configurer.