Introduction

Ce document décrit le processus de remplacement de vESA et vSMA lorsqu'une mise à niveau échoue en raison d'une petite partition Nextroot. 

Informations générales

Initialement, les images de l'appliance de sécurité de la messagerie virtuelle (vESA) et de l'appliance de gestion de la sécurité virtuelle (vSMA) ont été créées avec une taille de partition Nextroot inférieure à 500 Mo. Au fil des ans, et avec les nouvelles versions d'AsyncOS qui incluent des fonctionnalités supplémentaires, les mises à niveau ont nécessité plus d'espace dans cette partition tout au long du processus de mise à niveau. Les mises à niveau peuvent échouer en raison de cette taille de partition. Ce document fournit des détails sur la solution, qui consiste à déployer une nouvelle image virtuelle avec une partition Nextroot de 4 Go. 

Défauts associés pour ESA :ID de bogue Cisco CSCvy69068 et SMA : ID de bogue Cisco CSCvy69076

Symptômes

Une image vESA ou vSMA plus ancienne avec une taille de partition Nextroot inférieure à 500 Mo peut ne pas être mise à niveau avec ces erreurs. 

...
...
...
Finding partitions... done.
Setting next boot partition to current partition as a precaution... done.
Erasing new boot partition... done.
Extracting eapp done.
Extracting scanerroot done.
Extracting splunkroot done.
Extracting savroot done.
Extracting ipasroot done.
Extracting ecroot done.
Removing unwanted files in nextroot done.
Extracting distroot
/nextroot: write failed, filesystem is full
./usr/share/misc/termcap: Write failed
./usr/share/misc/pci_vendors: Write to restore size failed
./usr/libexec/getty: Write to restore size failed
./usr/libexec/ld-elf.so.1: Write to restore size failed
./usr/lib/libBlocksRuntime.so: Write to restore size failed
./usr/lib/libBlocksRuntime.so.0: Write to restore size failed
./usr/lib/libalias.so: Write to restore size failed
./usr/lib/libarchive.so: Write to restore size failed

Solution

Pour vous assurer que l'appliance virtuelle peut être mise à niveau, vérifiez que la taille de la partition Nextroot est de 4 Go.

commande : ipcheck

(example.cisco.com) > ipcheck

<----- Example output (relevant section) ----->

  Root                  4GB 7%
  Nextroot 4GB 1%
  Var                   400MB 3%
  Log                   172GB 3%
  DB                    2GB 0%
  Swap                  6GB
  Mail Queue            10GB

<----- End of example output ----->

Résultat attendu : Nextroot affiche 4 Go.

Si la partition Nextroot est inférieure à 4 Go, suivez la procédure applicable pour migrer le modèle de machine virtuelle actuel vers une image plus récente.

Important : Choisissez un chemin en fonction du type d'appliance : vESA utilise une migration basée sur un cluster (étapes 4 à 5). vSMA utilise une migration basée sur une sauvegarde (étape 6).

Étape 1.

Déployez votre nouveau vESA/vSMA

À partir des prérequis, téléchargez l'image virtuelle ESA/SMA et déployez-la conformément au Guide d'installation de Cisco Content Security Virtual Appliance.

Remarque : Le guide d'installation fournit des informations sur DHCP (**interfaceconfig**), la définition de la passerelle par défaut (**setgateway**) et le chargement du fichier de licence de l'appliance virtuelle. Assurez-vous que le déploiement est terminé comme indiqué.

Étape 2.

Octroi de licences pour le nouveau vESA/vSMA

Une fois le nouveau ESA ou SMA virtuel déployé, il est temps de charger le fichier de licence. Pour les licences traditionnelles (versions 15.0 et antérieures), la licence est contenue dans un fichier XML et doit être chargée à l'aide de l'interface de ligne de commande. À partir de l'interface de ligne de commande, vous utilisez la commande loadlicense, puis suivez les invites pour terminer l'importation de la licence.

Si la version est postérieure à la version 15.5, vous pouvez consulter cet article car la licence Smart est obligatoire : Activer la licence Smart et dépanner sur ESA/SMA/WSA

Étape 3.

Vérifiez que les deux appliances exécutent la même version AsyncOS. Si les versions diffèrent, exécutez la mise à niveau sur la nouvelle appliance pour qu'elle corresponde à la version d'origine avant la migration.

Étape 4. (Uniquement pour vESA, Ignorer pour vSMA)

Remarque : Cette étape suppose qu'il n'existe pas de cluster. Si une grappe existe déjà, ajoutez la nouvelle vESA à la grappe existante pour copier la configuration, puis supprimez la nouvelle appliance pour lancer le processus de mise à niveau.

Créer un nouveau cluster

Sur le vESA d'origine, exécutez clusterconfig pour créer un nouveau cluster.

Original-ESA.example.com> clusterconfig

Do you want to join or create a cluster?
1. No, configure as standalone.
2. Create a new cluster.
3. Join an existing cluster over SSH.
4. Join an existing cluster over CCS.
[1]> 2

Enter the name of the new cluster.
[]> Cluster-1

Must all machines in the cluster communicate with each other by hostname or by IP address?
1. Communicate by IP address.
2. Communicate by hostname.
[2]> 1

What IP address should other machines use to communicate with Machine C170.local?
1. 192.0.2.10 port 22 (SSH on interface Management)
2. Enter an IP address manually
[]> 1

Other machines will communicate with Machine C195.local using IP address 192.0.2.10 port 22. You can change this by using the COMMUNICATION subcommand of the clusterconfig command.
New cluster committed: Sat Jun 08 11:45:33 2019 GMT
Creating a cluster takes effect immediately, there is no need to commit.

