Upgrading or updating the Central Platform
Update the current version
- Update the
singular-singular.clusterKit.properties
file. See Preparing the configuration file for file parameters. - 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.
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.
- Make a backup of
singular-singular.clusterKit.properties
if you want to maintain the same configuration. - Download the new AppScan 360° installation package from the HCL License and Download Portal.
- 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.
- Backup all data.
- Prepare the environment as described in Setting up the AppScan 360° environment.
- 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. - Download the new AppScan 360° installation package from the HCL License and Download Portal.
- Prepare a share on a file server that exposes NFS and SMB protocols
- Make sure the AppScan 360° version 1.2.0 K8S cluster is installed with storage driver (CSI) that supports NFS.
- Stop the AppScan 360° service. From the
version 1.1.x installation folder, run:
> ./stop.ps1
- Connect to the designated share using a network drive on the AppScan 360° machine using SMB.
- Copy all the AppScan 360° shared data from
c:\saasworkingdirectory
(on the AppScan 360° machine) to the designated share on the file server. - 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
: v1kind
: PersistentVolumemetadata
:name
: nfs-pvUse 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
: - ReadWriteManypersistentVolumeReclaimPolicy
: 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>
- 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.