Getting Started under IIS 7.x

Transcription

1 Getting Started under IIS 7.x Installing IIS folders... Installing IIS 7.x on Windows Vista / Platforms Windows Editions Supported Requirements To Install IIS 7.x on Windows Vista / Windows 7 Installing IIS 7.x on Windows Server 2008 / Windows Server Platforms Requirements To Install IIS 7.x on Windows Server 2008 / 7 Installing AxCMS_Sample IIS directories Automated Installation Creating Virtual Directories Authentication Custom Extension Set default document 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 Windows Vista (Home Premium, Business, Enterprise, Ultimate Editions) IIS 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

2 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 / Click Start and then click Control Panel. In Control Panel, click Programs and then click Turn on or off Windows features. 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 Microsoft.NET Framework 3.5 SP1 with WCF should be added from Turn on or off Windows features (for Windows 7). 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 / Click Start, point to Administrative Tools, and then click Server Manager. In Roles Summary, click Add Roles. Use the Add Roles Wizard to add the Web Server (IIS) role. 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

3

4

5 Try to open 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.

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

7 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 You have to enter the extension for two applications AxCMSweb_Sample and AxCMSwebLive_Sample. For 32 bit system: %windir%\microsoft.net\framework\v \aspnet_isapi.dll For 64 bit system: %windir%\microsoft.net\framework64\v \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.

8

9 It will generate in Web.Config the next code: <configuration>...

10 <system.webserver> <handlers> <add name="axcms_sample" path="*.sample" verb="*" modules="isapimodule" scriptprocessor="%windir%\microsoft.net\framework64\v \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.

11 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.xap.xbap application/xaml+xml application/x-silverlight-app application/x-ms-xbap

12