Cluster Cluster-1

Choose the operation you want to perform:
- ADDGROUP - Add a cluster group.
- SETGROUP - Set the group that machines are a member of.
- RENAMEGROUP - Rename a cluster group.
- DELETEGROUP - Remove a cluster group.
- REMOVEMACHINE - Remove a machine from the cluster.
- SETNAME - Set the cluster name.
- LIST - List the machines in the cluster.
- CONNSTATUS - Show the status of connections between machines in the cluster.
- COMMUNICATION - Configure how machines communicate within the cluster.
- DISCONNECT - Temporarily detach machines from the cluster.
- RECONNECT - Restore connections with machines that were previously detached.
- PREPJOIN - Prepare the addition of a new machine over CCS.
[]>

(Cluster Cluster-1)>

Étape 5. (Uniquement pour vESA, Ignorer pour vSMA)

Rejoignez votre nouveau cluster vESA à votre cluster ESA d'origine

À partir de l'interface de ligne de commande sur le nouveau vESA, exécutez clusterconfig et sélectionnez Join an existing cluster pour ajouter le nouveau vESA au cluster configuré sur le vESA d'origine.

New-ESA.example.com> clusterconfig

Do you want to join or create a cluster?
1. No, configure as standalone.
2. Create a new cluster.
3. Join an existing cluster over SSH.
4. Join an existing cluster over CCS.
[1]> 3

While joining a cluster, you will need to validate the SSH host key of the remote machine to which you are joining.  To get the public host key fingerprint of the remote host, connect to the cluster and run: logconfig -> hostkeyconfig -> fingerprint.

WARNING: All non-network settings will be lost. System will inherit the values set at the group or cluster mode for the non-network settings. Ensure that the cluster settings are compatible with your network settings (e.g. dnsconfig settings)

Exception:Centralized Policy, Virus, and Outbreak Quarantine settings are not inherited from the cluster.  These settings on this machine will remain intact.

Do you want to enable the Cluster Communication Service on esa.example.com? [N]> n

Enter the IP address of a machine in the cluster.
[]> 192.0.2.10

Enter the remote port to connect to.  This must be the normal admin ssh port, not the CCS port.
[22]>

Would you like to join this appliance to a cluster using pre-shared keys? Use this option if you have enabled two-factor authentication on the appliance. [Y]> n

Enter the name of an administrator present on the remote machine
[admin]>

Enter passphrase:
Please verify the SSH host key for 192.0.2.11:
Public host key fingerprint: 80:11:33:aa:bb:44:ee:ee:22:77:88:ff:77:88:88:bb
Is this a valid key for this host? [Y]> y

Joining cluster group Main_Group.
Joining a cluster takes effect immediately, there is no need to commit.
Cluster Cluster-1

Choose the operation you want to perform:
- ADDGROUP - Add a cluster group.
- SETGROUP - Set the group that machines are a member of.
- RENAMEGROUP - Rename a cluster group.
- DELETEGROUP - Remove a cluster group.
- REMOVEMACHINE - Remove a machine from the cluster.
- SETNAME - Set the cluster name.
- LIST - List the machines in the cluster.
- CONNSTATUS - Show the status of connections between machines in the cluster.
- COMMUNICATION - Configure how machines communicate within the cluster.
- DISCONNECT - Temporarily detach machines from the cluster.
- RECONNECT - Restore connections with machines that were previously detached.
- PREPJOIN - Prepare the addition of a new machine over CCS.
[]>

(Cluster Cluster-1)>

Une fois les appareils connectés et synchronisés, le nouveau vESA présente la même configuration que le vESA existant.

commande : contrôle de grappe

Résultat attendu : Aucune incohérence n'est signalée et la synchronisation est terminée.

Étape 6. (Uniquement pour vSMA, Ignorer pour vESA)

Consultez les conditions requises pour la sauvegarde des données SMA dans le Guide de l'administrateur SMA : Prérequis de sauvegarde.

Exécutez backupconfig sur l'appliance en cours de remplacement pour planifier une sauvegarde sur le vSMA nouvellement déployé.

Pour démarrer une sauvegarde immédiate :

1. Connectez-vous à la CLI SMA d'origine en tant qu'administrateur.
2. Entrez backupconfig.
3. Sélectionnez Planifier.
4. Saisissez l'adresse IP de la nouvelle machine vers laquelle transférer les données.
5. Le SMA source vérifie l'existence du SMA cible et s'assure que le SMA cible dispose de suffisamment d'espace pour accepter les données.
6. Sélectionnez3 (Lancer une seule sauvegarde maintenant).
7. Entrez vieworstatus pour vérifier que la sauvegarde a été correctement planifiée.

Remarque : La durée nécessaire à la sauvegarde des données varie en fonction de la taille des données, de la bande passante réseau, etc.

Une fois la sauvegarde terminée, le nouveau vSMA a reçu toutes les données du SMA précédent.

Pour configurer la nouvelle machine en tant que périphérique principal, reportez-vous au Guide de l'administrateur SMA : Configurez la nouvelle machine en tant que périphérique principal.

Étape 7.

Si vous devez déployer plusieurs ESA/SMA, suivez les étapes 1 à 6.

Informations connexes

Guide d'installation de Cisco Content Security Virtual Appliance

Configuration et configuration du cluster ESA

Guides de l'utilisateur final SMA

Historique de révision

Révision	Date de publication	Commentaires
4.0	23-Jun-2026	Mise à jour du contenu technique, du titre, de l'introduction, de la traduction automatique, des exigences de style et du formatage.
1.0	27-May-2021	Première publication