Skip to main content
Windward

Installing the RESTful Engine

Overview

This article walks you through installing the Windward RESTful Engine on your server.

 

 

Requirements

  1. RESTful Engine Install (.zip) files
  2. A RESTful Engine license key
  3. Windows Server 2008 R2 or later (Windows Server 2012 recommended)
    • A VM (virtual machine), cloud server, or dedicated hardware can be used
  4. Microsoft IIS (Internet Information Services)
  5. .NET 4.5.1 framework

 

Installation

Step 1 - Download, move, and rename the RESTful Engine

First, download or enable IIS and navigate to your C:\inetpub\wwwroot folder. You can name this folder whatever you want your RESTful Engine to be named. 

 

Download the RESTfulEngine and RESTfulClient samples, then copy or move the RESTfulEngine folder (binaries from the .zip file) to  your  C:\inetpub\wwwroot folder. In the example below we have changed the name to RESTful Sample.

IRESTE_1.png

 

 

Step 2 - Create your website

Open IIS Manager by navigating to Control Panel > System And Security > Administrative Tools > Internet Information Services (IIS) Manager, or search for IIS from your start bar or Cortana. 

 

Create a new website by right-clicking on the server (top level of the navigation tree) and choose ‘Add Web Site...’ to bring up a new interface.

IRESTE_2.png IRESTE_3.png IRESTE_4.png

 

In the 'Add Web Site' dialog,

  • Set your Site Name, but not the application pool. Note: For help creating an Application Pool see Creating an Application Pool in IIS.
  • 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 the Physical Path to the RESTfulEngine folder (which you may have renamed) in ‘C:\inetpub\wwwroot’.  

For Binding, 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.

 

Step 3 - Editing Permissions

Back in the left pane of your IIS window, right-click the RESTfulEngine application you have created (in the navigation tree) and click 'Edit Permissions...' You must allow 'write' permissions for the application. 

 

 

IRESTE_5.png IRESTE_6.png IRESTE_7.png

 

  • In the properties dialog, select the Security tab, select CREATOR OWNER, and click 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 OK to close the permissions dialog.  Then click OK to close the properties dialog.

 

Step 4 - Turn Windows Features On or Off

Click "Start button" or Cortana and enter "Turn windows features on or off"

 

  • In the new window, navigate to Internet Information Services > World Wide Web Services > Application Development Features
  • Check (enable) the features. You may not need CGI.
  • Click OK to save selections and exit.

 

Step5 - Edit your web.config file

Edit the web.config file for logging and enter a valid license key. (C:\inetpub\wwwroot\<sitename>)

 

Congrats!

The RESTful Engine is now set up and ready to handle requests.

 

 

Next Steps

 

  1. Be sure you set up logging and enter your license key from Step 10 above. See the web.config file.
  2. Your RESTful Engine should be up and running. Now, try running some Examples.

 

 

Troubleshooting

 

If you are receiving error messages, you may find the following helpful: IIS Tips and Tricks

If you get a message that WindwardCustomFunctions is not found, this is actually not an error, but a failsafe for developers. It lets you know whether you set up CustomCallBacks, and it can simply be ignored. (If you want to set this up, see this article about setting up custom callbacks for the .NET Engine, it is the basis for the RESTful engine).

 

 

  • Was this article helpful?