This section explains how to upgrade to DAS 3.2.0 from DAS 3.1.0. For more information on release versions, see the Release Matrix.
You cannot roll back the upgrade process. However, it is possible to restore a backup of the previous database so that you can restart the upgrade progress.
Preparing to upgrade
Before upgrading to WSO2 DAS 3.2.0, complete the following:
- Make a backup of the DAS 3.1.0 database and copy the
<DAS-3.1.0_HOME>
directory in order to backup the product configurations. - Download any CAR files that are deployed in the DAS server and save them. Then delete them from DAS 3.1.0. This removes the scheduled tasks relating to the deployed artifacts and allows migration to be carried out smoothly. For more information, see Packaging Artifacts as a C-App Archive.
- Download WSO2 3.2.0 from here.
- Make the required changes in the datasource files in the
<DAS-3.2.0_HOME>/repository/conf/datasources
directory to make sure that they are configured as required. For more information, see Datasources.
Migrating analytics tables
If you want to connect your WSO2 Data Analytics Server 3.2.0 installation to the same databases that were used with your Data Analytics Server 3.1.0 installation, replace the configurations in the <DAS_3.2.0_HOME>/repository/conf/analytics/rdbms-config.xml
file ith that of the <DAS_3.1.0_HOME>/repository/conf/analytics/rdbms-config.xml
file.
Migrating encrypted data
To migrate encrypted data in WSO2 DAS 3.1.0 when you upgrade to WSO2 3.2.0, follow the steps below:
- Download migration resources from here.
- Unzip the migration resources you downloaded and copy the
org.wso2.das.migration-3.2.0.jar
to the<DAS-3.2.0_HOME>/repository/components/dropins
directory. - Copy the
.jks
files from the<DAS-3.1.0_HOME>/repository/resources/security
directory and place them in the<DAS-3.2.0_HOME>/repository/resources/security
directory. - Copy the
.db
files from the<DAS-3.1.0_HOME>/repository/database
directory and place them in the<DAS-3.2.0_HOME>/repository/database
directory. - If you have created tenants in the WSO2 DAS 3.1.0 environment and if there are any tenant resources in the
<DAS-3.1.0_HOME>/repository/tenants
directory, copy that content to the<DAS-3.2.0_HOME>/repository/tenants
directory. - If you have created any secondary user stores in the WSO2 DAS 3.1.0 environment, copy them from the
<DAS-3.1.0_HOME>/repository/deployment/server/userstores
directory and place them in the<DAS-3.2.0_HOME>/repository/deployment/server/userstores
directory. - If you have created any event receivers and event publishers in the WSO2 DAS 3.1.0 environment, do the following:
- To migrate the event receiver configurations, copy the contents in the
<DAS-3.1.0_HOME>/repository/deployment/server/eventreceivers
directory to the<DAS-3.2.0_HOME>/repository/deployment/server/eventreceivers
directory. - To migrate the event publisher configurations, copy the contents in the
<DAS-3.1.0_HOME>/repository/deployment/server/eventpublishers
directory to the<DAS-3.2.0_HOME>/repository/deployment/server/eventpublishers
directory.
- To migrate the event receiver configurations, copy the contents in the
- Start WSO2 DAS 3.2.0 with the following commend to perform data migration for encrypted data.
- On Windows:
wso2server.bat -Dmigrate
On Linux/Mac OS:
sh wso2server.sh -Dmigrate
- On Windows:
- Once the migration is successfully completed, stop the server and start it again with one of the following commands.
- On Windows:
wso2server.bat
On Linux/Mac OS:
sh wso2server.sh
- On Windows: