Avamar. Запуск сценария диагностики системы proactive_check.pl на сервере Avamar Server

Summary: Цель данной статьи — изучить функциональные возможности сценария упреждающей диагностики системы (PHC) и предоставить подробное руководство по его выполнению.

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

Примечание. Переменная proactive_check.pl сценарий должен выполняться в сети Avamar (Single-Node или Utility Node) в /home/admin/proactive_check .
 
Примечание. Для выполнения сценария proactive_check.pl должны быть запущены некоторые службы Avamar.
 
 

1. Войдите в Avamar Utility Node в качестве пользователя «admin».

2. Проверьте, является ли proactive_check Каталог существует: 

ls -ld proactive_check
 

Вывод, когда каталог существует: 

admin@avamar-server:~/>: ls -ld proactive_check
drwx------ 2 admin admin 282 May 27 13:18 proactive_check
 

Вывод, если каталог не существует: 

admin@avamar-server:~/>: ls -ld proactive_check
ls: cannot access 'proactive_check': No such file or directory
 

3. Если proactive_check Каталог существует, перейдите к шагу 4, в противном случае создайте каталог. Убедитесь, что путь имеет папку /home/admin:

cd /home/admin
mkdir proactive_check
ls -ld proactive_check
 

Пример. 

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. Откройте proactive_check и проверьте, является ли каталог proactive_check.pl или proactive_check.uu Файлы существуют:

cd /home/admin/proactive_check
ls -lh proactive_check*
 

Выходные данные, если существует один или оба файла: 

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
 

Вывод, если файлы не существуют:

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. Если файлы не существуют, перейдите к шагу 6. В противном случае переименуйте существующие файлы:

mv proactive_check.pl x-proactive_check.pl.`date -I`
mv proactive_check.uu x-proactive_check.uu.`date -I`
 

Пример.

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. Скачайте proactive_check.pl или proactive_check.uu с центральной площадки Dell

Примечание. Скрипт регулярно обновляется новыми проверками, поэтому очень важно всегда загружать и использовать последнюю версию.
 
Примечание. Скачивать и передавать оба файла необязательно. Создайте файл "proactive_check.uu" файл, меньший, чем полный "proactive_check.pl," путем вставки содержимого в файл в сетке Avamar, при условии знакомства с редактором vi.
 
 

7. Все еще входя в систему от имени администратора, перейдите в proactive_check и убедитесь, что файл был передан правильно:

cd /home/admin/proactive_check
ls -lh proactive_check*
 

Выпуск: 

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. Если proactive_check.uu преобразуем файл:

perl proactive_check.uu
 

Пример. 

admin@avamar-server:~/proactive_check/>: perl proactive_check.uu
 

Приведенная выше команда создает proactive_check.pl, которые можно проверить, выполнив следующие действия:

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. Если proactive_check.pl передается, сделайте его исполняемым:

chmod 755 proactive_check.pl
 

До: 

admin@avamar-server:~/proactive_check/>: ls -lh proactive_check.pl
-rw------- 1 admin admin 399K May 27 16:17 proactive_check.pl
 

После: 

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. Подтвердите версию Avamar.

gsan --version
 

Пример вывода:

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. Запустите сценарий.
  • При запуске сценария в Avamar версии 19.1 и ниже сценарий необходимо запускать от имени администратора
  • При запуске сценария в Avamar версии 19.2 или выше сценарий необходимо запускать от имени пользователя root:
su - 
cd /home/admin/proactive_check
 
 

Время использования сценария:

  • Запустите сценарий как средство упреждающей диагностики системы с помощью команды --logoff флаг (примерно от 3 до 5 минут)
  • Запустите сценарий как инструмент «Closing SR Health Check» (примерно 1–3 минуты).
Примечание. Указанное выше время может различаться в зависимости от конфигурации Avamar.
 
 
 

Использование сценария в качестве средства диагностики системы:

Запустите сценарий без каких-либо параметров, чтобы проверить общее состояние Avamar:

./proactive_check.pl
 

Пример выполнения сценария в Avamar версии 19.10. (как 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
 

Дополнительные сведения можно найти, просмотрев hc_results.txt .

cat hc_results.txt
 

Пример вывода с дополнительными сведениями:

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
 

Сценарий можно запустить несколько раз. Результаты добавляются к файлу hc_history.log.

 

Советы и примечания:

По крайней мере один раз в жизненном цикле сервисной заявки (SR) сценарий НЕОБХОДИМО запустить с командой «--logoff" , чтобы задокументировать исследуемую проблему и привязать номер сервисной заявки к серверу.  

Использование флага выхода гарантирует, что инженеры службы технической поддержки (TSE), которые будут работать с сетью в будущем, смогут просмотреть «историю болезни» сети.

Сценарий упреждающей проверки содержит и предоставляет способ запуска следующих часто используемых инструментов поиска и устранения неисправностей:
 

Когда флаги --sched, --capacity или --replrpt вывод отправляется на экран, а не в файл для этого отдельного флага. Если --hc flag, применяются все перечисленные флаги, и вывод для каждого флага отправляется в соответствующий hc_*.txt .

Выполните следующую команду с помощью команды --hc для создания всего набора отдельных hc_*.txt Файлы:

./proactive_check.pl --hc

Additional Information

Иногда сценарий может сообщать о наличии нескольких проблем на сервере Avamar.

В следующей статье объясняется, как взаимодействуют различные проблемы, и какие из них следует решать в первую очередь. Avamar. Как правильно применять подход «Иерархия поиска и устранения неисправностей Avamar».

Чтобы получить полный список флагов для сценария упреждающей проверки, выполните команду:

./proactive_check.pl --help

Affected Products

Avamar

Products

Avamar, Avamar Server
Article 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.