ASPX / ASP.NET

ASPX / ASP.NET

ASPX Deployment

ASPX deployment was introduced in IntraWeb XIV and allows you to deploy your application as a ASP.NET application. Your application is still Delphi, 100% Delphi native code, but there is a ASP.NET wrapper between IIS and your IntraWeb library.

1. Pre-requisites

1.1. Internet Information Services (IIS)

1.2. .NET Framework version 4.5

1.3. ASP.NET MVC 4

This tutorial was created using Windows 2008 R2 Server. Windows 7 and Windows 2012 have similar procedures.

2. Installing the pre-requisites on your Windows Server

2.1. Download and install .NET Framework 4.5, if not yet installed. Download link (english): http://www.microsoft.com/en-us/download/details.aspx?id=30653

.NET 4.5 Download

2.2. Download and install ASP.NET MVC 4, if not yet installed. This package is not part of .NET Framework install and must be downloaded and installed separately. Download link: https://www.microsoft.com/en-us/download/details.aspx?id=30683

After installing both packages, please reboot your Windows Server.

3. Copy all required files to your Windows Server

3.1. Copy ASPX deployment files

3.1.1) Copy all ASPX deployment files to some folder on your Windows Server. It is a good idea to keep them isolated from your application files. In this tutorial we will create a folder named ASPX and a BIN subfolder, like this:

Directory structure

3.1.2) Inside ASPX folder you must copy Global.asax and web.config files. Inside bin subfolder you must copy IntraWeb.dll and IntraWeb.IWP.dll:

ASPX Folder Files

Bin Folder Files

3.2. Copy application files

Now you should copy all your application files. As we said before, it is a good idea to keep it isolated from ASPX deployment files. So lets create a new directory where we will copy all our application files. In this tutorial we will use the Features demo, now compiled as an IW Library for ASPX deployment:

Application files

4. IIS Setup

4.1. Create an application pool

4.1.1) Run Internet Information Services Manager

4.1.2) Select “Application Pools”, right-click it and choose “Add Application Pool…”.

Add application pool

4.1.3) Configure basic settings for the new application pool. You can name it with any name you want. We will name it “ASPX App Pool” in this tutorial. Please note the .NET framework version used.

ASPX App Pool

4.1.4) Configure advanced settings for the new application pool. You must set these properties:

i) Enable 32-Bit applications: True

ii) Managed Pipleline Mode: Integrated

iii) Identity: domain user as the application pool identity, in the form domainuser name.

Advanced Settings

4.2. Create a new web application in IIS

Now that we already have a new application pool, we are ready to create the web application in IIS.

4.2.1) Select “Default Web Site”, right-click it and choose “Add Application…”.

Add application

4.2.2) Configure the new application. Give a name for the application (remember that this name is part of the URL of the application), select the correct application pool and set the physical path to the ASPX directory (created on section 3.1 above).

Application Pool

Also you should set the itentity used by your application, clicking “Connect as…” and then clicking on “Test settings…” button to check if it was successful. The user MUST have reading NTFS permissions in both ASPX and Features directories (in our sample).

Test

5. Application configuration

Now that IIS setup is complete, we have to configure the application. This is done editing the web.config file, in ASPX directory created on section 3.1 above. You may download our sample web.config file here. Then save it as “web.config” to your ASPX directory. Follow the comments marked as STEP 1 to 4 in the sample web.config file, and change the values according to your application. Changed values are bold:

<!– STEP 1: Change “value” below to match your application name under IIS –>
<add key=”wwwroot” value=”wwwroot\Features“/>

<!– STEP 2: Change “value” below to match your IntraWeb Library (DLL) module –>
<add key=”Application” value=“C:\web\Features\FeaturesLib.dll“/>

<!– STEP 3: Change “value” below to “true” if you are using IWP (IntraWeb pages). Otherwise leave it as “false” –>
<add key=”IWPEnabled” value=”false”/>

<!– STEP 4: Change “debug” value below to “false” if you are deploying in PRODUCTION environment –>
<compilation debug=”false” targetFramework=”4.5″/>

Save and close the file.

6. Testing the installation

Now open your browser and type the appropriate URL. In our case it is: http://localhost/Features

Note that there is no FeaturesLib.dll at the end of the URL like when you deploy an ISAPI application. It works!

Testing application