# Installing VitaraMaps on MicroStrategy Library

#### Download

* Download the library version of VitaraMaps from the official download page.
* You can find the latest version links on the VitaraMaps [Main Page.](https://www.vitaracharts.com/ms-product-downloads)

![](https://230207405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOuiTPVEbVQnzR38vviPf%2Fuploads%2FzmBWLNUi2oSh4FSZMmGs%2Funknown.png?alt=media\&token=95564f2d-853d-4a2f-977b-f2ea610259c3)

### New Installation

Follow the steps below to install VitaraMaps on your MicroStrategy Library Server:

1. **Download and Extract**

* Download the VitaraMapsLibrary.zip file.
* Unzip it to extract the VitaraMapsLibrary folder.

2. **Stop the Web Server**

* Stop IIS, Tomcat, or the equivalent  server.

3. **Remove Existing Installation**

* Delete any existing VitaraMapsLibrary folders under the MicroStrategy Library plugins directory.
* Do not keep backup copies of VitaraMapsLibrary inside the plugins directory.

4. **Copy Files**

* Copy the extracted VitaraMapsLibrary folder into the plugins directory of your MicroStrategy Library installation.\
  Path: **\tomcat\webapps\MicroStrategyLibrary\plugins**

5. **Apply License** (for MicroStrategy 2021 Update 4 and later)

* Replace the existing license.txt file under **/tomcat\webapps/MicroStrategyLibrary/plugins/VitaraMapsLibrary/**
* with the license file provided to you.

6. **Start the Web Server**

* Restart IIS/Tomcat or the respective server.

7. **Clear Browser Cache**\
   Open dossiers/documents in a new browser or incognito window to avoid issues with cached license files.

### Configure Mobile Library Server Path

Starting with VitaraMaps version 4.7, the following configuration is mandatory:

1. After copying the VitaraMapsLibrary plugins, open the Library Configuration Page using the following URLs:

**IIS/Windows Installation:**

<figure><img src="https://230207405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOuiTPVEbVQnzR38vviPf%2Fuploads%2FPftsPyn406Y6sQfLGHHH%2Fmaps_lib2.png?alt=media&#x26;token=068ff6ad-05ff-4e28-9448-88ce50870aa4" alt=""><figcaption></figcaption></figure>

**Tomcat/Linux Installation:**

<figure><img src="https://230207405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOuiTPVEbVQnzR38vviPf%2Fuploads%2Fa8Vx97UNUkqO16RrysKW%2Fmap_lib1.png?alt=media&#x26;token=b1d45152-ca31-4e51-8566-7057d1aae0d5" alt=""><figcaption></figcaption></figure>

2. On the configuration page, enter the path to your MicroStrategy Web application (not the Library) and click Submit.
3. Once successfully configured, the page will confirm the setup with a success message.\
   ![](https://230207405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOuiTPVEbVQnzR38vviPf%2Fuploads%2F8QcQ1SbHigXqdWbWe9Wd%2Funknown.png?alt=media\&token=e91584c3-4a4f-4015-8772-69592df9af78)

**Notes:**

* Setting the Web configuration URL enables VitaraMaps to render without internet access on iPad/iPhone.
* Clear the cache and restart the MicroStrategy Library Mobile App on your device to apply changes.
* For detailed instructions on clearing cache [Click here](https://docs.vitaracharts.com/faq/how-to-fix-mobile-rendering-issues#id-2.-clear-mobile-library-application-cache)<br>