Troubleshooting Guide

Common issues

Basic checks
If you experience issues, ensure to perform the following basic checks:
  • Verify that the system meets the minimum requirements for AppScan 360°.
  • Ensure prerequisites are installed and configured correctly, such as Docker, kubectl, and Helm.
  • Verify that the installation steps were followed correctly as per documentation, and the correct configuration parameters were provided during installation.
  • Utilize AppScan 360° Setup Assistant to further troubleshoot and validate the setup.
Login issues
If you have issues logging in to AppScan 360°, try the following:
  • Verify that the AppScan 360° cluster can connect to the database server.
  • Verify that the AppScan 360° database was created successfully on the database server.
  • Verify that the SQL server is configured to allow remote connections.
  • Verify that the AppScan 360° cluster can connect to the LDAP/SSO server.
  • Check the LDAP/SSO configuration in the AppScan 360° kit configuration file.

Logs/Configs for Troubleshooting

The following logs/configuration files can help in verifying & troubleshooting AppScan 360° setup and scan issues.

Single VM Setup logs
  • Single VM installation logs are located in aioWorkspace/logs directory
    • engageAS360-AIO.log - Contains logs related to the installation process of AppScan 360° on a single VM setup.
    • disengageAS360-AIO.log - Contains logs related to the uninstallation process of AppScan 360° on a single VM setup.
  • Individual kits installation logs are located in below directories
    • aioWorkspace/kit/seaWorkbench/logs - Contains logs related to the installation of the ASCP kit.
    • aioWorkspace/kit/workbench/logs - Contains logs related to the installation of the SCA kit.
  • Configurations to inspect for troubleshooting are located on below paths
    • aioWorkspace/audit/as360-aio-answers.env - Contains the configuration parameters used during the installation of AppScan 360° on a single VM setup. - System doesn't generate this if it is already supplied during installation along with kits.
    • aioWorkspace/audit/singular-singular.clusterKit.properties - Contains full configuration properties of AppScan 360°.
    • aioWorkspace/conf/aio_vars.env - Contains all Single VM Setup specific environment variables.
One Click Installer logs
  • For One Click Installer, logs are located in target directory path as below
    • <EXTRACTION_PATH>/seaWorkbench/logs - Contains logs related to the installation of the ASCP kit.
    • <EXTRACTION_PATH>/workbench/logs - Contains logs related to the installation of the SCA kit.
Application logs
  • Individual Application logs are located in mounted shared storage. accessible from the pods on below path 
    /storagemount/logs
  • Application logs are limited to 2MB. Once this limit is reached, another log is created, up to ten log files total.
  • Scan logs contain detailed information about scan executions, including progress updates, metrics, and debug information. They are specific to each scan execution and can be downloaded from the AppScan 360° user interface.

Support

HCL Customer Support

To facilitate efficient troubleshooting assistance, include the following:
  • For installation issues, include the installation logs and configs as mentioned in the Logs/Configs for Troubleshooting section.
  • For scan issues, include the contents of the scan directory (<fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID>/), including the scanned application (.irx file or .war/.jar/.zip source file for static analysis) and any scan logs. For additional information on troubleshooting scans, see Troubleshooting static analysis scans.