Upgrading from the Previous Release

Given below is how to upgrade from BAM 2.4.1 to BAM 2.5.0. To upgrade from a version older than 2.4.1, start from the doc that was released immediately after your current release and upgrade incrementally.

Preparing to upgrade

Download WSO2 BAM 2.5.0.

Configuration upgrades

Change the following files inside the <BAM_HOME>/repository/conf/ folder as follows:

Folder path	Description	Required change
`advanced/hive-site.xml`	Change the value of the `hive.jar.path` property.	`<value>${BAM_HOME}/repository/components/plugins/hive_0.8.1.wso2v10.jar</value>`
`advanced/hive-site.xml`	Change the value of the `hive.aux.jars.path` property.	<value>file://${BAM_HOME}/repository/components/plugins/apache-cassandra_1.2.13.wso2v4.jar, file://${BAM_HOME}/repository/components/plugins/guava_12.0.0.wso2v1.jar, file://${BAM_HOME}/repository/components/plugins/json_2.0.0.wso2v1.jar, file://${BAM_HOME}/repository/components/plugins/commons-dbcp_1.4.0.wso2v1.jar, file://${BAM_HOME}/repository/components/plugins/commons-pool_1.5.6.wso2v1.jar, file://${BAM_HOME}/repository/components/plugins/libthrift_0.7.0.wso2v2.jar, file://${BAM_HOME}/repository/components/plugins/hector-core_1.1.4.wso2v1.jar, file://${BAM_HOME}/repository/components/plugins/org.wso2.carbon.bam.cassandra.data.archive_4.2.2.jar</value>
`datasources/bam-datasources.xml`	Use the new `bam-datasources.xml` file that ships with BAM 2.5.0.	Change the URL, username, and password accordingly.
`datasources/bam-datasources.xml`	Change the value of `replicationFactor` property based on the Cassandra cluster and the business requirement.	`<replicationFactor>1</replicationFactor>`
`etc/cassandra.ymal`	Apply values of the new `cassandra.yaml` that ships with BAM 2.5.0.	Update seeds details, IP addresses, and port according to your deployment.
`etc/hector-config.xml`	If you are pointing to an external Cassandra server, you have to change the `externalCassandra` property value to true. Otherwise, the Cassandra port will be affected by the port offset changes, which are specified in `<BAM_HOME>/repository/conf/carbon.xml` file. For more information on port offset changes, see Port Offset.	`<Nodes externalCassandra="false">localhost:9160</Nodes>`
`etc/tasks-config.xml`	Apply values of the new `tasks-config.xml` that ships with BAM 2.5.0.
`advanced/streamdefn.xml`	Apply values of the new `streamdefn.xml` that ships with BAM 2.5.0.
`registry.xml`	Change the value of `versionResourcesOnChange` property to false.	`<versionResourcesOnChange>false</versionResourcesOnChange>`