Mise à niveau ou mise à jour de la plateforme AppScan 360°

Vous pouvez mettre à jour ou mettre à niveau l'intégralité de AppScan 360°, ou des composants spécifiques, avec ou sans migration de données :
Remarque : La procédure de mise à niveau est la même pour une installation de machine virtuelle unique AppScan 360° ou une installation répartie.

Mettre à jour la version actuelle

Pour mettre à jour l'installation avec une nouvelle configuration :
  1. Sauvegardez toutes les données.
  2. Mettez à jour le fichier singular-singular.clusterKit.properties. Voir Préparation du fichier de configuration pour les paramètres de fichier.
  3. A partir de l'emplacement du dossier qui contient le kit extrait, saisissez :
    ./setup.sh $PWD/..

Effectuer une mise à niveau vers une nouvelle version de AppScan 360° sans migrer les données

Effectuez une mise à niveau uniquement lorsqu'aucun examen actif n'est en cours d'exécution.

Pour effectuer une mise à niveau vers AppScan 360° version 1.2 à partir de la version 1.1.x ou antérieure sans migrer de données, suivez les instructions de la rubrique :
  1. Sauvegardez toutes les données.
  2. Configuration de l'environnement distribué AppScan 360°
  3. Préparation du fichier de configuration
  4. Installation groupée d'AppScan 360° et d'ASRA

Effectuer une mise à niveau vers une nouvelle version de AppScan 360° et migrer les données

Pour mettre à niveau AppScan 360° version 1.2 ou ultérieure et obtenir une version plus récente :

Les données sont migrées automatiquement.

  1. Sauvegardez toutes les données.
  2. Effectuez une sauvegarde de singular-singular.clusterKit.properties si vous souhaitez conserver la même configuration.
  3. Téléchargez le nouveau package d'installation d'AppScan 360° à partir de MyHCLSoftware.
  4. Installez AppScan 360° comme décrit dans Installation groupée d'AppScan 360° et d'ASRA.
    Remarque : Lors de la mise à niveau de l'installation, utilisez --target <newfolder>. Une fois la mise à niveau réussie, supprimez les dossiers d'installation précédents pour libérer de l'espace.

    Une fois qu'elle est terminée, vous recevez la confirmation que la mise à jour de AppScan 360° est installée et prête à être utilisée.

Mise à niveau de Conseils de résolution AppScan uniquement

Pour mettre à niveau Conseils de résolution AppScan uniquement :
  1. Sauvegardez toutes les données.
  2. Téléchargez le nouveau package d'installation d'AppScan 360° à partir de MyHCLSoftware.
  3. Fournissez l'autorisation exécutable au programme d'installation en exécutant
    chmod +x <PATH-OF-INSTALLER/APPSEC-INSTALLER-FILENAME>
  4. Exécutez le fichier d'installation en spécifiant les informations de registre dans la ligne de commande.
    Exemple :
    AppScan360_v1.6.0_ASRA.run -- [registry information] -f  ~/.docker/config.json
    Vous pouvez spécifier les informations de registre de trois manières différentes :
    • Directement. Exemple :
      ./AppScan360_v1.6.0_ASRA.run -- -server <registry[:port]> -f  ~/.docker/config.json

      Cette méthode envoie l'image Conseils de résolution AppScan au registre et installe Helm. Elle ne tente pas de créer un secret, mais vérifie qu'un secret est disponible dans le cluster.

    • A partir du fichier de configuration spécifié lors de l'installation ASCP. Exemple :
      ./AppScan360_v1.6.0_ASRA.run -- -config <singular-singular.clusterKit.properties> -f  ~/.docker/config.json

      La méthode envoie l'image Conseils de résolution AppScan au registre et installe Helm, puis crée ou remplace le secret.

    • A partir d'un fichier de configuration distinct. Exemple :
      ./AppScan360_v1.6.0_ASRA.run -- -file <docker_config_file> -f  ~/.docker/config.json

      Cette méthode envoie l'image Conseils de résolution AppScan au registre et installe Helm, utilise le fichier de configuration comme entrée pour créer un fichier secret.yaml pour Helm et supprime tout secret existant dans le cluster.

      Si vous choisissez d'utiliser un fichier de configuration distinct, le fichier doit contenir les informations suivantes :

      • CK_DOCKER_REGISTRY_ADDRESS=<registry[:port]>

      • CK_DOCKER_REGISTRY_USERNAME=<username>

      • CK_DOCKER_REGISTRY_PASSWORD=<password>

  5. Une fois l'installation terminée, un message approprié s'affiche :

Mise à niveau ou restauration de AppScan 360° à l'aide de Helm

Pour mettre à niveau AppScan 360° vers une nouvelle version à l'aide de Helm :
  1. Sauvegardez toutes les données.
  2. A partir du référentiel cloné, exécutez :
    git pull
Pour revenir à une version précédente de l'installation :
  1. Sauvegardez toutes les données.
  2. Passez en revue les versions disponibles :
    helm history <release-name> -n <namespace>
    Où <release-name> et <namespace> font référence aux composants AppScan 360° et à leurs emplacements relatifs dans le référentiel :
    • Plateforme centrale AppScan
      • <release-name> : appscan360-ascp
      • <namespace> : hcl-appscan-ascp
    • Conseils de résolution AppScan
      • <release-name> : asra
      • <namespace> : hcl-asra
  3. Spécifiez la version à laquelle revenir :
    helm rollback <release-name> <revision-number> -n <namespace>