After you upgrade

After you have deployed the newest version of MicroStrategy Web and the MicroStrategy SDK, you need to first restore your customizations and then test them thoroughly before deploying them into production. New features and functionality, as well as GUI changes (for example, changes related to HTML, JavaScript, CSS, architecture, and so on), might make it necessary for you to redo some customizations.

To restore your customizations:

1. Copy the plugins folder from your previous installation (which you backed up before the upgrade) to the plugins folder in your upgraded installation.

   The plugins folder is in the root directory of the installation.

To test your customizations, follow the steps below:

1. Redeploy each customization.
2. Recreate .jsp/.ascx customizations if used, using fresh copies of corresponding .jsp/.ascx files from upgraded MicroStrategy Web.
3. If you have customized XML layout files in <PluginName>\WEB-INF\xml\layouts, you need to get the latest version of the files and re-implement the changes in the layout file. These files are not deltas, they are copied to the plugin in their entirety just like the .jsp and .ascx files.
4. Restart the application server hosting MicroStrategy Web (for example, Tomcat, IIS, etc.).
5. Clear all browser caches.

6. Confirm that each customization works as expected and fulfills its purpose.

   If you followed the recommended best practices, the readme for the customization should include a description of what the customization is intended to do and the steps for testing it. Use the steps in the readme to test the customization after upgrading. If your customization does not work as expected, try to find the cause of the issue.