help.axcms.netAxinom Logo
Save Save Chapter Send Feedback

Getting Started under IIS 7.x

Installing IIS folders...


 

Installing IIS 7.x on Windows Vista / 7

  1. Platforms
  2. Windows Editions Supported
  3. Requirements
  4. To Install IIS 7.x on Windows Vista / Windows 7

Installing IIS 7.x on Windows Server 2008 / Windows Server 7

  1. Platforms
  2. Requirements
  3. To Install IIS 7.x on Windows Server 2008 / 7

Installing AxCMS_Sample IIS directories

  1. Automated Installation
  2. Creating Virtual Directories
  3. Authentication
  4. Custom Extension
  5. Set default document
  6. Templates directory
  7. Silverlight MIME types

 

Installing IIS 7.x on Windows Vista / 7

By default, IIS 7.x is not installed on Windows Vista / 7. You can install IIS 7.0 by using the "Turn Windows features on or off".

Platforms

  • IIS 7.0 - Windows Vista (Home Premium, Business, Enterprise, Ultimate Editions)
  • IIS 7.5 - Windows 7 (Home Premium, Professional, Enterprise, Ultimate Editions)

Windows Editions Supported

The Windows Vista / 7 Starter, Home Editions are targeted at home and personal users who do not have the need to perform application or web development. IIS 7 Web Server and FTP Server features are not available on these editions. However, if you look closely you will notice specific components of IIS 7 that can be installed on these Editions. Please note, however, that installing these components will not provide a web server that supports static content, Classic ASP, or ASP.NET.

Make sure you have installed one of the supported editions of Windows Vista before proceeding. 

  • Windows Vista Home Premium
  • Windows Vista Ultimate
  • Windows Vista Business
  • Windows Vista Enterprise
  • Windows 7 Home Premium
  • Windows 7 Professional
  • Windows 7 Enterprise
  • Windows 7 Ultimate

Requirements

  • Administrative Credentials

You must be a member of the following IIS administrative role or roles to perform this procedure:

  • Web Server Administrator

To Install IIS 7.x on Windows Vista / 7

  1. Click Start and then click Control Panel.
  2. In Control Panel, click Programs and then click Turn on or off Windows features.
  3. In the Windows Features dialog box, click Internet Information Services (wor Windows 7) or World Wide Web Services (for Windows Vista) and then click OK.
  4. Microsoft .NET Framework 3.5 SP1 with WCF should be added from Turn on or off Windows features (for Windows 7).
  5. IIS 6 Scripting tools are needed for automated installation. If you prefer complete all the steps manually, just leave it unticked.

Open the tree and make sure next checkboxes are checked

Installing IIS 7.x on Windows Server 2008 (R2)

By default, IIS 7.x is not installed on Windows Server® 2008 (R2). You can install IIS 7.x by using the Add Roles Wizard in Server Manager.

Platforms
  • IIS 7.0 associated with Windows Server 2008
  • IIS 7.5 associated with Windows Server 2008 R2 (Windows Server 7)

 Requirements

  • Administrative Credentials

You must be a member of the following IIS 7.x administrative role or roles to perform this procedure:

  • Server Administrator
To Install IIS 7.x on Windows Server 2008 / 7
  1. Click Start, point to Administrative Tools, and then click Server Manager.
  2. In Roles Summary, click Add Roles.
  3. Use the Add Roles Wizard to add the Web Server (IIS) role.
  4. IIS 6 Scripting tools are needed for automated installation. If you prefer complete all the steps manually, just leave it unticked.

Be sure next checkboxes checked

   

 Try to open http://localhost If you succeeded with installation you will see Welcome page as below:

 

Installing AxCMS_Sample IIS directories

Automated Installation

C:\Projects\AxCMS_Sample\Resources_Sample\Deploy folder contains CreateIIS.bat script which you can use for automated creation/recreation of IIS Virtual Directories. You should run it as Administrator. All you need before is installed IIS 7 with ASP.NET and IIS6 Scripting tools that was described above.

If you get errors (not warnings) during the install, proceed with manual installation that is described below.

 

Creating Virtual Directories

