Upgrading or updating the Central Platform

Update the current version

To update the installation with a new configuration:
  1. Update the singular-singular.clusterKit.properties file. See Preparing the configuration file for file parameters.
  2. From the folder location that contains the extracted kit, type:
    > ./setup.sh $PWD/..

Upgrade to a new version of AppScan 360° without migrating data

Perform an upgrade only when there are no active scans running.

To upgrade to AppScan 360° version 1.2 from version 1.1.x or earlier without migrating data, follow the instructions in:
  1. Setting up the AppScan 360° environment
  2. Preparing the configuration file
  3. Installing the AppScan Central Platform

Upgrade to a new version of AppScan 360° and migrate data

To upgrade AppScan 360° version 1.2 to a newer version:

Data is migrated automatically.

  1. Make a backup of singular-singular.clusterKit.properties if you want to maintain the same configuration.
  2. Download the new AppScan 360° installation package from the HCL License and Download Portal.
  3. Install AppScan 360° as described in Installing the AppScan Central Platform.

    When it's complete you receive confirmation that the AppScan 360° update is installed and ready to use.

To upgrade from AppScan 360° version 1.1.x to version 1.2.0 and migrate data:
  1. Backup all data.
  2. Prepare the environment as described in Setting up the AppScan 360° environment.
  3. Edit the singular-singular.clusterKit.properties file for installation as described in Preparing the configuration file, mapping parameters from version 1.1.x to version 1.2 as follows:
    AppScan 360° version 1.1.x parameter AppScan 360° version 1.2.0 parameter

    DB_NAME

    DB_HOST

    DB_USERNAME

    DB_PASSWORD

    		 CK_CONFIGURATION_CONFIDENTIAL_DEFAULT_CONNECTION
    LDAP_USERNAME CK_CONFIGURATION_DISCLOSED_LDAP_USERNAME
    LDAP_PASSWORD CK_CONFIGURATION_CONFIDENTIAL_LDAP_PASSWORD
    LDAP_DOMAIN CK_CONFIGURATION_DISCLOSED_LDAP_DOMAIN
    EXTERNAL_IDP_MODE CK_CONFIGURATION_DISCLOSED_EXTERNAL_IDP_MODE
    LDAP_AUTHORIZED_GROUPS CK_CONFIGURATION_DISCLOSED_LDAP_AUTHORIZED_GROUPS
    EXTERNAL_ACCESS_PROXY CK_CONFIGURATION_DISCLOSED_EXTERNAL_ACCESS_PROXY
    USE_EXTERNAL_SERVER_CERTIFICATE CK_CUSTOMER_INGRESS_CERTIFICATE_ENABLED
    MAIL_SMTP_HOST CK_CONFIGURATION_DISCLOSED_MAIL_SMTP_HOST
    MAIL_SMTP_PORT CK_CONFIGURATION_DISCLOSED_MAIL_SMTP_PORT
    MAIL_SMTP_ENABLE_SSL CK_CONFIGURATION_DISCLOSED_MAIL_SMTP_ENABLE_SSL
    MAIL_SMTP_USERNAME CK_CONFIGURATION_DISCLOSED_MAIL_SMTP_USERNAME
    MAIL_SMTP_PASSWORD CK_CONFIGURATION_DISCLOSED_MAIL_SMTP_PASSWORD
    Note: Version 1.1.x parameters not specified are not applicable in version 1.2.0. Also, version 1.2.0 has additional parameters that must be specified.
    Important: When upgrading from AppScan 360° version 1.1.0 or earlier, the LDAP configuration cannot be resused as is. You must verify all LDAP parameters meet AppScan 360° version 1.2 requirements before installing.
  4. Download the new AppScan 360° installation package from the HCL License and Download Portal.
  5. Prepare a share on a file server that exposes NFS and SMB protocols
  6. Make sure the AppScan 360° version 1.2.0 K8S cluster is installed with storage driver (CSI) that supports NFS.
  7. Stop the AppScan 360° service. From the version 1.1.x installation folder, run:
    > ./stop.ps1
  8. Connect to the designated share using a network drive on the AppScan 360° machine using SMB.
  9. Copy all the AppScan 360° shared data from c:\saasworkingdirectory (on the AppScan 360° machine) to the designated share on the file server.
  10. Define a persistent volume (PV) on the AppScan 360° version1.2.0 K8S cluster that maps to the designated share on the file server. For example:
    • apiVersion: v1
    • kind: PersistentVolume
    • metadata:
      • name: nfs-pv

        Use the value of the CK_CSI_STORAGE_SHARED_FILE_SYSTEM_VOLUME_NAME installation parameter

    • spec:
      • capacity:
        • storage: <SHARED_DATA_SIZE>

          use the value of the CK_CSI_STORAGE_SHARED_FILE_SYSTEM_REQUESTED_CAPACITY installation parameter

      • accessModes: - ReadWriteMany
      • persistentVolumeReclaimPolicy: Retain
      • storageClassName: <CSI_STORAGE_CLASS>

        Use the value of the CK_CSI_STORAGE_CLASS_NAME installation parameter

      • nfs:

        path: <SHARE_PATH_ON_FILE_SERVER>

        server: <FILE_SERVER_IP>

  11. Install AppScan 360° as described in Installing the AppScan Central Platform.

    When it's complete you receive confirmation that the AppScan 360° update is installed and ready to use.