Commande cache_mgt

Objectif

Gère l'infrastructure qui fournit la mise en cache sur les unités SSD.

Syntaxe

cache_mgt object action [-I [level]] [-T [timeout]]

Commande de gestion des unités de cache

cache_mgt device list [-l]

Commandes de gestion de pools de cache

cache_mgt pool list [-l]
cache_mgt pool create -d devName[,devName,...][-p poolName] [-f]
cache_mgt pool remove [-p poolName] [-f]
cache_mgt pool extend [-p poolName] -d devName[,devName,...] [-f]

Commandes de gestion de partitions de cache

cache_mgt partition list [-l]
cache_mgt partition create [-p poolName] -s partitionSize [-P partitionName]
cache_mgt partition remove [-P partitionName] [-f]
cache_mgt partition extend [-P partitionName] -s partitionSize
cache_mgt partition assign [-P partitionName] -t targetDevName
cache_mgt partition unassign {-t targetDevName | [-P partitionName]} [-f]

Commandes de gestion de la mise en cache sur les unités cible

cache_mgt cache list
cache_mgt cache start {-t targetDevName -P partitionName | -t {targetDevName | all} | -f}
cache_mgt cache stop {-t {targetDevName | all} | -p {poolName | all}}

Commandes de surveillance des statistiques

cache_mgt monitor start
cache_mgt monitor stop
cache_mgt monitor get {-h -s | -h | -s}

Commandes de gestion du moteur de cache

cache_mgt engine list [-l]
cache_mgt engine register -n cePath
cache_mgt engine unregister [-n cePath]

Descriptif

La commande cache_mgt permet de gérer la mise en cache sur des unités SSD. Cette commande fournit les fonctions suivantes:

Liste des unités SSD disponibles qui peuvent être utilisées pour créer ou étendre des pools de cache sur le système.
Créez, supprimez, étendez et répertoriez les pools de cache sur le système. Un pool de cache est un groupe d'unités SSD. Les partitions de cache sont créées à partir du pool de cache.
Créez, supprimez, étendez, affectez, désaffectez et répertoriez les partitions de cache sur le système. Une partition de cache fait partie du pool de cache. Une partition de cache doit être affectée à une unité cible devant être mise en cache.
Démarrer et arrêter la mise en cache d'une unité cible. Il répertorie également les partitions de cache ainsi que les unités cible affectées et leur statut de mise en cache. Un moteur de cache doit être enregistré avant le lancement de la mise en cache.
Surveillez les statistiques de cache.
Enregistrez et désenregistrez le moteur de cache. Il répertorie également les informations du moteur de cache enregistré.

Modes de mise en cache

La mise en cache peut être effectuée dans l'un des modes suivants:

Mode physique: Les unités de cache (ou unités SSD) sont directement affectées à une partition logique (LPAR). Les commandes cache_mgt peuvent être utilisées pour gérer le pool de cache, les partitions de cache et la mise en cache d'une unité cible.
Mode virtuel: Les unités de cache (ou unités SSD) sont affectées au serveur Virtual I/O Server. Le pool de cache et les partitions de cache sont gérés sur le serveur Virtual I/O Server. Les partitions de cache sur Virtual I/O Server peuvent être virtualisées (unités de cache virtuelles) sur la partition logique client via l'interface SCSI virtuelle. L'affectation et la mise en cache de la partition de cache doivent être gérées sur la partition logique.

Informations sur le moteur de cache

Le module de moteur de cache met en cache les unités cible sur les partitions de cache. Un moteur de cache est inclus par défaut et il est automatiquement enregistré sur les partitions logiques client.

Un seul pool de cache est pris en charge en mode physique et la mise en cache ne peut être démarrée que sur une seule partition de cache.

Indicateurs

Commandes de gestion d'unités de cache

Objet	Opération	Indicateurs et paramètres	Descriptif
dispositif	liste	[-l]	Répertorie les unités SSD. Si vous utilisez l'indicateur -l , la commande imprime le nom du pool de mémoire cache associé.

Commandes de gestion de pools de cache

