DEFINE RETRULE (Définir une règle de conservation)

Cette commande permet de définir une règle de conservation pour un serveur IBM Storage Protect .

Différents types de données peuvent être inclus dans un ensemble de conservation, en fonction du client ou du produit qui a sauvegardé les données. Pour plus d'informations, voir Types de données pouvant être inclus dans des ensembles de conservation.

Vous pouvez définir une règle de conservation à exécution ponctuelle, c'est-à-dire prévue pour ne s'exécuter qu'une seule et unique fois, ou une règle à exécution répétée et planifiée.

Une règle de conservation ponctuelle crée un ensemble de conservation qui collecte des données actives du le passé, du présent ou de l'avenir.

Vous pouvez également définir une règle de conservation qui soit exécutée périodiquement tel jour à telle heure à compter de maintenant (date et heure courantes) ou d'une date et d'une heure futures.

Restrictions: Les restrictions suivantes s'appliquent aux règles de conservation.

Vous ne pouvez pas modifier une règle ponctuelle pour qu'elle s'exécute régulièrement ou pour qu'elle crée un autre ensemble de conservation.
Si un noeud de votre ensemble de conservation est la cible d'une opération de réplication de noeud et que vous souhaitez créer un ensemble de conservation avec les données à répliquer, vous devez définir l'ensemble de conservation avec les valeurs de paramètre STARTTIME et STARTDATE qui précèdent le début de l'opération de réplication.

Classe de privilège

Pour exécuter cette commande, vous devez disposer du privilège système ou du privilège de règles illimité.

Syntaxe

Remarques :

¹ Le nom_espace_fichier peut correspondre à un espace fichier sur un client de sauvegarde-archivage ou à une machine virtuelle IBM Storage Protect for Virtual Environments . Pour spécifier la machine virtuelle, utilisez le nom de la machine virtuelle ou le nom de l'espace fichier correspondant.
² Si vous spécifiez un nom d'espace fichier, vous ne pouvez spécifier qu'un seul nom de noeud qualifié complet.
³ Pour créer un ensemble de conservation rétroactif qui collecte des données passées par une règle de conservation unique, vous devez définir la règle de conservation avec des valeurs de paramètre STARTTIME et STARTDATE .
⁴ Pour spécifier les paramètres HOLD et HOLDREASON , vous devez également spécifier FREQUENCY=ONETIME.

Planification classique

Planification étendue

Paramètres

nom_règle (obligatoire)

Spécifie le nom de la règle de conservation. Le nom doit être unique et ne doit pas comporter plus de 64 caractères.

nom_poste ou nom_groupe_noeuds (obligatoire)

Spécifie le nom du noeud client ou des groupes de noeuds auxquels s'applique la règle de conservation. Pour spécifier plusieurs noms de noeuds et noms de groupes de noeuds, séparez-les par une virgule sans ajouter d'espace. Vous pouvez utiliser des caractères génériques avec les noms de noeud, mais pas avec les noms de groupe de noeuds. Si vous spécifiez des caractères génériques dans le nom du noeud, lorsque l'ensemble de conservation sera créé, tous les noeuds dont le nom concorde avec le motif formé par ces caractères génériques seront inclus dans cet ensemble. Si vous spécifiez un nom d'espace fichier, vous ne pouvez spécifier qu'un seul nom de noeud. Vous pouvez spécifier un groupe de noeuds même si aucun des noeuds membres du groupe ne peut être inclus dans un ensemble de conservation.

Restrictions :

Les noeuds client mis hors service lorsque l'ensemble de conservation est créé sont exclus de ce dernier.
Une sauvegarde VSS de destination de type Local ne peut pas être incluse dans un ensemble de conservation car elle est stockée sur des volumes miroirs locaux client. Seuls les objets de métadonnées sont envoyés au serveur pour une sauvegarde VSS de destination de type Local. L'ensemble de conservation ne peut pas contrôler la sauvegarde.
Vous pouvez ajouter un noeud à un ensemble de conservation uniquement si le noeud a été enregistré sur le serveur avec le paramètre TYPE=CLIENT spécifié. Les noeuds sont enregistrés sur le serveur à l'aide de la commande REGISTER NODE. Pour déterminer la valeur TYPE d'un noeud enregistré, exécutez la commande QUERY NODE.

