Previous versions upgrade guides

This section contains specific instructions for previous version upgrades.

Pre-upgrade step for all installations of AppScan 360° version 2.0.0 - Update storage volume ownership

  1. Identify the userapi pod name:
    kubectl -n hcl-appscan-ascp get pods
    For example, a pod name might be ascp-mr-user-api-7f7bd44c78-c9d7n.
  2. Update storage owner:
    kubectl -n hcl-appscan-ascp exec <userapi-pod> -- chown -R 1111:2222 /storagemount 
    Depending on the number of scans stored on the volume, this may take some time.
  3. Verify the change:
    kubectl -n hcl-appscan-ascp exec <userapi-pod> -- ls -la /storagemount

Single VM Setup specific pre-upgrade step - Update storage volume ownership

  1. Run prepareUpgrade script to update the storage volume ownership before starting the installation for version 2.0.0.
    cd ~/aio-setup
    sudo ./AppScan360_SingleVMsetup_v2.0.0.run -- $PWD prepareUpgrade

Set LDAP Properties Before Upgrade to version 2.0.x

  1. For installation upgrading from version 1.6.x or earlier with LDAP/AD integration, in order to retain LDAP/AD settings you need to supply them via environment variables temporarily in the installation shell before starting upgrade to 2.0.x.
  2. Set Environment Variables: Before running the installation script, set the following environment variables in the shell. Replace placeholder values with actual values:
    export AS360_AIO_AD_DOMAIN='your_domain.com' 
    export AS360_AIO_AD_USERNAME='your_username' 
    export AS360_AIO_AD_PASSWORD='your_password' 
    export AS360_AIO_AD_AUTHORIZED_GROUPS='group1,group2' # Use '' if no groups 
    export AS360_AIO_AD_SSL='false' # Set to 'true' if using SSL 
    export AS360_AIO_AD_TARGET_OU='OU=Users,DC=your_domain,DC=com'
  3. Run the Installation Script: Ensure that the variables are set in the same shell session where the installation script is executed. This allows the installation script to access the variables and apply them to the singular properties file.
  4. Verify Properties: After installation, check the singular properties file located at aioWorkspace/audit/singular-singular.clusterKit.properties to confirm that the properties have been applied correctly.