Objet	Opération	Indicateurs et paramètres	Descriptif
pool	liste	[-l]	Répertorie les pools de cache. Si vous utilisez l'indicateur -l , la commande imprime également les unités SSD associées.
pool	create	-d `devName`[`,devName`,...] [-p `poolName`] [-f]	Crée un pool de cache avec la liste des unités SSD spécifiées avec l'indicateur -d . Le nom de pool peut également être spécifié avec l'indicateur -p . Si l'indicateur force (-f) est spécifié, un pool de mémoire cache est créé indépendamment de l'utilisation précédente des unités.
pool	Supprimer	[-p `poolName`] [-f]	Retire le pool de cache. Cette action échoue si une partition existe encore dans le pool. Si l'option -f est spécifiée, toutes les partitions existantes dans le pool sont retirées.
pool	étendre	[-p `poolName`] '-d `devName`[`,devName`,...] [-f]	Etend un pool existant avec la liste des unités SSD spécifiées avec l'indicateur -d . Si l'indicateur force (-f) est spécifié, un pool de mémoire cache est étendu quelle que soit l'utilisation précédente des unités.

Commandes de gestion de partitions de cache

Objet	Opération	Indicateurs et paramètres	Descriptif
Partition	liste	[-l]	Répertorie les partitions de cache (unités de cache virtuelles). Si vous utilisez l'indicateur -l , la commande imprime le nom de pool associé si une partition est un volume logique et les noms d'unité cible associés, s'ils sont configurés, dans un format séparé par des virgules.
Partition	create	[-p `poolName`] -s `partitionSize` [-P `partitionName`]	Crée une partition de cache dans un pool. Le nom du pool peut être spécifié avec l'indicateur -p . Le nom de partition peut être spécifié avec l'indicateur -P . La taille de partition doit être spécifiée avec l'indicateur -s . La taille de la partition doit être dans l'une des unités suivantes: B/b 512 byte blocks K/k KB M/m MB G/g GB
Partition	Supprimer	[-P `partitionName`] [-f]	Supprime une partition d'un pool de cache. Le nom de partition peut être spécifié avec l'indicateur -P . Remarque: Vous devez annuler l'affectation de la partition avant de la supprimer. Vous pouvez également utiliser l'indicateur force (-f) pour le supprimer.
Partition	étendre	[-P `partitionName`] -s `partitionSize`	Etend une partition existante par la valeur `partitionSize` spécifiée avec l'indicateur -s . La valeur `partitionName` peut également être spécifiée avec l'indicateur -P .
Partition	affecter	[-P `partitionName`] -t `targetDevName`	Crée la relation entre un nom de partition de cache spécifié avec l'indicateur -P et un nom d'unité cible spécifié avec l'indicateur -t dans la configuration. L'état de mise en cache reste 0 (arrêté) et l'opération de mise en cache n'est pas démarrée. Vous devez exécuter l'action cache start -t pour démarrer l'opération de mise en cache et modifier l'état de mise en cache dans la configuration.
Partition	libérer	-t `targetDevName` [-f]	Supprime la relation entre une partition de cache et le nom d'unité cible spécifié avec l'indicateur -t dans la configuration. Vous devez arrêter la mise en cache de la partition avant de la supprimer ou utiliser l'indicateur force (-f) avant de la supprimer.
Partition	libérer	[-P `partitionName`] [-f]	Supprime la relation entre une partition de cache et toutes ses unités cible dans la configuration. Vous devez arrêter la mise en cache de la partition avant de la supprimer ou utiliser l'indicateur force (-f) avant de la supprimer.

Commandes de gestion de la mise en cache sur les unités cible

Objet	Opération	Indicateurs et paramètres	Descriptif
Cache	liste		Répertorie les partitions pour lesquelles l'opération de mise en cache est démarrée.
Cache	DÉBUT	-t `targetDevName` -P `partitionName`	Démarre l'opération de mise en cache d'un nom d'unité cible spécifié avec l'indicateur -t sur un nom de partition de cache spécifié avec l'indicateur -P .
Cache	DÉBUT	-t {`nom_unité_cible` \| all }	Démarre l'opération de mise en cache d'un nom d'unité cible spécifié avec l'indicateur -t pour une partition de cache précédemment affectée. La commande démarre l'opération de mise en cache pour toutes les unités cible affectées si vous spécifiez l'option all avec l'indicateur -t .
Cache	DÉBUT	-f	Charge le moteur de cache même s'il n'y a pas d'unité de cache.
Cache	stop	-t {`nom_unité_cible` \| all }	Arrête l'opération de mise en cache d'un nom d'unité cible spécifié avec l'indicateur -t . La commande arrête l'opération de mise en cache pour toutes les unités cible affectées lorsque l'option all est spécifiée avec l'indicateur -t . La définition d'affectation de partition de cache n'est pas supprimée de la configuration.
Cache	stop	-p {`nom_pool` \| all }	Arrête l'opération de mise en cache de toutes les unités cible d'un nom de pool de mémoire cache spécifié avec l'indicateur -p . La commande arrête la mise en cache de toutes les unités cible affectées lorsque l'option all est spécifiée avec l'indicateur -p . La définition d'affectation de partition de cache n'est pas supprimée de la configuration.