nom_espace_fichier

Spécifie le nom d'un espace fichier auquel s'applique la règle de conservation.

Le nom de l'espace fichier peut correspondre à l'espace fichier d'un client de sauvegarde-archivage. Le nom de l'espace fichier peut également correspondre au nom d'une machine virtuelle IBM Storage Protect for Virtual Environments . Au lieu de spécifier un nom d'espace fichier, vous pouvez spécifier le nom de la machine virtuelle.

Vous pouvez spécifier des caractères génériques dans le nom de l'espace fichier. Pour spécifier un espace fichier contenant une virgule dans le nom, vous devez spécifier l'ID numérique de l'espace fichier, puis spécifier NAMETYPE=FSID.

Conseils :

Exécutez la commande QUERY FILESPACE pour déterminer quels espaces fichier et quels ID d'espace fichier sont définis pour un noeud sur le serveur.
Les espaces fichier mis hors service lorsque l'ensemble de conservation est créé sont exclus de ce dernier.

NAMEType

Détermine comment le serveur doit interpréter le nom d'espace fichier que vous indiquez. Utilisez ce paramètre uniquement lorsque vous indiquez un nom d'espace fichier qualifié complet.

La valeur par défaut est SERVER. Si un nom de mappage d'espace fichier virtuel est indiqué, vous devez utiliser SERVER. Vous pouvez spécifier l'une des valeurs suivantes :

SERVER: Le serveur utilise sa page de codes pour interpréter le nom de l'espace fichier.
UNIcode: Le serveur convertit le nom d'espace fichiers entré depuis sa page de codes vers la page de codes UTF-8. La réussite de la conversion dépend des caractères figurant dans le nom et de la page de codes du serveur. La conversion échoue si la chaîne inclut des caractères qui ne sont pas disponibles dans cette page de codes ou si le serveur ne parvient pas à accéder aux routines de conversion du système.
FSID: Le serveur interprète le nom de l'espace fichier comme l'ID de l'espace fichier (FSID).

CODEType

Indique le type des espaces fichier à inclure dans le traitement de la règle de conservation. La valeur par défaut est BOTH, qui signifie que les espaces fichier sont inclus quel que soit le type de page de codes. Utilisez ce paramètre uniquement lorsque vous entrez au moins un caractère générique pour le nom de l'espace fichier. Vous pouvez spécifier l'une des valeurs suivantes :

UNIcode: Indique uniquement les espaces fichier au format Unicode.
NONUNIcode: Indique uniquement les espaces fichier non Unicode.
BOTH: Indique les espaces fichier, quel que soit le type de page de codes.

STARTTime

Spécifie l'heure de début d'un intervalle dans lequel a lieu le premier traitement de la règle de conservation. Si l'heure de début est antérieure, les fichiers qui étaient actifs à partir de l'heure spécifiée et qui sont toujours stockés sur le serveur IBM Storage Protect sont inclus dans le groupe de conservation, même s'ils sont inactifs au moment de l'émission de la commande.

Astuce: Pour les ensembles de conservation créés dans le passé, un message d'information est émis dans le journal d'activité pour indiquer que l'ensemble de conservation peut inclure des fichiers tels qu'ils existaient dans le passé.

Si la création planifiée d'un ensemble de conservation ne s'exécute pas au moment prévu, elle a lieu dès que possible.

La valeur par défaut est l'heure actuelle. Ce paramètre est facultatif.

Vous pouvez spécifier l'une des valeurs suivantes :

