How Do I Install Report Engine for RESTful?

This article give detailed instructions for installing Report Engine for RESTful.




Turn On Windows Features

Now you must add some features to IIS that aren't included in the default installation. (This step may have already been done when IIS was installed.)

In the Search, Bar enter "Turn Windows features on or off", and start the application. In the new "Windows Features" dialog, navigate to Internet Information Services -> World Wide Web Services -> Application Development Features, and click on its checkbox. Then click on OK to save your selection and exit.

Create a Website

Start IIS Manager, and create a new website by right-clicking on the web server at the top of the Navigation Pane on the left of the IIS Manager UI. Choose "Add Web Site..." to bring up a new dialog:

Set the Site name - this should be "RESTfulEngine", unless you changed the RESTful Engine directory name in C:\inetpub\wwwroot when you installed it. If that is the case, use the new name for the Site name.

Then click the "Select…" button next to the Application pool text field. Click the drop down and select one of the options:

  • "ASP.NET v4.0"
  • ".NET 4.5" or ".NET 4.0"

Although you may only see ".NET 4.0" or ".NET 4.5", if you have .NET 4.5.1 installed, either option will work.

If you do not see .NET 4.0 or greater in the Application Pool drop-down list below, then you may need to run the Microsoft ASP.NET IIS Registration Tool (aspnet_regiis.exe) to activate the ASP.NET components on the Web server. 

Refer to this article for more information: ASP.NET IIS Registration Tool 

Next, browse to the Physical path to the RESTfulEngine directory (which you may have renamed) in "C:\inetpub\wwwroot".  

For the Binding section, select an IP address and port to be used for this website, and optionally a host name.

Then click OK to close the Add Web Site dialog.

Edit Permissions

You must allow 'write' permission for the RESTful Engine, for it to function properly.

In the left-hand pane of the IIS Manager, right-click on the RESTful Engine application you just created, and select "Edit Permissions..."  

In the Properties dialog, select the "Security" tab, then select "CREATOR OWNER", and click on the Edit button. Select the IIS_IUSRS account, and under the Allow column, select the "Write" checkbox under the permissions for the IIS_IUSRS group. 

Click on OK to close the Permissions dialog.  Then click OK to close the Properties dialog.

Edit web.config

You apply your license key to Report Engine for RESTful by editing its web.config file. It's located in the directory where you installed the Engine, i.e. C:\inetpub\wwwroot\<sitename>.


You've installed your Report Engine for RESTful! To ensure the installation was successful, open a browser on the machine where you installed the Engine, and enter the URL "http://localhost:<port>/v1/version", where <port> is the port number you specified when creating the RESTful Engine website above. You should see the version of your Engine, e.g.