Windward DocumentationReport Engine for RESTful User Manual ReferenceHosting RESTful Engine on AWS with EC2 (HTTP)

Hosting RESTful Engine on AWS with EC2 (HTTP)

Overview

It is assumed that you already have an AWS account and have the correct credentials and permissions to launch EC2 instances in your Virtual Private Cloud (VPC). Although almost everything can be done from the AWS CLI, the context of these instructions will be the AWS Management Console.

Creating RESTful engine instance with basic Windows Server AMI

The AMI and Instance Types mentioned will fulfill most requirements, but it is ultimately up to you to select the configuration that best meets your needs.

  1. Select EC2 from the Compute Services menu
  2. Select Instances from the left hand menu
  3. Click the Launch Instance button at the top of the screen
  4. Select the Quick Start menu item from the left hand menu
  5. Find the Microsoft Windows Server 2019 Base AMI and click the Select button
  6. Select the Instance Type t2.xlarge
  7. Click the Review and Launch button at the bottom of the page
  8. Click the Launch button
  9. The Key Pair dialog will appear. The Key Pair allows you to securely connect to your instance.
  10. Select Create a New Key Pair
  11. Specify a meaningful Key pair name
  12. Click the Download Key Pair button. A .PEM file will be downloaded to your computer
  13. Click the Launch Instance button
  14. From the Launch Status page, click the View Instances button
  15. The Instances page will be shown and you will see that your instance is initializing
  16. Select the instance from the list by selecting the radio button
  17. Select Actions -> Get Windows Password from the top menu button panel
  18. The Retrieve Password dialog will show.
  19. Click the Choose File button and browse to the .PEM file you created in step 12
  20. Click the Decrypt Password button
  21. The password for the administrator account will be shown in plain text. Copy this to use in connecting to your instance through RDP using the Public DNS listed on the same dialog. When using RDP, allow local resources (clipboard and drives) to make configuration easier.

Configure EC2 instance for ease of use

Allow HTTP Traffic to your EC2 instance

  1. From the Instances page, find the security group in the details section and select it.
  2. At bottom of screen, select the Inbound tab and then click the Edit button
  3. Click the Add Rule button
  4. For Type, select HTTP and then click the Save button

Allow administrator to download from the internet

  1. Launch Server Manager
  2. Select Local Server on left hand menu
  3. In Properties pane change IE Enhanced Security Configuration Click on "On" and select "Off for Administrators"
  4. Click OK button

Installing and Configuring IIS

  1. Open the Server Manager and click Add Roles and Features from the Manage menu item
  2. When the dialog opens, click the Next button
  3. For Installation Type keep the default selection of "Role-based or feature based installation", Click the Next button
  4. For Server Selection, keep the default selection and click the Next button
  5. For Server Roles, select Web Server (IIS) and click the Next button
  6. A dialog will be shown, click the Add Features button
  7. Click the Next button
  8. For Features, select the following
    1. ASP.NET 4.7
    2. HTTP Activation
  9. Test that IIS is installed successfully by navigating to http://localhost/ in the browser of your instance. You should see the Internet Information Services (IIS) default page.
  10. Test that you can reach the VM from outside of your VPC by navigating to the Public DNS of your instance from your local PC. (You can find this in the Details section of your Instance within the AWS management Console for Instances)

Installing the RESTful engine

Assuming you have an RDP session to your EC2 instance...

  1. Start Internet Explorer
  2. Navigate to : https://www.windwardstudios.com/version/version-downloads
  3. Find the RESTful Engine link in the most recent version and click on the link, when prompted select Save.
  4. Unzip RESTfulEngineAndClient.zip
  5. Unzip RESTfulEngine.zip
  6. Copy the RESTfulEngine directory to C:\inetpub\wwwroot
  7. Start the Server Manager
  8. Select Tools >> Internet Information Services (IIS) Manager
  9. Expand the Connections Treeview until you see the Default Web Site node
  10. Select the Default Web Site node and then in the right most menu select Stop
  11. Right click the Sites node from the left most treeview and select Add Website...
  12. The Add Website dialog will show
    1. Specify a Site name
    2. Specify the Physical path of the RESTfulEngine directory
    3. You may see a warning dialog concerning Port 80 being assigned to another site, just select the OK button
  13. Update the web.config file with your license key.
  14. Test that the RESTful engine is installed and configured correctly by clicking the Browse link in the right-hand Actions menu.
  15. Test that the RESTful engine is accessible from outside your VPC by navigating to the Public DNS of your instance from your local PC. (You can find this in the Details section of your Instance within the AWS management Console for Instances)

0 Comments

Add your comment

E-Mail me when someone replies to this comment