故障诊断指南

常见问题

基本检查
如果您遇到问题,请确保执行以下基本检查:
  • 验证系统是否满足 AppScan 360° 的最低要求。
  • 确保已正确安装和配置必要软件,如 Docker、kubectl 和 Helm。
  • 验证是否按照文档中的说明正确执行了安装步骤,并且在安装过程中是否提供了正确的配置参数。
  • 使用 AppScan 360° Setup Assistant 进一步的故障诊断并验证设置。
登录问题
如果登录 AppScan 360° 时遇到问题,请尝试执行以下操作:
  • 验证 AppScan 360° 集群能否连接到数据库服务器。
  • 验证是否已在数据库服务器上成功创建 AppScan 360° 数据库。
  • 验证 SQL Server 是否配置为允许远程连接。
  • 验证 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。一旦达到此限制,将创建另一个日志,总共最多 10 个日志文件。
  • 扫描日志包含有关扫描执行的详细信息,包括进度更新、度量和调试信息。这些信息特定于每次扫描执行,也可从 AppScan 360° 用户界面下载。

支持

HCL 客户支持

为便于提供高效的故障诊断协助,请将以下内容包括在内:
  • 对于安装问题,请提供用于故障诊断的日志/配置部分中所述的安装日志和配置。
  • 对于扫描问题,请包括扫描目录 (<fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID>/) 的内容,其中包括所扫描的应用程序(用于静态分析的 .irx 文件或 .war/.jar/.zip 源文件)和任何扫描日志。有关扫描故障诊断的其他信息,请参阅 静态分析扫描故障诊断。