Avamar：如何在 Avamar Server 上執行 proactive_check.pl 執行狀況檢查指令檔

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.
Check out other resources

Instructions

注意：proactive_check.pl指令檔必須在 /home/admin/proactive_check目錄下的 Avamar 伺服器 （單一節點或工具節點） 中執行。

 

注意：部分 Avamar 服務必須執行才能執行proactive_check.pl指令檔。


1.以系統管理員身分登入 Avamar 格線。

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

 

警告：若為 Avamar 版本 19.1 及更低版本，指令檔必須以系統管理員身分執行。從 Avamar 版本 19.2 開始，指令檔必須以 root 身分執行。



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.從 Dell 中央網站下載 proactive_check.pl 或 proactive_check.uu。 

注意：腳本會定期更新新的檢查內容，因此請務必始終下載並使用最新版本。

 

注意：您不需要同時下載和傳輸這兩個檔案。在熟悉 vi 編輯器的情況下，將內容貼至 Avamar 伺服器上的檔案，以建立比完整「proactive_check.pl」小的「proactive_check.uu」檔案。



7.仍以系統管理員身分登入 Avamar 伺服器，請前往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 Server 版本：
 

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.2 或更高版本上執行指令檔，則必須以 root 身分執行指令檔：

su - 
cd /home/admin/proactive_check



 

指令檔使用時間：
  • 以「主動式執行狀況檢查」工具的方式執行指令檔，並使用 --logoff 旗標 （約 3 至 5 分鐘）
  • 以「關閉 SR 執行狀況檢查」工具的方式執行指令檔 （約 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」旗標執行一次，以記錄正在調查的問題，並將 SR 編號連結至伺服器。  

使用登出旗標可確保日後在伺服器上工作的技術支援工程師 （TSE） 可以檢閱 Avamar 伺服器的「病歷程記錄」。


主動式檢查指令檔包含並提供執行下列常用故障診斷工具的方法：


當使用標誌 --sched、--capacity 或 --replrpt 時，輸出將發送到螢幕，而不是該單個標誌的檔。如果使用 --hc 標誌，則應用所有列出的標誌，並將每個標誌的輸出發送到其各自的 hc_*.txt 檔。


使用 --hc 旗標執行下列命令，以建立整組個別 hc_*.txt 檔案：
 

./proactive_check.pl --hc

Additional Information

有時，指令檔可能會報告 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.