Open Internet Information Services (IIS) and create following Applications in the default web site on your computer:

  • AxCMSweb_Sample
  • AxCMSwebLive_Sample
  • AxCMSPublishService_Sample

Virtual directories must point to the folders with the same names under the root folder.


AxCMS.net 9 is compatible with both IntegratedMode and Classic .NET AppPool. So you may left DefaultAppPool or create a new Application Pool for AxCMS.net 9 application.


 

 

Authentication

Configuration of directory security depends on whether you want to use Active Directory integration or not.

If not, you must let anonymous authentication for IIS. The AxCMS.net uses its own user-authentication based on HTML-Forms-authentication. In some operations systems (e.g. Windows 2000) anonymous access is allowed per default, in some other (e.g. Windows XP, Windows 2003) not. Please allow anonymous access to Management System, to Live System and to Publish Service.

If you want to use Active Directory Integration, enable Windows Authentication, and disable Anonymous authentication (if anonymous access is enabled, Windows Authentication is ignored). Active Directory is only relevant for Management System. For the Live System and PublishService Anonymous Access is necessary.

You find these options in under Authentication as shown below

 

 

 Custom Extension

Please map your custom extension to aspnet_isapi.dll of Framework 2.0. 

The mapping for your page extension is entered in IIS (at Home Directory / Configuration).

  • For AxCMS_Sample it is by default .Sample
  • For AxCMS_PremiumSample it is .AxCMS

You can define this extension yourself. Then your pages are called for example http://company/Homepage.Sample. You have to enter the extension for two applications AxCMSweb_Sample and AxCMSwebLive_Sample.

  • For 32 bit system: %windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll
  • For 64 bit system: %windir%\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll

Easiest way is to copy aspnet_isapi.dll path from *.aspx handler.

HINT: Be careful with changing proposed extension ".Sample" to your custom extension. Then you must also change extension in ALL config files and run StartCreate.bat once again, that pages in CMS are created with new extension.


 

It will generate in Web.Config the next code:

<configuration>
          . . .
     <system.webServer>
          <
handlers>
               <
add name="AxCMS_Sample"
                       
path="*.Sample" verb="*" 
                       
modules="IsapiModule" 
                       
scriptProcessor="%windir%\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll" 
                       
resourceType="Unspecified" 
                       
preCondition="classicMode,runtimeVersionv2.0,bitness64" />
          </
handlers>
     </
system.webServer>        
</configuration>

 

Set default document

Please ensure that default documents are allowed and that default.aspx as entry exists for both AxCMSweb_Sample and AxCMSwebLive_Sample.

 

Templates directory

The Management System and the Live System have to access the custom development (AxCMSTemplates_Sample). Therefore it is needed to create virtual directories "templates" that point to folder "AxCMSTemplates_Sample".

Under AxCMSweb_Sample and AxCMSwebLive_Sample create a virtual subdirectory templates pointing to the folder AxCMSTemplates_Sample. Repeat these procedures under AxCMSweb_Sample/publish and AxCMSwebLive_Sample/publish (so you have 4 virtual directories templates all pointing to the folder AxCMSTemplates_Sample).


NOTE: If you setup AxCMS_PremiumSample and get 403 error after the setup while clicking "banner" or "recommend page" module, you may need to choose Add Application instead of Add Virtual Directory for templates Virtual Directory under the Live Environment. It is also possible to convert it by right clicking on templates - Convert to Application.

 

Silverlight MIME types

Microsoft® SilverlightTM is a cross-browser, cross-platform plug-in for delivering the next generation of .NET based media experiences and rich interactive applications for the Web. Silverlight supports fast, cost-effective delivery of high-quality video to all major browsers running on the Mac OS or Windows.

All MIME types needed to support Silverlight are implemented by default in Windows Server 2008 / 7 IIS 7 and Windows Vista SP1 / Windows 7.  Windows Vista RTM customers can add mime types by running "IIS Manager", clicking on "Mime Types", then clicking "add" and adding the following mime types:

  • .xaml    application/xaml+xml
  • .xap     application/x-silverlight-app
  • .xbap    application/x-ms-xbap