疑難排解手冊

Common issues

基本檢查
如果遇到問題，請確保執行以下基本檢查：
  • 驗證系統是否滿足 AppScan 360° 的最低需求。
  • 確保是否正確安裝並配置先決條件，例如 Docker、kubectl 和 Helm。
  • 驗證是否按照說明文件正確執行安裝步驟，以及在安裝過程中是否提供正確的配置參數。
  • 利用 AppScan 360° Setup Assistant 執行進一步的疑難排解並驗證設定。
登入問題
如果您在登入 AppScan 360° 時遇到問題，請嘗試下列操作：
  • 確認 AppScan 360° 叢集可連線至資料庫伺服器。
  • 確認已在資料庫電腦上成功建立 AppScan 360° 資料庫。
  • 確認 SQL 伺服器已配置為允許遠端連線。
  • 確認 AppScan 360° 叢集可連線到 LDAP/SSO 伺服器。
  • 檢查 AppScan 360° 套件配置檔中的 LDAP/SSO 配置。

用於疑難排解的日誌/配置檔

以下日誌/配置檔有助於在 AppScan 360° 的設定和掃描問題中進行驗證和疑難排解。

單一 VM 設定日誌
  • 單一 VM 設定日誌位於 aioWorkspace/logs 目錄中
    • engageAS360-AIO.log - 包含在單一 VM 設定上與 AppScan 360° 安裝過程相關的日誌。
    • disengageAS360-AIO.log - 包含在單一 VM 設定上與 AppScan 360° 解除安裝過程相關的日誌。
  • 個別套件安裝日誌位於以下目錄中
    • aioWorkspace/kit/seaWorkbench/logs - 包含與安裝 ASCP套件相關的日誌。
    • aioWorkspace/kit/workbench/logs - 包含與安裝 SCA套件相關的日誌。
  • 用於疑難排解檢查的配置檔位於以下路徑
    • aioWorkspace/audit/as360-aio-answers.env - 包含在單一 VM 設定上安裝 AppScan 360° 期間使用的配置參數。- 如果在安裝過程中已隨套件一起提供，系統便不會產生此檔案。
    • aioWorkspace/audit/singular-singular.clusterKit.properties -包含 AppScan 360° 的完整配置內容。
    • aioWorkspace/conf/aio_vars.env - 包含所有單一 VM 設定專屬的環境變數。
一鍵式安裝程式日誌
  • 對於一鍵式安裝程式，日誌位於以下目標目錄路徑中
    • <EXTRACTION_PATH>/seaWorkbench/logs - 包含與安裝 ASCP套件相關的日誌。
    • <EXTRACTION_PATH>/workbench/logs - 包含與安裝 SCA套件相關的日誌。
應用程式日誌
  • 個別應用程式日誌位於裝載式共享儲存空間，可從以下路徑的 Pod 存取
    /storagemount/logs
  • 應用程式日誌限制為 2MB。達到此上限後，將建立另一個日誌，總計最多會建立十個日誌檔案。
  • 掃描日誌包含關於掃描執行的詳細資訊，包括進度更新、指標和除錯資訊。它們專屬於每個掃描執行，並可以從 AppScan 360° 使用者介面下載。

支援

HCL 客戶支援中心

為協助進行有效的疑難排解協助，請包括下列項目：
  • 對於安裝問題，包括 日誌/疑難排解配置檔區塊中提到的安裝日誌和配置檔。
  • 對於掃描問題，請包括掃描目錄 (<fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID>/) 的內容，這包括掃描的應用程式（.irx 檔案或用於靜態分析的 .war/.jar/.zip 來源檔案）和任何掃描日誌。如需疑難排解掃描的相關資訊，請參閱 靜態分析掃描的疑難排解。