오라클 19c 윈도우 환경에서 ahf(tfa) 설치 및 로그수집 가이드(SRDC)

OS환경 : Windows 2109 (64bit)

 

DB 환경 : Oracle Database 19.3.0.0

 

방법 : 오라클 19c 윈도우 환경에서 ahf(tfa) 설치 및 로그수집 가이드(SRDC)

TFA 란?
Oracle Support는 데이터 수집을 위해 TFA (Trace File Analyzer) 수집기를 사용하는 것이 좋음
TFA 수집기는 이벤트 시간을 기준으로 관련 정보 만 수집하므로 수집 된 데이터의 크기는 훨씬 작음
TFA Collector는 모든 CRS 로그 파일, ASM trace 파일, 데이터베이스 trace 파일, OSWatcher 출력값 및 CHM (Cluster Health Monitor) 출력값을 수집함

AHF 란?
AHF (Autonomous Health Framework)는 단순히 TFA, ORAchk 및 EXAchk, oswatcher, oratop 등
여러가지 도구들이 결합 된 설치 프로그램임
TFA, ORAchk 및 EXAchk는 이전과 동일하게 작동함

 

 

윈도우 환경에서 오라클 DB 사용시 문제 발생 시 SR에 올리는 로그 수집 방법(AHF)을 설명함

각각 수집하는 방식은 (오라클 11g R2 윈도우환경에서 장애시 로그수집 가이드(SRDC) https://positivemh.tistory.com/749) 를 참조하면됨

 

 

AHF 설치

먼저 Doc. 2291661.1 에서 해당 OS 용 파일 다운로드

 

 

ahf  압축파일 압축해제

 

 

cmd 관리자 모드로 해당 폴더로 이동

 

 

AHF 설치(perl home을 지정해줘야함 $ORACLE_HOME/perl 경로)

cmd> installahf.bat -perlhome C:\app\oracle\product\19c\perl
 
AHF Installation Log  : C:\ahf_install_3488_2021_10_20_14_15_40.log
 
Starting Autonomous Health Framework (AHF) Installation
 
AHF Version: 212300 Build Date: 202109091658
 
Default AHF Location : C:\
 
Do you want to change AHF Location (C:\) ? Y|[N] : <-- 엔터 입력
 
AHF Location : C:\oracle.ahf
오류: 오류: 시스템이 지정된 레지스트리 키 또는 값을 찾을 수 없습니다.
 
AHF Data Directory stores diagnostic collections and metadata.
AHF Data Directory requires at least 5GB (Recommended 10GB) of free space.
 
Choose Data Directory from below options :
1. C:\oracle.ahf [Free Space : 34404 MB]
2. Enter a different Location
 
Choose Option [1 - 2] : 1 <-- 1 입력
 
AHF Data Directory : C:\oracle.ahf\data
 
                C:\oracle.ahf\data\
C:\oracle.ahf\bin\orachk.bat <<===>> C:\oracle.ahf\orachk\orachk.bat에 대한 기호화된 링크를 만들었습니다.
 
Configuring TFA Services
 
 
Starting Discovery...
 
오류: 오류: 시스템이 지정된 레지스트리 키 또는 값을 찾을 수 없습니다.
 
No Grid Infrastructure Discovered on this system . . . . .
 
win-bn22lb7n8tk
Searching for running databases...
1. ORCL
 
 
Searching out ORACLE_HOME for selected databases...
 
 
Getting Oracle Inventory...
 
ORACLE INVENTORY: C:\Program Files\Oracle\Inventory
 
 
Discovery Complete...
 
Cleaning Temporary Folders . . .
Reading inv C:\Program Files\Oracle\Inventory\ContentsXML\inventory.xml
 
Successfully generated certificates.
 
Starting TFA Services
 
.------------------------------------------------------------------------------------.
| Host            | Status of TFA | PID  | Port  | Version    | Build ID             |
+-----------------+---------------+------+-------+------------+----------------------+
| win-bn22lb7n8tk | RUNNING       | 1580 | 58513 | 21.2.3.0.0 | 21230020210909165804 |
'-----------------+---------------+------+-------+------------+----------------------'
 
Running TFA Inventory...
 
.-----------------------------------------------------------.
|                Summary of AHF Configuration               |
+-----------------+-----------------------------------------+
| Parameter       | Value                                   |
+-----------------+-----------------------------------------+
| AHF Location    | C:\oracle.ahf                           |
| TFA Location    | C:\oracle.ahf\tfa                       |
| Orachk Location | C:\oracle.ahf\orachk                    |
| Data Directory  | C:\oracle.ahf\data                      |
| Repository      | C:\oracle.ahf\data\repository           |
| Diag Directory  | C:\oracle.ahf\data\win-bn22lb7n8tk\diag |
'-----------------+-----------------------------------------'
 
AHF binaries are available in C:\oracle.ahf\bin
 
AHF is successfully installed
 
Copying C:\ahf_install_3488_2021_10_20_14_15_40.log to C:\oracle.ahf\data\win-bn22lb7n8tk\diag\ahf

정상적으로 설치됨

 

 

grid가 설치된 환경이라면 아래와 같이 입력

 

 

로그 수집(Oracle Database single instance shutdown problems 내용 수집을 위한 dbparameters 입력)

cmd> cd C:\oracle.ahf\ahf\bin
cmd> tfactl diagcollect -srdc dbparameters
 
        1개 파일을 이동했습니다.
Enter the Database Name [Required for this SRDC] : orcl  <-- db name 입력
Wed Oct 20 14:26:26 2021: INFO : share_set_ora_env: OHOME c:\app\oracle\product\19c and OSID ORCL extracted from  OracleServiceorcl
Wed Oct 20 14:26:27 2021: INFO : share_set_ora_env : OUSER  extracted from  OracleServiceorcl
Wed Oct 20 14:26:28 2021: INFO : share_set_ora_env: OHOME c:\app\oracle\product\19c and OSID ORCL extracted from  OracleServiceorcl
Wed Oct 20 14:26:28 2021: INFO : share_set_ora_env : OUSER  extracted from  OracleServiceorcl
Warning: database orcl is not running on the node, Database reports will not be generated.
Do you have any of below related to the problem, Please provide your confirmation (1/2/3)
 1. Screenshot of the error message
 2. Spool file of the steps followed to recreate the error
 3. None of the above [Y|y|N|n] [Y]:
Enter the time of the issue [YYYY-MM-DD HH24:MI:SS,<RETURN>=ALL] : <-- 장애 발생 시점 입력 또는 ㅇ
Scripts to be run by this srdc: create_pfile_win srdc_dbparameters.sql srdc_win_os.bat cp_otherfiles_win
Components included in this srdc: DATABASE NOCHMOS OS TNS
Wed Oct 20 14:26:34 2021: INFO : share_set_ora_env: OHOME c:\app\oracle\product\19c and OSID ORCL extracted from  OracleServiceorcl
Wed Oct 20 14:26:34 2021: INFO : share_set_ora_env : OUSER  extracted from  OracleServiceorcl
Wed Oct 20 14:26:34 2021: INFO : share_set_ora_env: OHOME c:\app\oracle\product\19c and OSID ORCL extracted from  OracleServiceorcl
Wed Oct 20 14:26:34 2021: INFO : share_set_ora_env : OUSER  extracted from  OracleServiceorcl
Collecting data for local node(s).
 
TFA is using system timezone for collection, All times shown in KST.
 
Collection Id : 20211020142635win-bn22lb7n8tk
 
Detailed Logging at : C:\oracle.ahf\data\repository\srdc_dbparameters_collection_Wed_Oct_20_14_26_38_KST_2021_node_local\diagcollect_20211020142635_win-bn22lb7n8tk.log
2021/10/20 14:26:41 KST : NOTE : Any file or directory name containing the string .com will be renamed to replace .com with dotcom
2021/10/20 14:26:41 KST : Collection Name : tfa_srdc_dbparameters_Wed_Oct_20_14_26_37_KST_2021.zip
2021/10/20 14:26:41 KST : Scanning of files for Collection in progress...
2021/10/20 14:26:41 KST : Collecting additional diagnostic information...
2021/10/20 14:26:46 KST : Getting list of files satisfying time range [10/20/2021 07:26:41 KST, 10/20/2021 14:26:46 KST]
2021/10/20 14:26:48 KST : Collecting ADR incident files...
2021/10/20 14:26:58 KST : Completed collection of additional diagnostic information...
2021/10/20 14:27:03 KST : Completed Local Collection
2021/10/20 14:27:03 KST : Summary!win-bn22lb7n8tk!950kB!22s!Completed
2021/10/20 14:27:03 KST : Completed collection of zip files.
 
Logs are being collected to: C:\oracle.ahf\data\repository\srdc_dbparameters_collection_Wed_Oct_20_14_26_38_KST_2021_node_local
2021-10-20  오후 02:27         1,033,754 win-bn22lb7n8tk.tfa_srdc_dbparameters_Wed_Oct_20_14_26_37_KST_2021.zip

 

 

40번째 줄에 나온 경로로 이동 후 파일 확인

C:\oracle.ahf\data\repository\srdc_dbparameters_collection_Wed_Oct_20_14_26_38_KST_2021_node_local

 

 

zip파일 압축해제 후 확인

diag 정보, trace 정보 os 정보 등 여러가지 정보등이 수집됨

 

 

tfactl 명령으로 나온 zip 파일을 SR 첨부파일로 업로드하면됨

 

 

참조 : 2550798.1

https://docs.oracle.com/en/engineered-systems/health-diagnostics/autonomous-health-framework/ahfug/collecting-diagnostics-and-using-one-command-srdc.html#GUID-F8381A7A-E2F7-442C-AED0-3FEEF4129125