How Do I Install Report Engine for RESTful?
This article give detailed instructions for installing Report Engine for RESTful.
- A Report Engine for RESTful license key (request a trial license key if you don't have one)
- Windows Server 2008 R2 or later (Windows Server 2016 recommended). A virtual machine, cloud server, or dedicated hardware can be used.
- .NET 4.5.1 framework
- Microsoft Internet Information Services (IIS) for Windows Server 2008, Windows Server 2012 or Windows 10
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.
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.
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.