Avamar : Exécution du script de bilan de santé proactive_check.pl sur une instance d’Avamar Server
Summary: Cet article a pour but d’expliquer le fonctionnement du script de bilan de santé proactif (PHC) et de fournir un guide complet sur son exécution.
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Instructions
Remarque : La commande
proactive_check.pl Le script doit être exécuté sur la grille Avamar (nœud unique ou nœud utilitaire) dans le /home/admin/proactive_check .
Remarque : Certains services Avamar doivent être en cours d’exécution pour exécuter le script proactive_check.pl.
1. Connectez-vous à Avamar Utility Node en tant qu’administrateur.
2. Vérifiez si l’option proactive_check Le répertoire existe :
ls -ld proactive_check
Sortie lorsque le répertoire existe :
admin@avamar-server:~/>: ls -ld proactive_check
drwx------ 2 admin admin 282 May 27 13:18 proactive_check
Sortie lorsque le répertoire n’existe pas :
admin@avamar-server:~/>: ls -ld proactive_check
ls: cannot access 'proactive_check': No such file or directory
3. Si la demande proactive_check Le répertoire existe, passez à l’étape 4, sinon créez le répertoire. Assurez-vous que le chemin se trouve dans /home/admin :
cd /home/admin
mkdir proactive_check
ls -ld proactive_check
Exemple :
admin@avamar-server:~/>: cd /home/admin
admin@avamar-server:~/>:
admin@avamar-server:~/>: mkdir proactive_check
admin@avamar-server:~/>:
admin@avamar-server:~/>: ls -ld proactive_check
drwx------ 2 admin admin 282 May 27 13:38 proactive_check
4. Rendez-vous sur le proactive_check et vérifiez si le répertoire proactive_check.pl ou proactive_check.uu Des fichiers existent :
cd /home/admin/proactive_check
ls -lh proactive_check*
Sortie lorsque l’un des fichiers ou les deux existent :
admin@avamar-server:~/>: cd /home/admin/proactive_check
admin@avamar-server:~/proactive_check/>: ls -lh proactive_check*
-rwxr-xr-x 1 admin admin 399K May 27 05:04 proactive_check.pl
-rwx--x--x 1 admin admin 123K Jan 19 15:56 proactive_check.uu
Sortie lorsque les fichiers n’existent pas :
admin@avamar-server:~/>: cd /home/admin/proactive_check
admin@avamar-server:~/proactive_check/>: ls -lh proactive_check*
ls: cannot access 'proactive_check': No such file or directory
5. Si les fichiers n’existent pas, passez à l’étape 6, sinon renommez les fichiers existants :
mv proactive_check.pl x-proactive_check.pl.`date -I`
mv proactive_check.uu x-proactive_check.uu.`date -I`
Exemple :
admin@avamar-server:~/proactive_check/>: mv proactive_check.pl x-proactive_check.pl.`date -I`
admin@avamar-server:~/proactive_check/>: mv proactive_check.uu x-proactive_check.uu.`date -I`
6. Téléchargez le proactive_check.pl ou proactive_check.uu depuis le site Central Dell.
Remarque : Le script est régulièrement mis à jour avec de nouvelles vérifications, il est donc crucial de toujours télécharger et utiliser la dernière version.
Remarque : Il n’est pas nécessaire de télécharger et de transférer les deux fichiers. Créez le «
proactive_check.uu« , plus petit que le fichier " completproactive_check.pl», en collant le contenu dans un fichier de la grille Avamar, étant donné que vous êtes familiarisé avec l’éditeur vi.
7. Toujours connecté en tant qu’administrateur, accédez à proactive_check et confirmez que le fichier a été transféré correctement :
cd /home/admin/proactive_check
ls -lh proactive_check*
Sortie:
admin@avamar-server:~/>: cd /home/admin/proactive_check admin@avamar-server:~/proactive_check/>: ls -lh proactive_check* -rwxr-xr-x 1 admin admin 399K May 27 05:04 proactive_check.pl Or admin@avamar-server:~/>: cd /home/admin/proactive_check admin@avamar-server:~/proactive_check/>: ls -lh proactive_check* -rwx--x--x 1 admin admin 123K Jan 19 15:56 proactive_check.uu
8. Si la demande proactive_check.uu est transféré, convertissez le fichier :
perl proactive_check.uu
Exemple :
admin@avamar-server:~/proactive_check/>: perl proactive_check.uu
La commande ci-dessus crée le fichier proactive_check.pl, ce qui peut être vérifié en exécutant la commande suivante :
admin@avamar-server:~/proactive_check/>: ls -lh proactive_check.*
-rw------- 1 admin admin 123K May 27 16:13 proactive_check.uu
-rwx--x--x 1 admin admin 399K May 27 16:14 proactive_check.pl
9. Si la demande proactive_check.pl est transféré, rendez-le exécutable :
chmod 755 proactive_check.pl
Avant :
admin@avamar-server:~/proactive_check/>: ls -lh proactive_check.pl
-rw------- 1 admin admin 399K May 27 16:17 proactive_check.pl
Après :
admin@avamar-server:~/proactive_check/>: chmod 755 proactive_check.pl
admin@avamar-server:~/proactive_check/>: ls -lh proactive_check.pl
-rwxr-xr-x 1 admin admin 399K May 27 16:17 proactive_check.pl
10. Confirmez la version d’Avamar :
gsan --version
Exemple de résultat :
admin@avamar-server:~/>: gsan --version
version: 19.10.0-135
build date: Dec 8 2023 07:01:51
msg format: 13-10
SSL: TLSv1 OpenSSL 1.0.2p-fips 14 Aug 2018 (OwB:1.5.11.0, BSAFE Micro Edition Suite:5.0.2.1)
Zlib: 1.2.11
LZO: 1.08 Jul 12 2002
platform: Linux
OS version: SLES-64
Processor: x86_64
11. Exécutez le script.
-
Si vous exécutez le script sur Avamar 19.1 et versions antérieures, il doit être exécuté en tant qu’administrateur
-
Si vous exécutez le script sur Avamar 19.2 ou versions supérieures, il doit être exécuté en tant qu’utilisateur root :
su -
cd /home/admin/proactive_check
Durée d’utilisation des scripts :
- Exécutez le script en tant qu’outil de « bilan de santé proactif » avec le
--logoff(environ 3 à 5 minutes) - Exécutez le script en tant qu’outil « Closing SR Health Check » (environ 1 à 3 minutes)
Remarque : La durée ci-dessus peut varier en fonction de la configuration d’Avamar.
Utilisation du script comme outil de bilan de santé :
Exécutez le script sans aucun paramètre pour vérifier l’intégrité globale d’Avamar :
./proactive_check.pl
Exemple d’exécution du script dans Avamar version 19.10. (en tant qu’utilisateur root) :
root@avamar-server:/home/admin/proactive_check/#: ./proactive_check.pl
proactive_check.pl 8.13
Latest script version DISABLED
===== START HEALTHCHECK
Please Wait... Gathering System Info - This may take a minute or two
Avamar Hostname avamar-server.lab.com
Avamar Server Version 19.10.0-135
GSAN Version 19.10.0-135
MCS Version 19.10.0-135
avtar Version: 19.10.100-135
Hardware Manufacturer vmware
System ID 1234567890@00:AA:11:BB:22:CC
Node Type Single Node AVE .5TB
Operating System SLES12SP5-2024-R1
Avamar Hardening RPM 7.0.2-2.x86_64
Registered Media Access Nodes NONE
SWID ELMAVM123456YZ
License PASSED
AVI Installer PASSED 19.10.0.135
Datadomain dd-server Vers:7.13.0.20-1082704 S/N:AUXXXXXXXXXX7W
Datadomain dd_only_mode WARNING
ddrmaint Patches PASSED
Replication Partner Source to avamar-target.lab.com
Hardware EOSL PASSED
Remote Management PASSED
Version Supported PASSED
MC flush in past 24 hours PASSED
HFSCheck in past 36 hours PASSED
Checkpoint Status PASSED
Status.dpn PASSED
Mandatory Client Upgrades PASSED
Data Domain Version PASSED
/etc/profile PASSED
mcserver.xml PASSED
preferences.dtd permissions PASSED
MCS database size PASSED
Java symlink PASSED
Certificate Expiration PASSED
GSAN Patches PASSED
File Permissions PASSED
FIPS Status PASSED Disabled
Bonding Configuration PASSED
ascd status PASSED
Cron Running PASSED
Checkpoint Retention PASSED
Config Settings PASSED
HFSCheck overtime allowed PASSED
Swap Space PASSED
HFSCheck run time PASSED
MCS Patches INFO
Open File Settings PASSED
GSAN status PASSED
MCS status PASSED
ddrmaint service PASSED
ESE status WARNING
Backup Scheduler running PASSED
Maintenance scheduler running PASSED
Cron jobs enabled PASSED
Unattended startup PASSED
See detailed ERROR information in hc_results.txt
FINISHED
Il est alors possible de rechercher plus d’informations en consultant le hc_results.txt fichier :
cat hc_results.txt
Exemple de sortie avec plus d’informations :
root@avamar-server:/home/admin/proactive_check/#: cat hc_results.txt
========================================================================
Run Date: Mon May 27 14:51:11 2024 Version 8.13
========================================================================
command line:
DISCLAIMER: The results from this script are intended for the exclusive use of EMC Support & Development Engineers to diagnose potential problems so that they can use their trained skills to see exactly how the issues might or might not affect an individual server's performance
Please review KB534454 Avamar troubleshooting hierarchy if there are any issues found
# --> Latest script version DISABLED
# --> Avamar Hostname avamar-server.lab.com
# --> Avamar Server Version 19.10.0-135
# --> GSAN Version 19.10.0-135
# --> MCS Version 19.10.0-135
# --> Java processes (10)
# --> avtar Version: 19.10.100-135
# --> Hardware Manufacturer vmware
# --> System ID 1234567890@00:AA:11:BB:22:CC
# --> Node Type Single Node AVE .5TB
# --> Operating System SLES12SP5-2024-R1
# --> Avamar Hardening RPM 7.0.2-2.x86_64
# --> Registered Media Access Nodes NONE
WARNING: License has an expiration date.
# --> SWID ELMAVM123456YZ
# --> License PASSED
# --> AVI Installer PASSED 19.10.0.135
# --> Datadomain hdd-server Vers:7.13.0.20-1082704 S/N:AUXXXXXXXXXX7W
WARNING: Backups to the Data Domain are not locked. If this Avamar system is intended to be used as a pure metadata node (no backups going to Avamar), consider locking down the backups to the Data Domain to prevent accidental backups going to the Avamar system
RESOLUTION: See KB531973 and the latest admin guide for Avamar AVE Installs and the dd_only_mode flag. Please also see KB 000047627 and set maxcompdatastripe=20971520 and checkdiratomicrefs=true
# --> Datadomain dd_only_mode WARNING
# --> ddrmaint Patches PASSED
# --> Replication Partner Source to avamar-target.lab.com
# --> Hardware EOSL PASSED
# --> Remote Management PASSED
# --> Version Supported PASSED
# --> MC flush in past 24 hours PASSED
# --> HFSCheck in past 36 hours PASSED
# --> Checkpoint Status PASSED
# --> Status.dpn PASSED
# --> Mandatory Client Upgrades PASSED
# --> Data Domain Version PASSED
# --> /etc/profile PASSED
# --> mcserver.xml PASSED
# --> preferences.dtd permissions PASSED
The MCS database size is 358 MB
# --> MCS database size PASSED
# --> Java symlink PASSED
# --> Certificate Expiration PASSED
# --> GSAN Patches PASSED
# --> File Permissions PASSED
# --> FIPS Status PASSED Disabled
# --> Bonding Configuration PASSED
# --> ascd status PASSED
# --> Cron Running PASSED
# --> Checkpoint Retention PASSED
# --> Config Settings PASSED
# --> HFSCheck overtime allowed PASSED
# --> Swap Space PASSED
# --> HFSCheck run time PASSED
INFO: System is not on TLA recommended MCS hotfix 338823
RESOLUTION: See hot fix 338823 for more information
# --> MCS Patches INFO
# --> Open File Settings PASSED
# --> GSAN status PASSED
# --> MCS status PASSED
# --> ddrmaint service PASSED
WARNING: ESE status is down
RESOLUTION: Start ESE service if required
# --> ESE status WARNING
# --> Backup Scheduler running PASSED
# --> Maintenance scheduler running PASSED
# --> Cron jobs enabled PASSED
# --> Unattended startup PASSED
Le script peut être exécuté plusieurs fois. Les résultats sont ajoutés au fichier hc_history.log.
Trucs et remarques :
Au moins une fois au cours du cycle de vie d’une demande de service (SR), le script DOIT être exécuté avec l’option «--logoff" pour documenter le problème en cours d’examen et lier le numéro de demande de service au serveur.
L’utilisation de l’indicateur de déconnexion garantit que les ingénieurs du support technique (TSE) qui travailleront sur le réseau à l’avenir pourront consulter les « antécédents médicaux » du réseau.
Le script de vérification proactive contient et fournit un moyen d’exécuter les outils de dépannage suivants couramment utilisés :
- Avamar : Utiliser sched.sh pour vérifier l’historique des activités de sauvegarde, de réplication et de maintenance
- Avamar : Gestion de la capacité avec le script capacity.sh
-
replrpt(imprimer les informations de réplication sur l’écran commereplrpt.sh)
Quand les drapeaux --sched, --capacity ou --replrpt sont utilisées, la sortie est envoyée à l’écran et non à un fichier pour cette balise individuelle. Si la demande --hc est utilisée, toutes les balises répertoriées sont appliquées et la sortie de chaque balise est envoyée à son hc_*.txt .
Exécutez la commande suivante avec --hc pour créer l’ensemble des hc_*.txt Fichiers:
./proactive_check.pl --hcAdditional Information
Parfois, le script peut signaler plusieurs problèmes sur l’instance d’Avamar Server.
L’article suivant explique comment interagissent les divers problèmes et indique ceux qui doivent être traités en premier : Avamar : Application correcte de l’approche « hiérarchie de dépannage Avamar ».
Pour obtenir la liste complète des balises du script de vérification proactive, exécutez :
./proactive_check.pl --helpAffected Products
AvamarProducts
Avamar, Avamar ServerArticle Properties
Article Number: 000020955
Article Type: How To
Last Modified: 22 Sep 2025
Version: 17
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.