Valeur	Description	Exemple
HH:MM:SS	Une heure déterminée	23:30:08
NOW	Heure actuelle	NOW
NOW+HH:MM ou +HH:MM	Heure actuelle plus le nombre d'heures et de minutes spécifié	NOW+02:00 ou +02:00
NOW-HH:MM ou -HH:MM	Heure actuelle moins le nombre d'heures et de minutes spécifié	NOW-02:00 ou -02:00

STARTDate

Spécifie la date de début d'une plage dans laquelle a lieu le premier traitement de la règle de conservation. Si la date de début est antérieure, les fichiers qui étaient actifs à partir de la date indiquée et qui sont toujours stockés sur le serveur IBM Storage Protect sont inclus dans l'ensemble de conservation, même s'ils sont inactifs au moment où vous lancez la commande.

Si la création planifiée d'un ensemble de conservation ne s'exécute pas au moment prévu, elle a lieu dès que possible.

Ce paramètre est facultatif. La valeur par défaut est la date actuelle.

Vous pouvez spécifier l'une des valeurs suivantes :

Valeur	Description	Exemple
MM/JJ/AAAA	Une date déterminée.	15/05/2018
TODAY	Date en cours.	TODAY
TODAY+jours ou +jours	Date du jour plus le nombre de jours spécifié. Vous pouvez spécifier jusqu'à 9999 jours.	TODAY+3 ou +3
EOLM (End Of Last Month, fin du mois dernier)	Dernier jour du mois précédent	EOLM
EOLM-jours	Dernier jour du mois précédent moins le nombre de jours spécifié.	EOLM-1 Pour inclure les fichiers qui étaient actifs un jour avant le dernier jour du mois précédent
BOTM (Beginning Of This Month, début de ce mois)	Premier jour du mois en cours	BOTM
BOTM +jours	Premier jour du mois en cours, plus le nombre de jours spécifié.	BOTM+9 Pour inclure les fichiers qui étaient actifs le 10e jour du mois en cours

RETention (obligatoire)

Indique la durée, en jours, pendant laquelle un ensemble de conservation créé par la règle de conservation est conservé par le serveur. Ce paramètre est obligatoire.

La valeur spécifiée ici sera appliquée comme durée de conservation à tous les ensembles de conservation qui seront créés par cette règle. Vous aurez cependant la possibilité de changer cette durée ponctuellement pour un ensemble particulier en lui appliquant la commande UPDATE RETSET. Les données contenues dans un ensemble de conservation n'expirent que lorsque la durée de conservation de cet ensemble de conservation s'est écoulée, quelles que soient la classe de gestion et les stratégies de groupe de copie associées à ces données. Vous pouvez spécifier l'une des valeurs suivantes :

jours

Spécifiez un entier compris entre 0 et 30.000.

Après avoir déterminé la durée pendant laquelle les données doivent être conservées, vous pouvez utiliser le tableau suivant pour convertir le nombre d'années en jours. Si la période inclut une année bissextile, réglez le nombre de jours.

Tableau 1. Correspondance nombre de jours / années
Nombre d'années	Nombre de jours correspondant
1 an	365
2 ans	730
3 ans	1095
4 ans	1461
5 ans	1826
6 ans	2191
7 ans	2556
8 ans	2921
9 ans	3287
10 ans	3652
20 ans	7304
30 ans	10957
40 ans	14609
50 ans	18262

NOLimit

Spécifie que l'ensemble de conservation doit être conservé indéfiniment. Si vous spécifiez NOLimit, le serveur conserve les ensembles de conservation indéfiniment, sauf si un utilisateur ou un administrateur autorisé supprime l'ensemble de conservation. Pour plus d'informations sur la commande DELETE RETSET , voir DELETE RETSET (Suppression d'un ensemble de conservation).

ACTive

Spécifie si la règle de conservation est activée en vue de son traitement. Ce paramètre est facultatif. La valeur par défaut est Yes.

Yes: Spécifie que la règle de conservation est active. Pour permettre la création des ensembles de conservation par la règle de conservation, le paramètre ACTIVE doit être défini sur Yes.
No: Spécifie que la règle de conservation n'est pas dans un état actif (ACTIVE) et que, par conséquent, elle n'est pas utilisée pour créer des ensembles de conservation.

