Upgrading to Visualization Platform 3.1.1
This section contains information you need to know in order to upgrade to Visualization Platform 3.1.1.
Specifying the upgrade user account
To ensure that file permissions are set correctly, you must upgrade to Visualization Platform 3.1.1 using the same user account that was used to install your existing Visualization Platform.
Setting the installation root folder for the upgrade
You can unzip BIRTiHubVisualization.tar.gz into any folder other than your existing Visualization Platform installation root folder. You must then specify the installation root folder in the acinstall.properties file.
Your existing Visualization Platform configuration contains absolute paths. Visualization Platform 3.1.1 must use the same paths. To ensure that these paths are the same, you must upgrade to Visualization Platform 3.1.1 using exactly the same installation root folder that your existing Visualization Platform installation used. For example, if your existing Visualization Platform was installed in /opt/actuate/BIRTiHubVisualization, you must upgrade to Visualization Platform 3.1.1 using the installation root folder /opt/actuate/BIRTiHubVisualization.
Completing the upgrade
Upgrade to Visualization Platform 3.1.1 using the instructions in Installing BIRT iHub. In acinstall.properties, set ac.upgrade.ihub to y. If you want to start BIRT iHub automatically after upgrading, also set ac.upgrade.start.ihub to y. Do not unzip BIRTiHubVisualization.tar.gz into your existing Visualization Platform installation root folder, as it will overwrite the files in this folder. Do not open any files or folders in either the existing BIRT iHub installation or the new installation until you have finished the upgrade.
Post-upgrade tasks
After completing the upgrade, you must perform the following tasks:
*Move any customized JAR files in the following folders to the corresponding folders in the new installation. Then, delete the _old folders.
*${ihub_home}/oda/eclipse/plugins_old
*${ihub_home}/Jar/BIRT_old
*${ihub_home}/web/iportal/WEB-INF/lib_old
*Merge the new content in the following files into the corresponding web.xml files:
*BIRTiHubVisualization/modules/BIRTiHub/iHub/web/iportal/WEB-INF/web.xml.new
*BIRTiHubVisualization/modules/BIRTiHub/iHub/web/mgmtconsole/WEB-INF/web.xml.new
*Delete the folder into which you unzipped BIRTiHubVisualization.tar.gz.
Verifying the Visualization Platform 3.1.1 upgrade
When the upgrade program finishes, start Visualization Platform 3.1.1 if it did not start automatically.
To verify that Visualization Platform 3.1.1 was upgraded correctly, log in using the following default credentials:
*Username: Administrator
*Password: Leave Password blank
Visualization Platform 3.1.1 includes a sample volume named Default Volume. After logging in, verify that you can navigate in the volume.