help.axcms.netAxinom Logo
Save Save Chapter Send Feedback

Getting Started under IIS 5.x

Installing IIS folders...


Installing IIS 5.x

  1. Platforms
  2. About IIS 5
  3. Installing IIS 5.x
  4. Installing ASP.NET 2.0

Installing AxCMS_Sample IIS directories

  1. Automated installation
  2. Creating virtual directories
  3. Directory Security
  4. Microsoft .NET Framework
  5. Custom Extension
  6. Set Default Document
  7. Templates Directory
  8. Silverlight MIME types



Installing IIS 5.x


  • IIS 5 - is associated with Windows 2000 (all versions)
  • IIS 5.1 - is associated with Windows XP Professional or Windows XP Media Center Edition

  • About IIS 5

    The IIS Versions designed for workstations (that is IIS5 in Windows 2000 Professional and IIS5.1 in Windows XP Professional) have limited functionality as compared with their server versions (IIS5 on Windows 2000 Server and IIS6 on Windows .NET Server). This limited functionality relates, for example, to a maximum of 10 concurrently handled HTTP requests, the possibility of running a single Web site only, lack of host IP-based access control list, no Connection Limit extension. Therefore, IIS workstations are not suitable for serving up fully functional web sites - this limitation continually triggers the irritating "403 Too many users" message, despite the fact that the logs show that there are fewer than 10.

    Installing IIS 5.x

    Before begin, make sure you have your Windows installation CD. If you received your computer from an OEM who did not provide you with an installation CD, contact them to find out where on your computer the original install files are stored.

    • Go to Start » Control Panel
      if you are using Classic style menu, go to Start » Settings » Control Panel
    • Double Click on Add or Remove Programs icon
    • Click on Add/Remove Windows Components
    • Windows Components Wizard appears; tick Internet Information Services (IIS) as shown. Then OK and Next


    Installing ASP.NET 2.0 9 has been developed for .NET Framework Versions 3.5 SP1. There is no such application type in IIS because ASP.NET 3.5 is enhancement of ASP.NET 2.0 and it is still based on the ASP.NET 2.0 core fundamental. So it is possible only to install ASP.NET 2.0 in IIS that you should do.

    Type in command prompt window (start - run - cmd)

    • C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis /i

    Try to open http://localhost If you are succeeded with installation you will see Under Construction 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. All you need before is installed IIS 5 and configured ASP.NET 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) from Start - Control Panel - Administrative Tools and create following virtual directories 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.





    Directory Security

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

    If not, you must let anonymous access for IIS. The 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 Integrated Windows Authentication, and disable Anonymous access (if anonymous access is enabled, Integrated 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 Internet Service Manager under „Directory Security".



     Microsoft .NET Framework 9 has been developed for .NET Framework Versions 3.5 SP1. There is no such application type in IIS because ASP.NET 3.5 is enhancement of ASP.NET 2.0 and it is still based on the ASP.NET 2.0 core fundamental. So you should choose ASP.NET 2.0 as runtime environment.





    Custom Extension

    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 the two applications AxCMSweb_Sample and AxCMSwebLive_Sample.



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

    The checkbox „Check that file exists“ must not be checked as the files doesn’t really exist respectively the files will be created on-the-fly by the CMS HttpHandler.

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

    Note: There is a bug in this dialogue within the IIS, which does possibly not permit to press the OK button. Should you come across it close the dialogue and then open it again. Enter the path to the aspnet_isapi.dll, enter the extension and click the OK button. In this sequence it works.


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


    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).

    Remove Web-Application from these virtual directories.




     NOTE: If you setup AxCMS_PremiumSample and get 403 error after the setup while clicking "banner" or "recommend page" module, you may need to tick also Run scripts (such as ASP) for templates Virtual Directory under the Live Environment.

    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.

    There are 3 MIME types required for 9

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

    To add the MIME types do next:

    1. Go to Start\Administrative Tools and run Internet Information Services

    2. Expand Web Sites tree and navigate appropriate AxCMS site(s). In our case it is "Default Web Site" Right click on the site name and select "Properties", see figure below:

    3. In the Properties dialog click the "HTTP headers" from the upper menu and there "File Types".

    4.  In the "File Types" Dialog, click the "New Type" button.

    5. In the "File Type" Dialog enter one MIME Type at the time:

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

    see figure below: