Add GS Event handling mechanism analysis
This commit is contained in:
accusys
@@ -0,0 +1,327 @@
|
|||||||
|
# GS Event 處理機制分析
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
GS (DtrGuiSrv) 的事件處理機制負責：
|
||||||
|
- 定期輪詢 RAID 控制器的事件
|
||||||
|
- 儲存事件到記憶體佇列
|
||||||
|
- 記錄事件到檔案
|
||||||
|
- 觸發 Email / SNMP 通知
|
||||||
|
|
||||||
|
## 架構流程
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ GS Event 處理架構 │
|
||||||
|
├─────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ PollingCtlrEvent (Thread) │ │
|
||||||
|
│ │ ┌─────────────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ while(1) { │ │ │
|
||||||
|
│ │ │ for (每個控制器) { │ │ │
|
||||||
|
│ │ │ GetCtlrEvent() ──► 取得 RAID 事件 │ │ │
|
||||||
|
│ │ │ │ │ │ │
|
||||||
|
│ │ │ ▼ │ │ │
|
||||||
|
│ │ │ SaveInBandEvent() ──► 儲存到記憶體佇列 │ │ │
|
||||||
|
│ │ │ │ │ │ │
|
||||||
|
│ │ │ ▼ │ │ │
|
||||||
|
│ │ │ RecEventToFile() ──► 寫入 Event Log 檔案 │ │ │
|
||||||
|
│ │ │ } │ │ │
|
||||||
|
│ │ │ sleep(30秒) │ │ │
|
||||||
|
│ │ │ } │ │ │
|
||||||
|
│ │ └─────────────────────────────────────────────────────┘ │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ HandleInBandEventReq (GC 請求) │ │
|
||||||
|
│ │ - 0x01: 取得單一事件 (Remove_InBand_Event) │ │
|
||||||
|
│ │ - 0x02: 取得所有事件 │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 事件處理動作 │ │
|
||||||
|
│ │ - Email 通知 (IssueMailOut) │ │
|
||||||
|
│ │ - SNMP Trap 發送 │ │
|
||||||
|
│ │ - UI 更新 │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## 主要函數
|
||||||
|
|
||||||
|
### 1. PollingCtlrEvent - 事件輪詢執行緒
|
||||||
|
|
||||||
|
```c
|
||||||
|
// cPollingEvent.c:1397
|
||||||
|
UCHAR PollingCtlrEvent(pid_t pid2) {
|
||||||
|
while(1) {
|
||||||
|
for(i=0; i<MAX_DTR_IN_HOST-1; i++) {
|
||||||
|
pCtrlInfo = pGetgloDTRInfo(i);
|
||||||
|
|
||||||
|
// 只處理線上的控制器
|
||||||
|
if(pCtrlInfo->bStatus != CTLR_STATUS_ALIVE) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 取得控制器事件
|
||||||
|
bStatus = GetCtlrEvent(i, &event_info);
|
||||||
|
|
||||||
|
// 處理每個事件
|
||||||
|
while(event_info.bStatus) {
|
||||||
|
// FW 更新事件處理
|
||||||
|
if(event_info.bEventBuf[0] == FW_FLUSH_EVENT) {
|
||||||
|
// 設定 FW 狀態
|
||||||
|
}
|
||||||
|
|
||||||
|
// 儲存事件
|
||||||
|
SaveInBandEvent(i, &event_info);
|
||||||
|
|
||||||
|
// 寫入檔案
|
||||||
|
RecEventToFile(i, &event_info);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
sleep(MAX_EVENT_POLLING_THREAD_TIME_DELAY); // 30秒
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. SaveInBandEvent - 儲存事件到記憶體
|
||||||
|
|
||||||
|
```c
|
||||||
|
// cPollingEvent.c:1095
|
||||||
|
UCHAR SaveInBandEvent(UCHAR bCtlrNo, PEVENT_INFO pEvent_info) {
|
||||||
|
// 取得控制器的事件佇列
|
||||||
|
sCtlrEvent = pGetEventFreeQ(bCtlrNo);
|
||||||
|
|
||||||
|
// 從空閒佇列取得一個 entry
|
||||||
|
CurQ = sCtlrEvent->InBandFreeQ;
|
||||||
|
|
||||||
|
// 複製事件資料
|
||||||
|
memcpy(CurQ->bEventBuf, pEvent_info->bEventBuf, MAX_EDB_SZ);
|
||||||
|
|
||||||
|
// 標記為有效
|
||||||
|
CurQ->bStatus = TRUE;
|
||||||
|
|
||||||
|
return SYSOK;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. RecEventToFile - 寫入事件檔案
|
||||||
|
|
||||||
|
```c
|
||||||
|
// cPollingEvent.c:1145
|
||||||
|
void RecEventToFile(UCHAR bCtlrNo, PEVENT_INFO pEvent_info) {
|
||||||
|
// 取得時間
|
||||||
|
GetSystemDateTime(DateTimeBuf);
|
||||||
|
|
||||||
|
// 解析事件
|
||||||
|
ParseEvent2(pEvent_info->bEventBuf, EventStrBuf, EventMailBuf);
|
||||||
|
|
||||||
|
// 寫入 Event Log 檔案
|
||||||
|
pFile_EM = fopen(FileNameBuf, "a+");
|
||||||
|
fprintf(pFile_EM, "%s\t%s\n", DateTimeBuf, EventStrBuf);
|
||||||
|
fclose(pFile_EM);
|
||||||
|
|
||||||
|
// 建立 Email 通知檔案
|
||||||
|
// (供 Email 發送服務讀取)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. HandleInBandEventReq - GC 請求處理
|
||||||
|
|
||||||
|
```c
|
||||||
|
// cPollingEvent.c:1478
|
||||||
|
UCHAR HandleInBandEventReq(PNET_REQ_PACKAGE pReqPackage, SHORT iCtlrIndex) {
|
||||||
|
switch(pReqPackage->pInBuffer[INBAND_EVENT_REQ_F_CMD_CODE]) {
|
||||||
|
case 0x01: // 取得單一事件
|
||||||
|
bStatus = Remove_InBand_Event(iCtlrIndex, &EventInfo);
|
||||||
|
// 回傳事件資料
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 0x02: // 取得所有事件
|
||||||
|
pEMH = pGetEventMsgHeader(iCtlrIndex);
|
||||||
|
// 回傳所有事件 + 事件數量
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 事件結構
|
||||||
|
|
||||||
|
### EVENT_INFO
|
||||||
|
|
||||||
|
```c
|
||||||
|
typedef struct _EVENT_INFO {
|
||||||
|
UCHAR bStatus; // 事件狀態 (TRUE=有事件)
|
||||||
|
UCHAR bEventBuf[MAX_EDB_SZ]; // 事件資料 (512 bytes)
|
||||||
|
} EVENT_INFO, *PEVENT_INFO;
|
||||||
|
```
|
||||||
|
|
||||||
|
### 事件類型
|
||||||
|
|
||||||
|
| Event Code | 說明 |
|
||||||
|
|-----------|------|
|
||||||
|
| FW_FLASH_EVENT | 韌體更新事件 |
|
||||||
|
| 0x00-0xFF | 其他事件 |
|
||||||
|
|
||||||
|
## 事件命令碼
|
||||||
|
|
||||||
|
| Command | 值 | 說明 |
|
||||||
|
|---------|-----|------|
|
||||||
|
| Get InBand Event | 0x01 | 取得並移除一個事件 |
|
||||||
|
| Get All InBand Event | 0x02 | 取得所有事件 |
|
||||||
|
|
||||||
|
## 通訊協議
|
||||||
|
|
||||||
|
### GC 請求
|
||||||
|
|
||||||
|
```
|
||||||
|
Offset 0: Phase Code (0xFF)
|
||||||
|
Offset 1: Request Code (0x00)
|
||||||
|
Offset 2: Controller No
|
||||||
|
Offset 3: Event Command (0x01/0x02)
|
||||||
|
```
|
||||||
|
|
||||||
|
### GS 回應
|
||||||
|
|
||||||
|
```
|
||||||
|
Offset 0-2: Phase/Request/Controller
|
||||||
|
Offset 3: Status (0x50=Success)
|
||||||
|
Offset 4: InBand Event Status
|
||||||
|
Offset 5-8: Event Count (for 0x02)
|
||||||
|
Offset 9+: Event Data
|
||||||
|
```
|
||||||
|
|
||||||
|
## 資料結構
|
||||||
|
|
||||||
|
### 事件佇列
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────┐
|
||||||
|
│ InBand Event Queue │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ ┌─────────────┐ │
|
||||||
|
│ │ Free Q │ ──► Event Entry 1 ──► Event Entry 2 │
|
||||||
|
│ └─────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────┐│
|
||||||
|
│ │ Event Q Head ─────────────────────────► Tail ││
|
||||||
|
│ │ [Event1] -> [Event2] -> [Event3] -> ... ││
|
||||||
|
│ └─────────────────────────────────────────────────────────┘│
|
||||||
|
└─────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### MAX_EVENT_NO
|
||||||
|
|
||||||
|
```
|
||||||
|
#define MAX_EVENT_NO 512 // 每個控制器最大事件數
|
||||||
|
#define MAX_EDB_SZ 512 // 每個事件大小
|
||||||
|
```
|
||||||
|
|
||||||
|
## 輪詢週期
|
||||||
|
|
||||||
|
```c
|
||||||
|
// cPollingEvent.c
|
||||||
|
#define MAX_EVENT_POLLING_THREAD_TIME_DELAY 30 // 30 秒
|
||||||
|
|
||||||
|
sleep(MAX_EVENT_POLLING_THREAD_TIME_DELAY);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Email 通知
|
||||||
|
|
||||||
|
```c
|
||||||
|
// 事件觸發 Email
|
||||||
|
void RecEventToFile(UCHAR bCtlrNo, PEVENT_INFO pEvent_info) {
|
||||||
|
// 解析事件
|
||||||
|
ParseEvent2(pEvent_info->bEventBuf, EventStrBuf, EventMailBuf);
|
||||||
|
|
||||||
|
// 建立 Email 通知檔案
|
||||||
|
// IssueMailOut(bCtlrNo, ...);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## GC 端對應
|
||||||
|
|
||||||
|
### Java 請求
|
||||||
|
|
||||||
|
```java
|
||||||
|
// frmMain.java - EventPollingForSNMP()
|
||||||
|
|
||||||
|
// 發送請求
|
||||||
|
bCmds[0] = (byte) 0xFF; // Phase Code
|
||||||
|
bCmds[1] = (byte) 0x00; // Request Code
|
||||||
|
bCmds[2] = (byte) 0x00; // Controller No
|
||||||
|
bCmds[3] = (byte) 0x02; // Get InBand Event
|
||||||
|
```
|
||||||
|
|
||||||
|
## 關鍵變數
|
||||||
|
|
||||||
|
```c
|
||||||
|
// 全域變數
|
||||||
|
PCTLR_EVENT glo_sCtlrEvent[MAX_DTR_IN_HOST]; // 每個控制器的事件
|
||||||
|
PINBAND_EVENT_Q glo_sCtlrEventEntry[MAX_EVENT_NO]; // 事件 entry
|
||||||
|
|
||||||
|
UCHAR bPopEventMsg = FALSE; // 是否取出事件
|
||||||
|
UCHAR bIssueMail = FALSE; // 是否發送郵件
|
||||||
|
```
|
||||||
|
|
||||||
|
## 處理流程圖
|
||||||
|
|
||||||
|
```
|
||||||
|
RAID Controller
|
||||||
|
│
|
||||||
|
│ In-Band Protocol
|
||||||
|
▼
|
||||||
|
┌─────────────────────┐
|
||||||
|
│ GetCtlrEvent() │ 取得事件
|
||||||
|
└──────────┬──────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────┐
|
||||||
|
│ event_info.bStatus │ = TRUE?
|
||||||
|
└──────────┬──────────┘
|
||||||
|
Yes │
|
||||||
|
▼
|
||||||
|
┌─────┴─────┐
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
SaveInBand RecEventToFile
|
||||||
|
│ │
|
||||||
|
│ ├──► Event Log File
|
||||||
|
│ │
|
||||||
|
│ └──► Email File (for IssueMailOut)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Event Queue (Memory)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────┐
|
||||||
|
│ HandleInBandEventReq│ GC 讀取事件
|
||||||
|
│ (0x01 / 0x02) │
|
||||||
|
└──────────┬──────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
GC Client
|
||||||
|
```
|
||||||
|
|
||||||
|
## 常見錯誤碼
|
||||||
|
|
||||||
|
| 錯誤碼 | 說明 |
|
||||||
|
|--------|------|
|
||||||
|
| SYSOK | 成功 |
|
||||||
|
| SYSFAIL_EVENT_EMPTY | 無事件 |
|
||||||
|
| SYSFAIL_EVENT_NO_FREE_Q | 事件佇列已滿 |
|
||||||
|
| SYSFAIL_EVENT_INVALID | 無效事件 |
|
||||||
|
|
||||||
|
## 實作重點
|
||||||
|
|
||||||
|
1. **記憶體佇列**: 使用 linked list 儲存事件
|
||||||
|
2. **線程安全**: 使用 Semaphore 保護共享資源
|
||||||
|
3. **事件去重**: 每個事件只處理一次
|
||||||
|
4. **檔案記錄**: 所有事件寫入 Event Log
|
||||||
|
5. **異步通知**: Email/SNMP 異步觸發
|
||||||
Reference in New Issue
Block a user