Windward OhanaReport Engine for RESTful User Manual FAQsHow Do I Install Report Engine for RESTful?

How Do I Install Report Engine for RESTful?

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

Requirements

Installation

Download

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.

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.

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. The click on OK to save your selection and exit.

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>.

Validation

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.