Scroll

Installing Exago on Windows

Exago runs on the web server application Microsoft Internet Information Services (IIS). The following sections walk through the installation process for Windows based systems.

See Linux Installation or Installing Exago on Azure for alternative operating systems.

 

Prerequisites

See System Requirements to ensure that you have sufficient hardware to run Exago.

Before installing Exago, ensure that IIS is installed and configured correctly. See Configuring IIS for Exago for details. Please refer back to this guide for necessary configuration settings.

 

Installation

IMPORTANT. If you are upgrading an existing Exago installation, please ensure that the file eWebReportsManifest.txt is present in the install directory. Otherwise, the installer will overwrite any custom config or styling you've applied.

Download the Exago installer from our Downloads page.

Run the installer as an administrator. The installation menu will appear with three downloadable applications. Click the top icon to install the Exago Web Application, as pictured below.

Follow the steps in the wizard to install Exago. You may optionally choose to install the Scheduler and the Web Service from this wizard.

Even though the installer has finished, Exago will most likely not function at this point. You must continue with some additional configuration.

 

Create the Directory Structure

After the installation is complete, configure Exago using the following steps. (See Configuring IIS for Exago for a more detailed walkthrough).

  1. Set permissions for the Config folder:
    Right click on the folder named "Config" and click Properties.
    In the security tab click "Edit" then "Add." Enter the IIS application pool user (default IIS_IUSRS).
    In the "Permissions for Config" window select the user that was just created and select "Modify" or "Full Control" permissions.
    Repeat this process for the MapCache folder.

  2. Create a folder for storing reports. This folder needs to be accessible from the web server, but is not required to be on the web server. It can reside on any server accessible by Exago via direct UNC or virtual path created in IIS.

    IMPORTANT. Do not create the reports folder within the Exago application structure. Doing so will cause ASP.NET sessions to crash when report folders are created or deleted within the Exago application.

    Give the Report Folder read and write privileges for the IIS application pool user. Below are three examples of report paths to the folder \ReportsRepository:

    C:\ReportsRepository – Folder is on a file system.
    \\Server Name\ReportsRepository – Physical folder is on a separate server.
    /ReportsRepository – Assumes an IIS virtual directory called 'ReportsRepository' has been created to point to the folder.

  3. Create a folder for storing temporary data. By default this is a sub-folder of Exago called 'Temp'. However it is recommended to not use the install path's temp folder in production environments.

    Give the Temp folder read and write privileges for the IIS application pool user.

  4. Point your browser to the Administration Console. By default this is http://<YourServer>/Exago/Admin.aspx

    Specify the location of the Report Folder in the 'Report Path' setting.
    Specify the location of the Temp Folder in the 'Temp Path' setting.

 

What's Next

Point your browser to the Home Page to verify that your installation was successful. By default this is http://<YourServer>/Exago/ExagoHome.aspx

If you encounter problems at any point, please see Installation Troubleshooting for some potential solutions. If you cannot resolve your problem, please file a Support Ticket.

At this point you will need to set up your data sources in order to use Exago. See Administration Console Setup to get started.

If you would like to set up Google Maps, GeoCharts, and/or any downloadable Application Themes, please see Installing Optional Features for more information.

Resources

 


Hidden Article Information

Article Author
Nick
created 2015-12-11 21:27:20 UTC
updated 2017-05-25 14:24:47 UTC

Labels
Installation, Installing Exago, Install, configuring IIS, windows folder configuration,
Have more questions? Submit a request