Commandes de surveillance des statistiques

Objet	Opération	Indicateurs et paramètres	Descriptif
monitor	DÉBUT		Démarre la surveillance de l'opération de mise en cache.
monitor	stop		Arrête la surveillance de l'opération de mise en cache.
monitor	obtenir	{-h -s \| -h \| -s}	Extrait les statistiques d'E-S de mise en cache. La commande affiche les statistiques si l'indicateur -s est spécifié. La commande affiche l'en-tête si l'indicateur -h est spécifié.

Commandes de gestion du moteur de cache

Objet	Opération	Indicateurs et paramètres	Descriptif
moteur	liste	[-l]	Répertorie le chemin du moteur de cache défini dans la configuration. Si l'option -l est spécifiée, des informations supplémentaires sur le moteur de cache et ses capacités sont affichées.
moteur	pensez à vous inscrire	-n `cePath`	Enregistre le moteur de cache (`cePath`) spécifié avec l'indicateur -n .
moteur	annuler l'enregistrement	[-n `cePath`]	Annule l'enregistrement du moteur de cache. Si la valeur `cePath` n'est pas spécifiée avec l'indicateur -n , désactivez le moteur de cache. Vous ne devez pas supprimer sa définition de la configuration.

Exemples

Pour créer un pool de cache à partir d'une liste d'unités de cache, entrez la commande suivante:
```
cache_mgt pool create -d hdisk1,hdisk2,hdisk3 -p cmpool0
```
La sortie est similaire à l'exemple suivant:
```
Pool cmpool0 created with device hdisk1.
```
Pour répertorier le pool de cache, entrez la commande suivante:
```
cache_mgt pool list -l
```
La sortie est similaire à l'exemple suivant:
```
cmpool0,hdisk1
```
Pour créer une partition de cache dans un pool dont la taille est de 80 Mo, entrez la commande suivante:
```
cache_mgt partition create -p cmpool0 -s 80M -P part1
```
La sortie est similaire à l'exemple suivant:
```
Partition part1 created in pool cmpool0.
```
Pour répertorier les partitions de cache, entrez la commande suivante:
```
cache_mgt partition list -l
```
La sortie est similaire à l'exemple suivant:
```
part1,cmpool0
```
Pour affecter une partition de cache à une unité cible, entrez la commande suivante:
```
cache_mgt partition assign -t hdisk2 -P part1
```
La sortie est similaire à l'exemple suivant:
```
Partition part1 assigned to target hdisk2.
```
Pour démarrer la mise en cache d'une unité cible, entrez la commande suivante:
```
cache_mgt cache start -t hdisk2
```
La sortie est similaire à l'exemple suivant:
```
Cache for target hdisk2 has been started.
```
Pour répertorier toutes les unités cible démarrées ou pour lesquelles la mise en cache est affectée, entrez la commande suivante:
```
cache_mgt cache list
```
La sortie est similaire à l'exemple suivant:
```
hdisk2,part1,active
```
Pour étendre un pool de mémoire cache existant, entrez la commande suivante:
```
cache_mgt pool extend -p cmpool0 -d hdisk5 -f
```
La sortie est similaire à l'exemple suivant:
```
Pool cmpool0 extended with device hdisk5.
```
Pour étendre une partition de cache existante d'une taille de 120 Mo, entrez la commande suivante:
```
cache_mgt partition extend -P part1 -s 120M
```
La sortie est similaire à l'exemple suivant:
```
Partition part1 extended by size 120M.
```
Pour arrêter l'opération de mise en cache d'une unité cible, puis pour répertorier les partitions, entrez les commandes suivantes:
```
cache_mgt cache stop -t hdisk2 

cache_mgt cache list
```
La sortie est similaire à l'exemple suivant:
```
Cache for target hdisk2 has been stopped.

hdisk2,part1,inactive
```
Pour libérer l'unité cible d'une partition de cache, entrez la commande suivante:
```
cache_mgt partition unassign -t hdisk2
```
La sortie est similaire à l'exemple suivant:
```
Partition part1 unassigned from target hdisk2.
```
Pour supprimer une partition de cache d'un pool de cache, entrez la commande suivante:
```
cache_mgt partition remove -P part1
```
La sortie est similaire à l'exemple suivant:
```
Partition part1 removed.
```
Pour supprimer le pool de mémoire cache, entrez la commande suivante:
```
cache_mgt pool remove -p cmpool0
```
La sortie est similaire à l'exemple suivant:
```
Pool cmpool0 removed.
```