DESCription

Spécifie une description pour la règle de conservation. Cette description sera copiée dans les ensembles de conservation qui seront créés par cette règle de conservation. Ce paramètre est facultatif.

La description est limitée à 255 caractères. Placez la description entre guillemets si elle contient des caractères blancs (espaces ou autres).

STACK

Spécifie si les données des ensembles de conservation qui sont créés par la règle de conservation peuvent être copiées sur des volumes de bande partagés, c'est-à-dire des volumes qui contiennent également des données provenant d'autres ensembles de conservation. Ce paramètre est facultatif. La valeur par défaut est YES.

Restriction: Le paramètre STACK s'applique uniquement lorsque vous copiez des données de conservation sur des volumes de bande. Le paramètre est ignoré lorsque vous copiez des données de conservation dans le stockage cloud.

Yes: Indique que les données de l'ensemble de conservation peuvent partager des volumes de bande avec des données copiées à partir d'autres ensembles de conservation. Les données de l'ensemble de conservation peuvent être copiées sur n'importe quel volume de bande ayant le statut EMPTY. Les données peuvent également être copiées sur des volumes dont le statut est FILLING, mais uniquement si ces volumes ne sont pas déjà utilisés par des ensembles de conservation nécessitant un volume distinct.
No: Indique que les données de l'ensemble de conservation ne partagent pas les volumes de bande avec les données provenant d'autres ensembles de conservation. Les données de l'ensemble de conservation peuvent être copiées sur des volumes de bande ayant un statut EMPTY ou FILLING.
Restriction: les données ne peuvent être copiées dans des volumes de remplissage que si les volumes contiennent déjà des données pour l'ensemble de conservation en cours de copie. Lorsque l'opération de copie des données conservées dans le volume se termine, même si le volume n'est pas saturé, il est alors marqué comme FULL pour éviter son utilisation par d'autres ensembles de conservation.

MAXCOPYProcess

Spécifie le nombre maximal de processus parallèles que la règle de stockage peut exécuter lors de la copie de données conservées (pour les ensembles de conservation qui sont créés par cette règle de conservation) dans un pool de stockage de conservation. Ce paramètre est facultatif. Par défaut, le nombre optimal de processus parallèles est déjà calculé et défini sur Automatic. Tous les ensembles de conservation créés à partir de la règle de conservation héritent de la valeur MAXCOPYPROCESS spécifiée pour la règle de stockage. Assurez-vous qu'une valeur appropriée est définie pour le paramètre MAXCOPYPROCESS afin d'optimiser les performances des opérations de copie.

AUTOmatic: Spécifie que le nombre maximal de processus à utiliser est prédéfini pour des performances optimales.
STGRule: Spécifie que le nombre de processus parallèles est déterminé par la valeur MAXPROCESS de la règle de stockage.
nombre: Spécifie le nombre maximal de processus parallèles à utiliser pour copier les données conservées. Vous pouvez spécifier une valeur comprise entre 1 et 99.

DESTination

Spécifie une destination pour les ensembles de conservation qui sont créés par cette règle de conservation. Vous pouvez spécifier le nom d'un pool de stockage de conservation. Le pool de stockage de conservation peut se trouver sur bande ou sur le cloud. Si vous ne spécifiez pas de destination, la règle de conservation crée des ensembles de conservation en place et les données conservées sont stockées dans l'espace de stockage du serveur uniquement. Ce paramètre est facultatif.

Restriction :

Vous ne pouvez spécifier que des pools de stockage de conservation comme destination.

pool_stockage_conservation: Spécifie le nom du pool de stockage de conservation dans lequel les ensembles de conservation sont copiés.

HOLD

Spécifie le nom du verrou de conservation auquel un ou plusieurs ensembles de conservation peuvent être ajoutés. Vous pouvez placer un ensemble de conservation sous verrou de conservation afin de conserver indéfiniment les données pertinentes, par exemple, si un litige est en attente ou prévu. Un ensemble de conservation qui a été ajouté à un verrou de conservation ne peut pas être supprimé, quelle que soit sa date d'expiration, tant qu'il n'a pas été explicitement libéré du verrou.

