Guide de dépannage
Problèmes courants
Vérifications de base
Si vous rencontrez des problèmes, assurez-vous d'effectuer les vérifications de base suivantes :
- Vérifiez que le système répond à la configuration minimale requise pour AppScan 360°.
- Assurez-vous que les éléments prérequis sont installés et configurés correctement, tels que Docker, kubectl et Helm.
- Vérifiez que les étapes d'installation ont été suivies correctement conformément à la documentation et que les paramètres de configuration corrects ont été fournis pendant l'installation.
- Utilisez AppScan 360° Setup Assistant pour dépanner et valider la configuration.
Problèmes de connexion
Si vous rencontrez des problèmes pour vous connecter à AppScan 360°, essayez les solutions suivantes :
- Vérifiez que le cluster AppScan 360° peut se connecter au serveur de base de données.
- Vérifiez que la base de données AppScan 360° a bien été créée sur le serveur de base de données.
- Vérifiez que le serveur SQL est configuré pour autoriser les connexions à distance.
- Vérifiez que le cluster AppScan 360° peut se connecter au serveur LDAP/SSO.
- Vérifiez la configuration LDAP/SSO dans le fichier de configuration du kit AppScan 360°.
Journaux/configurations pour le dépannage
Les journaux/fichiers de configuration suivants peuvent vous aider à contrôler et résoudre les problèmes de configuration et d'examen d'AppScan 360°.
Journaux de configuration de machine virtuelle unique
- Les journaux de configuration de machine virtuelle unique se trouvent dans le répertoire
aioWorkspace/logsengageAS360-AIO.log: contient les journaux liés au processus d'installation d'AppScan 360° sur une configuration de machine virtuelle unique.disengageAS360-AIO.log: contient les journaux liés au processus de désinstallation d'AppScan 360° sur une configuration de machine virtuelle unique.
- Les journaux d'installation des kits individuels se trouvent dans les répertoires ci-dessous
aioWorkspace/kit/seaWorkbench/logs: contient les journaux relatifs à l'installation du kit ASCP.aioWorkspace/kit/workbench/logs: contient les journaux relatifs à l'installation du kit SCA.
- Les configurations à inspecter pour le dépannage se trouvent sur les chemins ci-dessous
aioWorkspace/audit/as360-aio-answers.env: contient les paramètres de configuration utilisés lors de l'installation d'AppScan 360° sur une configuration de machine virtuelle unique. - Le système ne génère pas ces paramètres s'ils sont déjà fournis lors de l'installation avec des kits.aioWorkspace/audit/singular-singular.clusterKit.properties: contient les propriétés de configuration complètes d'AppScan 360°.aioWorkspace/conf/aio_vars.env: contient toutes les variables d'environnement spécifiques à la configuration d'une machine virtuelle unique.
Journaux One Click Installer
- Pour One Click Installer, les journaux sont situés dans le chemin du répertoire cible comme ci-dessous
<EXTRACTION_PATH>/seaWorkbench/logs: contient les journaux relatifs à l'installation du kit ASCP.<EXTRACTION_PATH>/workbench/logs: contient les journaux relatifs à l'installation du kit SCA.
Journaux d'application
- Les journaux d'applications individuelles sont situés dans un stockage partagé monté. accessible à partir des pods sur le chemin ci-dessous
/storagemount/logs - Les journaux d'application sont limités à 2 Mo. Une fois cette limite atteinte, un autre journal est créé. Jusqu'à dix fichiers journaux peuvent être créés.
- Les journaux d'examen contiennent des informations détaillées sur les exécutions d'examen, y compris les mises à jour de progression, les mesures et les informations de débogage. Ils sont spécifiques à chaque exécution d'examen et peuvent être téléchargés à partir de l'interface utilisateur d'AppScan 360°.
Assistance
Pour faciliter une assistance efficace, incluez les éléments suivants :
- Pour les problèmes d'installation, incluez les journaux d'installation et les configurations comme indiqué dans la section Journaux/configurations pour le dépannage.
- Pour les problèmes d'examen, incluez le contenu du répertoire d'examen (
<fileStorageRoot>/SaaSWorkingDirectory/SaaSStorage/Scans/<scanID>/<ExecutionID>/), y compris l'application examinée (fichier.irxou fichier source.war/.jar/.zippour l'analyse statique) et tous les journaux d'examen. Pour plus d'informations sur la résolution d'incidents, consultez Dépannage des analyses statiques.