UPDATE RETRULE (Mettre à jour une règle de conservation)

Classe de privilège

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 dépasser 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 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 le début d'une période au cours de laquelle la règle de conservation est traitée pour la première fois. La valeur par défaut est l'heure actuelle. Ce paramètre est facultatif. Vous pouvez mettre à jour la valeur STARTTime comme suit, en fonction du type de règle de conservation.

• Une seule fois
  Pour une règle de conservation ponctuelle, vous pouvez spécifier une heure de début située dans le passé. Les fichiers qui étaient actifs à partir de l'heure spécifiée et qui sont toujours stockés sur le serveur IBM Storage Protect doivent être inclus dans l'ensemble de conservation, même s'ils sont inactifs lorsque vous exécutez la commande. Vous pouvez mettre à jour la valeur STARTTime , mais la nouvelle heure de début ne s'appliquera qu'aux futures exécutions de création d'ensemble de conservation.

  Restriction: Si un noeud sur un serveur est le noeud cible d'une opération de réplication de noeud à partir d'un autre serveur, la création d'ensembles de conservation ponctuels pour une heure et une date passées ne peut pas être déclenchée pour le noeud.
• Planifiée

  Dans le cas d'une création d'ensemble de conservation planifiée pour le jour-même, vous ne pouvez mettre à jour la planification de l'exécution que si l'exécution n'a pas encore été démarrée ou n'est pas encore terminée le jour même. Si l'exécution a été démarrée ou est terminée, vous pouvez changer sa planification pour qu'elle ait lieu le lendemain ou ultérieurement.

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é. Par exemple, le traitement à l'expiration ou d'autres activités de suppression peuvent avoir supprimé un ou plusieurs fichiers au fil du temps. Cependant, ces fichiers sont inclus dans l'ensemble de conservation s'ils existaient à l'heure spécifiée située dans le passé.

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 le début d'une période au cours de laquelle la règle de conservation est traitée pour la première fois. Ce paramètre est facultatif. La valeur par défaut est la date actuelle. Vous pouvez mettre à jour la valeur STARTDate comme suit, en fonction du type de règle de conservation.

• Une seule fois
  Pour une règle de conservation ponctuelle, vous pouvez spécifier une date de début située dans le passée. Les fichiers qui étaient actifs à partir de la date indiquée et qui sont toujours stockés sur le serveur IBM Storage Protect doivent être inclus dans l'ensemble de conservation, même s'ils sont inactifs lorsque vous exécutez la commande. Vous pouvez mettre à jour la valeur STARTDate , mais la nouvelle date de début ne s'appliquera qu'aux futures exécutions de création d'ensemble de conservation.

  Restriction: Si un noeud sur un serveur est le noeud cible d'une opération de réplication de noeud à partir d'un autre serveur, la création d'ensembles de conservation ponctuels pour une heure et une date passées ne peut pas être déclenchée pour le noeud.
• Planifiée

  Dans le cas d'une création d'ensemble de conservation planifiée pour le jour-même, vous ne pouvez mettre à jour la planification de l'exécution que si l'exécution n'a pas encore été démarrée. Si l'exécution a été démarrée ou est terminée, vous pouvez changer sa planification pour qu'elle ait lieu le lendemain ou ultérieurement.

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é. Par exemple, il se peut que le traitement à l'expiration ou d'autres activités de suppression aient supprimé un ou plusieurs fichiers au fil du temps ; cependant, ces fichiers sont inclus dans l'ensemble de conservation s'ils existaient à l'heure spécifiée située dans le passé.

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

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 , FREQUENCY=ONETIME doit être spécifié.

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.

RETention

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 facultatif.

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 pas tant que la durée de conservation en vigueur pour cet ensemble n'est pas écoulée, et ce sans considération de la classe de gestion et des politiques 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. Exemples de nombre de jours converti en 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.

Yes

Spécifie que la règle de conservation est active. Pour permettre la création d'ensembles de conservation par la règle de conservation, le paramètre ACTIVE doit être défini sur Oui.

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 dans un pool de stockage de conservation. Ce paramètre est facultatif. 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 dans lequel les copies des données des ensembles de conservation créés par cette règle de conservation seront stockées. Le pool de stockage de conservation peut se trouver sur bande ou sur le cloud. Pour supprimer une destination, spécifiez le paramètre DESTINATION avec une chaîne nulle (""). Ce paramètre est facultatif.

pool_stockage_conservation

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

Restriction :

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

SCHEDStyle

Spécifie le type de planification pour la règle de conservation. Ce paramètre est facultatif. 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. La valeur par défaut est WEEKLY (hebdomadaire). 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.

Commandes associées