Restriction: Pour spécifier les paramètres HOLD et HOLDREASON , vous devez également spécifier FREQUENCY=ONETIME.

HOLDREASon

Spécifie le motif pour lequel l'ensemble de conservation spécifié est placé sous verrou. Le motif ne peut pas comporter plus de 510 caractères. Placez-le entre guillemets s'il contient des espaces.

SCHEDStyle

Spécifie le type de planification pour la règle de conservation. Sa valeur par défaut est Classic.

Vous pouvez spécifier l'une des valeurs suivantes :

Classic: Le paramètre utilisable dans la syntaxe Classic est DAYOFWEEK (jour de la semaine). Si vous spécifiez SCHEDSTYLE=CLASSIC, vous ne pouvez pas spécifier les paramètres suivants : MONTH, DAYOFMONTH et WEEKOFMONTH.
Enhanced: Les paramètres utilisables dans la syntaxe Enhanced sont les suivants : MONTH, DAYOFMONTH, WEEKOFMONTH et DAYOFWEEK. Si vous spécifiez SCHEDSTYLE=ENHANCED, vous ne pouvez pas spécifier le paramètre FREQUENCY.

FREQuency

Spécifie la fréquence de création des ensembles de conservation. Vous pouvez spécifier le paramètre FREQUENCY uniquement avec le paramètre SCHEDSTYLE=CLASSIC.

Restriction: Si vous spécifiez FREQUENCY=ONETIME, vous ne pouvez pas modifier cette valeur une fois la règle de conservation définie. Inversement, si vous spécifiez une valeur autre que ONETIME, vous ne pouvez plus revenir à ONETIME une fois la règle de conservation définie.

Exemple : définition d'une règle de conservation qui déclenche la création d'un ensemble de conservation une fois par semaine

Définir une règle de conservation sur NODE1 nommée MY_WEEKLY_RETSET qui déclenche la création hebdomadaire d'un ensemble de conservation. Spécifier le 10 mai 2018 comme date de début et indiquer que la création de l'ensemble de conservation doit avoir lieu tous les samedis à 1h00. Les ensembles de conservation sont conservés pendant 150 jours.

define retrule my_weekly_retset NODE1 retention=150 
description="Weekly retention set creation" 
startdate=05/10/2018 starttime=01:00:00 
schedstyle=classic frequency=weekly dayofweek=saturday

Exemple : définition d'une règle de conservation pour un groupe de noeuds client et pour plusieurs noeuds désignés à l'aide d'un caractère générique

Définir une règle de conservation nommée SERVER_TEST_DATA sur les noeuds client NODE1, NODE2 et NODE3 et sur le groupe de noeuds client nommé TESTDATA. Les seuls noeuds du système dont le nom commence par les caractères "NODE" sont NODE1, NODE2 et NODE3. Il est donc aisé de les désigner au moyen d'un astérisque. Spécifier la date actuelle à 1h00 comme date de début. La durée de conservation est de 60 jours.

define retrule server_test_data NODE*,testdata retention=60 
startdate=TODAY starttime=01:00:00 
schedstyle=classic frequency=weekly dayofweek=monday

Commandes associées

Tableau 2. Commandes associées à DEFINE RETRULE
Commande	Description
SUPPRIMER LA RÈGLE	Suppression d'une règle de conservation.
NOEUD DE REQUETE	Affichage d'informations partielles ou complètes concernant un ou plusieurs clients.
REQUETE RETRULE	Affichage d'informations sur les règles de conservation.
ENREGISTRER LE POSTE	Définition d'un noeud de client sur le serveur et configuration des options pour cet utilisateur.
RENOMMER RETRULE	Renommage d'une règle de conservation.
MISE A JOUR DE RETRULE	Change les attributs d'une règle de conservation.