This guide covers the IIS configuration details necessary in order to install Exago. First-time users are highly encouraged to use this guide during their installation process. Following these steps in order will reduce the amount of troubleshooting necessary to get Exago running.
Exago requires the following Windows Features to be installed:
Before installing Exago, please ensure that these features are present on your system. To verify, access the Windows Features panel via Control Panel > Programs > Programs and Features, and click Turn Windows features on or off.
In the Windows Features dialog, expand Internet Information Services and ensure that the prerequisite features are selected. If any are not installed, check the relevant boxes, press OK, then restart the server.
These features are necessary in order for the proper Application Pools to be available.
At this point, Exago can be installed. For a detailed walkthrough, see Installing Exago on Windows.
Next, verify that Exago is using a valid application pool.
Open IIS via Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
In the left-most Connections pane, select the Exago application.
In the right-most Actions pane, click on Advanced Settings…
In this menu, click on the […] button to the right of the Application Pool.
In the Select Application Pool menu, determine which of the app pools has the properties:
Select this app pool, then press OK to close the App Pool menu, and then OK to close the Settings menu.
Next, ensure that the app pool is running. In the left-most Connections pane, select Application Pools.
Check the Status column for your selected app pool.
If it does not say Started, select the app pool and in the right-most Actions pane, press Start.
Exago uses a Temp folder to store working data. Create folders in locations suitable for your environment.
The Temp folder may contain sensitive report and database information. It should be in a secure location, inaccessible to web users.
Several Exago folders require you to set additional permissions for the application pool user. First, determine the user: Open IIS to the Application Pools pane, and look at the app pool which is running Exago. The Identity property indicates the application user:
By default, this is set to ApplicationPoolIdentity. This corresponds with the built-in user IIS_IUSRS. If this is a different user, then set permissions for that user account instead.
The following folders require the app pool user to have read/write permissions:
Note
This process may differ slightly depending on the version of Windows.
First, right-click on the folder and select Properties.
Open the Security tab. Then click the Edit… button.
If the application pool user is not available to select, you need to add it. Press the Add… button.
Then enter the username in the dialog box, and press OK (the default app pool user is IIS_IUSRS).
With the user selected, check the box for Allow Full control. Then press OK.
Repeat this process for every folder listed above.
Before starting Exago, ensure that the Web Site is running. Open IIS, and in the left-most Connections pane, locate and select the web server under which Exago was installed
Verify in the right-most Actions pane that the Start button is greyed out, and the Restart and Stop buttons are available. If the Start button is not greyed out, press it to start the web server.
Next, in the left-most Connections pane, locate and select the web site under which Exago was installed.
Verify in the right-most Actions pane that the Start button is greyed out, and the Restart and Stop buttons are available. If the Start button is not greyed out, press it to start the web site.
You’re almost done! To verify that Exago was installed correctly, open a web browser and navigate to http://[YourServerAddress]/[YourExagoVirtualPath]/Admin.aspx
. If you see the Exago Administration Console, then your installation was successful.
In the Admin Console > General Settings, set your Temp to the folder you previously created. Then click Okay.
Setup the Storage Management for storing reports, templates and themes.
Finally, navigate to http://[YourServerAddress]/[YourExagoVirtualPath]/ExagoHome.aspx
. If you can see the Exago Web Application user interface, depending on version the Report Tree should be:
Congratulations! You’ve completed your first Exago installation.
We highly recommend Setting up a State Server to handle Exago sessions.
If you are experiencing problems that aren’t detailed in this guide, please file a support ticket.