Getting Started under IIS 6.0

Transcription

1 Getting Started under IIS 6.0 Installing IIS folders... Installing IIS Platforms Installing IIS 6.0 Installing ASP.NET 2.0 Installing AxCMS_Sample IIS directories Automated Installation Creating virtual directories Directory Security Microsoft.NET Framework Application Pool Custom Extension Set Default Document Templates Directory Silverlight MIME types Installing IIS 6.0 Platforms Windows Server or 64 bit Windows XP x64 Edition Installing IIS 6.0 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. If you have Windows XP x64 then tick Internet Information Services (IIS), if you have Windows Server 2003 then tick Application Server as shown on picture. Then OK and Next C:\WINDOWS\Microsoft.NET\Framework\v \aspnet_regiis /i if you have 64 bit system, then C:\WINDOWS\Microsoft.NET\Framework64\v \aspnet_regiis /i After install you should enable ASP.NET 2.0 under Web Service Extensions (only for IIS 6)

2 Try to open If you succeeded with installation you will see Under Construction page as below:

3 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 6 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

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

5

6 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 AxCMS.net uses its own user-authentication based on HTML-Formsauthentication. 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 AxCMS.net 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.

7 Application Pool If you are using different.net Framework Versions in IIS 6, make sure to keep the 1.1 Versions in a different Application Pool as the 2.0 Versions: In your IIS Manager go to the Server > Application Pools. Right click there, select New > Application Pool... Choose a name, e.g. "Framework_2_0" and select default settings. In your website and virtual directory right click and choose Properties. Go to the tab Home Directory. In the Application Pool dropdown select your newly created application pool. Click OK. Repeat this step for all 2.0 Framework based applications.

8 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 You have to enter the extension for the two applications AxCMSweb_Sample and AxCMSwebLive_Sample. Please map your custom extension to aspnet_isapi.dll of Framework 2.0. For 32 bit system: C:\Windows\Microsoft.NET\Framework\v \aspnet_isapi.dll For 64 bit system: C:\Windows\Microsoft.NET\Framework64\v \aspnet_isapi.dll Easiest way is to copy aspnet_isapi.dll path from *.aspx handler. The checkbox Verify that file exists must not be checked as the files doesn t really exist respectively the files will be created onthe-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.

9 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. Set default document Please ensure that default documents are allowed and that default.aspx as entry exists for both AxCMSweb_Sample and AxCMSwebLive_Sample.

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

11

12

13 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 AxCMS.net 9.xaml.xap.xbap application/xaml+xml application/x-silverlight-app application/x-ms-xbap To add the MIME types do next: 1. Go to Start\Administrative Tools and run IIS Manager 2. Right click on the server name and select "Properties", see figure below:

14 3. In the Properties Dialog, click on the "MIME Types" button.

15 4. In the "MIME Types" Dialog, click the "New" button. 5. In the "MIME Type" Dialog enter one MIME Type at the time:.xap.xaml.xbap application/x-silverlight-app application/xaml+xml application/x-ms-xbap see figure below: