Upgrade MicroStrategy 10.10 on Linux
Last 5th of December MicroStrategy released its last product: version 10.10. Since there is already plenty of information on how to the upgrade on Windows, we show you, in this step-by-step guide, how to do it on Linux.
This is our environment prior upgrade:
- We are using a Linux Server mounted with CentOS 7 and Apache Tomcat 8
- We already have installed MicroStrategy 10.9 and both Intelligent Server and Web
The first thing you will need to do is download the last version, available on MicroStrategy Downloads: https://download.microstrategy.com/
Then log in and make sure to navigate to Feature Releases, select Version 10.10.0 and Linux as OS.
Since the download has been done outside our server, we need to transfer our tar file using FileZilla, a free FTP solution.
Next step is to extract all files.
Once this is done we should execute the setup.sh inside the install folder under path:
Execute setup.sh and follow all the steps through the Installation Wizard.
Since we are going to upgrade an existing installation we must check the Use an existing installation and Upgrade Operation box.
Next step is to fill the same customer information and Key licence when you first install MicroStrategy Intelligent Server.
Now select all necessary components. In our case we will exclude R and Usher (not in the screenshot).
Since version10.10 we can register MicroStrategy processes directly as services, but only if we are logged as root. Since we aren’t, we will skip this step.
Now we only need to wait till the Setup finishesh its process.
The upgrade for binary files is completed!
Now it’s time to migrate the metadata to the new version. For that, we will need to open the MicroStrategy Configuration Wizard and select the Upgrade option.
We now select to upgrade the Intelligent Server.
Then we select our Administrator user and Password.
We now select all the components we want to upgrade.
Last step is to log in on the Metadata database.
And the summary.
Click on Save and you will migrate the metadata successfully.
We will now reboot our Intelligent Server to apply all changes. For doing that we would need to execute MicroStratregy Service Manager under /home/yourfolder/MicroStrategy/bin and execute ./mstrsvcmgr . Then click on Restart and close .
Last step is to re-activate all our services using MicroStrategy Licence Manager under /home/yourfolder/MicroStrategy/bin and execute ./mstrlicmgr
You will now need to check the email you received which will give you the license key.
Fill the Server activation code.
And restart the Intelligent Server.
Upgrading MicroStrategy Web and Mobile
After upgrading binary files and metadata it’s time for Web and Mobile. For doing that we will need to delete first all .war files, directories and caches. We are going to do that using our root user via command line.
Delete folders under /opt/tomcat/apache-tomcat-8.5.23/work/Catalina/localhost
An example for removing files:
rm -rf MicroStrategy
rm -r will remove recursively, with -f we will force the operation without asking before doing it.
Now we deleted cache folder it’s time for .war and their respective folders. They will be here: /opt/tomcat/apache-tomcat-8.5.23/webapps
Remove them using same command as before
rm -rf MicroStrategy.war
Once we have deleted the necessary files, we must deploy the new .war again on the same folder. We just need to go to our install folder, and copy each .war to tomcat/webapps/home/mstr/MicroStrategy/install/WebUniversal
cp MicroStrategy.war /opt/tomcat/apache-tomcat-8.5.23/webapps/
Repeat the process with folders /home/mstr/MicroStrategy/install/LibraryWebMobile and /home/mstr/MicroStrategy/install/Mobile/MobileServer
After waiting a few seconds check MicroStrategy Web
It’s possible that the first time you log in after the deploying an error is triggered. This is because configuration options are gone, and since we deleted the cache and all the folders you need to log into
and fill the name of the server manually.
All the upgrade process is now complete!