diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 65324dcd3..ef617e071 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -55,11 +55,6 @@ "redirect_url": "/troubleshoot/developer/webapps/iis/health-diagnostic-performance/troubleshoot-native-memory-leak-iis-7x-application-pool", "redirect_document_id": false }, - { - "source_path": "iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md", - "redirect_url": "/troubleshoot/developer/webapps/iis/iis-extensions-tools-addons/troubleshooting-problems-with-microsoft-web-platform-installer", - "redirect_document_id": false - }, { "source_path": "iis/troubleshoot/using-failed-request-tracing/troubleshooting-failed-requests-using-tracing-in-iis-85.md", "redirect_url": "/troubleshoot/developer/webapps/iis/health-diagnostic-performance/troubleshoot-failed-requests-using-tracing-in-iis-85", @@ -70,11 +65,6 @@ "redirect_url": "/troubleshoot/developer/webapps/iis/www-authentication-authorization/troubleshooting-forms-authentication", "redirect_document_id": false }, - { - "source_path": "iis/troubleshoot/using-failed-request-tracing/troubleshoot-with-failed-request-tracing.md", - "redirect_url": "/troubleshoot/developer/webapps/iis/health-diagnostic-performance/troubleshoot-php-with-failed-request-tracing", - "redirect_document_id": false - }, { "source_path": "iis/troubleshoot/diagnosing-http-errors/troubleshooting-http-5022-bad-gateway-error-in-cgi-applications.md", "redirect_url": "/troubleshoot/developer/webapps/iis/health-diagnostic-performance/troubleshoot-502-2-bad-gateway-error-in-cgi-apps", @@ -125,11 +115,6 @@ "redirect_url": "/previous-versions/troubleshoot/iis/troubleshoot-smb-netbios-fcn-limit-issues", "redirect_document_id": false }, - { - "source_path": "iis/develop/troubleshooting-webmatrix/webmatrix-publish-and-download-troubleshooting.md", - "redirect_url": "/previous-versions/troubleshoot/iis/webmatrix-publish-and-download-troubleshooting", - "redirect_document_id": false - }, { "source_path": "iis/application-frameworks/building-and-running-aspnet-applications/index.md", "redirect_url": "/iis/application-frameworks/building-and-running-aspnet-applications/using-aspnet-forms-authentication", @@ -140,36 +125,11 @@ "redirect_url": "/iis/application-frameworks/building-and-running-aspnet-applications", "redirect_document_id": false }, - { - "source_path": "iis/application-frameworks/install-and-configure-php-applications-on-iis/index.md", - "redirect_url": "/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis", - "redirect_document_id": false - }, - { - "source_path": "iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis.md", - "redirect_url": "/iis/", - "redirect_document_id": false - }, - { - "source_path": "iis/application-frameworks/install-and-configure-php-on-iis/index.md", - "redirect_url": "/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60", - "redirect_document_id": false - }, { "source_path": "iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/index.md", "redirect_url": "/iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/classic-asp-not-installed-by-default-on-iis", "redirect_document_id": false }, - { - "source_path": "iis/application-frameworks/running-php-applications-on-iis/index.md", - "redirect_url": "/iis/application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above", - "redirect_document_id": false - }, - { - "source_path": "iis/application-frameworks/scenario-build-a-php-website-on-iis/index.md", - "redirect_url": "/iis/application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis", - "redirect_document_id": false - }, { "source_path": "iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/index.md", "redirect_url": "/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis", @@ -195,36 +155,16 @@ "redirect_url": "/iis/develop/runtime-extensibility", "redirect_document_id": false }, - { - "source_path": "iis/develop/installingpublishing-apps-with-webmatrix/index.md", - "redirect_url": "/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq", - "redirect_document_id": false - }, { "source_path": "iis/develop/runtime-extensibility/index.md", "redirect_url": "/iis/develop/runtime-extensibility/extending-web-server-functionality-in-net", "redirect_document_id": false }, - { - "source_path": "iis/develop/troubleshooting-webmatrix/index.md", - "redirect_url": "/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility", - "redirect_document_id": false - }, { "source_path": "iis/develop/using-visual-studio-with-iis/index.md", "redirect_url": "/iis/develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis", "redirect_document_id": false }, - { - "source_path": "iis/develop/using-webmatrix/index.md", - "redirect_url": "/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application", - "redirect_document_id": false - }, - { - "source_path": "iis/develop/windows-web-application-gallery/index.md", - "redirect_url": "/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery", - "redirect_document_id": false - }, { "source_path": "iis/extensions/advanced-logging-module/index.md", "redirect_url": "/iis/extensions/advanced-logging-module/advanced-logging-for-iis-custom-logging", @@ -310,16 +250,6 @@ "redirect_url": "/iis/extensions/web-deployment-tool/iis-web-deployment-tool", "redirect_document_id": false }, - { - "source_path": "iis/extensions/web-platform-installer/index.md", - "redirect_url": "/iis/extensions/web-platform-installer/microsoft-web-platform-installer", - "redirect_document_id": false - }, - { - "source_path": "iis/extensions/working-with-urlscan/index.md", - "redirect_url": "/iis/extensions/working-with-urlscan/urlscan-setup", - "redirect_document_id": false - }, { "source_path": "iis/get-started/case-studies/index.md", "redirect_url": "/iis/get-started/case-studies/case-study-iis-80-scaling-on-an-hp-proliant-dl980-g7-8-processor-socket-system", @@ -405,11 +335,6 @@ "redirect_url": "/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy", "redirect_document_id": false }, - { - "source_path": "iis/install/web-platform-installer/index.md", - "redirect_url": "/iis/install/web-platform-installer/web-platform-installer-20-walkthrough", - "redirect_document_id": false - }, { "source_path": "iis/manage/configuring-security/index.md", "redirect_url": "/iis/manage/configuring-security/configuring-ssl-in-iis-manager", @@ -535,11 +460,6 @@ "redirect_url": "/iis/troubleshoot/using-failed-request-tracing/how-to-enable-failed-request-tracing-for-unc-hosting", "redirect_document_id": false }, - { - "source_path": "iis/troubleshoot/web-platform-installer-issues/index.md", - "redirect_url": "/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer", - "redirect_document_id": false - }, { "source_path": "iis/web-dev-reference/index.md", "redirect_url": "/iis/web-dev-reference/server-variables", @@ -585,11 +505,6 @@ "redirect_url": "/iis/web-hosting/installing-infrastructure-components/planning-the-deployment", "redirect_document_id": false }, - { - "source_path": "iis/web-hosting/joining-the-web-hosting-gallery/index.md", - "redirect_url": "/iis/web-hosting/joining-the-web-hosting-gallery/servervalidator-demo", - "redirect_document_id": false - }, { "source_path": "iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/index.md", "redirect_url": "/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/overview-of-the-web-farm-framework-20-for-iis", diff --git a/iis/TOC.yml b/iis/TOC.yml index 95faf7e62..e28645bf2 100644 --- a/iis/TOC.yml +++ b/iis/TOC.yml @@ -194,18 +194,6 @@ href: install/installing-publishing-technologies/installing-and-configuring-webdav-on-iis.md - name: Installing and Configuring Web Deploy on IIS 8.0 or Later href: install/installing-publishing-technologies/installing-and-configuring-web-deploy-on-iis-80-or-later.md - - name: Web Platform Installer - items: - - name: Web Platform Installer 2.0 Walkthrough - href: install/web-platform-installer/web-platform-installer-20-walkthrough.md - - name: Using the Microsoft Web Platform Installer - href: install/web-platform-installer/using-the-microsoft-web-platform-installer.md - - name: Web Platform Installer Resources - href: install/web-platform-installer/web-platform-installer-resources.md - - name: Web Platform Installer v5 Command Line (WebPICMD.exe) - RTW release - href: install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release.md - - name: Web Platform Installer Direct Downloads - href: install/web-platform-installer/web-platform-installer-direct-downloads.md - name: Installing IIS 8.5 items: - name: Installing IIS 8.5 on Windows Server 2012 R2 @@ -294,10 +282,6 @@ href: manage/configuring-security/analyzing-client-usage-data-with-iis-user-access-logging.md - name: Configure Request Filtering in IIS href: manage/configuring-security/configure-request-filtering-in-iis.md - - name: IIS 8 - Certificate Management and Deployment - href: manage/configuring-security/iis-8-certificate-management-and-deployment.md - - name: IIS 8 - Sandboxing and Security - href: manage/configuring-security/iis-8-sandboxing-and-security.md - name: Managing Performance Settings items: - name: Improving Performance with Native Output Caching @@ -446,136 +430,6 @@ href: develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md - name: Using Visual Studio 2005 with IIS 7.0 href: develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md - - name: Windows Web Application Gallery - items: - - name: Package an Application for the Windows Web Application Gallery - href: develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md - - name: Windows Web Application Gallery Link Addition Process Walkthrough - href: develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough.md - - name: Windows Web Application Gallery Principles - href: develop/windows-web-application-gallery/windows-web-application-gallery-principles.md - - name: Introducing the Windows Web Application Gallery - href: develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md - - name: Integrate the Windows Web Application Gallery into a Control Panel - href: develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md - - name: "Windows Web Application Gallery: Known Issues" - href: develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md - - name: Using the Microsoft Web Platform Installer Badge - href: develop/windows-web-application-gallery/using-the-microsoft-web-platform-installer-badge.md - - name: Database Notes for packaging applications for the Web Application Gallery - href: develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md - - name: Reference for the Web Application Package - href: develop/windows-web-application-gallery/reference-for-the-web-application-package.md - - name: Testing a Zip Package for Inclusion with the Web Application Gallery - href: develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md - - name: How to Create an App Package Supporting both SQL Server and MySQL - href: develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql.md - - name: Azure App Gallery FAQ - href: develop/windows-web-application-gallery/azure-app-gallery-faq.yml - - name: Joomla! Sample files - href: develop/windows-web-application-gallery/joomla-sample-files.md - - name: Blogengine .NET Sample files - href: develop/windows-web-application-gallery/blogengine-net-sample-files.md - - name: Gallery Server Pro sample files - href: develop/windows-web-application-gallery/gallery-server-pro-sample-files.md - - name: Windows Web App Gallery FAQ - href: develop/windows-web-application-gallery/frequently-asked-questions.yml - - name: MediaWiki Sample Files - href: develop/windows-web-application-gallery/mediawiki-sample-files.md - - name: Umbraco CMS Sample files - href: develop/windows-web-application-gallery/umbraco-cms-sample-files.md - - name: WordPress Sample files - href: develop/windows-web-application-gallery/wordpress-sample-files.md - - name: Installing/Publishing Apps with WebMatrix - items: - - name: Acquia Drupal FAQ - href: develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq.md - - name: AtomSite FAQ - href: develop/installingpublishing-apps-with-webmatrix/atomsite-faq.md - - name: BlogEngine.NET FAQ - href: develop/installingpublishing-apps-with-webmatrix/blogenginenet-faq.yml - - name: dasBlog FAQ - href: develop/installingpublishing-apps-with-webmatrix/dasblog-faq.yml - - name: DotNetNuke ® Community Edition FAQ - href: develop/installingpublishing-apps-with-webmatrix/dotnetnuke-community-edition-faq.md - - name: Gallery FAQ - href: develop/installingpublishing-apps-with-webmatrix/gallery-faq.yml - - name: Gallery Server Pro FAQ - href: develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq.yml - - name: Joomla! FAQ - href: develop/installingpublishing-apps-with-webmatrix/joomla-faq.md - - name: Kentico CMS FAQ - href: develop/installingpublishing-apps-with-webmatrix/kentico-cms-faq.md - - name: Kooboo CMS FAQ - href: develop/installingpublishing-apps-with-webmatrix/kooboo-cms-faq.yml - - name: Mayando FAQ - href: develop/installingpublishing-apps-with-webmatrix/mayando-faq.md - - name: mojoPortal FAQ - href: develop/installingpublishing-apps-with-webmatrix/mojoportal-faq.yml - - name: Moodle FAQ - href: develop/installingpublishing-apps-with-webmatrix/moodle-faq.yml - - name: My Web Pages Starter Kit FAQ - href: develop/installingpublishing-apps-with-webmatrix/my-web-pages-starter-kit-faq.yml - - name: nopCommerce FAQ - href: develop/installingpublishing-apps-with-webmatrix/nopcommerce-faq.yml - - name: nService FAQ - href: develop/installingpublishing-apps-with-webmatrix/nservice-faq.md - - name: phpBB FAQ - href: develop/installingpublishing-apps-with-webmatrix/phpbb-faq.md - - name: ResourceBlender.NET FAQ - href: develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq.yml - - name: ScrewTurn Wiki FAQ - href: develop/installingpublishing-apps-with-webmatrix/screwturn-wiki-faq.yml - - name: SilverStripe CMS FAQ - href: develop/installingpublishing-apps-with-webmatrix/silverstripe-cms-faq.yml - - name: Sitefinity Community Edition FAQ - href: develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq.yml - - name: Subtext FAQ - href: develop/installingpublishing-apps-with-webmatrix/subtext-faq.yml - - name: SugarCRM FAQ - href: develop/installingpublishing-apps-with-webmatrix/sugarcrm-faq.yml - - name: Umbraco CMS FAQ - href: develop/installingpublishing-apps-with-webmatrix/umbraco-cms-faq.yml - - name: WordPress FAQ - href: develop/installingpublishing-apps-with-webmatrix/wordpress-faq.md - - name: Using WebMatrix - items: - - name: Create a Website from a Gallery Application - href: develop/using-webmatrix/create-a-website-from-a-gallery-application.md - - name: Download and Install an ASP.NET Application - href: develop/using-webmatrix/download-and-install-an-aspnet-application.md - - name: Download and Install a PHP Application - href: develop/using-webmatrix/download-and-install-a-php-application.md - - name: Make your Website SEO Friendly - href: develop/using-webmatrix/make-your-website-seo-friendly.md - - name: Analyze Requests to Your Website - href: develop/using-webmatrix/analyze-requests-to-your-website.md - - name: Publish Your Website - href: develop/using-webmatrix/publish-your-website.md - - name: WebMatrix Overview - href: develop/using-webmatrix/webmatrix-overview.md - - name: WebMatrix Privacy Statement - href: develop/using-webmatrix/webmatrix-privacy-statement.md - - name: Creating a Content Feed for Learning - href: develop/using-webmatrix/creating-a-content-feed-for-learning.md - - name: Troubleshooting WebMatrix - items: - - name: "Microsoft WebMatrix: Publish Compatibility" - href: develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility.md - - name: "Microsoft WebMatrix: Certificate errors during publishing" - href: develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing.md - - name: "Microsoft WebMatrix: Database errors while publishing and downloading sites" - href: develop/troubleshooting-webmatrix/microsoft-webmatrix-database-errors-while-publishing-and-downloading-sites.md - - name: "Microsoft WebMatrix: My Documents on network shares" - href: develop/troubleshooting-webmatrix/microsoft-webmatrix-my-documents-on-network-shares.md - - name: When publishing a site from WebMatrix, some files are not listed in the dialog - href: develop/troubleshooting-webmatrix/when-publishing-a-site-from-webmatrix-using-the-ftp-protocol-some-files-are-not-listed-in-the-publish-preview-dialog.md - - name: WebMatrix Publish and Download Troubleshooting - href: develop/troubleshooting-webmatrix/webmatrix-publish-and-download-troubleshooting.md - - name: WebMatrix MDF Migration - href: develop/troubleshooting-webmatrix/webmatrix-mdf-migration.md - - name: Issues with SQL Server Express or MySQL when using WebMatrix or WebPI - href: develop/troubleshooting-webmatrix/issues-with-sql-server-express-or-mysql-when-using-webmatrix-or-webpi_1298.md - name: Developing for FTP items: - name: How to Use Managed Code (C#) to Create a Simple FTP Authentication Provider @@ -606,28 +460,6 @@ href: develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-prevents-leeching.md - name: Publish items: - - name: Deploying Application Packages - items: - - name: Taking an Application Offline before Publishing - href: publish/deploying-application-packages/taking-an-application-offline-before-publishing.md - - name: "Videocast: Simplified Application Deployment on the Microsoft Web Platform" - href: publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform.md - - name: Provision an IIS Web Site in a Hosting Environment - href: publish/deploying-application-packages/provision-an-iis-web-site-in-a-hosting-environment.md - - name: DotNetNuke - href: publish/deploying-application-packages/dotnetnuke.md - - name: ScrewTurn Wiki - href: publish/deploying-application-packages/screwturn-wiki.md - - name: BlogEngine.NET - href: publish/deploying-application-packages/blogenginenet.md - - name: Umbraco - href: publish/deploying-application-packages/umbraco.md - - name: Deploying WordPress via Packages in a Hosting Environment - href: publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment.md - - name: Deploying Joomla! via Packages in a Hosting Environment - href: publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment.md - - name: Deploying Drupal via Packages in a Hosting Environment - href: publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment.md - name: Using Web Deploy items: - name: Packaging and Restoring a Web site @@ -642,8 +474,6 @@ href: publish/using-web-deploy/synchronize-iis-60-web-sites.md - name: Synchronize IIS href: publish/using-web-deploy/synchronize-iis.md - - name: Synchronizing Two IIS Servers with PHP - href: publish/using-web-deploy/synchronizing-two-iis-servers-with-php.md - name: Export a Package through IIS Manager href: publish/using-web-deploy/export-a-package-through-iis-manager.md - name: Import a Package through IIS Manager @@ -788,10 +618,6 @@ items: - name: Diagnosing Failures with Remote Administration href: troubleshoot/remote-administration-issues/diagnosing-failures-with-remote-administration.md - - name: Web Platform Installer Issues - items: - - name: Troubleshooting Problems with Microsoft Web Platform Installer - href: troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md - name: Windows Client OS Request Restriction items: - name: IIS Request Restrictions on Windows Client OS @@ -885,8 +711,6 @@ href: extensions/url-rewrite-module/creating-rewrite-rules-for-the-url-rewrite-module.md - name: URL Rewrite Module Configuration Reference href: extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md - - name: Enabling Pretty Permalinks in WordPress - href: extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md - name: Using Failed Request Tracing to Trace Rewrite Rules href: extensions/url-rewrite-module/using-failed-request-tracing-to-trace-rewrite-rules.md - name: Using Global and Distributed Rewrite Rules @@ -1045,26 +869,6 @@ href: extensions/database-manager/working-with-stored-procedures.md - name: Working with Tables href: extensions/database-manager/working-with-tables.md - - name: Working with UrlScan - items: - - name: UrlScan Setup - href: extensions/working-with-urlscan/urlscan-setup.md - - name: Common UrlScan Scenarios - href: extensions/working-with-urlscan/common-urlscan-scenarios.md - - name: UrlScan FAQ - href: extensions/working-with-urlscan/urlscan-faq.yml - - name: Data Mining UrlScan 3 Logs using LogParser 2.2 - href: extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22.md - - name: UrlScan Overview - href: extensions/working-with-urlscan/urlscan-overview.md - - name: UrlScan 1 Reference - href: extensions/working-with-urlscan/urlscan-1-reference.md - - name: UrlScan 2 Reference - href: extensions/working-with-urlscan/urlscan-2-reference.md - - name: UrlScan 3 Reference - href: extensions/working-with-urlscan/urlscan-3-reference.md - - name: Overview of UrlScan Versions - href: extensions/working-with-urlscan/overview-of-urlscan-versions.md - name: HttpPlatformHandler items: - name: HttpPlatformHandler Configuration Reference @@ -1120,138 +924,6 @@ href: application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/classic-asp-applications-on-iis-overview.md - name: "Scenario: Build a Classic ASP Website on IIS" href: application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md - - name: Install and Configure PHP on IIS - items: - - name: Configuring the FastCGI Extension for IIS 6.0 - href: application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60.md - - name: Installing PHP on Windows Vista with FastCGI - href: application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md - - name: Setting Up a Database for a PHP Application on IIS - href: application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md - - name: Install PHP and FastCGI Support on Server Core - href: application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md - - name: Install and Configure MySQL for PHP Applications on IIS 7 - href: application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md - - name: Walkthrough - Set Up MySQL 5.1 for PHP applications - href: application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications.md - - name: Install the SQL Server Driver for PHP - href: application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php.md - - name: Enable FastCGI Support in IIS 7 on Windows - href: application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7.md - - name: Install and Configure SQL Server 2008 for PHP Applications on IIS 7 - href: application-frameworks/install-and-configure-php-on-iis/install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above.md - - name: Install and Configure PHP - href: application-frameworks/install-and-configure-php-on-iis/install-and-configure-php.md - - name: How to Install the Microsoft Web Platform for PHP - href: application-frameworks/install-and-configure-php-on-iis/how-to-install-the-microsoft-web-platform-for-php.md - - name: Using PHP Manager for IIS to setup and configure PHP - href: application-frameworks/install-and-configure-php-on-iis/using-php-manager-for-iis-to-setup-and-configure-php.md - - name: Use the Windows Cache Extension for PHP - href: application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php.md - - name: Enable Per-Site PHP Configuration on IIS 7 and IIS 6.0 - href: application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above.md - - name: Create a Separate Site or Virtual Directory for PHP Content - href: application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content.md - - name: Configure SMTP E-Mail in IIS 7 - href: application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above.md - - name: How to Configure and Optimize the Microsoft Web Platform for PHP - href: application-frameworks/install-and-configure-php-on-iis/how-to-configure-and-optimize-the-microsoft-web-platform-for-php.md - - name: Run Multiple Versions of PHP on IIS - href: application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis.md - - name: Improve PHP Error Messages in IIS 7 - href: application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above.md - - name: How to Manage and Administer the Microsoft Web Platform - href: application-frameworks/install-and-configure-php-on-iis/how-to-manage-and-administer-the-microsoft-web-platform.md - - name: Secure Your SQL Server Database - href: application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database.md - - name: Secure Content in IIS Through Impersonation - href: application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation.md - - name: Secure PHP with Configuration Settings - href: application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings.md - - name: Secure Your Infrastructure and PHP Applications - href: application-frameworks/install-and-configure-php-on-iis/secure-your-infrastructure-and-php-applications.md - - name: How to Secure the Microsoft Web Platform - href: application-frameworks/install-and-configure-php-on-iis/how-to-secure-the-microsoft-web-platform.md - - name: Enable PHP Applications to Make Application-Level Access Control Decisions - href: application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions.md - - name: Install and Configure PHP Applications on IIS - items: - - name: Advanced Poll on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis.md - - name: b2Evolution on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis.md - - name: Coppermine on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis.md - - name: Crafty Syntax Live Help on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis.md - - name: Gallery2 on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis.md - - name: Geeklog on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis.md - - name: Mambo on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis.md - - name: Install WordPress on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis.md - - name: XOOPS on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis.md - - name: MediaWiki on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis.md - - name: Install osCommerce on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis.md - - name: PHPNuke on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis.md - - name: Install Zen Cart on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis.md - - name: CubeCart on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis.md - - name: ExpressionEngine on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis.md - - name: LimeSurvey on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis.md - - name: OpenAds on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis.md - - name: PHPList on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis.md - - name: Siteframe on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis.md - - name: PHPWCMS on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis.md - - name: pMachinePro on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis.md - - name: Install Drupal on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis.md - - name: Install Joomla! on IIS - href: application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis.md - - name: Using FastCGI to Host PHP Applications on IIS 7 - href: application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md - - name: Using FastCGI to Host PHP Applications on IIS 6.0 - href: application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md - - name: Translate .htaccess Content to IIS web.config - href: application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md - - name: Provide URL Rewriting Functionality - href: application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality.md - - name: How to Deploy Applications on the Microsoft Web Platform for PHP - href: application-frameworks/install-and-configure-php-applications-on-iis/how-to-deploy-applications-on-the-microsoft-web-platform-for-php.md - - name: Running PHP Applications on IIS - items: - - name: "MIX08: Partying with PHP on Microsoft Internet Information Services 7" - href: application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above.md - - name: Set Up FastCGI for PHP - href: application-frameworks/running-php-applications-on-iis/set-up-fastcgi-for-php.md - - name: Build a High-Performance PHP Stack with Windows IIS and Zend Server - href: application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server.md - - name: Configure PHP Process Recycling Behavior - href: application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior.md - - name: Best Practices for PHP on the Microsoft Web Platform - href: application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md - - name: Provision Web Sites for PHP Applications Using Managed Code - href: application-frameworks/running-php-applications-on-iis/provision-web-sites-for-php-applications-using-managed-code.md - - name: Develop on IIS 7 - href: application-frameworks/running-php-applications-on-iis/develop-on-iis-7-and-above.md - - name: Enable PHP Syntax Highlighting on IIS 7 - href: application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above.md - - name: How to Develop on the Microsoft Web Platform - href: application-frameworks/running-php-applications-on-iis/how-to-develop-on-the-microsoft-web-platform.md - name: "Scenario: Build an ASP.NET Website on IIS" items: - name: "Overview: Build an ASP.NET Website on IIS" @@ -1276,26 +948,6 @@ href: application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-3-configure-data-source-settings.md - name: "Configuring Step 4: Configure Application Security" href: application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-4-configure-application-security.md - - name: "Scenario: Build a PHP Website on IIS" - items: - - name: "Overview: Build a PHP Website on IIS" - href: application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md - - name: Plan a PHP Website on IIS - href: application-frameworks/scenario-build-a-php-website-on-iis/plan-a-php-website-on-iis.md - - name: "Planning Step 1: Plan IIS Web Server and PHP Installation" - href: application-frameworks/scenario-build-a-php-website-on-iis/planning-step-1-plan-iis-web-server-and-php-installation.md - - name: "Planning Step 2: Plan PHP Settings" - href: application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings.md - - name: "Planning Step 3: Plan PHP Application Security" - href: application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security.md - - name: Configure a PHP Website on IIS - href: application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis.md - - name: "Configuring Step 1: Install IIS and PHP" - href: application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php.md - - name: "Configuring Step 2: Configure PHP Settings" - href: application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-2-configure-php-settings.md - - name: "Configuring Step 3: Configure PHP Application Security" - href: application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security.md - name: Web Hosting items: - name: Getting Started @@ -1332,8 +984,6 @@ href: web-hosting/frequently-asked-questions-faq/general-iis7-questions.yml - name: .NET Questions href: web-hosting/frequently-asked-questions-faq/net-questions.yml - - name: PHP Questions - href: web-hosting/frequently-asked-questions-faq/php-questions.md - name: Sales and Marketing Questions href: web-hosting/frequently-asked-questions-faq/sales-and-marketing-questions.md - name: Top 10 Changes in IIS 7.0 @@ -1394,8 +1044,6 @@ href: web-hosting/configuring-servers-in-the-windows-web-platform/windows-sharepoint-services-for-shared-hosting.md - name: Guide to Deploy FTP and Publish with VWD href: web-hosting/configuring-servers-in-the-windows-web-platform/guide-to-deploy-ftp-and-publish-with-vwd.md - - name: Microsoft Web Platform Installer 2.0 - href: web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md - name: Dynamic Data Center Toolkit for Hosting href: web-hosting/configuring-servers-in-the-windows-web-platform/dynamic-data-center-toolkit-for-hosting.md - name: SQL Server 2005 @@ -1434,8 +1082,6 @@ href: web-hosting/verifying-the-deployment/verifying-remote-administration.md - name: Verifying the Developer Experience - ASP.NET href: web-hosting/verifying-the-deployment/verifying-the-developer-experience-aspnet.md - - name: Verifying the Developer Experience - PHP - href: web-hosting/verifying-the-deployment/verifying-the-developer-experience-php.md - name: Web Server For Shared Hosting items: - name: ASP.NET 2.0/3.5 Shared Hosting Configuration @@ -1448,12 +1094,8 @@ href: web-hosting/web-server-for-shared-hosting/smb-commands-registry-keys_198.md - name: Create a Backup with appcmd href: web-hosting/web-server-for-shared-hosting/create-a-backup-with-appcmd.md - - name: FastCGI with PHP - href: web-hosting/web-server-for-shared-hosting/fastcgi-with-php.md - name: ASP href: web-hosting/web-server-for-shared-hosting/asp.md - - name: Configuring IIS for Silverlight Applications - href: web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md - name: URL Rewrite for Hosting Providers href: web-hosting/web-server-for-shared-hosting/url-rewrite-for-hosting-providers.md - name: Database Manager for Hosters @@ -1520,30 +1162,6 @@ items: - name: Managing IIS on Windows Azure via Remote Desktop href: web-hosting/hosting-the-microsoft-web-platform-on-windows-azure/managing-iis-on-windows-azure-via-remote-desktop.md - - name: Joining the Web Hosting Gallery - items: - - name: ServerValidator Demo - href: web-hosting/joining-the-web-hosting-gallery/servervalidator-demo.md - - name: Microsoft Web Platform Hosting Program -Pilot - href: web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot.md - - name: Overview - href: web-hosting/joining-the-web-hosting-gallery/overview.md - - name: Install Server Components - href: web-hosting/joining-the-web-hosting-gallery/install-server-components.md - - name: Validate Your Server Configuration - href: web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md - - name: Create Welcome E-mails - href: web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails.md - - name: Generate a Profile XML File - href: web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file.md - - name: Configure Site for Web Deploy Publishing - href: web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md - - name: Automating server setup - href: web-hosting/joining-the-web-hosting-gallery/automating-server-setup.md - - name: Setup MySQL with WebMatrix Support - href: web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support.md - - name: How WebMatrix Verification Works - href: web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works.md - name: "Scenario: Build a Web Farm with IIS Servers" items: - name: "Overview: Build a Web Farm with IIS Servers" diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis.md deleted file mode 100644 index b0b223440..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: "Advanced Poll on IIS" -author: rick-anderson -description: "Advanced Poll is a polling system with a powerful administration tool. It features: multiple pools, templates, unlimited options, multi-language support, IP-..." -ms.date: 12/18/2007 -ms.assetid: f4b67492-0c6c-42b3-afa5-2963f9b25c98 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis -msc.type: authoredcontent ---- -# Advanced Poll on IIS - -by Eric Woersching - -## Introduction - -Advanced Poll is a polling system with a powerful administration tool. It features: multiple pools, templates, unlimited options, multi-language support, IP-Logging, IP-Locking, cookie support, comment feature, vote expire feature, random poll support and more. Advanced Poll supports data in text files and MySQL databases. For more information about Advanced Poll, see [http://www.proxy2.de/scripts.php](http://www.proxy2.de/scripts.php). - -The following sections describe how to install and configure Advanced Poll for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described here: [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Notes on PHP Setup - -Advanced Poll does not need many modifications beyond the default configuration provided by PHP **.** From the base configuration file provided by PHP, you only need to modify the following lines in your php.ini configuration file to get Advanced Poll to work: - -- Define `extension\_dir` as `c:\php\ext` (i.e., the location of your php extensions directory) -- Uncomment 'extension=php\_mysql.dll' in the extensions list to enable MySQL support - -## Download and Unpack the Application - -First, download the latest stable release of Advanced Poll. For this article, we use Advanced Poll 2.0.8. Download it from [here](http://www.proxy2.de/scripts.php). Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\advancedpoll`. - -## Set Up the Database - -Advanced Poll supports both text files and mySQL as the backend data repository. Here, we use the MySQL database option. These instructions assume that you already have MySQL installed and running. - -Before starting the installation procedure for AdvancedPoll, you must create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'advancedpoll' -- Database User: 'advancedpoll' -- Account Password: 'advancedpoll' - -## Set Up and Configure the Application - -1. Open the configuration file **Configu.inc.php** with a text editor, and set your database settings: - - [!code-powershell[Main](advanced-poll-on-iis/samples/sample1.ps1)] -2. Call the install script from your browser `http://localhost/advancedpoll/install.php`, and follow the setup instructions. - [![Screenshot that shows the welcome page of the installation wizard.](advanced-poll-on-iis/_static/image2.png)](advanced-poll-on-iis/_static/image1.png) - -All the necessary database tables are created. - -## Test the Advanced Poll Application - -To test that Advanced Poll has been installed successfully, use the built-in demonstration polls as illustrated in the following screenshots. - -[![Screenshot that shows the demonstration polls.](advanced-poll-on-iis/_static/image4.png)](advanced-poll-on-iis/_static/image3.png) - -Create a poll and view it as a site visitor would. Follow these steps: - -1. Navigate to `http://localhost/advancedpoll/admin`. -2. Enter the *administrator user name* and *password* created in the last installation step. - [![Screenshot that shows the poll list.](advanced-poll-on-iis/_static/image6.png)](advanced-poll-on-iis/_static/image5.png) -3. Once logged in, click **Create a new poll**. A form displays: - [![Screenshot that shows the form for creating a poll.](advanced-poll-on-iis/_static/image8.png)](advanced-poll-on-iis/_static/image7.png) -4. Click **Save** to publish this poll. -5. Here you see the actual poll as site visitors see it. - [![Screenshot that shows the poll as visitors see it.](advanced-poll-on-iis/_static/image10.png)](advanced-poll-on-iis/_static/image9.png) - -## Getting More Information - -To discuss the FastCGI support in IIS, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx) -- [IIS 7.0 FastCGI forums](https://forums.iis.net/1104.aspx) - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image1.png deleted file mode 100644 index 158dec82f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image10.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image10.png deleted file mode 100644 index efb6f1148..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image2.png deleted file mode 100644 index 158dec82f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image3.png deleted file mode 100644 index 752e30cda..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image4.png deleted file mode 100644 index 752e30cda..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image5.png deleted file mode 100644 index 1aa6f79c3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image6.png deleted file mode 100644 index 1aa6f79c3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image7.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image7.png deleted file mode 100644 index 2254e2b9e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image8.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image8.png deleted file mode 100644 index 2254e2b9e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image9.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image9.png deleted file mode 100644 index efb6f1148..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/samples/sample1.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/samples/sample1.ps1 deleted file mode 100644 index bed7e0593..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/advanced-poll-on-iis/samples/sample1.ps1 +++ /dev/null @@ -1,7 +0,0 @@ -$POLLDB["dbName"]="advancedpoll" // --supply the database you created - -$POLLDB["host"]="localhost" // --supply your mySQL instance - -$POLLDB["user"]="advancedpoll" // --supply the user name you have created - -$POLLDB["pass"]="advancedpoll" // --supply the password \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis.md deleted file mode 100644 index faf0060bf..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: "b2Evolution on IIS" -author: rick-anderson -description: "A popular open source blogging solution, b2Evolution, includes all the features of traditional blog tools, and extends them with evolved features such as fil..." -ms.date: 12/18/2007 -ms.assetid: 7e42e33c-94c3-4781-9fee-9526622c176b -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis -msc.type: authoredcontent ---- -# b2Evolution on IIS - -by Eric Woersching - -## Introduction - -A popular open source blogging solution, b2Evolution, includes all the features of traditional blog tools, and extends them with evolved features such as file and photo management, advanced skinning, multiple blogs support, as well as detailed user permissions. For more information about b2Evolution, see [http://www.b2evolution.net/](http://www.b2evolution.net/). - -The following sections describe how to install and configure b2Evolution for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described here: [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack the Application - -First, download the latest stable release of b2Evolution. For this article, we use b2Evolution 1.10.2. Download it from [here](http://b2evolution.net/downloads/index.html). Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\b2evolution`. - -## Set Up the Database - -Before starting the installation procedure for b2Evolution, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'b2Evolution' -- Database User: 'b2Evolution' -- Account Password: 'b2Evolution' - -## Set Up and Configure the Application - -To ensure that the installation process completes without errors, follow the instructions to set the file and directory permissions: [http://manual.b2evolution.net/Directory\_and\_file\_permissions](http://manual.b2evolution.net/Directory_and_file_permissions). For this walkthrough, we simply provided modify permissions to the local machine "Internet Guest Account" account for the following directories and file: - -- /blogs/media/blogs -- /blogs/media/users -- /blogs/conf/\_basic\_config.php - -We also updated the php.ini file to add the php\_mysql.dll module into it under the Dynamic Extensions section in the file and ensured that the extension directory points to the correct location: - -- extension\_dir = "./ext -- extension=php\_mysql.dll - -Here are the steps to follow: - -1. Browse to the `http://localhost/b2evolution/doc/install\_new.html` page for detailed setup instructions. -2. Click the Install link on the top of the page to redirect to the Install Wizard. - ![Screenshot of a browser window showing the B 2 evolution install wizard welcome page.](b2evolution-on-iis/_static/image1.png) -3. If you get an error stating that the config file (\_basic\_config.php) cannot be automatically updated, follow the alternate solution listed. Manually copy and paste the content listed on that page into the config file and then start the installation from scratch at: `http://localhost/b2evolution/blogs/install/index.php?locale=en-US`. - ![Screenshot of a browser window showing a successful installation page.](b2evolution-on-iis/_static/image3.png) -4. All the tables are created and the admin password is created. Copy this password and use it to log into the site as an Administrator. Change the password immediately: `http://localhost/b2evolution/blogs/admin.php`. -5. Go to the next page to learn how to verify that b2Evolution has been setup correctly. - -## Test the b2Evolution Application - -To test that b2Evolution has been installed successfully, create a blog posting and view it as a site visitor would. Follow these steps: - -1. Navigate to [http://localhost/b2Evolution/blogs/admin.php](http://localhost/b2Evolution/blogs/admin.php). -2. Enter the administrator username and password created in the last installation step. - ![Screenshot of a browser window showing the new blog post window.](b2evolution-on-iis/_static/image5.png) -3. Once logged in, enter a title for your post and some content and click Preview. This launches another IE window and displays the post: - ![Screenshot of a browser window showing the blog preview page in a new window.](b2evolution-on-iis/_static/image7.png) -4. Click Save to publish this content to the Blog selected (Blog A in the case above) -5. Click the "Exit to blogs" link on the upper right hand corner of the page to leave the Administrator portal and browse to the actual blog site. - ![Screenshot of a browser window showing the B 2 evolution page with Exit to blogs circled.](b2evolution-on-iis/_static/image9.png) - -You now see the actual Blog A as site visitors see it. - -![Screenshot of a browser window showing a page with the example blog site.](b2evolution-on-iis/_static/image11.png) - -## Changing the permalink structure - -The default permalinks in b2evolution look something like: -`http://www.yoursite.com/blogs/index.php?title=post_title&c=1&tb=1&pb=1&more=1` - -When hosting b2evolution on IIS you can change this structure to the one that does not use query string. In the blog administration console go to the Blog Settings > URLs tab, where you can choose different link formats; for example: -`http://www.yoursite.com/blogs/2003/05/20/post_title` - -In order for this permalink structure to work you need to instal [Microsoft URL rewrite module for IIS 7.0](https://www.iis.net/downloads/microsoft/url-rewrite "URL rewrite module"). Once it is installed, create a web.config file in the same folder where b2evolution php scripts are and then paste the following into it: - -[!code-xml[Main](b2evolution-on-iis/samples/sample1.xml)] - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image1.png deleted file mode 100644 index d1de605d0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image10.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image10.png deleted file mode 100644 index 43aab7f83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image11.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image11.png deleted file mode 100644 index e1a8f7248..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image11.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image12.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image12.png deleted file mode 100644 index e1a8f7248..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image12.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image2.png deleted file mode 100644 index d1de605d0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image3.png deleted file mode 100644 index b1b080461..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image4.png deleted file mode 100644 index b1b080461..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image5.png deleted file mode 100644 index 0904740ef..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image6.png deleted file mode 100644 index 0904740ef..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image7.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image7.png deleted file mode 100644 index 42ade140a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image8.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image8.png deleted file mode 100644 index 42ade140a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image9.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image9.png deleted file mode 100644 index 43aab7f83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/samples/sample1.xml deleted file mode 100644 index ee5c21610..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/b2evolution-on-iis/samples/sample1.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis.md deleted file mode 100644 index 45badce21..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: "Coppermine on IIS" -author: rick-anderson -description: "Coppermine is a multi-purpose, fully-featured and integrated web picture gallery script written in PHP. Coppermine uses GD or ImageMagick as the image librar..." -ms.date: 12/18/2007 -ms.assetid: 4a6fdd0f-12c2-4a7d-8b8e-f8af5e0c0370 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis -msc.type: authoredcontent ---- -# Coppermine on IIS - -by Eric Woersching - -## Introduction - -Coppermine is a multi-purpose, fully-featured and integrated web picture gallery script written in PHP. Coppermine uses GD or ImageMagick as the image library with a MySQL backend. - -The following sections describe how to install and configure Coppermine for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described here: [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack the Application - -First, download the latest stable release of Coppermine. For this article, we use Coppermine 1.4.13 downloaded from [here](http://downloads.sourceforge.net/coppermine/cpg1.4.13.zip). - -Once you downloaded the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\Coppermine`. Add permissions to IIS\_WPG to have Write access for the following folders: - -- `C:\inetpub\wwwroot\Coppermine\include` -- `C:\inetpub\wwwroot\Coppermine\albums` - -Ensure that both GD2 and MySQL are enabled in PHP by uncommenting the modules in the php.ini file. - -[!code-console[Main](coppermine-on-iis/samples/sample1.cmd)] - -## Set Up the Database - -Before starting the installation procedure for Coppermine create a database on your server. Also create a database user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'Coppermine' -- Database User: 'cpguser' -- Account Password: 'password' - -## Set Up and Configure Coppermine - -Open your web browser and browse to `http://localhost/Coppermine/install.php`, the Coppermine setup page. - -1. Enter the required installation information as in the screen shot below (replace the Database Server Hostname and Passwords with the information of your database server). Click "Let's Go!". - [![Screenshot shows the Coppermine Photo Gallery: Welcome to Coppermine installation page.](coppermine-on-iis/_static/image2.png)](coppermine-on-iis/_static/image1.png) -2. Click "Let's Continue" to complete the setup. - [![Screenshot shows the Coppermine Photo Gallery: Installation completed page.](coppermine-on-iis/_static/image4.png)](coppermine-on-iis/_static/image3.png) -3. After the installation is complete, delete the file install.php from `c:\inetpub\wwwroot\Coppermine` to ensure that no one can reconfigure the gallery. - -You must change the access permissions on the include folder now that the installation is finished. Ensure that the folder is NOT writable by the service account that is used for the application pool associated with the "Default Web Site". Once the permissions have been specified, you can browse to `http://localhost/Coppermine/index.php` and log on using the administrative username and password that you have specified earlier. - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image1.png deleted file mode 100644 index 33111958f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image2.png deleted file mode 100644 index 33111958f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image3.png deleted file mode 100644 index 22c07e18d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image4.png deleted file mode 100644 index 22c07e18d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/samples/sample1.cmd deleted file mode 100644 index a88bc836e..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/coppermine-on-iis/samples/sample1.cmd +++ /dev/null @@ -1,3 +0,0 @@ -extension=php_mysql.dll - -extension=php_gd2.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis.md deleted file mode 100644 index add0690c2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: "Crafty Syntax Live Help on IIS" -author: rick-anderson -description: "Crafty Syntax Live Help is an open source, live support solution that helps customer support with live help functionality. It can pro-actively push visitors..." -ms.date: 12/18/2007 -ms.assetid: fefc3a42-2b99-4f14-a5e9-d38eccd08641 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis -msc.type: authoredcontent ---- -# Crafty Syntax Live Help on IIS - -by Eric Woersching - -## Introduction - -Crafty Syntax Live Help is an open source, live support solution that helps customer support with live help functionality. It can pro-actively push visitors to your site or one requested by the customer. Crafty Syntax includes a large range of features to allow multiple operators, multiple departments and multiple languages. - -For more information about Crafty Syntax Live Help, see [http://www.craftysyntax.com/](http://www.craftysyntax.com/). - -The following sections describe how to install and configure Crafty Syntax Live Help for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described here: [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Notes on PHP Setup - -Crafty Syntax Live Help does not need many modifications beyond the default configuration provided by PHP **.** From the base configuration file provided by PHP, you need modify only the following lines in your php.ini configuration file to get Crafty Syntax Live Help working: - -- Define `extension\_dir` as `c:\php\ext` (i.e. the location of your php extensions directory) -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support - -## Download and Unpack the Application - -First, download the latest stable release of Crafty Syntax Live Help. For this article, we use Crafty Syntax Live Help 2.14.5 downloaded from [here](http://www.craftysyntax.com/installation.php). Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\cslh`. - -## Set Up the Database - -Before starting the installation procedure for Crafty Syntax Live Help, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'cslh' -- Database User: 'cslh' -- Account Password: 'cslh' - -## Set Up and Configure Crafty Syntax Live Help - -Browse to the `http://localhost/cslh/setup.php` page for detailed setup instructions. - -1. Click the Install link on the top of the page to redirect to the Install Wizard. -2. Enter the required database information using the database name and user name created earlier. - ![Screenshot of a browser window showing the installation screen.](crafty-syntax-live-help-on-iis/_static/image1.png) -3. All the tables are created and the config.php code is created. Copy the generated code and paste into config.php file: - ![Screenshot of a browser window showing the config file.](crafty-syntax-live-help-on-iis/_static/image3.png) -4. Go to the next page to learn how to verify the installation of Crafty Syntax Live Help. - -## Test the Application - -To test that Crafty Syntax has been installed successfully, chat with an operator to obtain support. Follow these steps: - -1. Navigate to `http://localhost/cslh/livehelp.php`. -2. Select the default department. - ![Screenshot of a browser window showing the Choose Department page.](crafty-syntax-live-help-on-iis/_static/image5.png) -3. Enter the question: - ![Screenshot of a browser window showing the Live help page.](crafty-syntax-live-help-on-iis/_static/image7.png) - -The operator responds to the question and starts the chat to provide live help. - -![Screenshot of a browser window showing the live chat page with the guest message box open.](crafty-syntax-live-help-on-iis/_static/image9.png) - -![Screenshot of a browser window showing the live chat page with the Ask message box.](crafty-syntax-live-help-on-iis/_static/image11.png) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image1.png deleted file mode 100644 index 76b8dec60..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image10.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image10.png deleted file mode 100644 index 91eb5ed02..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image11.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image11.png deleted file mode 100644 index 69d4af37b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image11.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image12.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image12.png deleted file mode 100644 index 69d4af37b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image12.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image2.png deleted file mode 100644 index 76b8dec60..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image3.png deleted file mode 100644 index 903a0f167..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image4.png deleted file mode 100644 index 903a0f167..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image5.png deleted file mode 100644 index 89ed0b6b8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image6.png deleted file mode 100644 index 89ed0b6b8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image7.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image7.png deleted file mode 100644 index 9040c3357..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image8.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image8.png deleted file mode 100644 index 9040c3357..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image9.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image9.png deleted file mode 100644 index 91eb5ed02..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/crafty-syntax-live-help-on-iis/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis.md deleted file mode 100644 index 379476078..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "CubeCart on IIS" -author: rick-anderson -description: "Introduction CubeCart is a powerful eCommerce script written with PHP and MySQL. With CubeCart, you can setup a powerful online store with hosting that suppo..." -ms.date: 01/17/2008 -ms.assetid: 8f3e0858-60eb-44ca-a09d-2179b395d359 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis -msc.type: authoredcontent ---- -# CubeCart on IIS - -by Eric Woersching - -## Introduction - -CubeCart is a powerful eCommerce script written with PHP and MySQL. With CubeCart, you can setup a powerful online store with hosting that supports PHP and one MySQL database. - -For more information about CubeCart, see [http://www.cubecart.com](http://www.cubecart.com/). - -In this section, we go through the steps required to install CubeCart to work with FastCGI extension on IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis) - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described here [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack the CubeCart - -First you will need to download latest stable release of CubeCart application. For this article we used CubeCart\_3.0.17 Full Package that can be downloaded from the mirror -[https://www.cubecart.com/site/helpdesk/index.php?\_m=downloads&\_a=view&parentcategoryid=1&pcid=5&nav=0,5](https://www.cubecart.com/site/helpdesk/index.php?_m=downloads&_a=view&parentcategoryid=1&pcid=5&nav=0,5) - -Once you downloaded the package, uncompress it and copy files and folders to `C:\Inetpub\wwwroot\cubecart`. - -## Set Up the Database - -Before starting the installation of CubeCart, create a database on your database server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'cubecart' -- Database User: 'cubecart' -- Account Password: 'cubecart' - -## Setup and Configuration - -Follow these steps: - -1. Go to [https://www.cubecart.com/build](https://www.cubecart.com/build) to generate the configuration setup script after creating the database for the project. - [![Screenshot of CubeCart Manual Installation webpage.](cubecart-on-iis/_static/image2.jpg)](cubecart-on-iis/_static/image1.jpg) -2. Click Continue to go to the next step. - - [![Screenshot of the CubeCart Manual Installation screen's Database Settings and Administrator Configurations Settings sections.](cubecart-on-iis/_static/image4.jpg)](cubecart-on-iis/_static/image3.jpg) - - [![Screenshot of the CubeCart Manual Installation screen's Skin and Advanced Settings sections.](cubecart-on-iis/_static/image6.jpg)](cubecart-on-iis/_static/image5.jpg) -3. Provide the database details and click Continue. We used the following details for our application: - - - Database Type: MySql - - Host Name: localhost - - Username: cubecartuser - - Password: cubecart - - Database: cubecart - - [![Screenshot of the CubeCart Manual Installation screen's Database Settings details.](cubecart-on-iis/_static/image8.jpg)](cubecart-on-iis/_static/image7.jpg) - - [![Screenshot of the CubeCart Manual Installation screen's Skin and Advanced Settings sections with inserted information.](cubecart-on-iis/_static/image10.jpg)](cubecart-on-iis/_static/image9.jpg) - - It generates 2 files: - - - global.inc.php - Open includes/global.inc.php and paste in the code created for you. - - db.sql - Execute the sql queries generated for you. - - [![Screenshot of the Cubeart Manual Installation screen, showing the global.inc.php code.](cubecart-on-iis/_static/image12.jpg)](cubecart-on-iis/_static/image11.jpg) - - [![Screenshot of the Cubeart Manual Installation screen, showing the db.sql code.](cubecart-on-iis/_static/image14.jpg)](cubecart-on-iis/_static/image13.jpg) -4. Give write access permissions to images/upload folder. - - [![Screenshot of the Permissions for Uploads dialog box with a highlight on a user name.](cubecart-on-iis/_static/image16.jpg)](cubecart-on-iis/_static/image15.jpg) -5. Delete the install folder from the directory before accessing the installed application. - -Installation is complete. Access the application by browsing the index.php file using the path `http://localhost/cubecart/index.php`. - -[![Screenshot of Welcome to CubeCart webpage.](cubecart-on-iis/_static/image18.jpg)](cubecart-on-iis/_static/image17.jpg) - -[![Screenshot of CubeCart's Test Product webpage.](cubecart-on-iis/_static/image20.jpg)](cubecart-on-iis/_static/image19.jpg) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, please use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image1.jpg deleted file mode 100644 index 248b9800f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image10.jpg deleted file mode 100644 index 896c15dda..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image11.jpg deleted file mode 100644 index 078f81750..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image12.jpg deleted file mode 100644 index 078f81750..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image13.jpg deleted file mode 100644 index cfe66670a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image14.jpg deleted file mode 100644 index cfe66670a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image15.jpg deleted file mode 100644 index 29641ad6c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image16.jpg deleted file mode 100644 index 29641ad6c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image17.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image17.jpg deleted file mode 100644 index 75a30329e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image18.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image18.jpg deleted file mode 100644 index 75a30329e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image19.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image19.jpg deleted file mode 100644 index 4cd78a1a3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image19.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image2.jpg deleted file mode 100644 index 248b9800f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image20.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image20.jpg deleted file mode 100644 index 4cd78a1a3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image20.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image3.jpg deleted file mode 100644 index 520d3bb57..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image4.jpg deleted file mode 100644 index 520d3bb57..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image5.jpg deleted file mode 100644 index ae1395c72..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image6.jpg deleted file mode 100644 index ae1395c72..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image7.jpg deleted file mode 100644 index 89d142bc6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image8.jpg deleted file mode 100644 index 89d142bc6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image9.jpg deleted file mode 100644 index 896c15dda..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/cubecart-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis.md deleted file mode 100644 index 6dc6ee7cb..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: "ExpressionEngine on IIS" -author: rick-anderson -description: "Introduction ExpressionEngine is a flexible, feature-rich content management system that empowers thousands of individuals, organizations, and companies arou..." -ms.date: 01/17/2008 -ms.assetid: 80b02fea-6773-499c-a470-733b02c34f79 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis -msc.type: authoredcontent ---- -# ExpressionEngine on IIS - -by Eric Woersching - -## Introduction - -ExpressionEngine is a flexible, feature-rich content management system that empowers thousands of individuals, organizations, and companies around the world to easily manage their websites. - -For more information about ExpressionEngine, see [http://ExpressionEngine.com/](http://expressionengine.com/). - -In this section, we go through the steps that are required to install ExpressionEngine to work with FastCGI extension on IIS 7.0 and above, and Windows Server® 2008. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack ExpressionEngine - -First, download the latest stable release of the ExpressionEngine application. For this article, we use ExpressionEngine (EECore1.6.1). Download the full package from the mirror [https://secure.expressionengine.com/download.php?ACT=agreement&id=34](https://secure.expressionengine.com/download.php?ACT=agreement&id=34). - -Once you download the package, uncompress it and copy the files and folders to `C:\Inetpub\wwwroot\eecore`. - -## Set Up the Database - -Before starting the installation procedure for ExpressionEngine, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'expressionengine' -- Database User: 'eemsuser' -- Account Password: 'eems' - -## Set Up and Configure ExpressionEngine - -Installation information and setup information documents are available at [https://expressionengine.com/](https://expressionengine.com/). - -Follow these steps: - -1. Rename the "eecore\System" folder to "eecore\microsoftsystem". This increases security by keeping the directory containing your ExpressionEngine backend files hidden from public access. -2. Delete the following file and directory. They upgrade from the previous version. - - - Eecore\microsoftsystem /update.php --- Delete this file - - Eecore\microsoftsystem/updates --- Delete this folder -3. Provide all permissions to the IIS user for the following folders: - - - images/avatars/uploads/ - - images/captchas/ - - images/member\_photos/ - - images/pm\_attachments/ - - images/signature\_attachments/ - - images/uploads/ - - system/cache/ - - [![Screenshot of Permissions for uploads dialog box. Permissions for I I S underscore I U S R S are all selected and allowed.](expressionengine-on-iis/_static/image2.jpg)](expressionengine-on-iis/_static/image1.jpg) - -## Run the Installation Script - -Inside the root directory, you find a file called install.php. Browse to the install using `http://localhost/eecore/install.php`. This runs a script which configures your database and sets up the default site. Be sure that you access the file through your webserver and not by loading the file into your web browser locally. - -1. Click the "Click Here to begin" button to start installation - [![Screenshot of local host web page. Click here to begin button is found near the bottom of the web page.](expressionengine-on-iis/_static/image4.jpg)](expressionengine-on-iis/_static/image3.jpg) -2. Accept the agreement and click Submit. - [![Screenshot of the Expressions Engine Installation Wizard. The button next to the text I agree to abide by the license Terms and Conditions as stated above is selected.](expressionengine-on-iis/_static/image6.jpg)](expressionengine-on-iis/_static/image5.jpg) -3. Provide a name for the folder, which you renamed from System. Click Submit. - [![Screenshot of the Expressions Engine Installation Wizard. A box for the name of the system folder is shown above the submit button.](expressionengine-on-iis/_static/image8.jpg)](expressionengine-on-iis/_static/image7.jpg) -4. Provide the details of your database: Admin username, password, time zone, etc. Click install ExpressionEngine. - - - MySQLUserName as: eemsuser - - MySQLPassword as: eems - - MySQLDataBase as : expressionengine - - Admin account user name as : expressionengineadmin - - And password as : eeadmin - - [![Screenshot of the Expressions Engine Installation Wizard. The Server Settings page is shown.](expressionengine-on-iis/_static/image10.jpg)](expressionengine-on-iis/_static/image9.jpg) - - [![Screenshot of the Expressions Engine Installation Wizard. The Database Settings page is shown.](expressionengine-on-iis/_static/image12.jpg)](expressionengine-on-iis/_static/image11.jpg) - - [![Screenshot of the Expressions Engine Installation Wizard. The Create your admin account page is shown.](expressionengine-on-iis/_static/image14.jpg)](expressionengine-on-iis/_static/image13.jpg) - - [![Screenshot of the Expressions Engine Installation Wizard. The Localization Settings page and Choose your default template design page is shown.](expressionengine-on-iis/_static/image16.jpg)](expressionengine-on-iis/_static/image15.jpg) -5. You see the confirmation screen for a successful installation. - [![Screenshot of the Expressions Engine Installation Wizard. The text says that Expression Engine has been successfully installed!](expressionengine-on-iis/_static/image18.jpg)](expressionengine-on-iis/_static/image17.jpg) -6. Login to the Control Panel using the Admin username and password. - [![SCreenshot of the Control Panel Login page. The username and password box are shown. The submit button is also shown.](expressionengine-on-iis/_static/image20.jpg)](expressionengine-on-iis/_static/image19.jpg) - -The following are some screenshots of ExpressionEngine after it is up and running on IIS. - -[![Screenshot of the Expression Engine web page. The home page is shown.](expressionengine-on-iis/_static/image22.jpg)](expressionengine-on-iis/_static/image21.jpg) - -[![Screenshot of the Expression Engine web page. The modules tab is displayed and a list of modules is shown.](expressionengine-on-iis/_static/image24.jpg)](expressionengine-on-iis/_static/image23.jpg) - -[![Screenshot of the Expression Engine web page. The Default Site Weblog is displayed. Text on Getting Started with Expression Engine is written under the date Monday, December 10, 2007.](expressionengine-on-iis/_static/image26.jpg)](expressionengine-on-iis/_static/image25.jpg) - -[![Screenshot of the Expression Engine web page. The Default Site Weblog is displayed.](expressionengine-on-iis/_static/image28.jpg)](expressionengine-on-iis/_static/image27.jpg) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, please use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image1.jpg deleted file mode 100644 index 06355ed9b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image10.jpg deleted file mode 100644 index dbd0c6ff5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image11.jpg deleted file mode 100644 index 293e404fd..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image12.jpg deleted file mode 100644 index 293e404fd..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image13.jpg deleted file mode 100644 index d1f82a5cb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image14.jpg deleted file mode 100644 index d1f82a5cb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image15.jpg deleted file mode 100644 index c224f6ffa..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image16.jpg deleted file mode 100644 index c224f6ffa..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image17.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image17.jpg deleted file mode 100644 index fea453af7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image18.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image18.jpg deleted file mode 100644 index fea453af7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image19.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image19.jpg deleted file mode 100644 index 65bbaa9f0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image19.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image2.jpg deleted file mode 100644 index 06355ed9b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image20.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image20.jpg deleted file mode 100644 index 65bbaa9f0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image20.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image21.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image21.jpg deleted file mode 100644 index f2d8fa76d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image21.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image22.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image22.jpg deleted file mode 100644 index f2d8fa76d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image22.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image23.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image23.jpg deleted file mode 100644 index 801359a76..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image23.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image24.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image24.jpg deleted file mode 100644 index 801359a76..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image24.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image25.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image25.jpg deleted file mode 100644 index 448452e37..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image25.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image26.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image26.jpg deleted file mode 100644 index 448452e37..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image26.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image27.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image27.jpg deleted file mode 100644 index abbd0bce5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image27.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image28.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image28.jpg deleted file mode 100644 index abbd0bce5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image28.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image3.jpg deleted file mode 100644 index 14bbe386b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image4.jpg deleted file mode 100644 index 14bbe386b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image5.jpg deleted file mode 100644 index 01d7a4bc2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image6.jpg deleted file mode 100644 index 01d7a4bc2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image7.jpg deleted file mode 100644 index fe3fc10e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image8.jpg deleted file mode 100644 index fe3fc10e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image9.jpg deleted file mode 100644 index dbd0c6ff5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/expressionengine-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis.md deleted file mode 100644 index ffe0fed6d..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis.md +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: "Gallery2 on IIS" -author: rick-anderson -description: "Gallery is a web application that lets you manage your photos on your own website. With Gallery, you can easily create and maintain photo albums via an intui..." -ms.date: 12/18/2007 -ms.assetid: 7e1bbc1e-badb-481e-93e0-e3b01b0d82f4 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis -msc.type: authoredcontent ---- -# Gallery2 on IIS - -by Eric Woersching - -## Introduction - -Gallery is a web application that lets you manage your photos on your own website. With Gallery, you can easily create and maintain photo albums via an intuitive interface. Photo management includes automatic thumbnail creation, image resizing, rotation, ordering, captioning, searching and more. Albums and photos can have view, edit, delete and other permissions per an individual authenticated user for an additional level of privacy. - -For more information about Gallery, refer to [http://gallery.menalto.com/](http://gallery.menalto.com/). - -The following sections describe how to install and configure Gallery for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described here in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -The instructions have been tested and work in the following configurations: - -- Windows Server® 2003 operating system -- IIS 6.0 -- PHP 5.2.4 -- MySQL 5.0.45 -- Gallery 2.2.3 – typical install - -## Notes on PHP Setup - -Gallery does not need many modifications beyond the default configuration provided by PHP **.** From the base configuration file provided by PHP, you only need to modify the following lines in your php.ini configuration file to get Gallery working: - -- Define `extension\_dir` as `c:\php\ext` (i.e., the location of your PHP extensions directory) -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support -- Uncomment `extension=php\_gd2.dll` in the extension list to enable graphics toolkit - -## Download and Unpack the Application - -The latest releases of Gallery are found at [http://gallery.menalto.com/](http://gallery.menalto.com/). The instructions in this document are based on version 2.2.3, but future versions will likely be very similar as far as installation is concerned. - -After downloading the zip package, extract its contents to `C:\Inetpub\wwwroot\Gallery2` or another directory of your choosing. You do not need to modify the permissions on the Gallery web directory, as the default permissions suffice. - -## Set Up Storage Directory - -Gallery requires a separate directory for storing all photos and related data, such as thumbnails. For security reasons, we recommend that you create this directory outside of the web root. - -For this walkthrough, we created a directory called g2data on C: drive `C:\g2data`. You must grant web server write permissions to this directory. Since FastCGI impersonates the requests from all users, make sure that the user account used for impersonation has write access to this directory. For example, if your web site or virtual directory is configured for Anonymous authentication, then you must grant "Internet Guest Account" write access to `C:\g2data`. - -![Screenshot of the g 2 data properties dialog. Internet Guest Account is highlighted.](gallery2-on-iis/_static/image1.png) - -## Set Up the Database - -In order to use Gallery, you must have access to some kind of a database. For this walkthrough, we use MS SQL Server® 2005. You can also use MySQL, MS SQL Server Express or others. - -Before starting the install, create a database on your server. Also create a database user and grant this user db ownership permission to the database. - -1. If you are using MS SQL Server 2005, then open Microsoft SQL Server Management Studio and click the "New Query" button. -2. Enter the following script into the query window (this script creates the database and user that are necessary for the Gallery application). - - [!code-sql[Main](gallery2-on-iis/samples/sample1.sql)] -3. Grant the newly created user the db\_owner permissions to Gallery2 database: - - ![Screenshot of the Database User window. The user name is highlighted in the main pane.](gallery2-on-iis/_static/image3.png) - -## Set Up and Configure the Application - -Open your web browser and browse to `http://localhost/gallery2/install/index.php`. - -1. Click "Begin installation" to go to the authenticate page. - ![Screenshot of a browser window. Authenticate is highlighted in the Install Steps pane.](gallery2-on-iis/_static/image5.png) -2. Follow the instructions and save the login.txt file into the Gallery2 directory. -3. Click "Authenticate Me". - - Proceed to the next steps to perform a system check and choose the installation type. For this walkthrough, we use "Standard Installation" option. - -4. Specify the path to the data directory that you have created earlier. If you have configured permissions for g2data correctly, you can proceed to the next step after clicking "Save". - - ![Screenshot of a browser window. Storage Setup is highlighted in the Install Steps pane.](gallery2-on-iis/_static/image7.png) - -In Step 5 in the "Install Steps" pane, enter the required database information. If you have setup the database and user correctly, clicking "Save" takes you to the subsequent installation steps. - -![Screenshot of a browser window. Database Setup is highlighted in the Install Steps pane.](gallery2-on-iis/_static/image9.png) - -In Step 7 in the "Install Steps" pane, you are asked to create an empty config.php file in Gallery2 folder: - -![Screenshot of a browser window. Create Config file is highlighted in the Install Steps pane.](gallery2-on-iis/_static/image11.png) - -Make sure that the web server has write permissions to this file. For this walkthrough, we allowed write permissions to this file for "Internet Guest Account". - -After that, proceed through the remaining installation steps. Once you have completed the installation, you can login to the newly created Gallery using the administrator user name and password which you specified during installation. - -![Screenshot of a browser window. The login dialog is open in the main pane.](gallery2-on-iis/_static/image13.png) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image1.png deleted file mode 100644 index 235f230c1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image10.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image10.png deleted file mode 100644 index 4d203dd6a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image11.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image11.png deleted file mode 100644 index 2bc625168..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image11.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image12.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image12.png deleted file mode 100644 index 2bc625168..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image12.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image13.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image13.png deleted file mode 100644 index 1eb1802d2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image13.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image14.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image14.png deleted file mode 100644 index 1eb1802d2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image14.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image2.png deleted file mode 100644 index 235f230c1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image3.png deleted file mode 100644 index 876dd9e9d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image4.png deleted file mode 100644 index 876dd9e9d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image5.png deleted file mode 100644 index 0a7fb3aff..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image6.png deleted file mode 100644 index 0a7fb3aff..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image7.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image7.png deleted file mode 100644 index 749c44525..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image8.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image8.png deleted file mode 100644 index 749c44525..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image9.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image9.png deleted file mode 100644 index 4d203dd6a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/samples/sample1.sql b/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/samples/sample1.sql deleted file mode 100644 index 0c682491e..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/gallery2-on-iis/samples/sample1.sql +++ /dev/null @@ -1,17 +0,0 @@ -USE [master] -GO - -CREATE DATABASE gallery2 -GO - -CREATE LOGIN [gallery2] -WITH PASSWORD=N'pass@word1', - DEFAULT_DATABASE=[gallery2], - CHECK_EXPIRATION=OFF, - CHECK_POLICY=OFF -GO - -USE [gallery2] -GO - -CREATE USER [gallery2] FOR LOGIN [gallery2] WITH DEFAULT_SCHEMA=[dbo] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis.md deleted file mode 100644 index f95c89ac5..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "Geeklog on IIS" -author: rick-anderson -description: "Geeklog is a PHP/MySQL based application for managing dynamic web content. It is a blog engine, or a CMS with support for comments, track backs, multiple syn..." -ms.date: 12/18/2007 -ms.assetid: a65396b9-8c0d-4a8d-8ba0-518b1c3be28e -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis -msc.type: authoredcontent ---- -# Geeklog on IIS - -by Eric Woersching - -## Introduction - -Geeklog is a PHP/MySQL based application for managing dynamic web content. It is a blog engine, or a [CMS](http://en.wikipedia.org/wiki/Web_content_management_system "Click to look up 'CMS' on Wikipedia") with support for comments, track backs, multiple syndication formats, spam protection, and all the other vital features of such a system. The core Geeklog distribution is easily extended by community-developed plugins, including forums and image galleries. - -For more information about Geeklog, see [http://www.geeklog.net](http://www.geeklog.net/). - -In this article, we go through the steps that would be required to install Geeklog to work with FastCGI extension on IIS6.0. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis) - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack the Application - -First, download the latest stable release of Geeklog. For this article, we use Geeklog 1.4.1 downloaded from [here](http://www.geeklog.net/filemgmt/viewcat.php?cid=8). Once you downloaded the package, uncompress it - -> [!NOTE] -> For this walkthrough, we extracted the files to D:\Geeklog. - -Everything outside the public\_html directory should not be visible over the web, as it contains sensitive information. Hence, copy the content of public\_html out into a directory served by your web server - -> [!NOTE] -> For this walkthrough, we copied the content to directory D:\public\_html and created a virtual directory called 'Geeklog' pointing to D:\public\_html. - -## Set Up the Database - -In order to use Geeklog, you must have access to a database. For this walkthrough, we use MS SQL Server 2005. You can also use MySQL or MS SQL Express. - -Before starting the install, create a database on your server. Also create a database user and grant this user db ownership permission to the database. If you are using MS SQL Server 2005, then open Microsoft SQL Server Management Studio and click the "New Query" button. Enter the following script into the query window (this script creates the database and user that are necessary for the Geeklog application). - -[!code-sql[Main](geeklog-on-iis/samples/sample1.sql)] - -> [!NOTE] -> Make sure the login Geeklog has permission to create tables inside the Geeklog database. - -## Configure the Application - -1. Start by making the following updates to config.php. The examples that follow are specific to this walkthrough. - - - Set $\_CONF['path'] to point to the directory where your config.php file resides. - - [!code-powershell[Main](geeklog-on-iis/samples/sample2.ps1)] - - Set $\_CONF['path\_html'] to point to where the contents of public\_html have been placed. - - [!code-powershell[Main](geeklog-on-iis/samples/sample3.ps1)] - - Set Geeklog to use MSSQL and configure the Sql login credentials. - - [!code-powershell[Main](geeklog-on-iis/samples/sample4.ps1)] - - Set $\_CONF['site\_url'] - - [!code-console[Main](geeklog-on-iis/samples/sample5.cmd)] -2. Edit lib-common.php and change the require\_once() at the top to point to the location of your config.php file. - - For more information on how to install Geeklog, refer to [http://www.geeklog.net/docs/install.html](http://www.geeklog.net/docs/install.html). -3. Afterwards, open your web browser and browse to `http://localhost/geeklog/admin/install/install.php`. - - ![Screenshot of the Geeklog installation window showing step 1 instructions.](geeklog-on-iis/_static/image1.png) -4. Select the installation type from the drop down. For this walkthrough, we set up a new Microsoft SQL Server database. Set the path to config.php and click Next. - - ![Screenshot of the Geeklog database settings screen.](geeklog-on-iis/_static/image3.png) -5. We are now ready to setup the database and complete the installation. Click Next. - [Screenshot of the Geeklog welcome screen.](geeklog-on-iis/_static/image5.png) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, please use the FastCGI forums: - -- [IIS.NET / IIS 6 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image1.png deleted file mode 100644 index 98291515a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image2.png deleted file mode 100644 index 98291515a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image3.png deleted file mode 100644 index f4ca231a5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image4.png deleted file mode 100644 index f4ca231a5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image5.png deleted file mode 100644 index 721c9fdf9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image6.png deleted file mode 100644 index 721c9fdf9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample1.sql b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample1.sql deleted file mode 100644 index 5b2ebd3af..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample1.sql +++ /dev/null @@ -1,17 +0,0 @@ -USE [master] -GO - -CREATE DATABASE Geeklog -GO - -CREATE LOGIN [Geeklog] -WITH PASSWORD=N'Geeklog', - DEFAULT_DATABASE=[Geeklog], - CHECK_EXPIRATION=OFF, - CHECK_POLICY=OFF -GO - -USE [Geeklog] -GO - -CREATE USER [Geeklog] FOR LOGIN [Geeklog] WITH DEFAULT_SCHEMA=[dbo] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample2.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample2.ps1 deleted file mode 100644 index a0ea147eb..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample2.ps1 +++ /dev/null @@ -1 +0,0 @@ -$_CONF['path'] = 'd:/geeklog/'; // should end in a slash \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample3.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample3.ps1 deleted file mode 100644 index e6e105b2c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample3.ps1 +++ /dev/null @@ -1 +0,0 @@ -$_CONF['path_html'] = 'd:/public_html/'; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample4.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample4.ps1 deleted file mode 100644 index 895b08ba2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample4.ps1 +++ /dev/null @@ -1,5 +0,0 @@ -$_DB_dbms = 'mssql'; // 'mssql' (Microsoft SQL Server) -$_DB_host = 'localhost'; // Name of your database server -$_DB_name = 'Geeklog'; // Name of the database -$_DB_user = 'Geeklog'; // MSSQL user name -$_DB_pass = 'Geeklog'; // MSSQL password \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample5.cmd deleted file mode 100644 index 01ba01bda..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/geeklog-on-iis/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -e.g. $_CONF['site_url'] = 'http://localhost/geeklog'; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/how-to-deploy-applications-on-the-microsoft-web-platform-for-php.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/how-to-deploy-applications-on-the-microsoft-web-platform-for-php.md deleted file mode 100644 index 396aaf41a..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/how-to-deploy-applications-on-the-microsoft-web-platform-for-php.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: "How to Deploy Applications on the Microsoft Web Platform for PHP" -author: rick-anderson -description: "There are a couple of steps you can take to optimize deployment of your applications on the Microsoft Web Platform, including: Translate .htaccess Files to W..." -ms.date: 11/15/2009 -ms.assetid: a0f87507-9376-4359-815e-12386286abd4 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/how-to-deploy-applications-on-the-microsoft-web-platform-for-php -msc.type: authoredcontent ---- -# How to Deploy Applications on the Microsoft Web Platform for PHP - -by Tali Smith - -There are a couple of steps you can take to optimize deployment of your applications on the Microsoft Web Platform, including: - -- [Translate .htaccess Files to Web.config Files](translate-htaccess-content-to-iis-webconfig.md). This article shows how to use the IIS web.config file for the functions performed by the Apache .htaccess functions. -- [Provide URL Rewriting Functionality](provide-url-rewriting-functionality.md). The URL Rewrite Module provides flexible rules-based rewrite engine that can be used to perform broad spectrum of URL manipulation tasks. - -You can use the [Web Platform Installer (Web PI)](https://www.microsoft.com/web/Downloads/platform.aspx) to easily download a variety of applications, including DasBlog (an ASP.NET blogging application), AtomSite (an online publishing platform), and Moodle (a learning management system). - -You can also visit the [Windows Web App Gallery](https://www.microsoft.com/web/gallery/) for one-click installation of applications such as Gallery (Web-based photo gallery), Umbraco (content management system), mojoPortal (content management system and web application framework for ASP.NET 3.5), DotNetNuke (content management system and application development framework), and Kentico CMS for ASP.NET (content management system). - -[Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md) and [Using FastCGI to Host PHP Applications on IIS 6.0](using-fastcgi-to-host-php-applications-on-iis-60.md) provide instructions for setting up FastCGI and PHP to host applications; this information is also detailed in a number of articles in [Install the Microsoft Web Platform](../install-and-configure-php-on-iis/index.md). - -For guidance in manually deploying specific applications, see: - -- Install [Zen Cart](install-zen-cart-on-iis.md) (open-source online store management system) -- Install [osCommerce](install-oscommerce-on-iis.md) (open-source based, online shopping and e-commerce solution) -- Install [Drupal](install-drupal-on-iis.md) (open-source content management system) -- Install [Joomla](install-joomla-on-iis.md) (open-source content management system) -- Install [WordPress](install-wordpress-on-iis.md) (a blogging package) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis.md deleted file mode 100644 index bd0195c51..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: "Install Drupal on IIS" -author: ruslany -description: "Introduction Drupal is a free, open-source content management system (CMS) software that lets individuals or communities of users easily publish, manage, and..." -ms.date: 09/19/2008 -ms.assetid: abceda1a-91b8-4d9d-820d-0dfc0128771a -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis -msc.type: authoredcontent ---- -# Install Drupal on IIS - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Introduction - -Drupal is a free, open-source content management system (CMS) software that lets individuals or communities of users easily publish, manage, and organize a wide variety of content on a Web site. - -For more information about Drupal, visit the [Drupal Web site](http://www.drupal.org/). - -This article describes how to install and configure Drupal for use with the FastCGI extension on Internet Information Services 7 (IIS 7) and above on Windows® Web Server 2008. The instructions assume that you have set up and configured the FastCGI extension and the PHP libraries. The instructions have been tested and found to work with the following software versions: - -- PHP 5.2.9 -- MySQL 5.1.34 -- Drupal 6.14 - -## Prerequisites - -From the base default configuration file provided by PHP, modify the following lines in your **Php.ini** configuration: - -- Define `extension\_dir` as `c:\php\ext` (for example, the location of your PHP extensions directory). -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support. - -In order for Drupal to work correctly with IIS 7 and above, it is necessary to install an [update for the IIS FastCGI module for IIS 7](https://blogs.iis.net/ruslany/archive/2008/08/27/update-for-iis-7-0-fastcgi-module.aspx). - -## Download and Unpack the Application - -First, download the latest stable release of [Drupal](http://www.drupal.org/). For this article, Drupal version 6.14 was used (future versions are likely to be similar to install). Uncompress the Drupal files and copy them to `C:\Inetpub\wwwroot\drupal` (or another directory of your choosing). - -Before running the Drupal installer, create the configuration file **Settings.php**, which Drupal uses to store key configuration settings. Assign write permissions to it with the command (from the installation directory): - -1. Copy the **.\sites\default\default.settings.php** file to **.\sites\default\settings.php**. -2. Grant "write" permissions to the file. - - [!code-console[Main](install-drupal-on-iis/samples/sample1.cmd)] -3. The installer will modify the Settings.php file with information provided during the installation process. -4. Check to ensure that the file permissions are set back to "read only" once the installation is complete. If the file permissions did not change back, you must change them manually with the command: - - [!code-console[Main](install-drupal-on-iis/samples/sample2.cmd)] -5. Drupal uses the Sites\Default\Files directory to store temporary files and therefore must be able to write and modify files in this folder. -6. Create the folder: - - [!code-console[Main](install-drupal-on-iis/samples/sample3.cmd)] -7. Grant "modify" permissions to the folder: - - [!code-console[Main](install-drupal-on-iis/samples/sample4.cmd)] - -## Set Up the Database - -Before starting the installation procedure for Drupal, you must create a database on your server. Also create a user and grant this user "db ownership" permission to the database. This article uses the following database information: - -- Database name: **drupal** -- Database user: **drupal** -- Account password: **drupal** - -### Run the Installation Script - -1. Open a Web browser, and go to `http://localhost/drupal/`. The first page of the installation script appears. Click **Install Drupal in English**. The Verify requirements step should proceed automatically unless you are missing requirements. - - ![Screenshot of a browser window with the Drupal language page in a tab.](install-drupal-on-iis/_static/image1.jpg) - *Figure 1: Choose language page* -2. On the **Database configuration page**, type the following information: - - - Database name: **drupal** - - User name: **drupal** - - Password: **drupal** - - Click **Save and continue**. The required database tables are created, and the configuration is saved into the Sites\Default\Settings.php file. Remove the "modify" permissions on this file. - - ![Screenshot of a browser window showing the Drupal database configuration page.](install-drupal-on-iis/_static/image3.jpg) - *Figure 2: Database configuration page* -3. On the **Configure site** page, enter the required configuration information. - - ![Screenshot of a browser window showing the Drupal Configure site page.](install-drupal-on-iis/_static/image5.jpg) - *Figure 3: Configure site page* - -## Enable Clean URLs - -By default, Drupal uses query string parameters for all the URLs it generates for your Web site. With the URL Rewrite Module, however, you can create "clean URLs." - -IIS 6.0 does not have URL rewriting capabilities, so you can use a third-party URL rewriting product such as [ISAPI Rewrite](https://www.iis.net/downloads?tabid=34&g=6&i=1599) or [Ionics ISAPI Rewrite Filter](http://www.codeplex.com/IIRF). - -IIS 7 and above have URL rewriting support, which can be enabled by installing the [URL Rewrite Module](../../extensions/url-rewrite-module/using-the-url-rewrite-module.md). - -The following instructions describe how the URL Rewrite Module for IIS 7 and above can be used to enable clean URLs in Drupal. - -1. Open the **Web.config** file located in `C:\inetpub\wwwroot\drupal` folder. If you do not have a Web.config file in the **drupal** directory, create it. -2. Copy and paste the following XML code into this file. - - [!code-xml[Main](install-drupal-on-iis/samples/sample5.xml)] -3. Save the **web.config** file. -4. Open a Web browser, and go to `http://localhost/Drupal/index.php?q=admin/settings/clean-urls`. - ![Screenshot of a browser window showing the Clean U R L page.](install-drupal-on-iis/_static/image7.jpg) - *Figure 4: Clean URLs page* -5. Under **Clean URLs**, select the **Enabled** option button, and then click **Save configuration**. If you successfully changed the URL format, all the URLs are represented in a hierarchical form that does not use query string parameters (for example, `http://localhost/Drupal/admin/settings/clean-urls`). - -> [!NOTE] -> *This article updates: " Drupal on IIS" by Ruslan Yakushev, published on September 19, 2008.* - -## Links for Further Information - -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md). -- [Installing PHP on Windows Vista with FastCGI](../install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md). -- [Installing FastCGI Support On Server Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md). -- [FastCGI forum](https://forums.iis.net/1104.aspx). -- [PHP community forum](https://forums.iis.net/1102.aspx). -- [Clean URLs on IIS](http://drupal.org/node/3854). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image1.jpg deleted file mode 100644 index a6dad8bfb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image2.jpg deleted file mode 100644 index a6dad8bfb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image3.jpg deleted file mode 100644 index 3820c3d2d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image4.jpg deleted file mode 100644 index 3820c3d2d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image5.jpg deleted file mode 100644 index 3ab82b100..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image6.jpg deleted file mode 100644 index 3ab82b100..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image7.jpg deleted file mode 100644 index 52787eae0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image8.jpg deleted file mode 100644 index 52787eae0..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample1.cmd deleted file mode 100644 index 59c957a36..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Drupal\sites\default>icacls settings.php /grant BUILTIN\IIS_IUSRS:(W) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample2.cmd deleted file mode 100644 index c7be86bb6..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Drupal>icacls sites\default\settings.php /reset \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample3.cmd deleted file mode 100644 index 025d8cf80..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Drupal>md sites\default\files \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample4.cmd deleted file mode 100644 index ff611ac5a..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Drupal>icacls sites\default\files /grant BUILTIN\IIS_IUSRS:(OI)(CI)(M) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample5.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample5.xml deleted file mode 100644 index 84ecf3d3f..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-drupal-on-iis/samples/sample5.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis.md deleted file mode 100644 index 3901694d9..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis.md +++ /dev/null @@ -1,162 +0,0 @@ ---- -title: "Install Joomla! on IIS" -author: ruslany -description: "Introduction Joomla is an open-source content management system (CMS) that lets you build Web sites and powerful online applications, such as: Corporate Web..." -ms.date: 12/12/2008 -ms.assetid: fce8b5fe-9ba3-4ca1-aab1-51d877bb0b17 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis -msc.type: authoredcontent ---- -# Install Joomla! on IIS - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Introduction - -Joomla is an open-source content management system (CMS) that lets you build Web sites and powerful online applications, such as: - -- Corporate Web sites or portals -- Corporate intranets and extranets -- Online magazines, newspapers, and publications -- E-commerce and online reservations -- Government applications -- Small business Web sites -- Non-profit and organizational Web sites -- Community-based portals -- School and church Web sites -- Personal or family home pages - -For more information about Joomla, visit the [Joomla Web site](http://www.joomla.org/). - -This article describes how to install and configure Joomla for use with the FastCGI extension on Internet Information Services 7 (IIS 7) and above on Windows® Web Server 2008. The instructions assume that you have set up and configured the FastCGI extension and the PHP libraries. The instructions have been tested and found to work with the following software versions: - -- PHP 5.2.9 -- MySQL 5.1.34 -- Joomla 1.5.14 - -## Prerequisites - -From the base default configuration file provided by PHP, modify the following lines in your **Php.ini** configuration: - -- Define `extension\_dir` as `c:\php\ext` (for example, the location of your php extensions directory). -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support. - -In order for Joomla to work correctly with IIS 7 and above, it is necessary to install an [Update for IIS FastCGI module for IIS 7](https://blogs.iis.net/ruslany/archive/2008/08/27/update-for-iis-7-0-fastcgi-module.aspx). - -## Download and Unpack the Application - -First, download the latest stable release of [Joomla](http://www.joomla.org/). For this article, Joomla version 1.5.14 was used (future versions are likely to be similar to install). Uncompress the Joomla files and copy them to **C:\Inetpub\wwwroot\joomla** (or another directory of your choosing). - -Before running the Joomla installer, create the configuration file **Configuration.php**, which Joomla uses to store key configuration settings. Assign write permissions to it with the command (from the installation directory): - -[!code-console[Main](install-joomla-on-iis/samples/sample1.cmd)] - -The installer will modify the **Configuration.php** file with information provided during the installation process. - -Joomla uses the Administrator\Cache folder Tmp and therefore needs to be able to write and modify files in this folder. Grant "modify" permissions to the folder: - -[!code-console[Main](install-joomla-on-iis/samples/sample2.cmd)] - -Joomla uses the temporary folder Tmp to store temporary files and therefore needs to be able to write and modify files in this folder. Grant "modify" permissions to the folder: - -[!code-console[Main](install-joomla-on-iis/samples/sample3.cmd)] - -## Set Up the Database - -Before starting the installation procedure for Joomla, you must create a database on your server. Also create a user and grant this user "db ownership" permission to the database. This article uses the following database information: - -- Database name: **joomla** -- Database user: **joomla** -- Account password: **joomla** - -## Run the Installation Script - -1. Start the configuration procedure in a Web browser. Go to `http://localhost/joomla/`. (If the Index.php file is not in the browser default document, then add it.) -2. Select the *language*, and then click **Next**. - - ![Screenshot of the Joomla installation page showing Choose Language in the main pane.](install-joomla-on-iis/_static/image1.jpg) - - *Figure 1: Choose Language page* -3. Verify that all pre-installation checks are successful, and then click **Next**. - - ![Screenshot of the Joomla installation page showing the pre-installation check results in the main pane.](install-joomla-on-iis/_static/image3.jpg) - - *Figure 2: Pre-installation Check page* -4. Review the GNU General Public License, and then click **Next**. - - ![Screenshot of the Joomla installation page showing license information in the main pane.](install-joomla-on-iis/_static/image5.jpg) - - *Figure 3: License page* -5. On this page enter the following information, and then click **Next**. - - - Host Name: **localhost** - - Username: **joomla** - - Password: **joomla** - - Database: **joomla** - - ![Screenshot of the Joomla installation page showing Database Configuration settings in the main pane.](install-joomla-on-iis/_static/image7.jpg) - - *Figure 4: Database Configuration page* -6. On the **FTP Configuration** page, select the **No** option button (not to enable FTP file system layer), and then click **Next**. - - ![Screenshot of the Joomla installation page. F T P configuration settings are showing in the main pane.](install-joomla-on-iis/_static/image9.jpg) - - *Figure 5: FTP Configuration page* -7. Specify the *site name* and the *administrator password*. Click **Next** to complete the installation. - - Note: You may scroll down and install sample data if you prefer. - - ![Screenshot of the Joomla installation page. Main configuration settings are showing in the main pane.](install-joomla-on-iis/_static/image11.jpg) - - *Figure 6: Main Configuration page* -8. The Finish page appears, and you are instructed to delete the `C:\inetpub\wwwroot\joomla\installation` directory. - - ![Screenshot of the Joomla installation page showing the Finish page in the main pane.](install-joomla-on-iis/_static/image13.jpg) - - *Figure 7: Finish page* -9. You can now go to the Joomla site. - - ![Screenshot showing the main Joomla web site .](install-joomla-on-iis/_static/image15.jpg) - - *Figure 8: Joomla site* - -## Enable Search Engine Friendly URLs - -By default, Joomla uses query string parameters for all the URLs it generates for your Web site. You change this by enabling search engine friendly URLs, a feature which relies on the URL rewriting functionality. - -IIS 6.0 does not include URL rewriting capabilities; you can use a third-party URL rewriting product such as [ISAPI\_Rewrite](https://www.iis.net/downloads?tabid=34&g=6&i=1599) or [Ionics ISAPI Rewrite Filter](http://www.codeplex.com/IIRF). - -IIS 7 and above includes URL rewriting support, which can be enabled by installing [Microsoft URL Rewrite Module for IIS 7](https://www.microsoft.com/downloads/details.aspx?familyid=836778EA-B2F2-4907-B2DC-A152EC0A4BC4&displaylang=en). - -1. Download and install the **Microsoft URL Rewrite Module**. -2. If it does not already exist; create and open a **Web.config** file located in the `C:\inetpub\wwwroot\joomla` directory. -3. Paste the following XML code into this file. - - [!code-xml[Main](install-joomla-on-iis/samples/sample4.xml)] -4. Save the **web.config** file. -5. Open a Web browser, and log on to the Joomla administrator console at `http://localhost/joomla/administrator/`. -6. Click on **Site** --> **Global Configuration** menu to configure SEO Settings: - - - Search Engine Friendly URLs - **Yes** - - Add suffix to URLs - **No** - ![Screenshot showing the global configuration Joomla page.](install-joomla-on-iis/_static/image17.jpg) - *Figure 9: Global Configuration page* -7. Click **Apply** to save the configuration. -8. Restart **Windows® Internet Explorer®**. -9. Go to `http://localhost/joomla/`. All links in Joomla pages now have URLs without query string parameters. If you click on any of these links, the server returns a correct response: - - ![Screenshot showing links on a Joomla page.](install-joomla-on-iis/_static/image19.jpg) - - *Figure 10: Links in Joomla page* - -> [!NOTE] -> *This article updates " Joomla! on IIS" by Ruslan Yakushev, published on December 12, 2008.* - -## Links for Further Information - -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md). -- [Installing PHP on Windows Vista with FastCGI](../install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md). -- [Installing FastCGI Support On Server Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md). -- [FastCGI forum](https://forums.iis.net/1104.aspx). -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image1.jpg deleted file mode 100644 index 1103e0e99..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image10.jpg deleted file mode 100644 index e79cd2508..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image11.jpg deleted file mode 100644 index 9bbcb8bad..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image12.jpg deleted file mode 100644 index 9bbcb8bad..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image13.jpg deleted file mode 100644 index c9c495391..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image14.jpg deleted file mode 100644 index c9c495391..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image15.jpg deleted file mode 100644 index 32df357e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image16.jpg deleted file mode 100644 index 32df357e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image17.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image17.jpg deleted file mode 100644 index a65845e55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image18.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image18.jpg deleted file mode 100644 index a65845e55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image19.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image19.jpg deleted file mode 100644 index af4337dc7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image19.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image2.jpg deleted file mode 100644 index 1103e0e99..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image20.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image20.jpg deleted file mode 100644 index af4337dc7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image20.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image3.jpg deleted file mode 100644 index 09cca209a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image4.jpg deleted file mode 100644 index 09cca209a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image5.jpg deleted file mode 100644 index 1c448d51c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image6.jpg deleted file mode 100644 index 1c448d51c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image7.jpg deleted file mode 100644 index 96c887ad7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image8.jpg deleted file mode 100644 index 96c887ad7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image9.jpg deleted file mode 100644 index e79cd2508..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample1.cmd deleted file mode 100644 index a2cb9455c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\joomla>icacls configuration.php /grant BUILTIN\IIS_IUSRS:W \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample2.cmd deleted file mode 100644 index d87dc0ca2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Joomla>icacls administrator\cache /grant BUILTIN\IIS_IUSRS:(OI)(CI)(M) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample3.cmd deleted file mode 100644 index 35b0a0d93..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\inetpub\wwwroot\Joomla>icacls tmp /grant BUILTIN\IIS_IUSRS:(OI)(CI)(M) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample4.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample4.xml deleted file mode 100644 index f6fa2e23d..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-joomla-on-iis/samples/sample4.xml +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis.md deleted file mode 100644 index 3a3019773..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: "Install osCommerce on IIS" -author: rick-anderson -description: "Introduction OsCommerce is an open-source online shopping and e-commerce solution that is available for free under the GNU General Public License. It feature..." -ms.date: 01/15/2008 -ms.assetid: 08359c89-a4f4-438e-8935-daea7e6aaff4 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis -msc.type: authoredcontent ---- -# Install osCommerce on IIS - -by Eric Woersching - -## Introduction - -OsCommerce is an open-source online shopping and e-commerce solution that is available for free under the GNU General Public License. It features a rich set of online shopping cart functionality that lets users set up, run, and maintain their online stores with minimal effort and with no costs, fees, or limitations. - -For more information about osCommerce, visit the [osCommerce Web site](http://www.oscommerce.com/). - -This article describes how to install and configure osCommerce for use with the FastCGI extension on Internet Information Services 7 (IIS 7) and above and on Windows Server® 2008 R2. The instructions assume that you have set up and configured the FastCGI extension and the PHP libraries. - -## Download and Unpack the Application - -First, download the latest stable release of [osCommerce](https://www.oscommerce.com/download-oscommerce). For this article, oscommerce-2.2ms2-060817 was used. Uncompress the osCommerce files and copy the files in the "catalog" folder to `C:\Inetpub\wwwroot\oscommerce`. - -Set the permissions on the **osCommerce/include/Configure.php** file to read, write, and execute. (If these permissions are not set correctly, you get an error message.) - -Before running the osCommerce installer, grant "Write" permissions to the **Configure.php** file. - -[!code-console[Main](install-oscommerce-on-iis/samples/sample1.cmd)] - -## Set Up the Database - -Before starting the installation procedure for osCommerce, you must create a database on your server. Also create a user and grant this user "db ownership" permission to the database.This article uses the following database information: - -- Database name: **oscommerce** -- Database user: **oscommerceuser** -- Account password: **oscommerce** - -## Set Up and Configure the Application - -Update the **Php.ini** file to add the **Php\_mysql.dll** module under the **Dynamic Extensions** section in the file, and ensure that the extension directory points to the correct location: - -[!code-console[Main](install-oscommerce-on-iis/samples/sample2.cmd)] - -1. Start the configuration procedure in a Web browser. Go to `http://www.my-server.com/osCommerce/catalog`. (If the Index.php file is not in the browser default document, then add it.) -2. Click on the installation link on the top of the page to redirect to the Install Wizard. The welcome page appears on the Web browser, and the configuration procedure can be started by clicking **Continue**. - - ![Screenshot of the o s Commerce welcome page in a web browser.](install-oscommerce-on-iis/_static/image1.jpg) - - *Figure 1: Welcome screen* -3. Next, provide details for the osCommerce database that you have created. Click **Continue**. - - ![Screenshot of the specified o s Commerce Database Server for a New Installation.](install-oscommerce-on-iis/_static/image3.jpg) - - *Figure 2: Database import* -4. You can now accept the default settings; or you can change the *URL* in the **WWW Address** box and change the *path* in the **Webserver Root Directory** box. Click **Continue**. - - ![Screenshot of the specified Web Server for a New o s Commerce Installation.](install-oscommerce-on-iis/_static/image5.jpg) - - *Figure 3: Database import was successful* -5. Provide the information for your new Online Store, and then click **Continue**. - - ![Screenshot of the specified Online Store Settings for a New o s Commerce Installation.](install-oscommerce-on-iis/_static/image7.jpg) - - *Figure 4: osCommerce configuration* -6. The following message appears after a successful installation. - - ![Screenshot of the confirmation page after successfully installing.](install-oscommerce-on-iis/_static/image9.jpg) - - *Figure 5: osCommerce configuration successful* - -## Post Installation - -After installing osCommerce, follow these steps to make your application secure and functional. - -1. Rename or delete the **osCommerce/install** folder. -2. Reset the permissions on **osCommerce/includes/configure.php** to read and execute. -3. Set the permissions on the **osCommerce/images** directory to read, write, and execute. -4. Set the permissions on the **admin/images/graphs** directory to read, write, and execute. -5. Create the directory **admin/backups** and set the permissions to read, write, and execute. (Save the database backup of your store in the "Tools" section of store administration in the **admin/backups** directory). - -## Test osCommerce - -To test that osCommerce was successfully installed, try to chat with an operator to obtain support: - -1. Go to `http://localhost/oscommerce/index.php`. - - ![Screenshot of the new o s Commerce test site home page.](install-oscommerce-on-iis/_static/image11.jpg) - - *Figure 6: osCommerce page* -2. Shop by selecting the items available in the left panel. - - ![Screenshot of the shopping cart with one item in the o s Commerce site.](install-oscommerce-on-iis/_static/image13.jpg) - - *Figure 7: Shop at osCommerce* - -> [!NOTE] -> *This article updates " osCommerce on IIS" by Eric Woersching, published on October 24, 2008.* - -## Links for Further Information - -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md). -- [Installing PHP on Windows Vista with FastCGI](../install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md). -- [Installing FastCGI Support On Server Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md). -- [FastCGI forum](https://forums.iis.net/1104.aspx). -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image1.jpg deleted file mode 100644 index c88a46499..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image10.jpg deleted file mode 100644 index f46db8f8b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image11.jpg deleted file mode 100644 index 742aaf065..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image12.jpg deleted file mode 100644 index 742aaf065..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image13.jpg deleted file mode 100644 index 18a05c612..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image14.jpg deleted file mode 100644 index 18a05c612..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image2.jpg deleted file mode 100644 index c88a46499..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image3.jpg deleted file mode 100644 index 3d5b5d503..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image4.jpg deleted file mode 100644 index 3d5b5d503..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image5.jpg deleted file mode 100644 index b99d55d08..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image6.jpg deleted file mode 100644 index b99d55d08..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image7.jpg deleted file mode 100644 index eaea0e15a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image8.jpg deleted file mode 100644 index eaea0e15a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image9.jpg deleted file mode 100644 index f46db8f8b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample1.cmd deleted file mode 100644 index 280623231..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample1.cmd +++ /dev/null @@ -1,2 +0,0 @@ -C:\inetpub\wwwroot\oscommerce\catalog\includes>icacls configure.php /grant BUILTIN\IIS_IUSRS:W -C:\inetpub\wwwroot\oscommerce\catalog\admin\includes>icacls configure.php /grant BUILTIN\IIS_IUSRS:W \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample2.cmd deleted file mode 100644 index edb852170..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-oscommerce-on-iis/samples/sample2.cmd +++ /dev/null @@ -1,2 +0,0 @@ -extension_dir = "./ext" -extension=php_mysql.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis.md deleted file mode 100644 index 20da03c18..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: "Install WordPress on IIS" -author: rick-anderson -description: "Introduction WordPress is a blog publishing application and content management system. According to wordpress.org, WordPress is “a state-of-the-art semantic..." -ms.date: 12/18/2007 -ms.assetid: 788066e2-c44d-4cea-b1fc-6ae6cab25454 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis -msc.type: authoredcontent ---- -# Install WordPress on IIS - -by Eric Woersching - -## Introduction - -WordPress is a blog publishing application and content management system. According to wordpress.org,WordPress is "a state-of-the-art semantic personal publishing platform with a focus on aesthetics, Web standards, and usability." The following sections describe how to install and configure WordPress for use with FastCGI on Internet Information Services 7 (IIS 7) and above. This document assumes that you have completed the setup and configuration of the [FastCGI extension and PHP libraries](using-fastcgi-to-host-php-applications-on-iis-60.md). - -The easiest way to install WordPress is by downloading it from the Windows® Web App Gallery. If you need the Microsoft® Web Platform, you can install the components with the Microsoft® Web Platform Installer (Web PI), which is also available at the [Windows Web App Gallery](https://www.microsoft.com/web/gallery/Categories.aspx?sorting=alphabetical). - -The following article provides guidance for installing WordPress manually. The instructions have been tested and found to work in the following configurations: - -- Windows Server® 2008 operating system -- IIS 7 -- PHP 5.2.9 -- MySQL 5.1.34 -- WordPress 2.8.5 - -## Prerequisites - -From the base default configuration file provided by PHP, modify the following lines in your Php.ini configuration: - -- Define `extension\_dir` as `c:\php\ext` (for example, the location of your php extensions directory). -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support. - -## Download and Unpack the Application - -First, download the latest stable release of [WordPress](http://wordpress.org/download/). For this article, WordPress version 2.8.5 was used. Uncompress the WordPress files and copy the files to `C:\Inetpub\wwwroot\wordpress` or another directory of your choosing. There is no need to modify permissions on the WordPress Web directory, because the default permissions suffice. - -## Set Up the Database - -Before starting the installation procedure for WordPress, you must create a database on your server. Also create a user and grant this user "db ownership" permission to the database. This article uses the following database information: - -- Database name: **wordpress** -- Database user: **wordpress** -- Account password: **wordpress** - -## Modify the Configuration File - -Modify the WordPress configuration file to connect to the database. - -1. From **Windows® Explorer**, navigate to the installation directory `C:\inetpub\wwwroot\wordpress`, and rename the file **wp-config-sample.php** to **wp-config.php**. -2. Edit **wp-config.php**; change the **DB\_NAME**, **DB\_USER**, **DB\_PASSWORD**, and **DB\_HOST** values as follows: - -[!code-xml[Main](install-wordpress-on-iis/samples/sample1.xml)] - -## Setup and Configure the Application - -1. From **Windows® Internet Explorer®**, go to `http://localhost/wordpress/wp-admin/install.php`. -2. Type the *name* of your blog and your *e-mail address*, and then click **Install WordPress**. - - ![Screenshot of a browser window showing the WordPress installation page.](install-wordpress-on-iis/_static/image1.jpg) - - *Figure 1: Enter information* -3. Note the temporary password assigned for the administrator account. - - ![Screenshot of a browser window showing the WordPress success page.](install-wordpress-on-iis/_static/image3.jpg) - - *Figure 2: Note the administrator password* -4. Begin managing your blog from `http://localhost/wordpress/wp-login.php`. - - ![Screenshot of a browser window showing the WordPress log in page.](install-wordpress-on-iis/_static/image5.jpg) - - *Figure 3: Log on to blog* -5. The Welcome page appears. - - ![Screenshot of a browser window showing the WordPress welcome page.](install-wordpress-on-iis/_static/image7.jpg) - - *Figure 4: Welcome page* - -## Enable "Pretty Permalinks" - -Typically, WordPress users must use "almost pretty" URLs (for example, `http://contoso.com/index.php/yyyy/mm/dd/post-name/`). With the URL Rewrite module, you can create "Pretty Permalinks" (for example, `http://example.com/year/month/day/post-name/`) for WordPress blogs hosted on IIS. - -The steps that follow assume that WordPress is installed in a Web site root directory. If WordPress is installed in a subdirectory, then the rewrite rules must be included in the Web.config file located within the same subdirectory as the WordPress files. - -1. Install **URL Rewrite Go Live** release. -2. Log on to **WordPress** as an administrator. -3. Click the **Settings** button. -4. Click the **Permalinks** tab for the **Customize Permalink Structure** page. - - ![Screenshot of a browser window showing the permalink settings page. Settings is selected on the dashboard pane.](install-wordpress-on-iis/_static/image9.jpg) - - *Figure 5: Customize permalink structure page* -5. Select **Custom Structure**, and then type - **/%year%/%monthnum%/%day%/%postname%/** in the **Custom Structure** text box. -6. Click **Save Changes**. You will see that all the blog post links have URLs that follow the format you have specified; however, if you click any link, the Web server returns a 404 - File Not Found error, because WordPress relies on a URL rewriting capability within a server to rewrite requests that have "pretty permalinks" to an Index.php file. - -## Create Rewrite Rule - -1. Open the **Web.config** file (located in the same directory as the WordPress files). If you do not have a Web.config file in the WordPress directory, create it. -2. Copy and paste the following XML section into the system.webServer element: - - [!code-xml[Main](install-wordpress-on-iis/samples/sample2.xml)] - -This rule matches any requested URL; if the URL does not correspond to a file or a folder on a file system, then the rule rewrites the URL to Index.php and determines which content to serve based on the REQUEST\_URI server variable that contains the original URL before it was modified by the rule. - -## Test the Rewrite Rule - -After the rewrite rule is saved to the Web.config file, open a Web browser, and then click any one of the permalinks in WordPress blog. You should see the correct content returned by the Web server for every permalink. - -![Screenshot of a browser window showing the example blog welcome page.](install-wordpress-on-iis/_static/image11.jpg) -*Figure 6: Blog welcome page* - -> [!NOTE] -> *This article updates " WordPress on IIS" by Eric Woersching, published on September 11, 2008.* - -## Links for Further Information - -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md). -- [Installing PHP on Windows Vista with FastCGI](../install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md). -- [Installing FastCGI Support On Server Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md). -- [FastCGI forum](https://forums.iis.net/1104.aspx). -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image1.jpg deleted file mode 100644 index b118d0da6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image10.jpg deleted file mode 100644 index 01608fd55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image11.jpg deleted file mode 100644 index 887d82e03..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image12.jpg deleted file mode 100644 index 887d82e03..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image2.jpg deleted file mode 100644 index b118d0da6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image3.jpg deleted file mode 100644 index 959f8a743..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image4.jpg deleted file mode 100644 index 959f8a743..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image5.jpg deleted file mode 100644 index 738bdc39a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image6.jpg deleted file mode 100644 index 738bdc39a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image7.jpg deleted file mode 100644 index a6df9f062..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image8.jpg deleted file mode 100644 index a6df9f062..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image9.jpg deleted file mode 100644 index 01608fd55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample1.xml deleted file mode 100644 index 436e975e2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample1.xml +++ /dev/null @@ -1,23 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample2.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample2.xml deleted file mode 100644 index 74d78fe4f..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis/samples/sample2.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis.md deleted file mode 100644 index 77ea7a7fe..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: "Install Zen Cart on IIS" -author: rick-anderson -description: "Zen Cart is a PHP-based, open-source online store management system. It uses a MySQL database and HTML components. Support is provided for several languages..." -ms.date: 01/15/2008 -ms.assetid: 5500e35b-b189-46dd-aa51-a222ef773b82 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis -msc.type: authoredcontent ---- -# Install Zen Cart on IIS - -by Eric Woersching - -## Introduction - -Zen Cart is a PHP-based, open-source online store management system. It uses a MySQL database and HTML components. Support is provided for several languages and currencies, and it is freely available under the GNU General Public License (GPL). - -For more information about Zen Cart, visit the [Zen Cart](http://www.zen-cart.com/) Web site. - -This article describes how to install and configure Zen Cart for use with the FastCGI extension on Internet Information Services 7 (IIS 7) and above, and on Windows Server® 2008. The instructions assume that you have set up and configured the FastCGI extension and the PHP libraries. The instructions have been tested and found to work with the following software versions: - -- PHP 5.2.9 -- MySQL 5.1.34 -- Zen Cart 1.3.8 - -## Download and Unpack the Application - -First, download the latest stable release of [Zen Cart](http://www.zen-cart.com/). For this article, zen-cart-v1.3.8 was used (future versions are likely to be similar to install). Uncompress and copy all the files and folders to `C:\Inetpub\wwwroot\zencart` (or another directory of your choosing). - -## Set Up the Database - -Before starting the installation procedure for Zen Cart, you must create a database on your server. Also create a user and grant this user "db ownership" permission to the database. This article uses the following database information: - -- Database name: **zencart** -- Database user: **zencart** -- Account password: **zencart** - -## Set Up and Configure the Application - -Update the **Php.ini** file to add the **Php\_mysql.dll** module under the **Dynamic Extensions** section in the file, and ensure that the extension directory points to the correct location: - -[!code-console[Main](install-zen-cart-on-iis/samples/sample1.cmd)] - -Note that this article uses the "/zencart" folder as an example, but this is not required. You may use another folder, or you can install Zen Cart in the "root" directory (the base of your Web site). - -## Create the Configure.php Files - -You must create files to identify the settings of your particular server and the location of the Zen Cart files you loaded, and then change the permissions on these files. - -1. On the server, locate the file **/zencart/includes/dist-configure.php**. -2. Rename this file to **configure.php**. -3. On the server, locate the file **/zencart/admin/includes/dist-configure.php**. -4. Rename this file to **configure.php**. -5. Change the permissions for these two files to read, execute, and write by opening a command prompt. -6. Browse to the `C:\inetpub\wwwroot\zencart` directory. -7. Type **icacls includes\configure.php /grant BUILTIN\IIS\_IUSRS:W** -8. Type **icacls admin\includes\configure.php /grant BUILTIN\IIS\_IUSRS:W** -9. Type **icacls cache /grant BUILTIN\IIS\_IUSRS:W** - -## Run the Installer - -The installer automatically supplies information during installation, but you must confirm that the auto-detected answers are correct (they may differ on some servers): - -1. Confirm the *physical path* to your Zen Cart directory (for example, `C:\Inetpub\wwwroot\zencart`). -2. Go to the http://localhost/zc\_install/zencart/install.php page for detailed setup instructions. -3. On the **Welcome** screen, click **Continue.** -4. At the **license page**, read and confirm acceptance of the GPL licensing agreement. -5. The installer examines your server for compliance with the technical requirements for running Zen Cart. Anything marked in red or with an "X" must be addressed before the installer can continue. Items marked with an orange or yellow caution symbol are simply warnings that may or may not apply to your setup at this point. -6. If you make changes to your server, click **Re-Check** (or press **F5** in your browser) to refresh the display and reflect the changes made before proceeding. -7. When the system inspection is satisfactory (all green check marks), click **Install** at the bottom of the screen. - - [![Screenshot of System inspection results. Green check marks appear on the left hand side of the list. ](install-zen-cart-on-iis/_static/image2.jpg)](install-zen-cart-on-iis/_static/image1.jpg) - - *Figure 1: System inspection results* -8. Provide database information about your *MySQL database*, *user name*, and *password*. If you do not have a MySQL database setup with a user name and password, you must create one. - - [![Screenshot of the My S Q L database. The Database setup information is displayed.](install-zen-cart-on-iis/_static/image4.jpg)](install-zen-cart-on-iis/_static/image3.jpg) - - *Figure 2: Database setup* -9. Next, you are prompted for *phpBB path* information. If you have the phpBB forum software already installed on your site, enable it for connectivity and synchronization from Zen Cart by specifying the path where the phpBB files are located. (For example, if the files are located in ...public\_html/forums, enter /forums in the Zen Cart installer for the path to the phpBB files.) - If you do not have the phpBB forum software already installed on your site, select **No**. -10. Complete the Store information about your e-commerce shop. Except for demonstration data, all of the information can also be (re)configured later in the administrator area of your shop. -11. To install the demonstration data, select **Yes**, and then click **Save Store Settings**. -12. Complete the administrator information to set your *login name*, *admin e-mail address*, and *password*. Note that both the login name and password are case sensitive. -13. Save the administrator settings to complete installation. Providing there were no errors during installation, you can now enter the Admin or the Catalog. - -## After Installation - -When you enter the Catalog, you receive security warnings about the Configure.php files and the /zc\_install directory. - -### Configure.php files - -Change the permissions on the **Configure.php** files to read and execute: - -[!code-console[Main](install-zen-cart-on-iis/samples/sample2.cmd)] - -Note that "zencart" is used as an example in this article; your site may or may not include "zencart" as a folder name. - -1. Open a command prompt. -2. Browse to `c:\inetpub\wwwroot\zencart`. -3. Type **icacls includes\configure.php /reset** -4. Type **icacls admin\includes\configure.php /reset** -5. Download a copy of these files to your computer from the server; they have been set up and configured to your server specifications based on the installation process. Most errors or problems can be corrected with minor adjustments to these two files. - -### zc\_install directory - -Delete the **/zencart/zc\_install** directory. If you are only testing and plan to install again, rename the folder (for example, /catalog/zc\_install\_complete) until you take your site live. - -Note that it is better to use a name other than zc\_install\_complete; some hackers may try to use it if they have read this help file. - -For security reasons, do not leave a zc\_install folder on the server of a live site. - -> [!NOTE] -> *This article updates " Zen Cart on IIS" by Eric Woersching, published on March 19, 2008.* - -## Links for Further Information - -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](using-fastcgi-to-host-php-applications-on-iis.md). -- [Installing PHP on Windows Vista with FastCGI](../install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md). -- [Installing FastCGI Support On Server Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md). -- [FastCGI forum](https://forums.iis.net/1104.aspx). -- For more information about running PHP applications on IIS, see the [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image1.jpg deleted file mode 100644 index 596057234..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image2.jpg deleted file mode 100644 index 596057234..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image3.jpg deleted file mode 100644 index 78fef9459..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image4.jpg deleted file mode 100644 index 78fef9459..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample1.cmd deleted file mode 100644 index 80c80ffba..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample1.cmd +++ /dev/null @@ -1,2 +0,0 @@ -extension_dir = "./ext" -extension=php_mysql.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample2.cmd deleted file mode 100644 index 2674ad687..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/install-zen-cart-on-iis/samples/sample2.cmd +++ /dev/null @@ -1,3 +0,0 @@ -/zencart/includes/configure.php - -/zencart/admin/includes/configure.php \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis.md deleted file mode 100644 index f3523ce51..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "LimeSurvey on IIS" -author: rick-anderson -description: "LimeSurvey is a fully functional online survey development and data entry system including data entry screen, public data entry script, conditional questions..." -ms.date: 08/02/2016 -ms.assetid: aa9490ce-563b-496d-bbd1-8d2ff2839073 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis -msc.type: authoredcontent ---- -# LimeSurvey on IIS - -by Eric Woersching - -## Introduction - -LimeSurvey is a fully functional online survey development and data entry system including data entry screen, public data entry script, conditional questions, method for issuing unqiue invitation links (tokens), emailing invitations and recording responses, and basic statistical analysis. - -For more information about LimeSurvey, see [https://www.limesurvey.org/](http://www.limesurvey.org/). - - In this section, we go through the steps required to install LimeSurvey to work with FastCGI extension on IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [this article](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack LimeSurvey - -First, download the latest stable release of the LimeSurvey application. For this article, we use LimeSurvey 2.5x downloaded from [https://www.limesurvey.org/#download](http://sourceforge.net/project/showfiles.php?group_id=74605.ir) - -Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\limesurvey`. - -## Set Up the Database - -Before starting the installation procedure for LimeSurvey, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'limesurvey' -- Database User: 'limesurveyuser' -- Account Password: 'limesurvey' - -## Set Up and Configure LimeSurvey - -### Install Required Libraries - -LimeSurvey requires two libraries named mbstring and php\_pdo\_mysql. To enable both libraries, open the PHP.ini file located in the PHP installation folder and search for mbstring and php\_pdo\_mysql. The lines that contain these stringsare most likely commented out with a semicolon. Remove the semicolons, save and restart your Web server. - LDAP and GD are optional libraries for the LimeSurvey tool. We have not enabled these tools for our application. - -### Run the Installation Script - -Go to `http://localhost/limesurvey/admin`. Now the LimeSurvey installation script starts. - -![Screenshot of the Lime Survey installation script. The Progress and Welcome text are shown.](limesurvey-on-iis/_static/image1.png) - -Follow the administration step – when you come to the database configuration screen please enter the credentials you configure for your database. - -![Screenshot of the local host slash lime survey slash admin web page. The Lime Survey installation script starts. The language selection menu is shown.](limesurvey-on-iis/_static/image2.png) - -### Login to the LimeSurvey Administration - -After completing the installation you will be forwarded to the administration login page at `http://your.domain.com/limesurvey/admin`. - -You should get the followin login screen. If you did not change the administration username and password during installation the default credentials are “admin” and “password” and must be changed as soon as possible. - -![Screenshot of the Lime Survey Administration log in page. The Username, Password, and Language boxes are shown.](limesurvey-on-iis/_static/image3.png) - -![Screenshot of the Lime Survey administration interface page. Options to Create survey, List Surveys, Global Settings, Comfort Update, Label sets, and templates are shown.](limesurvey-on-iis/_static/image4.png) - -## How to Use LimeSurvey - -Refer to the below link for admin setup and using LimeSurvey. - -[http://manual.limesurvey.org/](http://manual.limesurvey.org/) - -If you would like to check out/import some sample survey there are several surveys available in `C:\Inetpub\wwwroot\limesurvey\docs\samplesurveys` - -Refer to the following screen shots for the survey. - -![Screenshot of the Sample Lime Survey page. Two questions are shown. The first question asks What city do you live in? The second question asks How long have you lived in years?](limesurvey-on-iis/_static/image5.png) - -![Screenshot of the Sample Lime Survey page. The question Which do you like best about? is written on the page. Choices are given in a drop down menu.](limesurvey-on-iis/_static/image6.png) - -## Getting More Information - -To discuss the FastCGI support in IIS, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx) -- [IIS 7.0 FastCGI forums](https://forums.iis.net/1104.aspx) - -To get more information regarding running various PHP applications on IIS refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image1.png deleted file mode 100644 index abe45ed17..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image2.png deleted file mode 100644 index 71436e2df..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image3.png deleted file mode 100644 index f7a13898a..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image4.png deleted file mode 100644 index d355d90c1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image5.png deleted file mode 100644 index 235543b1b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image6.png deleted file mode 100644 index 8b84fbbc7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/limesurvey-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis.md deleted file mode 100644 index 989defec4..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: "Mambo on IIS" -author: rick-anderson -description: "Mambo is a free, open source content management system (CMS) that is developed in the PHP scripting language. It is a dynamic CMS and uses the free MySQL dat..." -ms.date: 12/18/2007 -ms.assetid: efd4ad25-b442-43a1-91a9-27fdf94cc370 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis -msc.type: authoredcontent ---- -# Mambo on IIS - -by Eric Woersching - -Mambo is a free, open source content management system (CMS) that is developed in the PHP scripting language. It is a dynamic CMS and uses the free MySQL database for storing data. The following sections describe how to install and configure Mambo for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described in [Using FastCGI to Host PHP Applications on IIS 6.0](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Notes on PHP Setup - -Mambo does not require many modifications beyond the default configuration provided by PHP. From the base configuration file provided by PHP, you only need to modify the following lines in your php.ini configuration file to get Mambo working: - -- Define `extension\_dir` as `c:\php\ext` (that is, the location of your php extensions directory) -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support - -## Download and Unpack the Application - -Download the latest stable release of Mambo. For this article we, use Mambo 4.6.2 downloaded from `http://www.source.mambo-foundation.org/content/view/90/63/`. After downloading the zip package, extract its contents to `C:\Inetpub\wwwroot\mambo` or another directory of your choosing. - -## Set Up the Database - -Before starting the installation procedure for Mambo, create a database on your server. Also create a database user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information - -- Database Name: 'mambo' -- Database User: 'mambouser' -- Account Password: 'mambo' - -## Directory Permissions Setup - -Enable write permission on the Mambo directory for the account that your web server uses for impersonation. For example, if you have configured the web site to impersonate Anonymous users to "Internet Guest Account" (IUSR\_\*), then you must grant this user write access to the directory: - -![Screenshot of the Permissions for Mambo dialog box. The Security Tab is displayed.](mambo-on-iis/_static/image1.png) - -## Configure the Application - -1. Open your web browser and browse to `http://localhost/mambo/installation/index.php`. This takes you to the Mambo setup page, where you see the results of the Mambo pre-installation tests. -2. When you have ensured that all the tests have passed, click "Next>>" at the top of the page. - - > [!NOTE] - > You can safely ignore the Session save path at this stage. If it is not set, Mambo will still function. - - ![Screenshot of a web browser screen displaying the Mambo Setup page. The results of the pre-installation check are displayed. ](mambo-on-iis/_static/image3.png) -3. On the next page Mambo, asks you to enter the DB information. Enter the correct information and click "Next >>". - - > [!NOTE] - > If your MySQL Server is configured to have strict mode enabled, then this step may fail. You must disable strict mode for MySQL in order for Mambo to succeed with the database setup. - - ![Screenshot of a web browser screen displaying the Mambo Installation website. The step 1 tab is displayed.](mambo-on-iis/_static/image5.png) -4. Enter your site's name. This is the global title of your Mambo-driven site. Enter a name, then press "Next >>" - ![Screenshot of a web browser screen displaying the Mambo Installation website. The step 2 tab is displayed.](mambo-on-iis/_static/image7.png) -5. In the next step, enter details for your site. The URL should be set to the external sitename to ensure proper configuration. In a local test setup, the URL may have an extra Mambo at the end (for example, `http://localhost/Mambo/Mambo`). Enter your administrator email and password. The final two options should be left in the default choices. Press "Next >>" - ![Screenshot of a web browser screen displaying the Mambo Installation website. The step 3 tab is displayed.](mambo-on-iis/_static/image9.png) -6. You are now finished setting up Mambo. Record your admin password. Delete the "installation" folder from `C:\Inetpub\wwwroot\Mambo` - - > [!NOTE] - > You must change the access permissions on the Mambo folder. Now that installation is complete, write access is not needed. - -Once the permissions have been specified, browse to `http://localhost/Mambo/index.php` for the "public" site, or log on at `http://localhost/Mambo/administrator/index.php` using the administrative username and password that you specified earlier. - -## Enabling search engine friendly URLs - -When hosting Mambo on IIS 7.0 it is possible to configure it to enable search engine friendly URLs. To do that follow these steps: - -1. Install [Microsoft URL Rewrite Module for IIS 7.0](https://www.iis.net/downloads/microsoft/url-rewrite "URL rewrite module") -2. Open configuration.php file in the folder where Mambo is installed and set $mosConfig\_sef= "1" -3. Create a web.config file in the same folder where Mambo is installed and paste into it the following: - - [!code-xml[Main](mambo-on-iis/samples/sample1.xml)] - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET/ IIS 6 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image1.png deleted file mode 100644 index c7f46b184..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image3.png deleted file mode 100644 index b9aa915b9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image5.png deleted file mode 100644 index 275281c4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image7.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image7.png deleted file mode 100644 index 69c970c81..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image9.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image9.png deleted file mode 100644 index a547a8ae2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/samples/sample1.xml deleted file mode 100644 index 862f0d447..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mambo-on-iis/samples/sample1.xml +++ /dev/null @@ -1,25 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis.md deleted file mode 100644 index f050ba135..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: "MediaWiki on IIS" -author: rick-anderson -description: "Introduction The following sections describe how to install and configure MediaWiki for use with FastCGI on Windows Server ® 2008. This document assumes that..." -ms.date: 01/14/2008 -ms.assetid: 1585f0f4-af98-42f5-9e51-433aa1456be8 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis -msc.type: authoredcontent ---- -# MediaWiki on IIS - -by Eric Woersching - -## Introduction - -The following sections describe how to install and configure [MediaWiki](http://www.mediawiki.org/wiki/MediaWiki) for use with FastCGI on Windows Server® 2008. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described [here](using-fastcgi-to-host-php-applications-on-iis.md). - -The instructions have been tested and found to work in the following configuration: - -- Windows Server 2008 RC0 -- IIS 7.0 -- PHP 5.2.4 Non-thread-safe Win32 binaries (RC2-dev) -- MySQL 5.0 -- MediaWiki 1.11.0 - -## Notes on PHP Setup - -1. Change the default session, upload folders and grant access to the built-in IIS\_IUSRS group. -2. Open a Command Prompt window with administrator privileges and run the following commands: - - [!code-console[Main](mediawiki-on-iis/samples/sample1.cmd)] - - [!code-console[Main](mediawiki-on-iis/samples/sample2.cmd)] - - [!code-console[Main](mediawiki-on-iis/samples/sample3.cmd)] - - From the base configuration file provided by PHP, you will need to modify your php.ini to have the following definitions: - - [!code-console[Main](mediawiki-on-iis/samples/sample4.cmd)] - - [!code-console[Main](mediawiki-on-iis/samples/sample5.cmd)] -3. Enable PHP support for MySQL. Modify your php.ini to define the extensions directory and uncomment the PHP MySQL extension definition: - - [!code-console[Main](mediawiki-on-iis/samples/sample6.cmd)] - -## Download and Unpack MediaWiki - -The latest release of MediaWiki is found at [https://www.mediawiki.org/wiki/Download](https://www.mediawiki.org/wiki/Download). The instructions in this document are based on version 1.11.0, but future versions are likely to be very similar as far as installation is concerned. - -1. After downloading the GNU zip package, extract its contents to `%SystemDrive%\Inetpub\wwwroot\MediaWiki` or another directory of your choosing. -2. Modify the permissions for the MediaWiki config folder and grant Write permissions for the built-in IIS\_IUSRS group. -3. Open a Command Prompt window with administrator privileges and run the following command: - - [!code-console[Main](mediawiki-on-iis/samples/sample7.cmd)] - -## Configure MediaWiki - -1. Begin the graphical MediaWiki installation procedure by pointing your browser at `http://localhost/mediawiki/config/index.php`. You see the following screen. - - [![Screenshot of the Media Wiki installer Environment checks.](mediawiki-on-iis/_static/image2.jpg)](mediawiki-on-iis/_static/image1.jpg) -2. Scroll down the window and configure your Wiki name and all the required fields. In the Database config section, enable the 'Use superuser account' checkbox and enter the database superuser password. - - [![Screenshot of the Media Wiki installer Database config. The checkbox next to Use Superuser account is checked.](mediawiki-on-iis/_static/image4.jpg)](mediawiki-on-iis/_static/image3.jpg) -3. Once you enter all the required information, click "Install MediaWiki!". The configuration page creates the database wikidb and saves your settings in the `%SystemDrive%\Inetpub\wwwroot\MediaWiki\config\LocalSettings.php` file. - - [![Screenshot of the Media Wiki installer install complete page. The text on the page says Installation successful!](mediawiki-on-iis/_static/image6.jpg)](mediawiki-on-iis/_static/image5.jpg) -4. Move the LocalSetting.php file to the `%SystemDrive%\Inetpub\wwwroot\MediaWiki\` folder and delete the folder `%SystemDrive%\Inetpub\wwwroot\MediaWiki\config` from your system. -5. LocalSetting.php contains sensitive information, so secure it by revoking access to unnecessary identities. Open a Command Prompt window with administrator privileges and run the following command: - - [!code-console[Main](mediawiki-on-iis/samples/sample8.cmd)] - - The previous command grants access only to the following identities: - - - SYSTEM - - BUILTIN\Administrators group - - Network Service -6. The installation is complete. Point your browser to `http://localhost/mediawiki/config/index.php`. - - [![Screenshot of the Media Wiki main page after installation. The text on the page says Media Wiki has been successfully installed.](mediawiki-on-iis/_static/image8.jpg)](mediawiki-on-iis/_static/image7.jpg) - -## Testing the Application - -For testing MediaWiki, create a user and modify the Main Page content. - -1. Navigate to `http://localhost/MediaWiki/index.php`. -2. Click the Log in / create account link in the top right corner. -3. Click the "Create an account" link. -4. Enter the username and password and click "Create account". - - [![Screenshot of the Media Wiki Log in and Create Account page. Boxes for Username, Password, Retype Password, and Real name are shown.](mediawiki-on-iis/_static/image10.jpg)](mediawiki-on-iis/_static/image9.jpg) - - [![Screenshot of the Media Wiki showing First User having been created. The text says Welcome, First User!](mediawiki-on-iis/_static/image12.jpg)](mediawiki-on-iis/_static/image11.jpg) -5. Go to the main page and click the Edit link. An Editor displays in which you can make your changes. When done with changes, click "Save Page". - - [![Screenshot of the Media Wiki editor for the Main Page.](mediawiki-on-iis/_static/image14.jpg)](mediawiki-on-iis/_static/image13.jpg) - -Here is the modified page. - -[![Screenshot of the Media Wiki page post edit. The text says Media Wiki running on I I S seven.](mediawiki-on-iis/_static/image16.jpg)](mediawiki-on-iis/_static/image15.jpg) - -## Enabling clean URLs with URL Rewrite Module - -When hosting MediaWiki on IIS 7.0, it is possible to configure MediaWiki to use URLs without query string by following these steps: - -1. Install [Microsoft URL Rewrite Module for IIS 7.0](https://www.iis.net/downloads?tabid=34&g=6&i=1691 "URL rewrite module") -2. Create a web.config file in the same folder where MediaWiki files were installed and paste into it the following - - [!code-xml[Main](mediawiki-on-iis/samples/sample9.xml)] -3. Update the LocalSettings.php file as follows: - - [!code-console[Main](mediawiki-on-iis/samples/sample10.cmd)] - -## Getting More Information - -To discuss the FastCGI support in IIS, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx) -- [IIS 7.0 FastCGI forums](https://forums.iis.net/1104.aspx) - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image1.jpg deleted file mode 100644 index 21ffcfcc3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image10.jpg deleted file mode 100644 index 4fee5b6f4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image11.jpg deleted file mode 100644 index 572c9b76f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image12.jpg deleted file mode 100644 index 572c9b76f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image13.jpg deleted file mode 100644 index 70af70c39..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image14.jpg deleted file mode 100644 index 70af70c39..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image15.jpg deleted file mode 100644 index b6f8ad2a8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image16.jpg deleted file mode 100644 index b6f8ad2a8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image2.jpg deleted file mode 100644 index 21ffcfcc3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image3.jpg deleted file mode 100644 index a0dc2298d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image4.jpg deleted file mode 100644 index a0dc2298d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image5.jpg deleted file mode 100644 index 0d66c2364..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image6.jpg deleted file mode 100644 index 0d66c2364..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image7.jpg deleted file mode 100644 index 3030b6747..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image8.jpg deleted file mode 100644 index 3030b6747..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image9.jpg deleted file mode 100644 index 4fee5b6f4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample1.cmd deleted file mode 100644 index 2f9922014..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -cd /d C:\php (i.e. the location of your php root directory) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample10.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample10.cmd deleted file mode 100644 index 2cd5a7336..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample10.cmd +++ /dev/null @@ -1,7 +0,0 @@ -## The URL base path to the directory containing the wiki; -## defaults for all runtime URL paths are based off of this. -## For more information on customizing the URLs please see: -## http://www.mediawiki.org/wiki/Manual:Short_URL -$wgScriptPath = "/MediaWiki"; -$wgScriptExtension = ".php"; -$wgArticlePath = "${wgScriptPath}/$1"; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample2.cmd deleted file mode 100644 index 08ae0a4a6..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -md session \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample3.cmd deleted file mode 100644 index 2ced34acc..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample3.cmd +++ /dev/null @@ -1,2 +0,0 @@ -md upload -icacls session /grant BUILTIN\IIS_IUSRS:(OI)(CI)(M) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample4.cmd deleted file mode 100644 index c49a8988e..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -upload_tmp_dir="C:\php\upload" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample5.cmd deleted file mode 100644 index 5c0603718..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -session.save_path = "C:\php\session" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample6.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample6.cmd deleted file mode 100644 index 88109fab1..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample6.cmd +++ /dev/null @@ -1,2 +0,0 @@ -extension_dir = "C:\php\ext" (i.e. the location of your php extensions directory) -extension=php_mysql.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample7.cmd deleted file mode 100644 index 35d20e34d..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ -icacls %SystemDrive%\Inetpub\wwwroot\MediaWiki\config /grant BUILTIN\IIS_IUSRS:(W) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample8.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample8.cmd deleted file mode 100644 index f2394ad4c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -cacls %SystemDrive%\inetpub\wwwroot\MediaWiki\LocalSettings.php /sddl:"D:PAI(A;;FA;;;SY)(A;;FA;;;BA)(A;;FA;;;NS)" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample9.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample9.xml deleted file mode 100644 index 0bacec3d6..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis/samples/sample9.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis.md deleted file mode 100644 index 256b2a9da..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: "OpenAds on IIS" -author: rick-anderson -description: "Introduction OpenAds 2.0 is an ad server written in PHP that allows you to place banners on your website and manage your banners in a professional way. OpenA..." -ms.date: 01/17/2008 -ms.assetid: 641d5740-dcfb-463d-96d7-3ac1d85b2352 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis -msc.type: authoredcontent ---- -# OpenAds on IIS - -by Eric Woersching - -## Introduction - -OpenAds 2.0 is an ad server written in PHP that allows you to place banners on your website and manage your banners in a professional way. OpenAds is open source, which means you have access to the source code, licensed under the General Public License. OpenAds is the latest version of PHPAds. - -For more information about Revive Adserver (formerly OpenAds), see [https://www.revive-adserver.com/](https://www.revive-adserver.com/). - -In this section, we go through the steps required to install OpenAds to work with FastCGI extension on IIS 6.0 and IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack OpenAds - -First, download the latest stable release of the OpenAds application. For this article, we use Revive Adserver (formerly OpenAds). See [https://www.revive-adserver.com/](https://www.revive-adserver.com/). - -Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\openads`. - -## Set Up the Database - -Before starting the installation procedure for osCommerce, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'openads' -- Database User: 'openadsuser' -- Account Password: 'openads' - -## PHP Configuration for OpenAds - -OpenAds requires the following PHP configuration settings in the php.ini file. Refer to the PHP configuration settings document for more information. - -- file\_uploads must be turned on -- register\_long\_arrays must be turned on -- Register\_globals setting must be turned off -- MySql extension must be enabled - -## Running the Installation - -After placing the files on the Web server, make sure the Web server can change the file config.inc.php which holds the basic configuration settings. Check the properties of the file and make sure the read-only flag is not set. - -OpenAds 2.0 contains an automatic installer which does most of the work for you. Do not manually edit the configuration files, because that could cause problems in the future. Follow the guidance given below. - -1. To start the installer, open a Web browser and point it to the directory in which `http://localhost/openads`. This starts the installer automatically. For more information about Revive Adserver (formerly OpenAds), see [https://www.revive-adserver.com/](https://www.revive-adserver.com/). - - ![Screenshot of a browser window showing the OpenAds installer.](openads-on-iis/_static/image1.jpg) -2. Click Continue to start the configuration and read the license agreement. Click I agree. The installer verifies the configuration required for OpenAds. - - ![Screenshot showing the OpenAds system checks page.](openads-on-iis/_static/image3.jpg) - - ![Screenshot showing OpenAds file permission checks with no errors.](openads-on-iis/_static/image5.jpg) -3. Click Continue to go to the database setup. - - ![Screenshot showing the OpenAds database and advanced settings.](openads-on-iis/_static/image7.jpg) -4. Provide the necessary database information and click Continue. The installer checks for the information provided and confirms it in order to continue. - - ![Screenshot of a browser showing the OpenAds database configuration settings.](openads-on-iis/_static/image9.jpg) -5. Provide the necessary information related to the server. Click Continue. - - ![Screenshot of a browser showing the OpenAds server administrator account information.](openads-on-iis/_static/image11.jpg) -6. Provide the administrator account details. Click Continue. - - ![Screenshot of a browser showing the OpenAds installation progress bar and details.](openads-on-iis/_static/image13.jpg) -7. Select the default setup data. Click Continue to finish the installation with the default information. - - ![Screenshot of a browser showing the OpenAds successful installation screen.](openads-on-iis/_static/image15.jpg) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image1.jpg deleted file mode 100644 index ec55e5878..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image10.jpg deleted file mode 100644 index ff4baf719..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image11.jpg deleted file mode 100644 index 314db6099..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image12.jpg deleted file mode 100644 index 314db6099..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image13.jpg deleted file mode 100644 index ca65f6061..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image14.jpg deleted file mode 100644 index ca65f6061..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image15.jpg deleted file mode 100644 index 31618b5ef..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image16.jpg deleted file mode 100644 index 31618b5ef..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image2.jpg deleted file mode 100644 index ec55e5878..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image3.jpg deleted file mode 100644 index 9a689d108..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image4.jpg deleted file mode 100644 index 9a689d108..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image5.jpg deleted file mode 100644 index b251d3bd3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image6.jpg deleted file mode 100644 index b251d3bd3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image7.jpg deleted file mode 100644 index a3b2cdfdf..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image8.jpg deleted file mode 100644 index a3b2cdfdf..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image9.jpg deleted file mode 100644 index ff4baf719..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/openads-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis.md deleted file mode 100644 index 458682938..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "PHPList on IIS" -author: rick-anderson -description: "Introduction PHPList is an open-source newsletter manager and one-way email announcement delivery system. It is effective for newsletters, publicity lists, n..." -ms.date: 01/17/2008 -ms.assetid: 6869bc34-44d6-4d2b-ada2-7ff44836eb5f -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis -msc.type: authoredcontent ---- -# PHPList on IIS - -by Eric Woersching - -## Introduction - -PHPList is an open-source newsletter manager and one-way email announcement delivery system. It is effective for newsletters, publicity lists, notifications, and many other uses. It contains several features, such as tracking delivery status, tracking links and URLS, multiple templates for different subscribers, etc. - -For more information and features about PHPList, see [http://www.phplist.com/](http://www.phplist.com/). - -In this section, we go through the steps that would be required to install PHPList to work with FastCGI extension on IIS 7.0 and above, and Windows Server® 2008. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack PHPList - -First, download the latest stable release of the PHPList application. For this article, we use phplist-2.10.5.zip. Download the full package from the mirror [http://sourceforge.net/projects/phplist/](http://sourceforge.net/projects/phplist/). - -Once you download the package, uncompress it and copy the files and folders to a local folder. In this directory there is a directory public\_html which contains the directory "lists". Upload the "lists" directory into a directory you can access via the web. The rest of the files are for reference only and are not required for PHPList to work. - -> [!NOTE] -> The folder name for the PHPList application should be "lists," as it is hardcoded in some screens. If the folder name is not given as "lists," some of the admin screens may not work after the installation. The folder name can be changed if required in the configuration file. The folder structure we use for our application is `C:\Inetpub\wwwroot\lists`. - -## Set Up the Database - -Before starting the installation procedure for PHPList, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'phplistdb' -- Database User: 'phplist' -- Account Password: 'phplist' - -## Set Up and Configure PHPList - -Some of PHPList source files use only "<?" tag instead of "<?php" script tag. - -1. Configure the PHP to allow the "<?" tag. Set short\_open\_tag tag to on. -2. Set magic quotes to on by setting the magic\_quotes\_gpc on in the PHP.ini file. -3. Open the configuration file \lists\config\config.php in your editor and edit for the required database fields and folder details. We use the default details to create the folders like default folders. - -### Running the Installation Script - -1. After editing the configuration file, run the installation file by browsing to the index page located in the admin folder. -2. Open `http://localhost/lists/admin/index.php` in the browser. The system informs about database availability based on the configuration file and prompts for the table creation for the new installation. - - ![Screenshot of browser window displaying index page from admin folder. A list of default tables are displayed.](phplist-on-iis/_static/image1.jpg) - - ![Screenshot of browser window displaying lower portion of the list of default tables to create.](phplist-on-iis/_static/image3.jpg) -3. Click Continue with PHPList setup after creating the default tables. - - ![Screenshot of P H P List setup dialog box containing Login screen.](phplist-on-iis/_static/image5.jpg) -4. Login using the default user id "admin" and password "phplist". - - ![Screenshot of P H P List configuration options after admin login.](phplist-on-iis/_static/image7.jpg) -5. Change administration password and configure the general values by clicking on the specified links. - - ![Screenshot of P H P List dialog box displaying configuration parameters to edit. ](phplist-on-iis/_static/image9.jpg) -6. There several configuration parameters. Edit those parameters according to the application requirements. We use the default setup for testing. - - a. Click the "main page" link shown on the right side menu to access the admin main page. - - ![Screenshot of the P H P List main admin page. Main Page link is shown on right side menu.](phplist-on-iis/_static/image11.jpg) -7. Access the PHPLists administration page by clicking on the "lists" link shown on the right side menu. Here you can add, delete, or edit the list. - - ![Screenshot of the P H P Lists administration page with lists link shown.](phplist-on-iis/_static/image13.jpg) -8. Click "add a list" as shown below to add a new list. - - ![Screenshot of P H P Lists edit a list configuration screen.](phplist-on-iis/_static/image15.jpg) -9. Access the user admin index page by browsing to the application default folder `http://localhost/lists/index.php`. The installation is finished and you can access the application based on the settings provided by the admin user. - - ![Screenshot of P H P Lists user admin index page in browser screen after configuration.](phplist-on-iis/_static/image17.jpg) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx) - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image1.jpg deleted file mode 100644 index 3d0490bcd..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image10.jpg deleted file mode 100644 index 80edf947d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image11.jpg deleted file mode 100644 index eecdfa5b9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image12.jpg deleted file mode 100644 index eecdfa5b9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image13.jpg deleted file mode 100644 index b770063f7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image14.jpg deleted file mode 100644 index b770063f7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image15.jpg deleted file mode 100644 index 02fc9c73d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image16.jpg deleted file mode 100644 index 02fc9c73d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image17.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image17.jpg deleted file mode 100644 index bb232723f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image18.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image18.jpg deleted file mode 100644 index bb232723f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image2.jpg deleted file mode 100644 index 3d0490bcd..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image3.jpg deleted file mode 100644 index b8896d22e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image4.jpg deleted file mode 100644 index b8896d22e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image5.jpg deleted file mode 100644 index b55d66b09..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image6.jpg deleted file mode 100644 index b55d66b09..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image7.jpg deleted file mode 100644 index 08aaff489..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image8.jpg deleted file mode 100644 index 08aaff489..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image9.jpg deleted file mode 100644 index 80edf947d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phplist-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis.md deleted file mode 100644 index 507ef4622..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: "PHPNuke on IIS" -author: rick-anderson -description: "PostNuke is a software application that creates an impressive, dynamic Web site and provides the webmaster with a site that they can administer through a Web..." -ms.date: 01/15/2008 -ms.assetid: 619cd008-51e4-4465-bea0-bb69b1b5afda -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis -msc.type: authoredcontent ---- -# PHPNuke on IIS - -by Eric Woersching - -## Introduction - -PostNuke is a software application that creates an impressive, dynamic Web site and provides the webmaster with a site that they can administer through a Web browser with a minimal amount of HTML knowledge. - -In addition, PostNuke's functionality can be increased by installing modules, blocks and themes. For example, you can add a forum, a gallery and a contact form. You can also change how the entire site looks by changing themes. All of this can be done with just a few clicks in the administration panel, saving hours of time, both in the initial creation of the website and in its day to day maintenance. - -For more information about PostNuke, see [http://www.postnuke.com/](http://www.postnuke.com/). - -In this section, we go through the steps required to install PostNuke to work with the FastCGI extension on IIS 6.0 and IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack PostNuke - -First, download the latest stable release of the PostNuke application framework. For this article, we use PostNuke-0.764.zip downloaded from the mirror [http://noc.postnuke.com/frs/?group\_id=5&release\_id=700](http://noc.postnuke.com/frs/?group_id=5&release_id=700). - -Once you download the package, uncompress it and copy all the files and folders in the HTML directory to `C:\Inetpub\wwwroot\postnuke` folder. - -## Set Up the Database - -Before starting the installation procedure for PostNuke, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'postnuke' -- Database User: 'postnukeuser' -- Account Password: 'postnuke' - -## Set Up and Configure the Application - -PostNuke is simple to install. - -1. To begin the install script, type the URL of the install.php file into your Web browser. If you installed PostNuke to your `c:\inetpub\wwwroot\postnuke` folder, the install file is located at `http://localhost/postnuke/install.php`. - [![Screenshot shows Post Nuke setup page with U R L field to enter the U R L of the install dot p h p file, and a Language drop down to set your preferred language.](phpnuke-on-iis/_static/image2.jpg)](phpnuke-on-iis/_static/image1.jpg) -2. From here, select the default language for your PostNuke site. The English language files are included with the distribution, so we select English. -3. Read through the license agreement. - - Following the license agreement, a CHMOD (or permissions) check is run on some files and directories. In order to install correctly, PostNuke must be able to write to certain files during the installation, and for the more advanced features, certain directories must also be writable. If these conditions are not met, a warning displays. - - In our case, the file register\_globals is used in other applications running on the same machine and is not set as off. - - [![Screenshot shows C H M O D file permission check being run on certain files.](phpnuke-on-iis/_static/image4.jpg)](phpnuke-on-iis/_static/image3.jpg) - - Once you pass the CHMOD, information about the database you created is required. The database host, database name, username, password, database type (i.e MySQL, PostgreSQL or similar) and table type are needed. The table prefix setting allows you to specify a prefix for each table in the database – meaning that PostNuke database tables will not conflict if you wish to have more than one installation using the same database. For most installs, the table prefix setting can be left as ‘pn', though if you plan to install PostNuke multiple times, change the prefix. -4. Once the details are filled in, click 'new install'. You are asked to verify the details you provided to the installer. - [![Screenshot shows install dot p h p page with database fields to create database. Start button shown at the bottom of the page to start database creation.](phpnuke-on-iis/_static/image6.jpg)](phpnuke-on-iis/_static/image5.jpg) -5. After the confirmation, the installer asks for database creation. Since we have already created the database, do not check the create database option before clicking Start. - [![Screenshot shows the database fields to review before selecting Start button to create database.](phpnuke-on-iis/_static/image8.jpg)](phpnuke-on-iis/_static/image7.jpg) -6. Confirmation on the created tables displays. Click Continue after the confirmation. - [![Screenshot shows the list of database tables created.](phpnuke-on-iis/_static/image10.jpg)](phpnuke-on-iis/_static/image9.jpg) -7. Provide the admin details for the setup and click the Set Login button. - [![Screenshot shows admin fields to set login. Set Login button shown at the bottom of the page to set admin login details.](phpnuke-on-iis/_static/image12.jpg)](phpnuke-on-iis/_static/image11.jpg) - -It confirms a successful installation. - -## How to Use - -Open the admin.php page to maintain the required information. - -[![Screenshot shows the admin dot p h p page with admin details to maintain the admin information.](phpnuke-on-iis/_static/image14.jpg)](phpnuke-on-iis/_static/image13.jpg) - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, please use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image1.jpg deleted file mode 100644 index 0d89756de..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image10.jpg deleted file mode 100644 index dc6f0b79c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image11.jpg deleted file mode 100644 index b44b12fae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image12.jpg deleted file mode 100644 index b44b12fae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image13.jpg deleted file mode 100644 index b44b12fae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image14.jpg deleted file mode 100644 index b44b12fae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image2.jpg deleted file mode 100644 index 0d89756de..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image3.jpg deleted file mode 100644 index 0c8919b17..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image4.jpg deleted file mode 100644 index 0c8919b17..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image5.jpg deleted file mode 100644 index f7337ab6e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image6.jpg deleted file mode 100644 index f7337ab6e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image7.jpg deleted file mode 100644 index 4d8443616..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image8.jpg deleted file mode 100644 index 4d8443616..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image9.jpg deleted file mode 100644 index dc6f0b79c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpnuke-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image1.jpg deleted file mode 100644 index f80c30ff1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image2.jpg deleted file mode 100644 index f80c30ff1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image3.jpg deleted file mode 100644 index 187f9d3b9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image4.jpg deleted file mode 100644 index 187f9d3b9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image5.jpg deleted file mode 100644 index e0c586cff..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image6.jpg deleted file mode 100644 index e0c586cff..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image7.jpg deleted file mode 100644 index 21febf2bc..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image8.jpg deleted file mode 100644 index 21febf2bc..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phprojekt-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis.md deleted file mode 100644 index 1eb5f0b48..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: "PHPWCMS on IIS" -author: rick-anderson -description: "PHPWCMS is a web content management system optimized for fast and easy setup and works on any standard web server. PHPWCMS is perfect for professional, publi..." -ms.date: 01/18/2008 -ms.assetid: b16dca49-5d35-491e-b033-1bfda2e1cbad -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis -msc.type: authoredcontent ---- -# PHPWCMS on IIS - -by Eric Woersching - -## Introduction - -PHPWCMS is a web content management system optimized for fast and easy setup and works on any standard web server. PHPWCMS is perfect for professional, public and private users. It is very easy to learn and provides the flexibility to separate layout and content - -For more information about PHPWCMS, see [http://www.phpwcms.com/](http://www.phpwcms.com/). - -In this section, we go through the steps required to install PHPWCMS to work with the FastCGI extension on IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of FastCGI extension and PHP libraries as described here [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack PHPWCMS - -First, download the latest stable release of PHPWCMS application. For this article, we use the phpwcms\_1.3.3. Full Package downloaded from the mirror [http://sourceforge.net/projects/phpwcms/](http://sourceforge.net/projects/phpwcms/). - -Once you download the package, uncompress it and copy files and folders to `C:\Inetpub\wwwroot\phpwcms`. -For installation help, see [http://www.phpwcms.org/](http://www.phpwcms.org/). - -## Set Up the Database - -Before starting the installation procedure for PHPWCMS, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'phpwcms' -- Database User: 'phpwcmsuser' -- Account Password: 'phpwcms' - -## Set Up and Configure PHPWMCS - -1. Provide "All" permissions to the IIS user for the files and folders located in the PHPWCMS directory. - - - upload - - filearchive - - filearchive/can\_be\_deleted - - template - - content - - content/ads - - content/images - - content/gt - - content/form - - content/rss - - content/tmp - - content/pages -2. Provide "Read&Write" permissions to the IIS user for the files and folders located in the PHPWCMS directory. - - - setup/setup.conf.inc.php - - template/inc\_css/frontend.css - - config/phpwcms/conf.indexpage.inc.php - - template/inc\_default/startup.php - - ![Screenshot of the Permissions for upload dialog with all Permisions allowed for the I I S underscore I U S R S Group.](phpwcms-on-iis/_static/image1.jpg) -3. Call the install script in your browser via the following path: `http://localhost/phpwcms/setup/index.php`. - - ![Screenshot of the welcome message with the General Public License terms.](phpwcms-on-iis/_static/image3.jpg) - - Installation starts with the welcome message. -4. Click "I Agree the GPL, Continue…" to continue to the installation after reading the license. - - ![Screenshot of the available server configurations after agreeing to the General Public License.](phpwcms-on-iis/_static/image5.jpg) - - The system reports the available server configuration. - - - If the register\_globals is set to on, then set it to off by editing the PHP.ini file located in the PHP folder. - - Set safe\_mode to off in the PHP.ini file to avoid security risks. -5. After the configuration confirmation, click "Start setup PHPWCMS" to start the setup. - - ![Screenshot of configuring the My S Q L database and collation settings after clicking Start Setup P H P W C M S.](phpwcms-on-iis/_static/image7.jpg) -6. Enter the database details created for the PHPWCMS application above and click "Continue". -7. Confirm the Char set options required. We select default options for our application. - - ![Screenshot of selecting the default database schema.](phpwcms-on-iis/_static/image9.jpg) -8. Confirm the table creation by selecting the check box to create PHPWCMS tables and click Continue. - - ![Screenshot of creating the specified P H P W C M S tables.](phpwcms-on-iis/_static/image11.jpg) -9. Take the table creation backup for future use and click Continue. - - ![Screenshot after taking the table creation backup.](phpwcms-on-iis/_static/image13.jpg) -10. After getting the table creation confirmation, click Continue. Enter the admin user details and click Continue. - - ![Screenshot of the admin user details in the Path settings.](phpwcms-on-iis/_static/image15.jpg) - - ![Screenshot of the P H P W C M S path settings before clicking send path values.](phpwcms-on-iis/_static/image17.jpg) -11. Confirm the folder settings by clicking "send path values". We need not change any information here, as all folders already exist in the application. - - ![Screenshot of the confirmation page with any problems that may exist before starting P H P W C M S.](phpwcms-on-iis/_static/image19.jpg) -12. Download conf.inc.php from the Download the created config file\* link and save it to your hard disk. Then move that file to the config\phpwcms\ folder. -13. The system confirms the folder permissions and confirms the installation completion. Delete the setup folder after this installation. -14. Press LOGIN in the upper right corner and login with your username and password created. - - ![Screenshot of the login page with the admin login credentials.](phpwcms-on-iis/_static/image21.jpg) - - This takes you to the home screen. - - ![Screenshot of the home screen after logging in.](phpwcms-on-iis/_static/image23.jpg) - -## Getting More Information - -To discuss the FastCGI support in IIS, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx) -- [IIS 7.0 FastCGI forums](https://forums.iis.net/1104.aspx) - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image1.jpg deleted file mode 100644 index fb134cff8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image10.jpg deleted file mode 100644 index b4f5f1753..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image11.jpg deleted file mode 100644 index 4e19ba650..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image12.jpg deleted file mode 100644 index 4e19ba650..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image13.jpg deleted file mode 100644 index b4f5f1753..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image14.jpg deleted file mode 100644 index b4f5f1753..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image15.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image15.jpg deleted file mode 100644 index 127de2852..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image16.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image16.jpg deleted file mode 100644 index 127de2852..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image17.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image17.jpg deleted file mode 100644 index 26f0b753d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image18.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image18.jpg deleted file mode 100644 index 26f0b753d..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image19.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image19.jpg deleted file mode 100644 index 6c140d040..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image19.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image2.jpg deleted file mode 100644 index fb134cff8..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image20.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image20.jpg deleted file mode 100644 index 6c140d040..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image20.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image21.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image21.jpg deleted file mode 100644 index 2b1aef294..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image21.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image22.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image22.jpg deleted file mode 100644 index 2b1aef294..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image22.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image23.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image23.jpg deleted file mode 100644 index 4e9f52939..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image23.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image24.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image24.jpg deleted file mode 100644 index 4e9f52939..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image24.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image3.jpg deleted file mode 100644 index 501c63156..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image4.jpg deleted file mode 100644 index 501c63156..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image5.jpg deleted file mode 100644 index 13ee177e1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image6.jpg deleted file mode 100644 index 13ee177e1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image7.jpg deleted file mode 100644 index e5a6dfd4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image8.jpg deleted file mode 100644 index e5a6dfd4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image9.jpg deleted file mode 100644 index b4f5f1753..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/phpwcms-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis.md deleted file mode 100644 index 04cd19ab2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: "pMachinePro on IIS" -author: rick-anderson -description: "The application pMachine Pro is a popular open source blogging solution. It includes all the features of traditional blog tools, and supports multiple langua..." -ms.date: 01/18/2008 -ms.assetid: 8ffe0ee7-c74c-4a6b-83aa-3ed6009e03fc -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis -msc.type: authoredcontent ---- -# pMachinePro on IIS - -by Eric Woersching - -## Introduction - -The application pMachine Pro is a popular open source blogging solution. It includes all the features of traditional blog tools, and supports multiple languages. ExpressionEngine has replaced it. The existing pMachine Pro is still available for free download, but it is no longer supported. - -For more information about pMachine Pro, see [http://www.ellislab.com/](http://www.ellislab.com/). - -The following sections describe how to install and configure pMachinePro for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Notes on PHP Setup - -pMachine Pro does not require many modifications beyond the default configuration provided by PHP. From the base configuration file provided by PHP, you only need to modify the following lines in your php.ini configuration file to get pMachine Pro working: - -- Define `extension\_dir` as `c:\php\ext` (i.e., the location of your PHP extensions directory) -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support - -## Download and Unpack pMachinePro - -First, download the latest stable release of pMachine Pro. For this article, we use pMachine Pro 2.4.1 downloaded from here **<ISSUE: Missing link>.** Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\pMachine`. - -## Set Up the Database - -Before starting the installation procedure for pMachinePro, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'pmachine' -- Database User: 'pmachine' -- Account Password: 'pmachine' - -## Set Up and Configure pMachinePro - -To ensure that the Installation process can complete without errors, follow the instructions to set the file and directory permissions described in the installation document contained in the package. For this walkthrough, we provide modify permissions to the local machine "Internet Guest Account" for the following directories and file: - -- /images/uploads -- /images/captchas -- /pm/config.php - -Change the database connection setting in the config.php file to point to your installed MySQL instance. - -Browse to the `http://localhost/pMachine/pm/install.php` page for detailed setup instructions. Click the Install link on the top of the page to redirect to the Install Wizard. - -[![Screenshot of the local host slash p Machine slash p m slash install dot p h p page.The Version two dot four Installation Script is shown.](pmachinepro-on-iis/_static/image2.jpg)](pmachinepro-on-iis/_static/image1.jpg) - -The data population SQL scripts in the install.php are out of sync with the actual table schema created in MySQL 5.0.45. You must update the insert scripts contained in install.php, and in template.data.php. -This results in creating all the tables and you see the registration form to register the admin user. - -## Test pMachinePro - -To test that pMachine has been installed successfully, create a blog postings and view it as a site visitor would. Follow these steps: - -1. Navigate to `http://localhost/pMachine/pm/index.php`. -2. Enter the administrator username and password created in the last installation step. - [![Screenshot of the local host slash p Machine slash p m slash install dot p h p page. The administrator page is shown.](pmachinepro-on-iis/_static/image4.jpg)](pmachinepro-on-iis/_static/image3.jpg) -3. Once logged in, enter a title for your post and some content and click Preview. This displays what the post looks like. - - [![Screenshot of Machine Control Panel page. A box for the title and content for a post is shown.](pmachinepro-on-iis/_static/image6.jpg)](pmachinepro-on-iis/_static/image5.jpg) - - [![Screenshot of the Machine Control Panel page. The text Test Blog Entry is shown. The submit and continue editing buttons are found below the text.](pmachinepro-on-iis/_static/image8.jpg)](pmachinepro-on-iis/_static/image7.jpg) -4. Click Submit to publish this content to the Blog selected (Blog A in the case above). -5. Navigate to `http://localhost/pmachine/weblog.php` to browse to the actual blog site. See the actual blog as seen by site visitors. - - [![Screenshot of the local host slash p machine slash web blog dot p h p page. The date Sunday September sixteenth two thousand seven is shown above the text Test Blog Entry.](pmachinepro-on-iis/_static/image10.jpg)](pmachinepro-on-iis/_static/image9.jpg) - -## Getting More Information - -To discuss the FastCGI support in IIS, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). -- [IIS 7.0 FastCGI forums](https://forums.iis.net/1104.aspx) - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image1.jpg deleted file mode 100644 index 49bc9c0ed..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image10.jpg deleted file mode 100644 index de264d878..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image2.jpg deleted file mode 100644 index 49bc9c0ed..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image3.jpg deleted file mode 100644 index 8c3558b3f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image4.jpg deleted file mode 100644 index 8c3558b3f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image5.jpg deleted file mode 100644 index 64b3d7d74..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image6.jpg deleted file mode 100644 index 64b3d7d74..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image7.jpg deleted file mode 100644 index 6efd9a965..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image8.jpg deleted file mode 100644 index 6efd9a965..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image9.jpg deleted file mode 100644 index de264d878..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/pmachinepro-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality.md deleted file mode 100644 index 52046ec1c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality.md +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: "Provide URL Rewriting Functionality" -author: rick-anderson -description: "The Microsoft ® URL Rewrite Module for Internet Information Services 7 (IIS 7) and above provides flexible rules-based rewrite engine that can be used to per..." -ms.date: 11/15/2009 -ms.assetid: 06fa0273-c583-4020-8743-1afadce4e625 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality -msc.type: authoredcontent ---- -# Provide URL Rewriting Functionality - -by Tali Smith - -## Introduction - -The Microsoft® URL Rewrite Module for Internet Information Services 7 (IIS 7) and above provides flexible rules-based rewrite engine that can be used to perform broad spectrum of URL manipulation tasks, including, but not limited to: - -- Enabling user-friendly and search engine-friendly URLs with dynamic Web applications. -- Rewriting URLs based on HTTP headers and server variables. -- Handling Web site content. -- Controlling access to Web site content based on URL segments or request metadata. - -## Features of the URL Rewrite Module - -The Microsoft URL Rewrite Module includes these key features: - -- **Rules-based URL rewriting engine**. Rewrite rules are used to express the logic of what to compare/match the request URL with, and what to do if comparison was successful. Web server and site administrators can use rewrite rule sets to define URL rewriting logic. -- **Regular expression pattern matching**. Rewrite rules can use [ECMA-262](http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf) compatible, regular expression syntax for pattern matching. -- **Wildcard pattern matching.** Rewrite rules can use wildcard syntax for pattern matching. -- **Global and distributed rewrite rules**. Global rules are used to define server-wide URL rewriting logic and are defined within the ApplicationHost.config file. They cannot be overridden or disabled on any lower configuration levels. Distributed rules are used to define URL rewriting logic specific to a particular configuration scope. Distributed rules can be defined on any configuration level by using Web.config files. -- **Access to server variables and http headers**. Server variables and HTTP headers provide additional information about current HTTP requests. This information can be used to make rewriting decisions or to compose the output URL. -- **Various rule actions**. Instead of rewriting a URL, a rule may perform other actions, such as issue an HTTP redirect, abort the request, or send a custom status code to HTTP client. -- **Support for IIS kernel mode and user mode output caching.** IIS output caching provides significant performance improvements for Web applications. The URL Rewrite Module is fully compatible with both types of output caching. This means that it is possible to safely cache responses for rewritten URLs, and thus boost the performance of Web applications that rely on URL rewriting. -- **String manipulation functions.** Built-in string manipulation functions can be used to convert URLs to lowercase and to perform URL encoding and decoding. -- **Rewrite maps**. A rewrite map is an arbitrary collection of name-value pairs that can be used within the rewrite rules to generate the substitution URL during rewriting. Rewrite maps are particularly useful when you have a large set of rewrite rules, all of which use static strings (for example, if there is no pattern matching used). In those cases, instead of defining a large set of simple rewrite rules, you can put all the mappings between input URL and substitution URL as keys and values into the rewrite map, and then have one rewrite rule that references this rewrite map to look up a substitution URL based on the input URL. -- **Failed Request Tracing support**. IIS Failed Request Tracing can be used to troubleshoot errors related to URL rewriting. -- **Rule templates**. A rule template is an extension for the URL Rewrite Module user interface that simplifies the creation of rewrite rules for a particular task. The module includes three built-in rule templates. It also lets you plug in any number of custom templates. -- **UI for testing of regular expression and wildcard patterns**. A GUI tool for testing rule patterns is included in the module's user interface. The tool can be used to quickly check how the regular expression or wildcard pattern works. It can also be used for troubleshooting and debugging of problems related to pattern matching. -- **UI for managing rewrite rules and rewrite maps**. Rewrite rules and rewrite maps can be added, removed and edited by using the URL Rewrite Module feature in IIS Manager. -- **GUI tool for importing of mod\_rewrite rules**. The URL Rewrite Module includes a GUI tool for converting rewrite rules from mod\_rewrite format into an IIS format. - -## URL Rewrite Module Resources - -The following articles cover the functionality of the URL Rewrite Module, and explain how to use it to accomplish common URL rewriting scenarios. - -**Learning the basics** - -- [Creating rewrite rules](../../extensions/url-rewrite-module/creating-rewrite-rules-for-the-url-rewrite-module.md "Creating rewrite rules") -- [Using Failed Request Tracing to trace rewrite rules](../../extensions/url-rewrite-module/using-failed-request-tracing-to-trace-rewrite-rules.md "Using FRT to trace rewrite rules") -- [Using global and distributed rules](../../extensions/url-rewrite-module/using-global-and-distributed-rewrite-rules.md "Using global and distributed rewrite rules") -- [Using rewrite maps](../../extensions/url-rewrite-module/using-rewrite-maps-in-url-rewrite-module.md "Using rewrite maps") -- [Importing rewrite rules](../../extensions/url-rewrite-module/importing-apache-modrewrite-rules.md "Importing rewrite rules") -- [Enabling "pretty permalinks" in WordPress](../../extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md "Enabling Pretty Permalinks") -- [Rule templates](../../extensions/url-rewrite-module/rule-templates-overview.md) - - - [User-friendly URL](../../extensions/url-rewrite-module/user-friendly-url-rule-template.md) - - [Rule with Rewrite Map](../../extensions/url-rewrite-module/rule-with-rewrite-map-rule-template.md) - - [Request blocking](../../extensions/url-rewrite-module/request-blocking-rule-template.md) -- [Testing rule and condition patterns](../../extensions/url-rewrite-module/testing-rewrite-rule-patterns.md) - -**References and guidance** - -- [URL Rewrite Module configuration reference](../../extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md "Configuration reference") -- [URL Rewriting and Microsoft® ASP.NET routing](../../extensions/url-rewrite-module/iis-url-rewriting-and-aspnet-routing.md) -- [URL rewriting and request filtering](../../extensions/url-rewrite-module/iis-request-filtering-and-url-rewriting.md) -- [URL rewriting for ASP.NET Web forms](../../extensions/url-rewrite-module/url-rewriting-for-aspnet-web-forms.md) -- [Developing rule templates for the URL Rewrite Module](../../extensions/url-rewrite-module/developing-rule-template-for-url-rewrite-module.md) - -**Video walkthrough** - -- [Using the URL Rewrite Module - video walkthrough](../../extensions/url-rewrite-module/url-rewrite-module-video-walkthrough.md) - -### Known Issues and Changes - -There are a few known issues and changes to consider: - -- The mod\_rewrite rules that use **REQUEST\_URI** server variables may not work correctly when imported by using the URL rewrite "**Import Rules…**" feature. To fix the imported rules, use any text editor to open the web.config file that contains those rules. Locate the `` section, and then within that section replace all instances of string "**{SCRIPT\_NAME}**" with the string "**{URL}**". -- Digest authentication cannot be used with the URL Rewrite Module. -- ASP.NET Forms Authentication uses rewritten URLs for redirection. For example, if the requested URL is "**/article.htm**" and the URL Rewrite Module rewrites the URL to "**/article.aspx**", which is protected by Forms Authentication, then ASP.NET redirects to "**/login.aspx?ReturnUrl=%2Farticle.aspx**". -- The auto-detect mode in ASP.NET Forms Authentication uses rewritten URLs for redirection. For example, if the requested URL is "**/article.htm**" and the URL Rewrite Module rewrites the URL to "**/article.aspx**", which is protected by Forms Authentication, then ASP.NET redirects to "**/article.aspx?AspxAutoDetectCookieSupport=1**". -- UseUri mode in ASP.NET Forms Authentication uses rewritten URLs for redirection. For example, if the requested URL is "**/article.htm**" and URL rewrite module rewrites the URL to "**/article.aspx**", which is protected by Forms Authentication, then ASP.NET redirects to "**/(S(vy2ebt45imfkmjjwboow3l55))/article.aspx**". -- ASP.NET rewrites back to the original URL when using URI-based authentication or a cookieless session state. For example, when a request is made to "**/(S(vy2ebt45imfkmjjwboow3l55))/article.htm**" and the URL Rewrite Module rewrites "**/article.htm**" to "**/article.aspx**", then ASP.NET rewrites the URL back to "**/article.htm**", which may result in a "404 - File Not Found" error. -- The IIS DefaultDocument module may redirect to a rewritten URL when the URL Rewrite Module rewrites to a folder. For example, if a substitution URL in a rewrite rule is "**/folder1/folder2**", and these folders exist on file system and have default document configured, then DefaultDocument module redirects a Web client to "**/folder1/folder2/**", thus exposing the rewritten URL. To prevent this from happening, use "/" at the end of the substitution URL when rewriting to a folder (for example, "**/folder1/folder2/**"). - -## Example: Enable "Pretty Permalinks" - -Typically, WordPress users must use "almost pretty" URLs (for example, `http://contoso.com/index.php/yyyy/mm/dd/post-name/`). With the URL Rewrite module, you can create "Pretty Permalinks" (for example, `http://example.com/year/month/day/post-name/`) for WordPress blogs hosted on IIS. - -The steps that follow assume that WordPress is installed in a Web site root directory. If WordPress is installed in a subdirectory, then the rewrite rules must be included in the Web.config file located within the same subdirectory as the WordPress files. - -1. Install **URL Rewrite Go Live** release. -2. Log on to **WordPress** as an administrator. -3. Click the **Settings** button. -4. Click the **Permalinks** tab for the **Customize Permalink Structure** page. - - [![Screenshot shows Permalink Settings page with Default selected.](provide-url-rewriting-functionality/_static/image2.jpg)](provide-url-rewriting-functionality/_static/image1.jpg) - - *Figure 1: Customize permalink structure page* -5. Select **Custom Structure**, and then type - **/%year%/%monthnum%/%day%/%postname%/** in the **Custom Structure** text box. -6. Click **Save Changes**. You will see that all the blog post links have URLs that follow the format you have specified; however, if you click any link, the Web server returns a 404 - File Not Found error, because WordPress relies on a URL rewriting capability within a server to rewrite requests that have "pretty permalinks" to an Index.php file. - -## Create Rewrite Rule - -1. Open the **Web.config** file (located in the same directory as the WordPress files). If you do not have a Web.config file in the WordPress directory, create it. -2. Copy and paste the following XML section into the system.webServer element: - - [!code-xml[Main](provide-url-rewriting-functionality/samples/sample1.xml)] - -This rule matches any requested URL; if the URL does not correspond to a file or a folder on a file system, then the rule rewrites the URL to Index.php and determines which content to serve based on the REQUEST\_URI server variable that contains the original URL before it was modified by the rule. - -## Test the Rewrite Rule - -After the rewrite rule is saved to the Web.config file, open a Web browser, and click any one of the permalinks in WordPress blog. You should see the correct content returned by the Web server for every permalink. - -[![Screenshot shows a test page in a block with the U R L highlighted.](provide-url-rewriting-functionality/_static/image4.jpg)](provide-url-rewriting-functionality/_static/image3.jpg) - -*Figure 2: Blog welcome page* - -*This article updates the*[*Enabling Pretty Permalinks in WordPress*](../../extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md)*and*[*IIS 7 URL Rewrite Module support in WordPress 2.8*](https://blogs.iis.net/ruslany/archive/2009/05/16/iis-7-url-rewrite-module-support-in-wordpress-2-8.aspx)*articles written by Ruslan Yakushev.* - -## Links for Further Information - -- [URL Rewrite Module](https://www.iis.net/downloads?tabid=34&g=6&i=1691). -- [Creating rewrite rules for the URL Rewrite Module](../../extensions/url-rewrite-module/creating-rewrite-rules-for-the-url-rewrite-module.md). -- [Videocast about URL rewriting functionality](https://www.iis.net/downloads/microsoft/url-rewrite). -- [URL Rewrite Module 1.1 configuration](../../extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image1.jpg deleted file mode 100644 index 01608fd55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image2.jpg deleted file mode 100644 index 01608fd55..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image3.jpg deleted file mode 100644 index 887d82e03..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image4.jpg deleted file mode 100644 index 887d82e03..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/samples/sample1.xml deleted file mode 100644 index 74d78fe4f..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/provide-url-rewriting-functionality/samples/sample1.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis.md deleted file mode 100644 index 57816a9ac..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis.md +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: "Siteframe on IIS" -author: rick-anderson -description: "Siteframe™ is a lightweight content-management system designed for the rapid deployment of community-based websites. With Siteframe, a group of users can sha..." -ms.date: 01/17/2008 -ms.assetid: cbd31eed-9257-4768-99a5-dc73513ddaed -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis -msc.type: authoredcontent ---- -# Siteframe on IIS - -by Eric Woersching - -## Introduction - -Siteframe™ is a lightweight content-management system designed for the rapid deployment of community-based websites. With Siteframe, a group of users can share stories and photographs, create blogs, send email to one another, and participate in group activities. Siteframe enables this by providing Web-based content management so that anyone can create content without learning HTML. - -For more information about Siteframe, see [http://siteframe.org/](http://siteframe.org/). - -In this section, we go through the steps that required to install Siteframe to work with the FastCGI extension on IIS 6.0 and IIS 7.0 and above. To find out more about FastCGI support in IIS, see [https://www.iis.net/fastcgi](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). - -The following steps assume that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -## Download and Unpack Siteframe - -First, download the latest stable release of the Siteframe application. For this article, we use siteframe-5.0.5-783 downloaded from the mirror [http://siteframe.org/p/siteframe-5-0-5](http://siteframe.org/p/siteframe-5-0-5). - -Once you download the package, uncompress it and copy all the files and folders to `C:\Inetpub\wwwroot\siteframe`. - -## Set Up the Database - -Before starting the installation procedure for Siteframe, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'siteframe' -- Database User: 'siteframeuser' -- Account Password: 'Siteframe' - -## PHP Configuration - -SiteFrame requires the following PHP extensions: - -- The "ext/mysqli" extension -- The "ext/gd" extension - to use images on your site -- The "ext/curl" extension - for outbound Trackback pings -- The PEAR XML-RPC module - to use the "ping" plugin -- The PHP5-exif module - if available, to retrieve EXIF information from photographs -- Allow\_url\_fopen - this setting must be set to on to permit access to RSS feeds - -Enable all these extensions by un-commenting the lines below in the PHP.ini file, located in the PHP installation folder. - -extension\_dir = "./ext -extension=php\_mysqli.dll -extension=php\_gd2.dll -extension=php\_curl.dll -extension=php\_xmlrpc.dll -extension=php\_exif.dll -allow\_url\_fopen=on - -## Set Up and Configure Siteframe - -1. Open the Siteframe application folder and copy the siteframe.ini-dist to siteframe.ini; edit it to suit your settings. For this installation, the following parameters below were edited. - - - site\_url = [http://localhost/siteframe](http://localhost/siteframe) - - ite\_path = C:\Inetpub\wwwroot\siteframe - - db\_type = mysql - - db\_host = localhost - - db\_user = siteframeuser - - db\_password = siteframe - - db\_database = siteframe -2. To ensure that the installation process can complete without errors, follow the instructions to set the file and directory permissions. For this walkthrough, we provide modify permissions to the local machine "IUSER" account for the following directories and files: - - - /siteframe - - ![Screenshot of configuring Permissions for I I S underscore I U S R S Group in the Permissions for files dialog.](siteframe-on-iis/_static/image1.jpg) -3. Copy \_htaccess file to .htaccess. Windows may not allow naming the file with only the extension (.htaccess). Open the file in the editor (notepad) and save as ".htaccess". -4. Siteframe requires the Smarty templates. Download and install Smarty templates from - [https://www.smarty.net/](https://www.smarty.net/) and copy to the local folder. - - > [!NOTE] - > Smarty templates are available only in the .tar format and these .tar files must be extracted using gzip or other tools. We use the "izarc" tool downloaded from [https://www.izarc.org/](https://www.izarc.org/). -5. After installing the extract tool, right click the filename and extract .tar to the folder `c:\smarty`. To avoid the security issues, keep this folder outside of the web root directory. There could be one other Smarty-2.6.18.tar file located inside the extracted files; if so, extract that file into the same folder as well. -6. Edit PHP configuration file php.ini to add the installed Smarty include path. - Include\_path = ".;c:\smarty\libs". Restart IIS to affect the changes. -7. Set up these two folders inside your www root: - - - (wwwroot)/smarty/templates (This is where your templates will go.) - - (wwwroot)/smarty/configs -8. Set up these two folders OUTSIDE of your www root: - - - c:/smarty/templates\_c - - c:/smarty/cache -9. Set up security settings for the Web server to write to these four folders. For more information on installing smarty templates, see [http://news.php.net/php.smarty.dev/2703](http://news.php.net/php.smarty.dev/2703). - -## Run the Setup - -1. After installing the Smarty templates, creating the siteframe database and providing the configuration, run the installation script by calling `http://localhost/setup.php`. - - ![Screenshot of entering Admin user credentials by accessing the installation script through the web browser.](siteframe-on-iis/_static/image3.jpg) -2. Provide the details to create the admin user. Click "Continue with setup" to: go to register admin user, confirm the database setup and create the required tables. Creating the tables is the end of the Siteframe installation. - - ![Screenshot of the confirmation page for admin user registration, database setup and creation of required tables.](siteframe-on-iis/_static/image5.jpg) - -## Test the SiteFrame Application - -To test that SiteFrame has been installed successfully, create a blog postings and view it as a site visitor would. Follow these steps: - -1. Navigate to `http://localhost/siteframe/index.php`. -2. Enter the administrator username and password created in the last installation step. - - ![Screenshot of the Site Frame Test page after logging in as an administrator.](siteframe-on-iis/_static/image7.jpg) -3. Once logged in, click New Page to create an entry. - - ![Screenshot of the page to create a new content entry for the website.](siteframe-on-iis/_static/image9.jpg) -4. Click Save to publish the content. - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, please use the FastCGI forums: - -- [IIS.NET / IIS 6 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image1.jpg deleted file mode 100644 index b09eacd7e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image10.jpg deleted file mode 100644 index 5143ec530..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image2.jpg deleted file mode 100644 index b09eacd7e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image3.jpg deleted file mode 100644 index c477a8d2b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image4.jpg deleted file mode 100644 index c477a8d2b..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image5.jpg deleted file mode 100644 index 125617605..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image6.jpg deleted file mode 100644 index 125617605..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image7.jpg deleted file mode 100644 index a8684ddae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image8.jpg deleted file mode 100644 index a8684ddae..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image9.jpg deleted file mode 100644 index 5143ec530..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/siteframe-on-iis/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md deleted file mode 100644 index 9ae45378b..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Translate .htaccess Content to IIS web.config" -author: rick-anderson -description: "Many PHP applications are distributed with configuration files for the Apache Web server. These configuration files (usually called .htaccess files) contain..." -ms.date: 02/23/2009 -ms.assetid: ce4e6cf1-dec5-4a42-9ca6-be447dc7fa0d -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig -msc.type: authoredcontent ---- -# Translate .htaccess Content to IIS web.config - -by Steve Jacobson - -## Introduction - -Many PHP applications are distributed with configuration files for the Apache Web server. These configuration files (usually called .htaccess files) contain a number of settings that can be used for integrating the application with the capabilities of the Web server. - -IIS 7 and above uses a file called Web.config to hold settings for integration with applications. The Web.config file contains information that control module loading, security configuration, session state configuration, and application language and compilation settings. Web.config files can also contain application-specific items such as database connection strings. - -This article describes the most common uses of the .htaccess file by PHP applications, and shows how to use the Web.config file for these same functions in IIS. - -## Sample Application Configuration Files - -The following examples are two configuration files for a sample application: an .htaccess file and a Web.config file. - -### Sample Application .htaccess File - -[!code-console[Main](translate-htaccess-content-to-iis-webconfig/samples/sample1.cmd)] - -### Sample Application Web.config File - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample2.xml)] - -## Request Filtering - -This application uses the *FilesMatch* directive in the .htacess file to limit browser access to files that are components of the application. - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample3.xml)] - -IIS uses the Request Filtering module to limit browser access to files that are components of the application. For the sample application in a Web.config file, the section could look like: - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample4.xml)] - -Note that you can leave this section commented out for installation, because the installation scripts are blocked by this filter. - -An alternative to using the request filtering is to use the URL Rewriter module to return a 403 error for any of the matching file types. The advantage of the URL Rewriter module is that it uses a regular expression for the match. - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample5.xml)] - -## Default Document - -In the .htaccess file for the sample application, the *DirectoryIndex* directive tells the Web server which file to load if no filename is included with the URL. - -[!code-powershell[Main](translate-htaccess-content-to-iis-webconfig/samples/sample6.ps1)] - -For IIS, the default document should be set up as high in the Web site hierarchy as the Module Handler. For example, with PHP, the Module Handler is usually set at the Web server level. The default document should be set at that level also, rather than locally within a Web site's context. The following code within your Web.config file can ensure this: - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample7.xml)] - -## URL Rewriting - -IIS includes the URL Rewrite module. You can use this extension to provide rules for IIS to rewrite incoming URL requests. The most common use of URL Rewriting is to provide shorter, easy-to-remember URLs. - -Many PHP applications currently ship with rewrite rules as part of their .htaccess file. These rules tell Apache's mod\_rewrite how and when to rewrite incoming requests. The IIS URL Rewrite module can read these rules and translate them into URL Rewrite rules. - -For more information about importing Apache mod\_rewrite rules, see: [Importing Apache mod\_rewrite Rules](../../extensions/url-rewrite-module/importing-apache-modrewrite-rules.md). - -For the sample application, the relevant mod\_rewrite rules in the .htaccess file are: - -[!code-console[Main](translate-htaccess-content-to-iis-webconfig/samples/sample8.cmd)] - -The IIS URL Rewriter module can read these rules and translate them. The translated URL Rewriter rules are: - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample9.xml)] - -## Error Page Redirects / Handling - -Some applications handle standard errors within the scope of the application. The *ErrorDocument* directive in the .htaccess file of the sample application tells the Web server to load the home page for any 404 or "File Not Found" errors. - -[!code-powershell[Main](translate-htaccess-content-to-iis-webconfig/samples/sample10.ps1)] - -IIS uses the *httpErrors* directive for this functionality. However, because the capability to set this at the application level is turned off by default for IIS, this section should be commented out. - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample11.xml)] - -## Directory Browsing - -Another application security (or integrity) measure often implemented is disabling directory browsing from the clients. Many Web server configurations will let users see a listing of files in a directory that does not contain one of the default document files. In the .htaccess file of the sample application, this is disabled using the *Options* directive: - -[!code-powershell[Main](translate-htaccess-content-to-iis-webconfig/samples/sample12.ps1)] - -IIS limits this access in the Web.config file using the *directoryBrowse* directive: - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample13.xml)] - -## Cache Aging - -Caching directives are used to ensure that static content is cached for a period of time, and dynamic content is not cached at all. In the .htaccess file of the sample application, the *ExpiresBy* directives provided by mod\_expires module are used. - -[!code-powershell[Main](translate-htaccess-content-to-iis-webconfig/samples/sample14.ps1)] - -In the Web.config file, IIS uses the Output Caching module and the caching directive to control caching. For the sample application, you can enable caching for .html files for a maximum of 14 days. For .php files, ensure that no caching is performed at all with the code: - -[!code-xml[Main](translate-htaccess-content-to-iis-webconfig/samples/sample15.xml)] - - - -## Links for Further Information - -- [IIS URL Rewriting and Microsoft® ASP.NET routing](../../extensions/url-rewrite-module/iis-url-rewriting-and-aspnet-routing.md). -- [IIS forum](https://forums.iis.net/). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample1.cmd deleted file mode 100644 index b7c03c505..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample1.cmd +++ /dev/null @@ -1,109 +0,0 @@ -# -# Apache/PHP/Application settings: -# - -# Protect files and directories from prying eyes. - - Order allow,deny - - -# Don't show directory listings for URLs which map to a directory. -Options -Indexes - -# Follow symbolic links in this directory. -Options +FollowSymLinks - -# Make Application handle any 404 errors. -ErrorDocument 404 /index.php - -# Force simple error message for requests for non-existent favicon.ico. - - ErrorDocument 404 "The requested file favicon.ico was not found. - - -# Set the default handler. -DirectoryIndex index.php - -# Override PHP settings. More in sites/default/settings.php -# but the following cannot be changed at runtime. - -# PHP 4, Apache 1. - - php_value magic_quotes_gpc 0 - php_value register_globals 0 - php_value session.auto_start 0 - php_value mbstring.http_input pass - php_value mbstring.http_output pass - php_value mbstring.encoding_translation 0 - - -# PHP 4, Apache 2. - - php_value magic_quotes_gpc 0 - php_value register_globals 0 - php_value session.auto_start 0 - php_value mbstring.http_input pass - php_value mbstring.http_output pass - php_value mbstring.encoding_translation 0 - - -# PHP 5, Apache 1 and 2. - - php_value magic_quotes_gpc 0 - php_value register_globals 0 - php_value session.auto_start 0 - php_value mbstring.http_input pass - php_value mbstring.http_output pass - php_value mbstring.encoding_translation 0 - - -# Requires mod_expires to be enabled. - - # Enable expirations. - ExpiresActive On - - # Cache all files for 2 weeks after access (A). - ExpiresDefault A1209600 - - # Do not cache dynamically generated pages. - ExpiresByType text/html A1 - - -# Various rewrite rules. - - RewriteEngine on - - # If your site can be accessed both with and without the 'www.' prefix, you - # can use one of the following settings to redirect users to your preferred - # URL, either WITH or WITHOUT the 'www.' prefix. Choose ONLY one option: - # - # To redirect all users to access the site WITH the 'www.' prefix, - # (http://example.com/... will be redirected to http://www.example.com/...) - # adapt and uncomment the following: - # RewriteCond %{HTTP_HOST} ^example\.com$ [NC] - # RewriteRule ^(.*)$ http://www.example.com/$1 [L,R=301] - # - # To redirect all users to access the site WITHOUT the 'www.' prefix, - # (http://www.example.com/... will be redirected to http://example.com/...) - # uncomment and adapt the following: - # RewriteCond %{HTTP_HOST} ^www\.example\.com$ [NC] - # RewriteRule ^(.*)$ http://example.com/$1 [L,R=301] - - # Modify the RewriteBase if you are using Application in a subdirectory or in a - # VirtualDocumentRoot and the rewrite rules are not working properly. - # For example if your site is at http://example.com/application uncomment and - # modify the following line: - # RewriteBase /application - # - # If your site is running in a VirtualDocumentRoot at http://example.com/, - # uncomment the following line: - # RewriteBase / - - # Rewrite URLs of the form 'x' to the form 'index.php?q=x'. - RewriteCond %{REQUEST_FILENAME} !-f - RewriteCond %{REQUEST_FILENAME} !-d - RewriteCond %{REQUEST_URI} !=/favicon.ico - RewriteRule ^(.*)$ index.php?q=$1 [L,QSA] - - -# $Id: .htaccess,v 1.90.2.1 2008/07/08 09:33:14 goba Exp $ \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample10.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample10.ps1 deleted file mode 100644 index 077507d9c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample10.ps1 +++ /dev/null @@ -1,2 +0,0 @@ -# Make Application handle any 404 errors. -ErrorDocument 404 /index.php \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample11.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample11.xml deleted file mode 100644 index 1e5f8740f..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample11.xml +++ /dev/null @@ -1,7 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample12.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample12.ps1 deleted file mode 100644 index c815d5f53..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample12.ps1 +++ /dev/null @@ -1,2 +0,0 @@ -# Don't show directory listings for URLs which map to a directory. -Options -Indexes \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample13.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample13.xml deleted file mode 100644 index 277cffee5..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample13.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample14.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample14.ps1 deleted file mode 100644 index f762c5074..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample14.ps1 +++ /dev/null @@ -1,11 +0,0 @@ -# Requires mod_expires to be enabled. - - # Enable expirations. - ExpiresActive On - - # Cache all files for 2 weeks after access (A). - ExpiresDefault A1209600 - - # Do not cache dynamically generated pages. - ExpiresByType text/html A1 - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample15.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample15.xml deleted file mode 100644 index 7472b6ca8..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample15.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample2.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample2.xml deleted file mode 100644 index c86a7e8a6..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample2.xml +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample3.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample3.xml deleted file mode 100644 index 09811d709..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample3.xml +++ /dev/null @@ -1,3 +0,0 @@ - - Order allow,deny - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample4.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample4.xml deleted file mode 100644 index 7f1817e24..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample4.xml +++ /dev/null @@ -1,25 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample5.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample5.xml deleted file mode 100644 index 677d17ee5..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample5.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample6.ps1 b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample6.ps1 deleted file mode 100644 index f9724725d..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample6.ps1 +++ /dev/null @@ -1,2 +0,0 @@ -# Set the default handler. -DirectoryIndex index.php \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample7.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample7.xml deleted file mode 100644 index 6c578a12f..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample7.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample8.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample8.cmd deleted file mode 100644 index 06339ab78..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample8.cmd +++ /dev/null @@ -1,7 +0,0 @@ -RewriteCond %{HTTP_HOST} ^example\.com$ [NC] - RewriteRule ^(.*)$ http://www.example.com/$1 [L,R=301] - - RewriteCond %{REQUEST_FILENAME} !-f - RewriteCond %{REQUEST_FILENAME} !-d - RewriteCond %{REQUEST_URI} !=/favicon.ico - RewriteRule ^(.*)$ index.php?q=$1 [L,QSA] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample9.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample9.xml deleted file mode 100644 index 1b8d1bcea..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig/samples/sample9.xml +++ /dev/null @@ -1,20 +0,0 @@ - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md deleted file mode 100644 index 0274affd4..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: "Using FastCGI to Host PHP Applications on IIS 6.0" -author: ruslany -description: "This article explains how to use the Microsoft IIS FastCGI extension to set up and run PHP applications on Windows XP and Windows Server ® 2003 operating sys..." -ms.date: 12/05/2007 -ms.assetid: c9a924d7-5f0e-45f3-a4ad-2ebbc3fc619e -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60 -msc.type: authoredcontent ---- -# Using FastCGI to Host PHP Applications on IIS 6.0 - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Introduction - -The PHP programming language has been an important player in the Web Application space for many years. Even though PHP was not developed by Microsoft, supporting this technology is very important to us and so you can install it on any stand-alone IIS Server, and it's also built-in to our cloud-based [Windows Azure Web Sites (WAWS)](https://www.windowsazure.com/documentation/services/web-sites/) platform. This article explains how to use the Microsoft IIS FastCGI extension to set up and run PHP applications on Windows XP and Windows Server® 2003 operating systems. - -## What is FastCGI? - -FastCGI is a standard protocol that allows the CGI executable files for application frameworks to interface with the Web server. It differs from the standard CGI protocol in that FastCGI reuses CGI processes for multiple requests, which provides a significant performance boost as compared to CGI. Support for IIS FastCGI enables IIS to host normal CGI programs like PHP or Ruby on Rails by using the FastCGI protocol, and to offer high performance and stability for production deployment of such application frameworks. - -Using the IIS FastCGI support includes the following: - -- IIS Web server -- IIS FastCGI extension -- CGI program (such as php-cgi.exe) - -The Web server dispatches HTTP requests to your application to the FastCGI component, which in turn launches the CGI program executable, and forwards the request for processing. Once the request is finished and the response is returned back to the server and sent to the client, the CGI process is reused for a subsequent request. This helps to avoid the high performance penalty of starting a new process for each request, which results in better performance and scalability in a production environment. - -To learn more about the FastCGI protocol, see [http://www.fastcgi.com/devkit/doc/fcgi-spec.html](http://www.fastcgi.com/devkit/doc/fcgi-spec.html). - -## Install the FastCGI Extension for IIS 6.0 and IIS 5.1 - -You can download the FastCGI extension for 32-bit and 64-bit Windows XP and Windows Server 2003 here: - - - -When you run the FastCGI installer, it copies FastCGI-specific files to the `%windir%\system32\inetsrv` folder, and then registers and enables the FastCGI Web server extension. Of the files that the installer copies, note the following: - -- **fcgiext.dll** – This is the actual FastCGI handler that communicates with FastCGI-enabled processes for processing requests. -- **fcgiext.ini** – This is the configuration file that contains the mapping of file extensions to FastCGI processes. It also contains the configuration of FastCGI process pools. -- **fcgiconfig.js** – This configures the FastCGI extension. The script updates the fcgiext.ini file, modifies the IIS metabase and recycles the Web service application pools if necessary. - -## Download and Install PHP - -The FastCGI extension is fully compatible with the current official PHP 4.4.x and PHP 5.x distribution for Windows, available from . Since the FastCGI extension hosts and executes php processes in a single threaded manner, it is recommended that you download and install the non-thread-safe PHP build that is available for Windows. The non-thread-safe PHP build provides a performance boost from a lack of thread safety that is acceptable for a single-concurrency environment like FastCGI. - -## Configure the FastCGI Extension to Work with PHP - -Once PHP is installed on Windows, you have two options to configure FastCGI: use the configuration script that is provided with the installation of the FastCGI extension, or perform all the configuration tasks manually by modifying IIS configuration settings and the fcgiext.ini file. - -### Configure the FastCGI Extension to Work with PHP by Using the Configuration Script - -The configuration script with the name fcgconfig.js is provided with the installation of the FastCGI extension. It is located in %*windir*%\system32\inetsrv. - -**To configure the FastCGI extension to work with PHP:** - -1. Open a command prompt. -2. Change the current directory to %*windir*%\system32\inetsrv. -3. Register the PHP CGI program as the one that will be processing .php extensions by running the following configuration script: - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample1.cmd)] - - Replace `C:\PHP\php-cgi.exe` with the path to php-cgi.exe if you installed to a directory other than `C:\PHP`. - - > [!NOTE] - > If you do not want to register the PHP extension to be processed by the FastCGI component on your entire server, and only want to register it for a specific Web site, add a "–site:[siteId]" argument, for example: - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample2.cmd)] - - > [!NOTE] - > For a complete list of configuration parameters that are supported by the FastCGI extension, see the FastCGI extension documentation. - -### Manually Configure the FastCGI Extension to Work with PHP - -To manually configure the IIS and FastCGI extension, you must create script mappings for the PHP extension in the IIS metabase, and modify the fcgiext.ini file that is located in %*windir*%\system32\inetsrv. - -**To create script mapping:** - -1. Launch inetmgr.exe. -2. Double-click the machine icon for the local computer. -3. Right-click **Web Sites** and click **Properties**. -4. Click the **Home Directory** tab. -5. Click the **Configuration…** button. -6. Click the **Add…** button. -7. In the **Add/Edit Application Extension Mapping** dialog box, click **Browse...**. Navigate to the fcgiext.dll file that is located in %*windir*%\system32\inetsrv. - - > [!NOTE] - > If you need to use FastCGI in 32-bit mode on a 64-bit machine, navigate to %*windir*%\SysWOW64\inetsrv. - -8. In the **Extension** text box, enter **.php**. - -9. Under **Verbs**, in the **Limit to** text box, enter **GET,HEAD,POST**. - -10. Ensure that the **Script engine** and **Verify that file exists** check boxes are selected. - - [![Screenshot of the Add or Edit Application Extension Mapping dialog box. In the Executable box, C colon backslash W I N N T backslash system thirty two backslash i net s r v backslash f c g i e x t dot d l l is written.](using-fastcgi-to-host-php-applications-on-iis-60/_static/image2.png)](using-fastcgi-to-host-php-applications-on-iis-60/_static/image1.png) - -11. Click **OK**. - -**To modify the fcigext.ini file:** - -Once the script mapping has been added, modify the fcgiext.ini file. - -1. Add an extension to **application mapping (php=PHP)** to the **[Types]** section. -2. Add a **[PHP]** section with **ExePath=c:\php\php-cgi.exe** (assuming you installed PHP files to the C:\PHP folder). - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample3.cmd)] - -3. After you save the changes to the fcgiext.ini file, restart the application pool that is associated with the Web site that hosts your PHP applications. - -**To configure a default document in IIS:** - -Most PHP applications use a file named index.php as the default application document. Configure IIS to treat this file as the default content page. - -1. Launch inetmgr.exe. -2. Double-click the machine icon for the local computer. -3. Right-click **Web Sites** and click **Properties**. -4. Click the **Documents** tab. -5. Click the **Add…** button. -6. In the **Add Content Page** dialog box, in the **Default content page** text box, enter **index.php**. -7. Click **OK**. - - [![Screenshot of the Web Sites Properties dialog box. Enable default content page is selected. The Add Content Page dialog box is shown. Index dot p h p is written in the Default content page box.](using-fastcgi-to-host-php-applications-on-iis-60/_static/image4.png)](using-fastcgi-to-host-php-applications-on-iis-60/_static/image3.png) - -## Set the FastCGI Configuration for Optimal Functionality, Security, and Performance with PHP - -IIS focuses on full PHP functionality support and performance of PHP applications that are running on the FastCGI extension. In collaboration with Zend Technologies, IIS identified the set of configuration settings for the FastCGI extension and PHP that would provide optimal functionality and performance for PHP applications when running on Windows by using the FastCGI extension. - -To obtain optimal functionality and performance, configure your server as follows: - -1. Modify the **php.ini** file as follows: - - - Set **fastcgi.impersonate = 1**. FastCGI under IIS supports the ability to impersonate the security tokens of the calling client. This allows IIS to define the security context under which the request runs. - - Set **cgi.fix\_pathinfo=1**. cgi.fix\_pathinfo provides \*real\* PATH\_INFO/PATH\_TRANSLATED support for CGI. Previously, PHP behavior was to set PATH\_TRANSLATED to SCRIPT\_FILENAME, and to not define PATH\_INFO. For more information about PATH\_INFO, see the cgi specifications. Setting this value to 1 will cause PHP CGI to fix its paths to conform to the specification. - - Set **cgi.force\_redirect = 0**. - -2. Set the FastCGI configuration settings for the PHP section by running fcgiconfig.js as follows: - - - Set the FastCGI process pool property **InstanceMaxRequests** to **10000**. This setting specifies that the FastCGI extension will recycle php-cgi.exe after it has processed 10000 requests successfully. - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample4.cmd)] - -3. Configure the FastCGI extension to set the **PHP\_FCGI\_MAX\_REQUESTS** environment variables for the PHP process to **10000**. This setting instructs php-cgi.exe to recycle itself after it has processed 10000 requests successfully. - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample5.cmd)] - - > [!NOTE] - > You can configure **InstanceMaxRequests** and **PHP\_FCGI\_MAX\_REQUESTS** to use numbers other than 10000. As a general rule, ensure that the value of **InstanceMaxRequests** is less than or equal to the value of **PHP\_FCGI\_MAX\_REQUESTS**. - -## Test PHP CGI - -After installing the FastCGI extension and registering and configuring the PHP CGI, you can request your PHP application and use it normally. - -To test the PHP application, create and request a **phpinfo.php** page in your site that contains the following: - -[!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis-60/samples/sample6.xml)] - -You should see something like the following: - -[![Screenshot of the P H P Version five dot two dot four web page. In the Server A P I field, Fast C G I is written.](using-fastcgi-to-host-php-applications-on-iis-60/_static/image6.png)](using-fastcgi-to-host-php-applications-on-iis-60/_static/image5.png) - -Note that the **Server API** field indicates that PHP is hosted in **FastCGI** mode. - -## Get More Information - -Use the FastCGI forums to discuss the usage of the FastCGI extension or to file bug reports: - -- [IIS.NET FastCGI forums](https://forums.iis.net/1103.aspx) - -For more information about how to run various PHP applications on IIS, see: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image1.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image2.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image3.png deleted file mode 100644 index b5f09c370..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image4.png deleted file mode 100644 index b5f09c370..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image5.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image5.png deleted file mode 100644 index 9aad271d1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image6.png deleted file mode 100644 index 9aad271d1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample1.cmd deleted file mode 100644 index 405b3153d..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -cscript fcgiconfig.js -add -section:"PHP" -extension:php -path:"C:\PHP\php-cgi.exe" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample2.cmd deleted file mode 100644 index b68827c5e..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -cscript fcgiconfig.js -add -section:"PHP" -extension:php -path:"C:\PHP\php-cgi.exe" –site:1 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample3.cmd deleted file mode 100644 index 02f81c01c..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample3.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[Types] -… -php=PHP -… - -[PHP] -ExePath=c:\php\php-cgi.exe \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample4.cmd deleted file mode 100644 index eed9c978b..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -> cscript fcgiconfig.js -set -section:"PHP" -InstanceMaxRequests:10000 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample5.cmd deleted file mode 100644 index 5ea92cae2..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -> cscript fcgiconfig.js -set -section:"PHP" -EnvironmentVars:PHP_FCGI_MAX_REQUESTS:10000 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample6.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample6.xml deleted file mode 100644 index a16412bb3..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60/samples/sample6.xml +++ /dev/null @@ -1,5 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md deleted file mode 100644 index 02002f1f6..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md +++ /dev/null @@ -1,305 +0,0 @@ ---- -title: "Using FastCGI to Host PHP Applications on IIS 7" -author: ruslany -description: "This article describes how to configure the FastCGI module and PHP to host PHP applications on IIS 7 and above. IMPORTANT : This article provides instruction..." -ms.date: 12/05/2007 -ms.assetid: f1143e47-6a11-4429-b8e6-e106661a7187 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis -msc.type: authoredcontent ---- -# Using FastCGI to Host PHP Applications on IIS 7 - -by [Ruslan Yakushev](https://github.com/ruslany) - -This article describes how to configure the FastCGI module and PHP to host PHP applications on IIS 7 and above. - -> [!IMPORTANT] -> :::image type="icon" source="using-fastcgi-to-host-php-applications-on-iis/_static/image2.gif"::: -> This article provides instructions on how to install and use the FastCGI component on Windows Server 2008 and Windows Vista **SP1**. SP1 is **required** on Windows Vista. - - - -## Overview - -The FastCGI module in IIS enables popular application frameworks that support the FastCGI protocol to be hosted on the IIS Web server in a high performance and reliable way. FastCGI provides a high-performance alternative to the Common Gateway Interface (CGI), which is a standard way of interfacing external applications with Web servers that has been a part of the supported IIS feature set since the first release. - -CGI programs are executable files that are launched by the Web server for each request to process the request and generate dynamic responses that are then sent back to the client. Because many of these frameworks do not support multi-threaded execution, CGI enables them to execute reliably on IIS by executing exactly one request per process. Unfortunately, it provides poor performance due to the high cost of starting and shutting down a process for each request. - -FastCGI addresses the performance issues that are inherent in CGI by providing a mechanism to reuse a single process over and over again for many requests. Additionally, FastCGI maintains compatibility with non-thread-safe libraries by providing a pool of reusable processes and ensuring that each process handles only one request at a time. - - - -## Enable FastCGI Support in IIS - - - -### Windows Server 2008 - -Go to **Server Manager** > **Roles** > **Add Role Services**. On the **Select Role Services** page, select the **CGI** check box. This enables both the CGI and FastCGI services. - -![Screenshot of the Add Role Services window showing the Select Role Services dialog.](using-fastcgi-to-host-php-applications-on-iis/_static/image1.png) - - - -### Windows Vista SP1 - -Go to **Control Panel** > **Programs and Features** > **Turn Windows features on or off**. In the **Windows Features** dialog box, select the **CGI** check box. This enables both the CGI and FastCGI services. - -![Screenshot of the Windows Features dialog with C G I selected.](using-fastcgi-to-host-php-applications-on-iis/_static/image3.png) - - - -### :::image type="icon" source="using-fastcgi-to-host-php-applications-on-iis/_static/image2.gif"::: IMPORTANT: Install the Update for the FastCGI Module - -The update for the IIS FastCGI module fixes several known compatibility issues with popular PHP applications. Install the update from one of the following locations: - -- [Update for Windows Server 2008](https://www.microsoft.com/downloads/info.aspx?na=22&p=1&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3dd0343911-1775-4aef-8c99-5f13862ac386%26DisplayLang%3den "Update for Windows Server 2008") -- [Update for Windows Server 2008 x64 Edition](https://www.microsoft.com/downloads/info.aspx?na=22&p=3&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d70278393-3291-4aa1-870b-0e9b0907bddf%26DisplayLang%3den "Update for Windows Server 2008 x64 Edition") -- [Update for Windows Server 2008 for Itanium-based Systems](https://www.microsoft.com/downloads/info.aspx?na=22&p=5&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d98e06637-0f00-45d5-83c5-ed1b41fd6a7b%26DisplayLang%3den "Update for Windows Server 2008 for Itanium-based Systems") -- [Update for Windows Vista SP1](https://www.microsoft.com/downloads/info.aspx?na=22&p=2&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d19600729-8470-4956-a276-200450d814bd%26DisplayLang%3den "Update for Windows Vista") -- [Update for Windows Vista SP1 for x64 based Systems](https://www.microsoft.com/downloads/info.aspx?na=22&p=4&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3dc7066c3b-dcf7-4441-87bc-f7dcb51067d0%26DisplayLang%3den "Update for Windows Vista for x64 based Systems") - - - -### Install the Administration Pack for IIS - -> [!NOTE] -> This step is optional. - -Among other useful features, the Administration Pack for IIS has a convenient user interface for configuring FastCGI settings. The Administration Pack can be installed from the following locations: - -- [Administration Pack for IIS 7 and Above - x86](https://www.iis.net/downloads?tabid=34&i=1682&g=6) -- [Administration Pack for IIS 7 and Above - x64](https://www.iis.net/downloads?tabid=34&i=1683&g=6) - - - -## Install and Configure PHP - -It is recommended that you use a non-thread safe build of PHP with IIS FastCGI. A non-thread safe build of PHP provides significant performance gains over the standard build by not doing any thread-safety checks, which are not necessary, since FastCGI ensures a single threaded execution environment. - -### To install PHP - -1. Download the latest non-thread safe zip package with binaries of PHP: . -2. Unpack the files to the directory of your choice (e.g. `C:\PHP`). Rename the php.ini-recommended file to php.ini. -3. Open the php.ini file. Uncomment and modify the settings as follows: - - - Set **fastcgi.impersonate = 1**. FastCGI under IIS supports the ability to impersonate security tokens of the calling client. This allows IIS to define the security context that the request runs under. - - Set **cgi.fix\_pathinfo=1**. cgi.fix\_pathinfo provides \*real\* PATH\_INFO/PATH\_TRANSLATED support for CGI. Previously, PHP behavior was to set PATH\_TRANSLATED to SCRIPT\_FILENAME, and to not define PATH\_INFO. For more information about PATH\_INFO, see the cgi specifications. Setting this value to 1 will cause PHP CGI to fix its paths to conform to the specifications. - - Set **cgi.force\_redirect** = 0. - - Set **open\_basedir** to point to the folder or network path where the content of the Web site(s) is located. - - Set **extension\_dir** to point to the location where the PHP extensions are located. Typically, for PHP 5.2.X the value would be set as **extension\_dir = "./ext"** - - Enable the required PHP extension by un-commenting the corresponding lines, for example: - - extension=php\_mssql.dll - extension=php\_mysql.dll -4. Open a command prompt, and run the following command to verify that PHP installed successfully: - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample1.cmd)] - -If PHP installed correctly and all its dependencies are available on the machine, this command will output the current PHP configuration information. - - - -## Configure IIS to Handle PHP Requests - -For IIS to host PHP applications, you must add a handler mapping that tells IIS to pass all PHP-specific requests to the PHP application framework by using the FastCGI protocol. - - - -### Configure IIS to handle PHP requests by using IIS Manager - -1. Open IIS Manager. At the server level, double-click **Handler Mappings**. - - ![Screenshot of I I S Manager with the Handler Mappings icon highlighted.](using-fastcgi-to-host-php-applications-on-iis/_static/image1.jpg) -2. In the **Actions** pane, click **Add Module Mapping**. In the **Add Module Mapping** dialog box, specify the configuration settings as follows: - - - Request path: **\*.php** - - Module: **FastCgiModule** - - Executable: **"C:\[Path to your PHP installation]\php-cgi.exe"** - - Name: **PHP via FastCGI** -3. Click **OK**. - - ![Screenshot showing the Add Module Mapping dialog.](using-fastcgi-to-host-php-applications-on-iis/_static/image6.png) -4. In the **Add Module Mapping** confirmation dialog box that asks if you want to create a FastCGI application for this executable, click **Yes**. - - ![Screenshot of the Add Module Mapping confirmation dialog with Yes circled.](using-fastcgi-to-host-php-applications-on-iis/_static/image3.jpg) -5. Test that the handler mapping works correctly by creating a phpinfo.php file in the `C:\inetpub\wwwroot` folder that contains the following code: - - [!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample2.xml)] -6. Open a browser and navigate to `http://localhost/phpinfo.php`. If everything was setup correctly, you will see the standard PHP information page. - - ![Screenshot of a browser window showing the P H P information page.](using-fastcgi-to-host-php-applications-on-iis/_static/image8.png) - - > [!NOTE] - > If you do not see **FastCgiModule** in the **Modules:** list, the module is either not registered or not enabled. To check if the FastCGI module is registered, open the IIS configuration file that is located at `%windir%\windows\system32\config\applicationHost.config` and check that the following line is present in the `` section: - - [!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample3.xml)] - - In the same file, also check that the FastCGI module is added to the `` section: - - [!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample4.xml)] - - - -### Configure IIS to handle PHP requests by using the command line - -Alternatively, you can complete the steps above by using the command line tool A **ppCmd**. - -1. Create the FastCGI application process pool by running the following command: - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample5.cmd)] -2. Create the handler mapping by running the following command: - - [!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample6.cmd)] - - > [!NOTE] - > If you are using PHP version 4.X, you can use php.exe instead of php-cgi.exe. - - - -## Best Practices for Configuring FastCGI and PHP - -The download `https://download.microsoft.com/download/A/2/F/A2F199C0-672E-44E6-BF1D-878E233C3F08/hostingPHPonIIS7.zip "Hosting PHP"` contains a summary presentation on best practices for hosting PHP in a shared hosting environment. - - - -### Security Isolation for PHP Web Sites - -The recommendation for isolating PHP Web sites in a shared hosting environment is consistent with all general security isolation recommendations for IIS. In particular, it is recommended to: - -- Use one application pool per Web site -- Use a dedicated user account as an identity for the application pool -- Configure an anonymous user identity to use the application pool identity -- Ensure that FastCGI impersonation is enabled in the php.ini file (fastcgi.impersonate=1) - -For more details about security isolation in a shared hosting environment, see [Ensure Security Isolation for Web Sites](../../manage/configuring-security/ensure-security-isolation-for-web-sites.md "Ensure Security Isolation for Web Sites"). - - - -### PHP Process Recycling Behavior - -Ensure that FastCGI always recycles the php-cgi.exe processes before the native PHP recycling kicks in. The FastCGI process recycling behavior is controlled by the configuration property **instanceMaxRequests**. This property specifies how many requests the FastCGI process will process before recycling. PHP also has a similar process recycling functionality that is controlled by the environment variable **PHP\_FCGI\_MAX\_REQUESTS**. By setting **instanceMaxRequests** to be less than or equal to **PHP\_FCGI\_MAX\_REQUESTS**, you can ensure that the native PHP process recycling logic will never kick in. - -The FastCGI settings can be configured either by using IIS Manager or by using the command line tool A **ppCmd**. - -#### Configure FastCGI recycling settings by using IIS Manager - -1. Ensure that the [Administration Pack for IIS](#install-the-administration-pack-for-iis) is installed on your server. Open IIS Manager. On the server level, double-click **FastCGI Settings**. - - ![Screenshot of the I I S Manager window showing the Fast C G I settings icon highlighted.](using-fastcgi-to-host-php-applications-on-iis/_static/image10.png) -2. Select the FastCGI application that you want to configure. In the **Actions** pane, click **Edit**. - - ![Screenshot of the I I S Manager window showing the Fast C G I Settings page and Edit highlighted in the Actions pane.](using-fastcgi-to-host-php-applications-on-iis/_static/image12.png) -3. In the **Edit FastCGI Application** dialog box, set the **InstanceMaxRequests** to **10000**. Next to the **EnvironmentVariables** setting, click the Browse (**...**) button. - - ![Screenshot of the Edit Fast C G I Application dialog. The browse button and Instance Max Requests are circled.](using-fastcgi-to-host-php-applications-on-iis/_static/image14.png) -4. In the **EnvironmentVariables Collection Editor** dialog box, add the **PHP\_FCGI\_MAX\_REQUESTS** environment variable and set its value to **10000**. - - ![Screenshot of the Environment Variables Collection Editor dialog with Value highlighted.](using-fastcgi-to-host-php-applications-on-iis/_static/image16.png) - - > [!NOTE] - > If you do not configure these settings, the following default settings will be used: **instanceMaxRequests** = 200, **PHP\_FCGI\_MAX\_REQUESTS** = 500 (on most PHP builds). - -#### Configure FastCGI recycling settings by using the command line - -Configure the recycling behavior of FastCGI and PHP by using **AppCmd** by running the following commands: - -[!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample7.cmd)] - - - -### PHP Versioning - -Many PHP applications rely on functions or features that are available only in certain versions of PHP. If these types of applications are to be hosted on the same server, different PHP versions must be enabled and running side-by-side. The IIS FastCGI handler fully supports running multiple versions of PHP on the same Web server. - -For example, assume that on your Web server you plan to support PHP 4.4.8, PHP 5.2.1, and PHP 5.2.5 non-thread safe. To enable that configuration, you must place corresponding PHP binaries in separate folders on the file system (e.g. `C:\php448\`, `C:\php521\` and `C:\php525nts`) and then create FastCGI application process pools for each version: - -[!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample8.cmd)] - -If you have three Web sites (site1, site2, site3) and each site must use a different PHP version, you can now define handler mappings on each of those sites to reference a corresponding FastCGI application process pool. - -> [!NOTE] -> Each FastCGI process pool is uniquely identified by a combination of fullPath and arguments properties. - -[!code-console[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample9.cmd)] - - - -### PHP Security Recommendations - -The following settings can be used to tighten the security of a PHP installation. To make the recommended changes, locate and open the php.ini file and edit the configuration settings as described below: - -| Setting | Description | -| --- | --- | -| allow\_url\_fopen=Off allow\_url\_include=Off | Disable remote URLs for file handling functions, which may cause code injection vulnerabilities. | -| register\_globals=Off | Disable register\_globals. | -| open\_basedir="c:\inetpub\" | Restrict where PHP processes can read and write on a file system. | -| safe\_mode=Off safe\_mode\_gid=Off | Disable safe mode. | -| max\_execution\_time=30 max\_input\_time=60 | Limit script execution time. | -| memory\_limit=16M upload\_max\_filesize=2M post\_max\_size=8M max\_input\_nesting\_levels=64 | Limit memory usage and file sizes. | -| display\_errors=Off log\_errors=On error\_log="C:\path\of\your\choice" | Configure error messages and logging. | -| fastcgi.logging=0 | The IIS FastCGI module will fail the request when PHP sends any data on stderr by using the FastCGI protocol. Disable FastCGI logging to prevent PHP from sending error information over stderr and generating 500 response codes for the client. | -| expose\_php=Off | Hide the presence of PHP. | - - - -## Enabling per-site PHP configuration - -This section describes the recommended way of enabling per-site PHP configuration. This recommendation was discovered and validated by Radney Jasmin with hosting provider [GoDaddy.com](http://www.godaddy.com/) who now offers PHP hosting on Windows Server 2008 by using FastCGI. - -### Per-site PHP Process Pools - -When each Web site has its own application pool, which is a recommended practice on IIS, it is possible to associate a dedicated FastCGI process pool with each Web site. A FastCGI process pool is uniquely identified by the combination of **fullPath** and **arguments** attributes. If you need to create several FastCGI process pools for the same process executable, such as php-cgi.exe, you can use the **arguments** attribute to distinguish the process pool definitions. With php-cgi.exe processes, you can also use the command line switch "-d" to define an INI entry for a PHP process. You can use this switch to set a PHP setting that makes the arguments string unique. - -For example, if there are two Web sites "website1" and "website2" that must have their own set of PHP settings, the FastCGI process pools can be defined as follows: - -[!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample10.xml)] - -In this example the PHP setting **open\_basedir** is used to distinguish between the process pool definitions. The setting also enforces that the PHP executable for each process pool can perform file operations only within the root folder of the corresponding Web site. - -Then website1 can have the PHP handler mapping as follows: - -[!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample11.xml)] - -and website2 can have the PHP handler mapping as follows: - -[!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample12.xml)] - -### Specifying php.ini location - -When the PHP process starts, it determines the location of the configuration php.ini file by using various settings. [The PHP documentation](http://www.php.net/manual/en/configuration.php) provides a detailed description of the PHP startup process. One of the places where the PHP process searches for the php.ini location is the PHPRC environment variable. If the PHP process finds a php.ini file in the path that is specified in this environment variable, it will use it; otherwise, the PHP process will revert to using the default location of the php.ini file. This environment variable can be used to allow hosting customers to use their own versions of php.ini files. - -For example if there are two Web sites "website1" and "website2" that are located at the following file paths: `C:\WebSites\website1` and `C:\WebSites\website2`, you can configure the php-cgi.exe process pools in the `` section of the applicationHost.config file as follows: - -[!code-xml[Main](using-fastcgi-to-host-php-applications-on-iis/samples/sample13.xml)] - -This way website1 can have its own version of the php.ini file that is located in the `C:\WebSites\website1`, while website2 can have its own version of the php.ini file that is located in `C:\WebSites\website2`. This configuration also ensures that if a php.ini file cannot be found in the location that is specified by the PHPRC environment variable, then PHP will use the default php.ini file that is located in the same folder where the php-cgi.exe is located. - - - -## Provide URL Rewriting Functionality for PHP Applications - -The majority of popular PHP applications rely on the URL rewriting functionality in Web servers to enable user-friendly and search engine-friendly URLs. IIS provide URL rewriting capabilities by using the [URL rewrite module](../../extensions/url-rewrite-module/using-the-url-rewrite-module.md "URL rewrite module"). - -For more information about how to use the URL Rewrite module, see the following articles: - -- [Microsoft URL Rewrite Module Walkthroughs](../../extensions/url-rewrite-module/using-the-url-rewrite-module.md): Describes how to use the URL Rewrite module. -- [Microsoft URL Rewrite Module configuration reference](../../extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md) Explains the functionality of the module and provides descriptions of all the configuration options. -- Configuring popular PHP applications to work with the URL Rewrite module: - - - [WordPress](install-wordpress-on-iis.md) - - [MediaWiki](mediawiki-on-iis.md) - - [b2Evolution](b2evolution-on-iis.md) - - [Mambo](mambo-on-iis.md) - - [Drupal](install-drupal-on-iis.md) - - - -## Related resources - -For more information regarding hosting PHP applications on IIS refer to the following resources: - -- [Popular PHP applications on IIS](index.md) -- [Configuring FastCGI extension for IIS 6.0](../install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60.md) -- [Using FastCGI extension to host PHP on IIS 6.0](using-fastcgi-to-host-php-applications-on-iis-60.md) -- [Installing FastCGI support on Windows Server 2008 Core](../install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md) diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.gif b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.gif deleted file mode 100644 index 4a6ac0c4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.jpg deleted file mode 100644 index 9f9fb3718..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.png deleted file mode 100644 index 1633432a7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image10.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image10.png deleted file mode 100644 index e5fca5833..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image12.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image12.png deleted file mode 100644 index 9e01b1fa6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image12.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image14.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image14.png deleted file mode 100644 index 43445e2c2..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image14.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image16.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image16.png deleted file mode 100644 index 2bea6d1ca..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image16.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image2.gif b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image2.gif deleted file mode 100644 index 4a6ac0c4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image2.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.jpg deleted file mode 100644 index be2388956..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.png deleted file mode 100644 index 716a86bf6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image4.png deleted file mode 100644 index 716a86bf6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image6.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image6.png deleted file mode 100644 index 9b23d4ee1..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image8.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image8.png deleted file mode 100644 index c8b618bcc..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample1.cmd deleted file mode 100644 index 91d448c70..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\PHP>php –info \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample10.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample10.xml deleted file mode 100644 index 786eb51dd..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample10.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample11.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample11.xml deleted file mode 100644 index 2251dc8ca..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample11.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample12.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample12.xml deleted file mode 100644 index acf4e6f12..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample12.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample13.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample13.xml deleted file mode 100644 index d80802e85..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample13.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample2.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample2.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample2.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample3.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample3.xml deleted file mode 100644 index fcbed4ded..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample3.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample4.xml b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample4.xml deleted file mode 100644 index f86930009..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample4.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample5.cmd deleted file mode 100644 index e82b6d26e..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\{php_folder}\php-cgi.exe'] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample6.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample6.cmd deleted file mode 100644 index 525a6df0b..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample6.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers /+[name='PHP_via_FastCGI',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='c:\{php_folder}\php-cgi.exe',resourceType='Unspecified'] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample7.cmd deleted file mode 100644 index 91be8dafc..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample7.cmd +++ /dev/null @@ -1,3 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='c:\{php_folder}\php-cgi.exe'].instanceMaxRequests:10000 - -C:\>%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='C:\{php_folder}\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS',value='10000']" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample8.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample8.cmd deleted file mode 100644 index 49757df97..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample8.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php448\php.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php521\php-cgi.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php525nts\php-cgi.exe'] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample9.cmd b/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample9.cmd deleted file mode 100644 index 35360f672..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis/samples/sample9.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config site1 –section:system.webServer/handlers /+"..[name=’PHP448_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php448\php.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site2 –section:system.webServer/handlers /+"..[name=’PHP521_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php521\php-cgi.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site3 –section:system.webServer/handlers /+"..[name=’PHP525nts_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php525nts\php-cgi.exe’,resourceType=’Either’] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis.md b/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis.md deleted file mode 100644 index 38ef566df..000000000 --- a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: "XOOPS on IIS" -author: rick-anderson -description: "XOOPS is a popular open source portal and content management system. It serves as a web framework for use by small, medium and large sites. It allows adminis..." -ms.date: 12/18/2007 -ms.assetid: 6c81b442-b873-4b8b-93a8-ee1cbd1b9c46 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis -msc.type: authoredcontent ---- -# XOOPS on IIS - -by Eric Woersching - -## Introduction - -XOOPS is a popular open source portal and content management system. It serves as a web framework for use by small, medium and large sites. It allows administrators to easily create dynamic websites with great content and many outstanding features. It is a tool for developing small to large dynamic community websites, intra company portals, corporate portals, weblogs and much more. The following sections describe how to install and configure XOOPS for use with FastCGI on IIS 6.0. This document assumes that you have completed the setup and configuration of the FastCGI extension and PHP libraries as described in [https://www.iis.net/fastcgi/phpon60](using-fastcgi-to-host-php-applications-on-iis-60.md). - -The instructions have been tested and found to work in the following configurations: - -- Windows Server® 2003 operating system -- IIS 6.0 -- PHP 5.2.4 -- MySQL 5.0.45 -- XOOPS 2.0.17 - -## Notes on PHP Setup - -XOOPS does not require many modifications beyond the default configuration provided by PHP **.** From the base configuration file provided by PHP, you only need to modify the following lines in your php.ini configuration file to get XOOPS working: - -- Define `extension\_dir` as `c:\php\ext` (i.e., the location of your php extensions directory) -- Uncomment `extension=php\_mysql.dll` in the extensions list to enable MySQL support - -## Download and Unzip XOOPS - -The latest release of XOOPS is at [http://www.xoops.org/](http://www.xoops.org/). The instructions in this document are based on version 2.0.17, but future versions are likely to be very similar as far as installation is concerned. After downloading the zip package, extract the contents of the 'htdocs' folder from the archive into `C:\Inetpub\wwwroot\xoops` or another directory of your choosing. - -## Access Permissions - -In order for XOOPS installation to work, you must make sure that the IIS application pool worker process has write access to the following directories and files: - -- mainfile.php -- cache -- templates\_c -- uploads - -> [!NOTE] -> FastCGI impersonates the requests from all users. Make sure that the user account used for impersonation has write access to those files. - -For example, if the web site or virtual directory is configured for Anonymous authentication, then grant "Internet Guest Account" write access to those files. - -## Set Up the Database - -Before starting the installation procedure for XOOPS, create a database on your server. Also create a user and grant this user db ownership permission to the database. Follow the instructions in the [Setting Up a Database for a PHP Application on IIS](../install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md) article for a MySQL database. This walkthrough uses the following database information: - -- Database Name: 'xoops' -- Database User: 'xoops' -- Account Password: 'xoops' - -## Set Up and Configure the Application - -Begin the graphical XOOPS installation procedure by pointing your browser at `http://localhost/xoops`. You see the following page. - -1. Click 'Next' to go to the next screen. - - ![Screenshot showing a browser window with the XOOPS custom installation open in a tab.](xoops-on-iis/_static/image1.png) -2. Proceed through the installation screens until you get to the most important page-- the setup for configuring the database connection. Fill in the information as appropriate: - - ![Screenshot showing a browser window with the XOOPS General configuration open in a tab.](xoops-on-iis/_static/image3.png) - - > [!NOTE] - > The XOOPS root path is shown with the wrong slashes, but the install still works. -3. Now that the database connection is configured, proceed to the following screens that verify the connection and set up the database tables. Keep clicking "Next" and several screens later XOOPS will be successfully installed. - -## Getting More Information - -To discuss the FastCGI Extension for IIS 6.0, or file bug reports, use the FastCGI forums: - -- [IIS.NET / IIS 6.0 FastCGI forums](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, refer to: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image1.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image1.png deleted file mode 100644 index c4285c5ce..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image2.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image2.png deleted file mode 100644 index c4285c5ce..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image3.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image3.png deleted file mode 100644 index 7ea6bf325..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image4.png b/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image4.png deleted file mode 100644 index 7ea6bf325..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-applications-on-iis/xoops-on-iis/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above.md b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above.md deleted file mode 100644 index 872333250..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above.md +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: "Configure SMTP E-Mail in IIS 7 and higher" -author: rick-anderson -description: "To send e-mail from a PHP application using the System.Net.Mail API, you must configure Simple Mail Transfer Protocol (SMTP) e-mail. Configuring e-mail servi..." -ms.date: 11/15/2009 -ms.assetid: 181c9548-33dd-4af4-88b8-0dab0fd05811 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above -msc.type: authoredcontent ---- -# Configure SMTP E-Mail in IIS 7 and higher - -by Tali Smith - -## Note - -The IIS SMTP Virtual Server Component that is mentioned in this article is part of IIS 6.0, the support for which has ended with the support of [Windows Server 2003](https://support.microsoft.com/lifecycle/search/810). To relay emails to Exchange OnPrem and/or Office 365, use one of the supported versions of Exchange Server, as we no longer support doing so with IIS SMTP. - -## Introduction - -To send e-mail from a PHP application using the System.Net.Mail API, you must configure Simple Mail Transfer Protocol (SMTP) e-mail. Configuring e-mail services tells the System.Net.Mail application programming interface (API) to which SMTP server to deliver the e-mail generated by your application. Mail can be delivered immediately, or it can be delivered to a file location on disk where it can be retrieved for delivery later. For example, a company can provide an e-mail link for sending feedback messages or for requesting information. - -The procedures for configuring SMTP e-mail can be performed at the following levels in Internet Information Services 7 (IIS 7) and above: - -- Web server -- Site -- Application -- Physical and virtual directories -- File (URL) - -## Install SMTP - -The SMTP server is not installed by default. - -1. Open Server Manager by right-clicking on **My Computer**, and selecting **Manage**. (Alternately, open **Control Panel**, click on **Programs and Features**, and then select **Turn Windows features on or off**.) -2. Under **Features**, select **Add Features**. -3. Select the **SMTP Server** check box. -4. Click **Add Required Role Services**. If there are any missing roles required for the SMTP installation, Windows Server® 2008 R2 or Windows Server® 2008 installs them. Click **Next**. -5. You need to step through the entire wizard again, even though IIS is already installed (IIS 6 Management Compatibility and the IIS 6 Management Console must be installed for SMTP to work). - - ![Screenshot of the Add Features Wizard showing Confirm Installation Selections in the main pane. Install is highlighted.](configure-smtp-e-mail-in-iis-7-and-above/_static/image1.jpg) - - *Figure 1: Confirm Installation Selections* -6. Press **Close** when installation is complete. - -## Configure SMTP E-Mail for a Web Application - -Once you add SMTP, you can configure it for your PHP applications. This can be done by using the user interface (UI), by running Appcmd.exe commands from a command prompt, by editing configuration files directly, or by writing Windows® Management Instrumentation (WMI) scripts. Note that you must have IIS installed before enabling SMTP. - -### Use the User Interface - -1. Open **Internet Information Services (IIS) Manager**, and then navigate to the level you want to manage. -2. **Features View**, double-click **SMTP E-mail**. -3. On the **SMTP E-mail** page, type the e-mail address of the sender in the **E-mail address** text box. -4. On the **SMTP E-mail** page, select one of the following delivery methods: - - - **Deliver e-mail to SMTP server:** to deliver e-mail messages immediately. This requires an operational SMTP server for which the user has credentials. - - **Store e-mail in pickup directory:** to store e-mails in a file location on disk for later delivery by the PHP application (or by a Microsoft® ASP.NET application or by a user). -5. If **Deliver e-mail to SMTP server** is selected, do the following: - - - Type the unique name of your SMTP server in the **SMTP Server** text box, or select the **Use localhost** check box to set the name to **LocalHost**. Setting the name to LocalHost means that ASP.NET uses an SMTP server on the local computer. Typically, this is the default SMTP virtual server. - - Enter a TCP port in the **Port** text box. Port 25 is the SMTP standard TCP port and is the default setting. More than one virtual server can use the same TCP port if all servers are configured by using different IP addresses. - - Under **Authentication Settings**, specify the authentication mode and credentials if your SMTP server requires these. -6. If **Store e-mail in pickup directory** is selected, type the batch e-mail location in the **Store e-mail in pickup directory** text box. -7. Click **Apply** in the **Actions** pane. - -### Use the Command Line - -You can configure IIS so that e-mail is delivered immediately or stored for later delivery. - -#### Deliver e-mail messages immediately - -To configure SMTP e-mail to deliver e-mail messages immediately, use the following syntax: - -[!code-console[Main](configure-smtp-e-mail-in-iis-7-and-above/samples/sample1.cmd)] - -The variable **from***string* is the e-mail address of the sender. The variable **/deliveryMethod:network** configures IIS to deliver e-mail messages immediately. The variable **/network.port***int* sets the TCP port that is used by IIS to deliver e-mail messages. The variable **/network.host***string* specifies the host used for SMTP transactions. The variable **network.defaultCredentials:True**|**False** enables or disables authentication using the default network credentials. If **defaultCredentials** is set to **True**, Kerberos or NTLM are used if the server supports these protocols. The variables **network.userName:** *string* and **network. password:** *string* set a basic authentication user name and password. - -#### Store e-mails for later delivery - -To configure SMTP e-mail to store e-mails in a file location on disk for later delivery by an application, such as an ASP.NET application, or by a user, such as an administrator, use the following syntax: - -[!code-console[Main](configure-smtp-e-mail-in-iis-7-and-above/samples/sample2.cmd)] - -The variable from string is the e-mail address of the sender. The variable/deliveryMethod:PickupDirectoryFromIis|SpecifiedPickupDirectory string configures IIS to store e-mails in a file location on disk for later delivery. The variable /SpecifiedPickupDirectory string sets the file location on disk in which to store the e-mail messages for later delivery. - -Note that when you use Appcmd.exe to configure the `` element at the global level in IIS, you must specify **/commit:WEBROOT** in the command so that configuration changes are made to the root Web.config file instead of the ApplicationHost.config file. - -### Edit the Configuration Files - -1. First, configure the Php.ini file. Open the **Php.ini** file, and find the entry: - - [!code-console[Main](configure-smtp-e-mail-in-iis-7-and-above/samples/sample3.cmd)] -2. Set the following values: - - [!code-console[Main](configure-smtp-e-mail-in-iis-7-and-above/samples/sample4.cmd)] - - Note that the default value is localhost, so there is no need to change this if SMTP is installed locally. - - - Save and close the **Php.ini** file. -3. Enable Relay for localhost: - - - Open the **Internet Information Services (IIS) 6.0 Manager**. - - Right-click on **Default SMTP Virtual Server**. -4. On the **Properties** page, open the **Access** tab, and then click on **Connection**. You can see which server or IP addresses are allowed to connect to the server. -5. If the IP address 127.0.0.1 is not listed, add it using the **Add** button. You may also add your server IP address to the list. - - ![Screenshot of a desktop showing multiple windows. The Computer dialog is at the top with I P address and O K highlighted.](configure-smtp-e-mail-in-iis-7-and-above/_static/image3.jpg) - - *Figure 2: Enable Relay for localhost* -6. Click **OK** to accept the information. -7. Click the **Relay** button on the **Access** tab, and set up the relay options for the server. Ensure that localhost and the IP address 127.0.0.1 are granted permission to relay mail. -8. Click **OK** to accept the options, and then click **Apply** and **OK** to return to the main page of the IIS Manager. -9. Click **Restart IIS**. - -## Test E-Mail from PHP - -Create a test script to see whether you can send e-mail using PHP. Copy the following text and save it as **email\_test.php** at your server root. - -[!code-xml[Main](configure-smtp-e-mail-in-iis-7-and-above/samples/sample5.xml)] - -Run the file at **mydomain.com/email\_test.php**. - -## Links for Further Information - -- [Configure SMTP e-mail in IIS 7](https://technet.microsoft.com/library/cc772058(WS.10).aspx). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image1.jpg deleted file mode 100644 index d5e363d66..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image2.jpg deleted file mode 100644 index d5e363d66..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image3.jpg deleted file mode 100644 index 92e05ed61..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image4.jpg deleted file mode 100644 index 92e05ed61..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample1.cmd deleted file mode 100644 index cf4c00146..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\%windir%\system32\inetsrv\appcmd set config /commit:WEBROOT /section:smtp /from: string /deliveryMethod:network /network.port: int /network.defaultCredentials:True|False /network.host:string /network.userName:string /network.password:string \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample2.cmd deleted file mode 100644 index 77dc38ec7..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\%windir%\system32\inetsrv\appcmd set config /commit:WEBROOT /section:smtp /from: string /deliveryMethod:PickupDirectoryFromIis|SpecifiedPickupDirectory /SpecifiedPickupDirectory:string \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample3.cmd deleted file mode 100644 index 6d4db0686..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -[mail function] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample4.cmd deleted file mode 100644 index f552abd8f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample4.cmd +++ /dev/null @@ -1,3 +0,0 @@ -SMTP=localhost -sendmail_from = string -smtp_port=25 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample5.xml b/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample5.xml deleted file mode 100644 index af3072326..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configure-smtp-e-mail-in-iis-7-and-above/samples/sample5.xml +++ /dev/null @@ -1,5 +0,0 @@ - [!NOTE] - > If you are using a 64-bit platform in WOW mode, you must use the fcgiext.dll file that is located in the `%WINDIR%\SysWOW64\inetsrv` path. - -8. In the **Extension** text box, enter **.php** (or another extension that is specific to your FastCGI application). -9. Under **Verbs**, in the **Limit to** text box, enter **GET,HEAD,POST**. -10. Select the **Script engine** and **Verify that file exists** check boxes. - - ![Screenshot of the Add/Edit Application Extension Mapping dialog.](configuring-the-fastcgi-extension-for-iis-60/_static/image1.png) - -11. Click **OK**. - -### FCGIEXT.ini - -The configuration for FastCGI is a collection of one or more applications. A FastCGI application consists of a pool of processes that each handle HTTP requests. Each process in the pool handles one request at a time. After each request, the process is returned to the pool to await another request. Each application is required to have its own section in the configuration file to specify its behavior. - -The main section of the fcgiext.ini file is the **[types]** section. This section associates file extensions from the URL with FastCGI applications. - -The general syntax is as follows: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample1.cmd)] - -The previous example consists of seven mappings that are mapped as follows: - -- The file extension "abc" is associated with the FastCGI application named "Application 1". -- The file extension "def" is associated with the FastCGI application named "Application 2", but only for requests that are made to the application /app1 under the site with the numeric identifier of "1701187997". Note that application-specific mappings override site, extension-specific mappings. -- Requests to the application /app1 under the Web site with the identifier of "1701187997" and with a file extension other than "def" are associated with the FastCGI application named "Application 3". -- The file extension "def" is associated with the FastCGI application named "Application 4", but only for requests that are made to the applications other than /app1 under the Web site with the numeric identifier of "1701187997". Note that site-specific mappings override non-site-specific mappings. -- Requests to the applications other than /app1 under the Web site with the identifier of "1701187997" and with file extensions other than "def" are associated with the FastCGI application named "Application 5". -- The file extension "def" is associated with the FastCGI application named "Application 6" for requests that are not for sites with the numeric identifier of "1701187997". -- Requests with a file extension that does not have a specific mapping are associated with the FastCGI application named "Application 7". - -> [!NOTE] -> Application names are ASCII and should generally contain only alphanumeric characters. Space characters are allowed. Application names are not case sensitive. - -> [!NOTE] -> Multiple mappings can be associated with the same FastCGI application. - -### FastCGI Application Settings - -The FastCGI extension has a set of configuration settings that controls the behavior of FastCGI processes that are associated with the FastCGI process pool. This section lists all the settings that are supported by FastCGI and their format: - -- *ExePath* - The physical path to the process executable to use in the pool. -- *Arguments* - Arguments to pass to each process in the pool at start time. This setting is optional. -- *EnvironmentVars –* Environment variables that are set for the process executable associated with this pool. This setting uses the following format: - -> EnvironmentVars=Name:Value,Name:Value,…,Name:Value - -Example: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample2.cmd)] - -If the environment variable value contains a space character, then enclose the value in quotes. If the environment variable value contains a comma character, then this character is escaped with "/". Similarly, if the environment variable value contains "/", then this character should be escaped as well. - -Example: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample3.cmd)] - -- *Protocol –* This setting specifies the protocol to use to communicate with the FastCGI process. The allowed values are 'NamedPipe' and 'Tcp'. If not specified, the default value is 'NamedPipe'. -- *QueueLength* – This setting specifies the maximum number of requests to this application's process pool that are queued before the FastCGI handler starts returning errors to clients, indicating that the application is too busy. If not specified, the default value is 1000. -- *MaxInstances* – This is the highest number of process instances allowed in the process pool. Note that the FastCGI handler will not create this number of processes unless they are needed. If your application never receives more than two concurrent requests, your application only creates two processes. The default is 0, which means that the number of process instances will be adjusted automatically based on available memory and current CPU usage . -- *InstanceMaxRequests* – This is the number of requests that are sent to a process in the pool before it is shut down and recycled. The default value is 1000. -- *IdleTimeout* – This is the number of seconds that a process can remain idle without working on a request before it shuts down. The default is 300 seconds. -- *ActivityTimeout* – This is the number of seconds that the FastCGI handler waits for I/O activity from a process before it is terminated. The default is 30 seconds. -- *RequestTimeout* – This is the maximum amount of time that a FastCGI process is allowed to handle a request before it is terminated. The default value is 90 seconds. -- *ResponseBufferLimit –* Data from FastCGI processes is buffered before being returned to the client as responses. This property specifies the amount of response data, in bytes, that is buffered for requests to this application. This buffer is flushed to the client once it is full, or when the response is complete, whichever occurs first. If not specified, the default value is 4194304 (4MB). -- *FlushNamedPipe* – There are some cases where a FastCGI application might not read all of the data from the named pipe that communicates with the Web server. If this happens, the Web server waits for a read that is not coming, causing a deadlock on that member of the process pool. This most often happens in the case where the FastCGI process abnormally exits. For instance, the process may have an internal notion of the maximum number of requests that it can handle that is less than the *InstanceMaxRequests* setting. Setting *FlushNamedPipe* to 1 will cause FastCGI to flush data that might lead to this condition. The default value is 0. -- *UnhealthyOnQueueFull* – If the value is 1, the worker process that is hosting is flagged to IIS as unhealthy any time that the application's request queue is filled. IIS checks health whenever it does a ping to the worker process. If that worker process has been flagged as unhealthy, it (along with everything it is hosting) will be recycled. If not specified, the default value is 0. -- *MonitorChangesTo* - This property specifies the path to a file, changes to which will trigger a recycle of FastCGI executables that are running for this FastCGI process pool. If the value of this property is blank, file change monitoring is disabled. The path to a file can be absolute or relative to the folder in which the FastCGI process (as specified by ExePath) is present. If not specified, the default value is blank. -- *StderrMode* - This setting specifies how content that is received on **stderr** is handled. The allowed values are: - - - '**ReturnStderrIn500**' - The FastCGI extension will set the response status code to 500 and send whatever was received on the stderr stream as a response. This is the same behavior as in the FastCGI Extension v1.0. - - '**ReturnGeneric500**' - The FastCGI extension will set the response status code to 500, but will return a generic 500 response. - - '**IgnoreAndReturn200**' - Data on **stderr** is completely ignored and the FastCGI extension will send what was received on **stdout** as a response, with the status code 200. - - **'TerminateProcess**' - The FastCGI extension will terminate the FastCGI process as soon as it returns anything on **stderr**. A generic response with the status code 500 will be sent to the HTTP client. - -If this setting is not specified, the default value is 'ReturnStderrIn500'. - -- *MaxInstances* - This setting dictates the maximum number of FastCGI processes that can be launched for each application pool. This value is also equal to the maximum number of requests that can be processed simultaneously, since one process handles only one request at a time. This setting existed in the FastCGI Extension v1.0; however, with FastCGI Extension v1.5, the value can be set to 0, which will turn on automatic adjustment of the maximum number of instances. When the value is set to 0, the FastCGI extension will constantly analyze current CPU load and memory availability and, based on that, will increase or decrease the number of FastCGI process instances that are running at the same time. -- *SignalBeforeTerminateSeconds* - This setting specifies the number of seconds to elapse after setting the shutdown event and before calling TerminateProcess, thereby forcibly terminating the process. The default value is 0, which means that the event is not set and the FastCGI processes can be terminated abruptly at any time. If this value is greater than 0, the FastCGI process will create an event that is inherited by the child process. The value of this event's handle is set as the environment variable \_FCGI\_SHUTDOWN\_EVENT\_. The name of the named pipe, which is used to communicate with the process, is stored in the environment variable \_FCGI\_X\_PIPE\_. -- *ActivityTimeout* - This is the number of seconds that the FastCGI handler waits for I/O activity from a process before it is terminated. This setting existed in the FastCGI Extension v1.0, but in v1.5 its default value has been increased from 30 seconds to 70 seconds. - -### Using UTF-8 Encoding for Server Variables - -By default, the FastCGI extension uses ASCII encoding when setting server variables that are used by PHP. When the requested URL contains non-ASCII characters, server variables that derive their values from the requested URL string may be set incorrectly. PHP applications that rely on those server variables may not work as a result. - -To prevent this, the FastCGI extension can be configured to use UTF-8 encoding when setting server variables. To configure FastCGI to use UTF-8 encoding for a particular set of server variables, use the **REG\_MULTI\_SZ** registry key **FastCGIUtf8ServerVariables** and set its value to a list of server variable names. For example: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample4.cmd)] - -The above example configures the FastCGI extension to use UTF-8 encoding when setting the REQUEST\_URI and PATH\_INFO server variables. - -After setting the registry key, restart IIS by using the **iisreset** command. - -**Warning:** Using UTF-8 encoding for server variables may affect how PHP core and PHP applications work. Make sure to verify that applications work as expected after the registry key has been changed. - -## Using the FastCGI Configuration Script - -To simplify and automate the configuration steps that are described in the previous sections, a configuration script (fcgiconfig.js) is provided with the installation of the FastCGI extension. The script is located in `%WINDIR%\system32\inetsrv`. This script adds and removes script maps and modifies application pool settings in the fcgiext.ini file. - -### Adding a New FastCGI Mapping - -To add a new FastCGI mapping, run the script fcgiconfig.js with the **–add** switch. When using this switch, you must provide the following parameters: - -- **-section:<Section name>.** This parameter specifies the name of the section that will be added to the fcgiext.ini file in the **[Types]** block. -- **-extension:<file extension>**. This parameter specifies which file extensions are associated with this section. -- **-path:<file path to CGI executable>**. This parameter specifies the absolute file path to the CGI executable that processes requests for files with the extension that is specified in the **–extension** parameter. -- **-site:<site id>**. This optional parameter specifies to which site the section should be added. If not specified, the section is added to all sites on your Web server. -- **-application:"/w3svc/<siteid>/root/<appname>"** -- **-norecycle**. By default, the configuration script recycles all application pools on IIS 6.0 for configuration changes to take effect. This optional parameter prevents this recycling. - -Examples: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample5.cmd)] - -The previous example adds a script map for the .php extension and updates the fcgiext.ini file. - -As an option, you can specify to which site the script map is applied: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample6.cmd)] - -This example adds a script map to the "Default Web Site" only. - -Also, you can specify to which application the script map is applied: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample7.cmd)] - -### Removing an Existing FastCGI Mapping - -To remove an existing FastCGI mapping, run the script fcgiconfig.js with the **–remove** switch. When using this switch, you must provide the following parameters: - -- **-section:<Section name>**. This parameter specifies the name of the section that will be removed from the fcgiext.ini file in the **[Types]** block. -- **-norecycle**. By default, the configuration script recycles all application pools on IIS 6.0 for configuration changes to take effect. This optional parameter prevents this recycling. - -This example removes the FastCGI mapping for PHP applications: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample8.cmd)] - -### Configuring an Existing FastCGI Mapping - -You can use the configuration script to set all the FastCGI configuration properties that are described earlier in this article. To set the configuration properties, use the **–set** switch. When using this switch, you must provide the following parameters: - -- **-section:<Section name>**. This parameter specifies the name of the section to which the configuration change will be applied. -- **-<Parameter Name>:<Parameter Value>.** This parameter specifies the name of the parameter to change and its new value. The complete list of possible parameters is found in the section "Application Pool Settings". -- **-norecycle**. By default, the configuration script recycles all application pools on IIS 6.0 for configuration changes to take effect. This optional parameter prevents this recycling. - -This example sets the FastCGI process pool configuration property InstanceMaxRequests for the "PHP" section: - -[!code-console[Main](configuring-the-fastcgi-extension-for-iis-60/samples/sample9.cmd)] diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image1.png b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image1.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image2.png b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image2.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image3.png b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image3.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image4.png b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image4.png deleted file mode 100644 index 5c40ae95e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample1.cmd deleted file mode 100644 index 54cbdf200..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample1.cmd +++ /dev/null @@ -1,8 +0,0 @@ -[types] -abc=Application 1 -def:/lm/w3svc/1701187997/root/app1=Application 2 -*:/lm/w3svc/1701187997/root/app1=Application 3 -def:1701187997=Application 4 -*:1701187997=Application 5 -def=Application 6 -*=Application 7 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample2.cmd deleted file mode 100644 index a9c10da38..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -EnvironmentVars=VARIABLE1:10000,VARIABLE2:20000 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample3.cmd deleted file mode 100644 index 22a432742..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -EnvironmentVars=VARIABLE1:"C://PHP",VARIABLE2="1/,2/,3" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample4.cmd deleted file mode 100644 index bc28b39a3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -reg add HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\w3svc\Parameters /v FastCGIUtf8ServerVariables /t REG_MULTI_SZ /d REQUEST_URI\0PATH_INFO \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample5.cmd deleted file mode 100644 index 0f65e19ad..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript fcgiconfig.js -add -section:"PHP" -extension:php -path:"C:\PHP\php-cgi.exe" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample6.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample6.cmd deleted file mode 100644 index 1686b716d..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample6.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript fcgiconfig.js -add -section:"PHP" -extension:php -path:"C:\PHP\php-cgi.exe" –site:1 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample7.cmd deleted file mode 100644 index 4999ef3d3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript fcgiconfig.js -add -section:"PHP" -extension:php -path:"C:\PHP\php-cgi.exe" -application:"/w3svc/1/root/app1" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample8.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample8.cmd deleted file mode 100644 index 8ad38932f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript fcgiconfig.js -remove -section:"PHP" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample9.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample9.cmd deleted file mode 100644 index b1aaa63d4..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/configuring-the-fastcgi-extension-for-iis-60/samples/sample9.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript fcgiconfig.js -set -section:"PHP" –InstanceMaxRequests:10000 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content.md b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content.md deleted file mode 100644 index fd4d05e2f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Create a Separate Site or Virtual Directory for PHP Content" -author: rick-anderson -description: "Introduction PHP hosters generally set up an environment, and provide a separate domain for each customer to host their applications. Self-hosters or very sm..." -ms.date: 11/15/2009 -ms.assetid: b47e1bcf-47f1-4710-b686-db85030fb71d -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content -msc.type: authoredcontent ---- -# Create a Separate Site or Virtual Directory for PHP Content - -by Tali Smith - -## Introduction - -PHP hosters generally set up an environment, and provide a separate domain for each customer to host their applications. - -Self-hosters or very small hosters, however, may need create a separate site or virtual directory to host their PHP content on a system that is also used for other workloads when: - -- Application contents are located in a separate physical directory on disk. -- Mixing other application contents with the PHP application is not desired. -- Different permission settings are desired. -- You would like to host the PHP application at a different port or domain. - -In these cases, you can add a separate virtual directory to host the PHP content; the directory is still accessible as part of the default Web site's URL hierarchy. You must also set the permissions necessary to enable PHP content to be served. - -## Create a Virtual Directory to Host PHP Content - -1. Using **Windows® Explorer**, browse to the `C:\inetpub` directory. -2. Create a subdirectory named **phpapp** directory. -3. Right-click on the `C:\inetpub\phpapp` directory, and then click **Properties**. -4. On the **Security** tab, click **Edit**. -5. Click **Add**, and then type **IIS\_IUSRS** in the **Enter the object names to select** box. -6. Click **OK**. - [![Screenshot of the Permissions for p h p app dialog box. The Security tab is shown. Under Group or user names, I I S underscore I U S R S is highlighted.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.gif)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.gif) - *Figure 1: Permissions for phpapp folder* -7. Click **OK** to accept the default permissions (read and execute) -8. Click **OK** to close the phpapp Permissions window. - -## Set Permissions - -Any directory containing PHP content must grant the following permissions: - -- Grant IIS\_IUSRS read permission. This allows the Php-cgi.exe process to access the PHP content, if PHP is not configured to impersonate the authenticated user (fastcgi.impersonate = 0). This allows PHP in any Internet Information Services (IIS) application pool to access the content. -- OPTIONAL: If using impersonation, the directory must grant read access to all possible authenticated users that use the application by granting access to the individual user or a group to which all such users belong. -- If using anonymous authentication, the directory must grant access to the anonymous user configured in IIS (IIS\_IUSR by default). -- If using Windows®-based authentication methods, access must be granted to all possible authenticated users or group to which they all belong. -- It is strongly recommended not to grant write access or full access to IIS\_IUSRS or any account under which PHP executes. However, sometimes write access may be necessary if the application writes to its own files. In that case, grant write access only to the files or subdirectory that requires it. It is preferred however to configure all write access to be outside of the Web-accessible directory structure. -- OPTIONAL: If using application pool isolation to isolate applications, the directory should instead grant access to the custom account assigned to the corresponding application pool. -- ADVANCED: Alternatively, when using application pool isolation, access may be granted to the application pool security identifier (SID). - -Follow these steps: - -1. From the **Start** menu, open **Internet Information Services (IIS) Manager**. -2. Expand the server node, and then expand **Sites**. -3. In the tree view on the left, right-click the **Default Web Site**. -4. Click **Add Virtual Directory**. -5. In the **Alias** box, type **phpapp**. -6. In the **Physical path** box, type `c:\inetpub\phpapp` - [![Screenshot of the Add Virtual Directory dialog box. The Alias box contains the text p h p a p p. The Physical path box contains the text C colon backslash i net p u b backslash p h p a p p.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.jpg) - *Figure 2: Adding a virtual directory for php applications* -7. Click **OK**. -8. Using Windows Explorer, browse to the `C:\inetpub\phpapp` directory. -9. Create a file named **Hello.php**. -10. Paste the following into the file: - - [!code-xml[Main](create-a-separate-site-or-virtual-directory-for-php-content/samples/sample1.xml)] -11. Save and close the file. -12. Test the page. -13. Start **Windows® Internet Explorer®**, and then enter: **localhost/phpapp/hello.php** in the **Address** bar. - [![Screenshot of the Add Site Binding dialog box. Under Type, h t t p is chosen. Under I P address, All Unassigned is chosen. Under Port is the number eighty. Under Host name is p h p site.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image4.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image3.jpg) - *Figure 3: "Hello" page* -14. Close all open windows. - -## Create a Separate Site to Host PHP Content - -It is possible to create a separate site with the desired port and domain name to host the PHP application. - -1. Open **Internet Information Services (IIS) Manager** (Inetmgr.exe). -2. Expand the server node. -3. In the tree view on the left, right-click the **Sites** node, and then click **Add Web Site**. -4. Enter **PHPSite** for the **Site name**. -5. Enter `c:\inetpub\phpapp` for **Physical path**. -6. Enter **85** for **Port**. - [![Screenshot of the Add Web Site dialog box. P H P Site is written under Site name. Eighty five is written under Port. The physical path is c colon backslash i net p u b backslash p h p a p p.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image6.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image5.jpg) - *Figure 4: Add Web Site dialog*- Click **OK**. -7. Open **Internet Explorer**, and request `http://localhost:85/hello.php`. - [![Screenshot of the Add Virtual Directory dialog box. The physical path is c colon backslash i net p u b backslash p h p a p p.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image8.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image7.jpg) - *Figure 5: "Hello" page running on a Web Site* -8. Return to **IIS Manager** (Inetmgr.exe). -9. In the tree view on the left, right-click the **PHPSite**. -10. Click **Edit Bindings**. -11. Click **Add**. -12. Enter **phpsite** for the Host name. - [![Screenshot of the Add Site Binding dialog box. The host name is p h p site.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image10.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image9.jpg) - *Figure 6: Adding a site binding* -13. Click **OK** and close Site Bindings dialog. -14. Edit `C:\Windows\system32\drivers\etc\hosts` file in Notepad as administrator and add the following DNS entry: - - [!code-console[Main](create-a-separate-site-or-virtual-directory-for-php-content/samples/sample2.cmd)] -15. Save and close the hosts file. -16. Open **Internet Explorer**, and go to `http://phpsite/hello.php`. - [![Screenshot of the p h p site web page. The text hello is shown.](create-a-separate-site-or-virtual-directory-for-php-content/_static/image12.jpg)](create-a-separate-site-or-virtual-directory-for-php-content/_static/image11.jpg) - *Figure 7: "Hello" page running on a Web Site* -17. Close all open windows. - -Note that you can add any number of bindings to a site, to expose it on any combination of available IP addresses, ports, and domain names. - -You can also use this process to create SSL site bindings (although this also requires a valid server certificate, and may involve additional IIS configuration to properly secure an SSL site). - -*Note: This article uses material from the [PHP on Windows Training Kit](https://www.microsoft.com/downloads/details.aspx?FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb&DisplayLang=en), published on August 25, 2009.* diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.gif b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.gif deleted file mode 100644 index 688eaae43..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.jpg deleted file mode 100644 index aa993f9b4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image10.jpg deleted file mode 100644 index 0033eae83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image11.jpg deleted file mode 100644 index 9d9a2bb36..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image12.jpg deleted file mode 100644 index 9d9a2bb36..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.gif b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.gif deleted file mode 100644 index 688eaae43..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.jpg deleted file mode 100644 index aa993f9b4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image3.jpg deleted file mode 100644 index 0033eae83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image4.jpg deleted file mode 100644 index 0033eae83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image5.jpg deleted file mode 100644 index e0209f604..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image6.jpg deleted file mode 100644 index e0209f604..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image7.jpg deleted file mode 100644 index aa993f9b4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image8.jpg deleted file mode 100644 index aa993f9b4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image9.jpg deleted file mode 100644 index 0033eae83..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample1.xml deleted file mode 100644 index 03cf745b6..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample1.xml +++ /dev/null @@ -1,5 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample2.cmd deleted file mode 100644 index 7e532fcd3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/create-a-separate-site-or-virtual-directory-for-php-content/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -127.0.0.1 phpsite \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7.md b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7.md deleted file mode 100644 index 5bf672920..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: "Enable FastCGI Support in IIS 7 on Windows" -author: rick-anderson -description: "Introduction Internet Information Services 7 (IIS 7) and above comes with extended support for application frameworks through FastCGI, an open protocol suppo..." -ms.date: 11/15/2009 -ms.assetid: 5cedd13d-a696-4c1e-8282-7aef4e333227 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7 -msc.type: authoredcontent ---- -# Enable FastCGI Support in IIS 7 on Windows - -by Tali Smith - -## Introduction - -Internet Information Services 7 (IIS 7) and above comes with extended support for application frameworks through FastCGI, an open protocol supported by many open-source application frameworks that otherwise may not support stable and high-performance native integration with IIS.FastCGI provides a high-performance alternative to the Common Gateway Interface (CGI), a standard way for external applications to interface with Web servers that has been supported as part of the IIS feature set since the first release. - -For example, PHP traditionally runs on IIS either as an ISAPI extension or as a CGI program. CGI programs are executables launched by the Web server to output dynamic information; CGI applications run in a separate process that is created at the start of each request and terminated at the end. The "one process per request" model makes CGI programs simple to implement but can limit efficiency and scalability. ISAPI extensions execute inside the IIS worker process on multiple threads. - -FastCGI lets a single, long-running process handle multiple user requests; it retains the simplicity of the CGI programming model while eliminating much of the overhead. FastCGI addresses the performance issues inherent in CGI by providing a mechanism to reuse a single process over and over again for many requests. Additionally, FastCGI maintains compatibility with non-thread-safe libraries by providing a pool of reusable processes and ensuring that each process handles only one request at a time. - -The FastCGI module lets PHP developers get dramatically better performance, scalability, and reliability when running on Windows® operating systems. The FastCGI module also enables easy integration with the new features of IIS (such as the new output caching features) and with Microsoft® ASP.NET. - -## Before You Begin - -Windows Server® 2008 R2, Windows Server® 2008, Windows Vista®, or Windows® 7, and IIS 7 or above must be installed. - -## Enable FastCGI Support - -1. Add the CGI role service by going to **Server Manager** > **Roles** > **Add Role Services**. -2. Under **Application Development**, select the **CGI** check box. This enables both the CGI and FastCGI services (selecting CGI enables both CGI and FastCGI). - ![Screenshot of Add Role Services dialog with C G I selected under Application Development.](enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.png) - *Figure 1: Select Role Services page* -3. Confirm the selections on the **Confirm Installation Selection** page, and then click **Install**. -4. The **Installation Results** page shows that the installation succeeded. Click **Close**. -5. The CGI role service appears under the IIS panel. - -## Enable FastCGI Support in Windows 7 and Windows Vista SP1 - -IIS 7.0 for Windows Vista® Service Pack 1 (SP1) includes a built-in FastCGI component. (Note that IIS 7.0 included in Windows Vista without SP1 does *not* include FastCGI component.) To get FastCGI support on IIS 7.0 in Windows Vista, you must upgrade to Windows Vista SP1. - -The steps to enable FastCGI in Windows 7 are similar. - -1. Add the CGI role service by going to **Control Panel** > **Programs and Features** > **Turn Windows features on or off.** - ![Screenshot of the enabled C G I features in Programs and Features.](enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.jpg) - - *Figure 2: Windows Features page* - -## Install the Update for FastCGI Module - -The update for the IIS FastCGI module fixes several known compatibility issues with popular PHP applications. Install the update from one of the following locations: - -- [Update for Windows Server 2008](https://www.microsoft.com/downloads/details.aspx?FamilyID=d0343911-1775-4aef-8c99-5f13862ac386&DisplayLang=en) -- [Update for Windows Server 2008 x64 Edition](https://www.microsoft.com/downloads/info.aspx?na=22&p=3&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d70278393-3291-4aa1-870b-0e9b0907bddf%26DisplayLang%3den) -- [Update for Windows Server 2008 for Itanium-based Systems](https://www.microsoft.com/downloads/info.aspx?na=22&p=5&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d98e06637-0f00-45d5-83c5-ed1b41fd6a7b%26DisplayLang%3den) -- [Update for Windows Vista SP1](https://www.microsoft.com/downloads/info.aspx?na=22&p=2&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d19600729-8470-4956-a276-200450d814bd%26DisplayLang%3den) -- [Update for Windows Vista SP1 for x64 based Systems](https://www.microsoft.com/downloads/info.aspx?na=22&p=4&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3dc7066c3b-dcf7-4441-87bc-f7dcb51067d0%26DisplayLang%3den) - -## Install the Administration Pack for IIS 7.0 and Above - -> [!NOTE] -> This step is optional. - -The [IIS 7.0 Administration Pack](https://www.iis.net/downloads/microsoft/administration-pack) adds to the set of management features that ship with IIS to include Administration UI support for ASP.NET authorization, custom errors, FastCGI configuration, request filtering, and much more. The Administration Pack also provides a generic configuration editor that is capable of setting any IIS configuration setting and automatically generating scripts to make the task easily repeatable. - -> [!NOTE] -> This article uses information from [Using FasCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md#InstallPHP) by Ruslan Yakushev, published on December 5, 2007. - -## See also - -- [Enabling FastCGI on IIS 7](https://technet.microsoft.com/library/cc753077(WS.10).aspx) -- [Setting up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md) -- [Installing FastCGI Support On Server Core](install-php-and-fastcgi-support-on-server-core.md) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.jpg deleted file mode 100644 index d5cdc6612..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.png b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.png deleted file mode 100644 index 1633432a7..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.jpg deleted file mode 100644 index 10e0fee92..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.png b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.png deleted file mode 100644 index 716a86bf6..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image3.jpg deleted file mode 100644 index 10e0fee92..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above.md b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above.md deleted file mode 100644 index aaa8eeb6d..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above.md +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: "Enable Per-Site PHP Configuration on IIS 7 and IIS 6.0" -author: rick-anderson -description: "A common requirement when running PHP applications in shared hosting environment is per-site configuration, because each PHP application may require a differ..." -ms.date: 11/15/2009 -ms.assetid: 9b7f3737-817b-40b6-8fe8-b0e909d8ebc3 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above -msc.type: authoredcontent ---- -# Enable Per-Site PHP Configuration on IIS 7 and IIS 6.0 - -by Tali Smith - -A common requirement when running PHP applications in shared hosting environment is per-site configuration, because each PHP application may require a different set of PHP settings. Shared hosting providers often want to provide their customers with an option of controlling PHP configuration if necessary. - -With PHP 5.3 final release available, it is now simpler than before to implement per-site PHP configuration because PHP 5.3 has built-in support for per-directory INI settings and for user-defined INI files. - -This article describes per-site configuration for both PHP 5.2 and PHP 5.3. - -## Enable Per-Site PHP Configuration with PHP 5.2 on IIS 6.0 - -For example, suppose you have two Web sites in IIS 6.0, website1.com and website2.com, and you want each Web site to use its own php.ini file. Assume that php.ini for Website1.com is located in the `C:\Inetpub\website1.com` folder, and php.ini for Website2.com is located in `C:\Inetpub\website2.com` folder. - -1. Create script mappings and FastCGI configuration sections for each Web site. You can use the helper script fcgiconfig.js, located in the `%WINDIR%\system32\inetsrv\` folder. -2. Execute the following commands to create PHP script mappings for website1.com and website2.com. Make sure you replace `` with the correct path to PHP executable and `` with the correct site ID. - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample1.cmd)] -3. Open the fcgiext.ini file located in `%WINDIR%\system32\inetsrv`. It should contain the following sections: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample2.cmd)] - - The [PHP website1.com] and [PHP website2.com] sections can be used to specify some site specific FastCGI configuration settings, such as the path to php.ini file for each of the Web sites. When it begins, the PHP process determines the location of configuration php.ini file by using various settings, such as the PHPRC environment variable. (For a detailed description of the PHP startup process, see the [PHP documentation](https://www.php.net/manual/en/configuration.php).) If the PHP process finds a php.ini file in the path specified in the PHPRC environment variable, it will use it; otherwise, the PHP process will revert to default location of php.ini. -4. Configure FastCGI to set this PHPRC environment variable to point to site-specific php.ini file with the following commands: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample3.cmd)] -5. If you examine the fcgiext.ini file, you will see that the configuration sections have been updated: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample4.cmd)] -6. You can now verify that PHP loads its configuration from site specific location: - - - Copy php.ini into `C:\Inetpub\website1.com` - - Create a phpinfo.php file in `C:\Inetpub\website1.com` - - Place this code inside of phpinfo.php: <?php phpinfo(); ?> - - Open web browser and make a request to `http://website1.com/phpinfo.php`. The output of phpinfo.php file will show the location from where php.ini file was loaded: - ![Screenshot of a web browser displaying the output of the P H P info dot P H P file. The Loaded Configuration File is circled.](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image1.gif) - *Figure 1 website1* - -## Enable per-Site PHP Configuration with PHP 5.2 on IIS 7 and Above - -The section describes the recommended way of enabling per-site PHP configuration. - -### Create Per-site PHP Process Pools - -To enable per-site PHP configuration, you must associate a dedicated FastCGI process pool with each Web site. A FastCGI process pool is uniquely identified by the combination of fullPath and arguments attributes. So, if you need to create several FastCGI process pools for the same process executable, such as php-cgi.exe, you can use the arguments attribute to distinguish process pools definitions. In addition, with php-cgi.exe processes, you can use the command-line switch "-d" to define an INI entry for PHP process. You can use this switch to set a PHP setting that makes the arguments string unique. - -For example, suppose you have two Web sites ("website1" and "website2") that each need their own set of PHP settings. The FastCGI process pools can be defined as follows: - -[!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample5.xml)] - -The PHP setting **open\_basedir** is used here to distinguish between process pool definitions. In addition, it ensures that the PHP executable for each process pool can perform file operations only within the root folder of the corresponding Web site. - -PHP handler mapping for website1 is: - -[!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample6.xml)] - -PHP handler mapping for website2 is: - -[!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample7.xml)] - -## Specify PHP.INI Location - -When it begins, the PHP process determines the location of configuration php.ini file by using various settings, such as the PHPRC environment variable. (For a detailed description of the PHP startup process, see the [PHP documentation](http://www.php.net/manual/en/configuration.php).) If the PHP process finds a php.ini file in the path specified in the PHPRC environment variable, it will use it; otherwise, the PHP process will revert to default location of php.ini. The PHPRC environment variable can be used to allow hosting customers to use their own versions of php.ini files. - -If website1 and website2 are located at `C:\WebSites\website1` and `C:\WebSites\website2`, then the php-cgi.exe process pools in the `` section of applicationHost.config can be configured as follows: - -[!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample8.xml)] - -Now website1 has its own version of php.ini in `C:\WebSites\website1`, while website2 has its own version of php.ini in `C:\WebSites\website2`. This configuration also ensures that if there is no php.ini found in location specified by PHPRC environment variable, then PHP will fall back to using the default php.ini file located in the folder where php-cgi.exe is located. - -## Enable Per-Site PHP Configuration with PHP 5.3 on IIS 6.0 or IIS 7 and Above - -Now, suppose you want two versions of PHP 5.3 on the two Web sites, this time in IIS 7 and above. Suppose that the PHP application at website1.com does some heavy database activity and therefore requires longer script execution time, which in PHP is controlled by the max\_execution\_time setting. The PHP application at website2.com is a photo album where visitors may upload very large image files; it therefore requires a bigger maximum allowed file upload size, which is controlled by the php.ini setting upload\_max\_filesize. - -To enable this scenario on IIS, you first need to install PHP 5.3 and configure IIS to work with it. The easiest way to do this is to use the PHP installer, which is available at the [community PHP site](http://windows.php.net/download/). Make sure to use the installer for the VC9 non-thread-safe build of PHP 5.3, and choose the "IIS FastCGI" option during the installation. Alternatively, you can follow the instructions described in the article "[Using FastCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md)" and create the FastCGI handler/script mapping at the server level, so that the mapping applies to all Web sites on the server. - -There are now two options: - -1. Define the per-site PHP settings in the main php.ini file. -2. Let Web application owners define those settings in user-defined INI files. - -## Define in the Main PHP.INI File - -1. Open the main **php.ini** file (If you used the PHP installer, then this file will most probably be located at `C:\Program Files\PHP\` folder. If you installed from a compressed [ZIP] file archive, then the file will be at the same directory where the php-cgi.exe file is located). -2. Add the following at the end of the file: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample9.cmd)] -3. Save the php.ini file, and then recycle the application pools for these Web sites for the PHP.INI changes to take effect. -4. Use **phpinfo()** or **ini\_get("max\_execution\_time")** to check that the new settings have overwritten the default settings. Create a PHP file with the following text and save it in the Web root folder: - - [!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample10.xml)] -5. Open the PHP script on the Web site `http://localhost/phpinfo.php`. - - ![Screenshot of a browser window displaying the P H P info page. The max execution time field and value are circled.](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image3.gif) - *Figure 2: phpinfo() page* - - This output shows that the local value of the max\_execution\_time setting (in the second column) is 300, while the master value, or default, is 30. - -## Enable the User-Defined INI files - -If you want to allow Web application owners to control PHP settings themselves, you can enable a user-defined PHP configuration. - -1. Add the following setting, which specifies the name to be used for user-specific INI files, to the main **php.ini** file. Setting this to an empty value disables the user-defined PHP configuration. - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample11.cmd)] -2. Create a file called **.user.ini** in `C:\inetpub\website1.com\` folder, and add the following: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample12.cmd)] -3. Add the following to the file **.user.ini** in `C:\inetpub\website2.com\` folder: - - [!code-console[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample13.cmd)] - - Note that if your main php.ini file has [PATH] sections that point to the root folders of these sites, then you need to remove those sections; if you do not remove those sections, the user-defined settings will not take effect. -4. Use **phpinfo()** or **ini\_get("max\_execution\_time")** to check that the new settings have overwritten the default settings. Create a PHP file with the following text and save it in the Web root folder: - - [!code-xml[Main](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample14.xml)] -5. Open the PHP script on the Web site `http://localhost/phpinfo.php`. - - ![Screenshot of a browser window displaying the P H P info page. The upload max file size field and value are circled.](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image5.gif) - *Figure 3: phpinfo() page* - - Note also that when you enable the user-defined INI files, the settings in those files are cached by the PHP engine to avoid re-reading those files for every request. This means that if the user makes a change to .user.ini file, then that change may not take effect right away. Instead it may take effect after the cache time to live (TTL) has expired. The cache TTL value is controlled by the php.ini setting user\_ini.cache\_ttl, which is set to 300 seconds (5 minutes) by default. - - - -> [!NOTE] -> *This article combines information from [Per-site PHP configuration with PHP 5.3 and IIS](https://blogs.iis.net/ruslany/archive/2009/07/11/per-site-php-configuration-with-php-5-3-and-iis.aspx) published on July 11, 2009, [Per-site PHP configuration with IIS FastCGI](http://ruslany.net/2008/07/per-site-php-configuration-with-iis-fastcgi/) published on July 12, 2008, and [Using FastCGI to Host PHP Applications on IIS 7.0](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md#PHP_Versioning) published on June 26, 2009, all by Ruslan Yakushev.* - -## See also - -- [IIS 7 FastCGI Module Forum](https://forums.iis.net/1104.aspx) -- [PHP Community Forum](https://forums.iis.net/1102.aspx) -- [IIS Administration Pack](https://www.iis.net/downloads/microsoft/administration-pack) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image1.gif b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image1.gif deleted file mode 100644 index ece892f12..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image3.gif b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image3.gif deleted file mode 100644 index b56ecea82..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image3.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image5.gif b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image5.gif deleted file mode 100644 index 2e9187e2f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/_static/image5.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample1.cmd deleted file mode 100644 index bbcc5d93f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -cscript fcgiconfig.js -add -section:"PHP website1.com" -extension:php -path: -site: cscript fcgiconfig.js -add -section:"PHP website2.com" -extension:php -path: -site: \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample10.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample10.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample10.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample11.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample11.cmd deleted file mode 100644 index f04a13734..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample11.cmd +++ /dev/null @@ -1 +0,0 @@ -user_ini.filename = .user.ini \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample12.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample12.cmd deleted file mode 100644 index faa46fdf7..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample12.cmd +++ /dev/null @@ -1 +0,0 @@ -max_execution_time = 300 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample13.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample13.cmd deleted file mode 100644 index 9cadac852..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample13.cmd +++ /dev/null @@ -1 +0,0 @@ -upload_max_filesize = 12M \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample14.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample14.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample14.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample2.cmd deleted file mode 100644 index 88e229001..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample2.cmd +++ /dev/null @@ -1,9 +0,0 @@ -[Types] -php:169297538=PHP website1.com ; The actual site id will be different for your site -php:273357939=PHP website2.com ; The actual site id will be different for your site - -[PHP website1.com] -ExePath=C:\php523nts\php-cgi.exe - -[PHP website2.com] -ExePath=C:\php523nts\php-cgi.exe \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample3.cmd deleted file mode 100644 index 8edfe7470..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -cscript fcgiconfig.js -set -section:"PHP website1.com" -EnvironmentVars:PHPRC:C:\Inetpub\website1.com cscript fcgiconfig.js -set -section:"PHP website2.com" -EnvironmentVars:PHPRC:C:\Inetpub\website1.com \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample4.cmd deleted file mode 100644 index 1c306e12f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample4.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[PHP website1.com] -ExePath=C:\php523nts\php-cgi.exe -EnvironmentVars=PHPRC:C:\Inetpub\website1.com - -[PHP website2.com] -ExePath=C:\php523nts\php-cgi.exe -EnvironmentVars=PHPRC:C:\Inetpub\website2.com \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample5.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample5.xml deleted file mode 100644 index 786eb51dd..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample5.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample6.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample6.xml deleted file mode 100644 index e3cc69f56..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample6.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample7.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample7.xml deleted file mode 100644 index 6e43abf97..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample7.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample8.xml b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample8.xml deleted file mode 100644 index d80802e85..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample8.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample9.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample9.cmd deleted file mode 100644 index 469b0c07e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above/samples/sample9.cmd +++ /dev/null @@ -1,6 +0,0 @@ -[PATH=C:/inetpub/website1.com/] -max_execution_time = 300 - -[PATH=C:/inetpub/website2.com/] - -upload_max_filesize = 12M \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions.md b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions.md deleted file mode 100644 index 2bdd7517f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions.md +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: "Enable PHP Applications to Make Application-Level Access Control Decisions" -author: rick-anderson -description: "You can expose key access control information to a PHP application to facilitate application-level access control, if desired. The Microsoft ® .NET extensibi..." -ms.date: 11/15/2009 -ms.assetid: 56ad831c-305b-46fb-aa92-71784fa1bd3a -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions -msc.type: authoredcontent ---- -# Enable PHP Applications to Make Application-Level Access Control Decisions - -by Tali Smith - -## Introduction - -You can expose key access control information to a PHP application to facilitate application-level access control, if desired. The Microsoft® .NET extensibility in Internet Information Services 7 (IIS 7) and above makes it very easy to add custom authentication or authorization features or to complement existing access control features with custom functionality. - -For example, you can: - -- Use Membership and Roles APIs to manage the use and role stores in a consistent way, regardless of the underlying provider storage. -- Provide custom credential store support for Forms Authentication by writing a custom Membership provider. -- Provide custom role store support for Role Manager by writing a custom Role provider. - -PHP can integrate with the IIS security model by executing PHP scripts while impersonating the authenticated user provided by IIS, but the authenticated user must be a Windows® user and the access control lists (ACLs) for the PHP application content must grant access for each impersonated user. The ACLs must be managed throughout the lifetime of the application and, in many cases, managed when moving the application between servers. - -With IIS and FastCGI, PHP can use an execution model that simplifies security management. The PHP scripts can be executed using the identity of the application pool to which the application belongs. This model has the following advantages: - -- The content can grant access for a single identity, the identity of the application pool. Alternatively, if you do not want application pool isolation, you can give access to the IIS\_IUSRS group, which allows all IIS application pools on any IIS machine to have access. This significantly simplifies deployment and ongoing management of the application. -- All access security can be managed at the application level using application authorization features; it can be applied uniformly to parts of the application that do not correspond to physical resources and therefore cannot have ACL-based permissions. -- No impersonation needs to take place, which may improve performance. - -Note that this security model may not be appropriate if: - -- You isolate multiple applications from each other within a single application pool, by impersonating a specific user for each. -- You secure application content by using ACLs for each user and impersonating that user to access application content. Or, you use application features or libraries that use the impersonated user to authenticate their actions. -- The application content is on a Universal Naming Convention (UNC) share, and is configured with fixed credentials for the application's virtual directories. - -IIS access control features help create flexible and manageable access control solutions for PHP applications and the PHP-specific integration that can enable PHP applications to make application-level access control decisions. - -## Configure Basic Authentication - -1. Start **IIS Manager** (Inetmgr.exe). -2. Expand the server node, and then expand the **Sites** node. -3. In the tree view on the left, click on the Web site that hosts the application you want to secure. -4. Under the **IIS** feature group, double-click **Authentication**. Here you can see the available authentication methods, which correspond to the installed authentication modules. By default, Anonymous Authentication is enabled -5. Right-click **Anonymous Authentication**, and then click **Disable**. -6. Right-click **Basic Authentication**, and then click **Enable**. - - [![Screenshot of the I I S Manager Authentication page. In the server node, Sites is expanded. In the Authentication pane under Name, Basic Authentication is selected.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image2.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image1.jpg) - - *Figure 1: Authentication page* -7. In the tree view on the left, click the same Web site that you clicked in Step 3. -8. In the **Actions** pane, click **Restart**. -9. Close IIS Manager. Note that only the built-in authentication schemes are visible in the Authentication feature. Third-party custom authentication schemes need to be configured separately, but the Authentication feature may still be used to disable the built-in authentication methods. - -## Configure Forms Authentication - -Basic authentication can be an insecure way of providing authentication over the Internet, because the browser sends the password in clear text. To prevent password disclosure, you should only use basic authentication over Secure Sockets Layer (SSL) connections. Basic authentication requires that the user log in with a local Windows account or a domain account stored in Windows Active Directory®. Because of this, users authenticated with basic authentication can be impersonated if desired. - -Forms Authentication is a Microsoft® ASP.NET authentication feature that can be used for any application content on IIS by taking advantage of the ASP.NET Integrated mode engine. Before using Forms Authentication, be sure that ASP.NET is installed on the server and the PHP application is using an application pool configured to run in Integrated mode (default). For many Internet sites, the ASP.NET Forms Authentication may be a better option, for the following reasons: - -- It allows the application to provide the login experience as a seamless part of the application. -- It supports arbitrary credential stores, including built-in support for Microsoft® SQL Server® databases and Windows accounts. Numerous open-source credential store providers are available, or custom ones can be provided by the application. -- It provides enhanced functionality for secure authentication ticket management. - -To configure Forms Authentication: - -1. Start **IIS Manager** (Inetmgr.exe). -2. Expand the server node, and then expand the **Sites** node. -3. In the tree view on the left, click on the Web site that hosts the application you want to secure. -4. Under the **IIS** feature group, double-click **Authentication**. -5. Right-click **Forms Authentication**, and then click **Enable**. -6. Right-click **Anonymous Authentication**, and then click **Enable**. -7. Disable all other authentication methods. Anonymous authentication is required for Forms Authentication to authenticate users requesting the login page. - - [![Screenshot of the I I S Manager. The Sites node is expanded and Access Controls Lab is selected. In the Authentication pane, Forms Authentication is selected.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image4.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image3.jpg) - - *Figure 2: Forms Authentication and Anonymous Authentication enabled* -8. In the tree view on the left, click on the Web site that hosts the application you want to secure. -9. Under the **IIS** feature group, double-click **Modules**. -10. Double-click the **FormsAuthentication** module, and then clear the **Invoke only for requests to ASP.NET applications or managed handlers** check box. - - [![Screenshot of the Edit Managed Module dialog box. In the Name box, Forms Authentication is written. In the Type box, System dot Web dot Security dot Forms Authentication Module is written.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image6.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image5.jpg) - - *Figure 3: Enabling Forms Authentication for all requests* -11. Click **OK**. This allows the Forms Authentication module to provide authentication services for all requests, regardless of the application content being requested. This enables your PHP application to take advantage of Forms Authentication. - -You can edit a number of configuration options that control the behavior of the Forms Authentication module (see docs at [https://msdn.microsoft.com/library/1d3t3c61.aspx](https://msdn.microsoft.com/library/1d3t3c61.aspx)): - -- The default login page URL. -- The timeout and automatic renewal time period for the authentication ticket. -- Whether to use cookieless (URL-based) or cookie-based authentication tickets, or auto-detect cookie support. -- Whether Forms Authentication requires SSL (recommended). -- The encryption levels of the authentication ticket. - -You can also configure the credential store for use with Forms Authentication by selecting the appropriate Membership provider. By default, you can use either the SQL Server-based Membership provider (configured to use the local SQL Server Express instance by default), or the Active Directory membership provider (configured to use the local Windows account store by default). However, you can also download and use third-party membership providers, or develop your own membership provider to work with your application's existing credential store. - -## Configure Authorization - -IIS URL Authorization is a new authorization mechanism that enables the application to create declarative authorization rules within the application itself. These rules can grant or deny access to parts of the application based on the authenticated user and the user's role memberships. The IIS URL Authorization feature is a separate feature from the ASP.NET URL Authorization feature. It is similar in functionality but supports a slightly different configuration syntax and is available even if ASP.NET is not installed. Either feature can be used to provide configuration-based user and role authorization for PHP applications. - -### Configure URL Authorization - -1. Start **IIS Manager** (Inetmgr.exe). -2. Expand the server node, and then expand the **Sites** node. -3. In the tree view on the left, click on the click on the Web site that hosts the application you want to secure. -4. Double-click **Authorization Rules**. -5. Click **Add Deny Rule**, and then select **All anonymous users**. - - [![Screenshot of the Add Deny Authentication Rule Dialog box. All Anonymous users is selected.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image8.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image7.jpg) - - *Figure 4: Add an authorization rule to deny anonymous users* -6. Click **OK**. -7. In the tree view on the left, click the click on the Web site that hosts the application you want to secure name. -8. In the **Actions** pane, click **Restart**. -9. Close IIS Manager. This denies access to the application for anonymous users. This causes requests to the application to be rejected, and it allows Forms Authentication to redirect users to the login page so that they may log in. - -### Configure Role-Based Authorization - -URL Authorization allows you to create Allow or Deny rules that apply to: - -- Anonymous users. -- A specific user. -- A user in one or more roles. - -Role-based rules can be a great way to manage permissions for a large group of users. - -When using roles, the role membership information is provided by the Roles module. The Roles module uses a provider model for obtaining roles for a particular user, similar to the Membership provider model. - -1. Start **IIS Manager** (Inetmgr.exe). -2. Expand the server node, and then expand the **Sites** node. -3. In the tree view on the left, click the click on the Web site that hosts the application you want to secure. -4. Under **ASP.NET**, double-click **.NET Roles**. -5. In the **Actions** pane, click **Enable**. - - [![Screenshot of the I I S Manager dot NET Roles pane. The Sites node is expanded. Access Controls Lab is selected.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image10.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image9.jpg) - - *Figure 5: Enable .NET roles* -6. In the **Actions** pane, click **Add**. -7. In the **Name** box, type **Admin** - - [![Screenshot of the dot Net Roles pane. The Add dot NET Role dialog box is shown. In the Name box Admin is written.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image12.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image11.jpg) - - *Figure 6: Add a .NET role* -8. Click **OK**. -9. In the tree view on the left, click the click on the Web site that hosts the application you want to secure. -10. Under **ASP.NET**, double-click **.NET Users**. -11. In the **Actions** pane, click **Add**. -12. Type the *user credentials*, and then click **Next**. -13. Select the **Admin** role check box to add the new user to that role. -14. Click **Finish**. -15. In the tree view on the left, click the Web click on the Web site that hosts the application you want to secure, used in step 9. -16. Under the **IIS** feature group, double-click **Modules**. -17. Double-click the **RoleManager** module, clear the **Invoke only for requests to ASP.NET applications or managed handlers** check box, and then click **OK**. -18. Double-click the **DefaultAuthentication** module, clear the **Invoke only for requests to ASP.NET applications or managed handlers** check box, and then click **OK**. -19. In the tree view on the left, click the **Admin** sub-directory under the click on the Web site that hosts the application you want to secure, used in steps 9 and 15. -20. Double-click **Authorization Rules**. -21. Remove all existing rules by clicking each rule and then clicking **Remove**. -22. In the **Confirm Remove** dialog box, click **Yes**. -23. Click **Add Allow Rule**, and then select **Specified roles or user groups**. -24. Type **admin** in the associated textbox, and then click **OK**. - - [![Screenshot of the Authorization Rules pane in I I S Manager. The Access Controls Lab node is expanded and admin is selected. In the Module and Roles columns Allow and Admin are highlighted.](enable-php-applications-to-make-application-level-access-control-decisions/_static/image14.jpg)](enable-php-applications-to-make-application-level-access-control-decisions/_static/image13.jpg) - - *Figure 7: Add allow rule for administrator role* -25. Close IIS Manager. - -## Integrating PHP with IIS 7.0 and Above - -IIS 7 and above provides rich authentication and authorization options that a PHP application can use directly, without needing to provide any custom code. However, there are times when the application needs to perform further authorization at a more granular level than a resource. Or, other times, the application may want to customize the behavior or rendering of the page based on the identity of the user. IIS makes this possible by providing the authenticated user identity information to the PHP page through server variables. - -You can use the following server variables to inspect the authenticated user and/or make decisions about the authenticated identity: - -- LOGON\_USER – the authenticated user's name. Empty if the authenticated user is anonymous. -- AUTH\_TYPE – the authentication scheme that was used to authenticate the user. - -## Links for Further Information - -- [PHP on Windows Training Kit](https://www.microsoft.com/downloads/details.aspx?FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb&DisplayLang=en) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image1.jpg deleted file mode 100644 index 514843468..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image10.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image10.jpg deleted file mode 100644 index bed06ca20..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image11.jpg deleted file mode 100644 index 3f3cf88e5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image12.jpg deleted file mode 100644 index 3f3cf88e5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image13.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image13.jpg deleted file mode 100644 index d26faa1be..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image14.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image14.jpg deleted file mode 100644 index d26faa1be..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image2.jpg deleted file mode 100644 index 514843468..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image3.jpg deleted file mode 100644 index 20374ce32..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image4.jpg deleted file mode 100644 index 20374ce32..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image5.jpg deleted file mode 100644 index e755d9ceb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image6.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image6.jpg deleted file mode 100644 index e755d9ceb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image7.jpg deleted file mode 100644 index 350c84029..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image8.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image8.jpg deleted file mode 100644 index 350c84029..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image9.jpg deleted file mode 100644 index bed06ca20..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/enable-php-applications-to-make-application-level-access-control-decisions/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-configure-and-optimize-the-microsoft-web-platform-for-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/how-to-configure-and-optimize-the-microsoft-web-platform-for-php.md deleted file mode 100644 index 4e1b2d7bd..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-configure-and-optimize-the-microsoft-web-platform-for-php.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "How to Configure and Optimize the Microsoft Web Platform for PHP" -author: rick-anderson -description: "There are various steps you can take to optimize Windows Server ® 2008 R2 or Windows Server ® 2008, Internet Information Services 7 (IIS 7) and above, and Fa..." -ms.date: 11/15/2009 -ms.assetid: d9fd6965-0705-4b33-98cb-49e8b691a9f0 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/how-to-configure-and-optimize-the-microsoft-web-platform-for-php -msc.type: authoredcontent ---- -# How to Configure and Optimize the Microsoft Web Platform for PHP - -by Tali Smith - -There are various steps you can take to optimize Windows Server® 2008 R2 or Windows Server® 2008, Internet Information Services 7 (IIS 7) and above, and FastCGI performance for your Web workloads and PHP applications. These include: - -- [Use the Windows Cache Extension](use-the-windows-cache-extension-for-php.md). The Windows Cache Extension for PHP is a PHP accelerator that is used to significantly increase the speed of PHP applications running on the Windows® operating system. PHP applications can take advantage of the functionality provided by the Windows Cache Extension for PHP without code modifications. -- [Configure IIS 7 and Above Output Caching](../../manage/managing-performance-settings/configure-iis-7-output-caching.md). This feature can cache dynamic PHP content in memory so that the script used to generate the dynamic output does not need to run for each request.See also [Walkthrough: IIS 7.0 and Above Output Caching](../../manage/managing-performance-settings/walkthrough-iis-output-caching.md) and [Videocast: Improving Performance with Native Output Caching](../../manage/managing-performance-settings/improving-performance-with-native-output-caching.md). -- [Configure PHP Recycling Behavior](../running-php-applications-on-iis/configure-php-process-recycling-behavior.md). Make sure FastCGI always recycles the Php-cgi.exe processes before the native PHP recycling starts. -- [Enable Per-Site PHP Configuration for PHP on IIS 6.0 and IIS 7 and Above](enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above.md). This feature is particularly important in a shared hosting environment, letting customers control PHP configuration. -- [Configure SMTP E-Mail in IIS 7 and Above](configure-smtp-e-mail-in-iis-7-and-above.md). Configure Simple Mail Transfer Protocol (SMTP) e-mail in IIS when you want to deliver e-mail messages from your site. Mail can be delivered immediately or it can be delivered to a file location on disk where it can be retrieved for delivery later. -- [Create a Separate Site or Virtual Directory for PHP Content](create-a-separate-site-or-virtual-directory-for-php-content.md). Self-hosters or very small hosters may need create a separate site or virtual directory to host their PHP content on a system that is also used for other workloads. - -[Best Practices for PHP on the Microsoft Web Platform](../running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md) provides a summary of additional steps you can take. diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-install-the-microsoft-web-platform-for-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/how-to-install-the-microsoft-web-platform-for-php.md deleted file mode 100644 index d7125f5d6..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-install-the-microsoft-web-platform-for-php.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: "How to Install the Microsoft Web Platform for PHP" -author: rick-anderson -description: "Introduction Microsoft embraces hosting PHP applications on the Windows ® operating system, both by building enabling technologies and by working with the PH..." -ms.date: 11/15/2009 -ms.assetid: 3deeba26-60a8-4277-a489-4acd5ae6486c -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/how-to-install-the-microsoft-web-platform-for-php -msc.type: authoredcontent ---- -# How to Install the Microsoft Web Platform for PHP - -by Tali Smith - -## Introduction - -Microsoft embraces hosting PHP applications on the Windows® operating system, both by building enabling technologies and by working with the PHP community to ensure that popular PHP applications run performantly on the Windows operating system. Customers appreciate the convenience and familiarity of the Windows operating system to run PHP applications. The capabilities built into Windows Server® 2008, such as Internet Information Services 7 (IIS 7) and above and FastCGI, make seamless operation of PHP applications possible. With the advent of the SQL Server Connector for PHP, users can add Microsoft® SQL Server® 2008 to the stack if they desire, providing a top-to-bottom solution for PHP applications based on Microsoft® technology. - -The Microsoft® Web Platform provides advantages for PHP hosters, Web farm managers, self-hosters, server administrators, PHP application developers, and many others. PHP hosters can refer to the [Shared Hosting Guidance Content Map](../../web-hosting/getting-started/shared-hosting-content-map.md) for a wealth of articles and videos, including [Shared Hoster Configuration](../../web-hosting/planning-the-web-hosting-architecture/shared-hosting-configuration.md) and [Configuring a Web Farm Using IIS Shared Configuration](../../manage/managing-your-configuration-settings/configuring-a-web-farm-using-iis-shared-configuration.md). - -To host PHP applications on the Microsoft® Web Platform, you must first set up the platform component. - -## Install the Operating System - -At the base of the Microsoft Web Platform is Windows Server 2008, Windows Server® 2008 R2, or another Windows Server® operating system version. - -- [Install Windows Server 2008 and Windows Server 2008 R2](../../install/installing-iis-7/install-windows-server-2008-and-windows-server-2008-r2.md) - -## Use Microsoft Web PI to Install the Microsoft Web Platform - -The easiest way to install the rest of the Microsoft Web Platform is by using the Microsoft® Web Platform Installer (Web PI), a free tool that makes it easy to get the latest components of the Microsoft Web Platform, including Internet Information Services (IIS), Microsoft® SQL Server® Express, the Microsoft® .NET Framework, and Microsoft® Visual Web Developer. Web PI also makes it easy to install and run the most popular free Web applications for blogging, content management, and more with the built-in [Windows Web Application Gallery](https://www.microsoft.com/web/gallery/ "Windows Web Application Gallery"). - -- [Use the Microsoft Web Platform Installer](../../install/web-platform-installer/using-the-microsoft-web-platform-installer.md). - -## Install the Microsoft Web Platform Manually - -It is also possible to install IIS, PHP, and a database manually. - -1. **Install and configure IIS.** IIS is the Web server role in the Windows Server operating systems. The following articles provide guidance in installing IIS: - - - [Install IIS 7 and Above on Windows Server 2008 or Windows Server 2008 R2](../../install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2.md). - - [Install IIS 7 and Above on Windows Vista® and Windows® 7](../../install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7.md). - - [Install and Configure IIS 7 and Above on Server Core](../../install/installing-iis-7/install-and-configure-iis-on-server-core.md). -2. **Install and configure PHP.** - - The following articles provide guidance on installing PHP: - - - [Install and Configure PHP](install-and-configure-php.md). - - [Install PHP and FastCGI Support on Server Core](install-php-and-fastcgi-support-on-server-core.md). -3. **Enable FastCGI support.** FastCGI is an open protocol supported by many open-source application frameworks that otherwise may not support stable and high-performance native integration with IIS. The following articles provide guidance in enabling FastCGI: - - - [Enable FastCGI Support in IIS 7 and Above on Windows Server 2008, Windows Server 2008 R2. Windows Vista, or Windows 7](enable-fastcgi-support-in-iis-7-on-windows-server-2008-windows-server-2008-r2-windows-vista-or-windows-7.md). - - [Install PHP and FastCGI Support on Server Core](install-php-and-fastcgi-support-on-server-core.md). - - [Configure the FastCGI Extension for IIS 6.0](configuring-the-fastcgi-extension-for-iis-60.md). - - [Videocast: Set Up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md). -4. **Install a database.** You can use either MySQL or SQL Server in the Microsoft Web Platform. - - - [Install and Configure MySQL for PHP Applications on IIS 7 and Above](install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md). - - [Install and Configure SQL Server for PHP Applications on IIS 7 and Above](install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above.md). - -You are now ready to configure and optimize the Microsoft Web Platform. diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-manage-and-administer-the-microsoft-web-platform.md b/iis/application-frameworks/install-and-configure-php-on-iis/how-to-manage-and-administer-the-microsoft-web-platform.md deleted file mode 100644 index ee34cb446..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-manage-and-administer-the-microsoft-web-platform.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "How to Manage and Administer the Microsoft Web Platform" -author: rick-anderson -description: "The following articles provide guidance in managing and administering the Microsoft® Web Platform. Create a Web Site. This article provides guidance for cre..." -ms.date: 11/15/2009 -ms.assetid: 0de263a3-9995-4937-aeaa-141b0692c914 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/how-to-manage-and-administer-the-microsoft-web-platform -msc.type: authoredcontent ---- -# How to Manage and Administer the Microsoft Web Platform - -by Tali Smith - -The following articles provide guidance in managing and administering the Microsoft® Web Platform. - -- [Create a Web Site](../../get-started/getting-started-with-iis/create-a-web-site.md). This article provides guidance for creating Web sites. -- [Select a Provisioning Option](../../manage/creating-websites/select-a-provisioning-option.md). This article provides guidance for provisioning Web sites for both IT administrators and the software developers. -- [Improve Error Messages in PHP](improve-php-error-messages-in-iis-7-and-above.md). This article describes how you can use Internet Information Services (IIS) for more descriptive error messages. -- [Use the Application Warm-Up Module](../../manage/index.md). This article describes how you can improve the responsiveness of your Web sites by proactively loading and initializing all the dependencies. -- [Run Multiple Versions of PHP on IIS](run-multiple-versions-of-php-on-iis.md). This article describes how you can run multiple versions of PHP side by side, which can be very useful in certain scenarios. -- [Use Bit Rate Throttling](../../manage/managing-performance-settings/use-bit-rate-throttling.md). This extension provides lets you throttle progressive downloads of media files based on the content bit rate. For sites that deliver audio and video files that may not be watched in their entirety, this extension can significantly reduce your media-related bandwidth costs. -- [Troubleshoot with Failed Request Tracing](../../troubleshoot/using-failed-request-tracing/troubleshoot-with-failed-request-tracing.md). Failed Request Tracing lets you create failure definitions that automatically capture detailed execution traces of certain requests. See also [Troubleshooting Failed Requests Using Tracing in IIS 7.0 and Above](../../troubleshoot/using-failed-request-tracing/troubleshooting-failed-requests-using-tracing-in-iis.md) and [Using Failed Request Tracing to Trace Rewrite Rules](../../extensions/url-rewrite-module/using-failed-request-tracing-to-trace-rewrite-rules.md). - -The Web Deployment Tool (WDT) and the Database Manager are particularly helpful in managing and administering the Microsoft Web Platform. - -- [Use the Web Deployment Tool](../../publish/using-web-deploy/use-the-web-deployment-tool.md). The WDT simplifies the migration, management, and deployment of Internet Information Services (IIS) Web servers, Web applications, and Web sites. See [Web Deployment Tool](../../publish/deploying-application-packages/index.md) for detailed infrmation on all aspects of the WDT. -- [Use the Database Manager](../../extensions/database-manager/use-the-database-manager.md). Database Manager is a new IIS module specifically designed for the management of databases located in hosting environments. See [Using the IIS Database Manager](../../extensions/database-manager/index.md) for detailed information. diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-secure-the-microsoft-web-platform.md b/iis/application-frameworks/install-and-configure-php-on-iis/how-to-secure-the-microsoft-web-platform.md deleted file mode 100644 index 067cfea09..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/how-to-secure-the-microsoft-web-platform.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: How to Secure the Microsoft Web Platform -author: rick-anderson -description: Describes how to secure the Microsoft Web Platform and links to other articles that provide full guidance. -ms.date: 11/15/2009 -ms.assetid: d4dd559d-5b26-4da8-a639-184b8742b2d2 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/how-to-secure-the-microsoft-web-platform -msc.type: authoredcontent ---- -# How to Secure the Microsoft Web Platform - -by Tali Smith - -Security is always a consideration; it is critical to make careful security considerations when you implement and maintain your Web sites, infrastructure, and applications. Internet Information Services 7 (IIS 7) and above offers many ways to [configure security](../../manage/configuring-security/index.md), including [dynamic IP restrictions](../../manage/configuring-security/using-dynamic-ip-restrictions.md), [application pool identities](../../manage/configuring-security/application-pool-identities.md), and [Secure Sockets Layer (SSL)](../../manage/configuring-security/how-to-set-up-ssl-on-iis.md). IIS also provides a comprehensive set of authentication and authorization features that can be used to create the desired access control scheme for PHP applications without writing any custom code. You can use features such as Forms Authentication, Role Manager, and URL Authorization to quickly deploy access control solutions that are easily manageable through IIS Manager and other tools. - -The following articles provide guidance: - -- [Secure Your Infrastructure and Applications](secure-your-infrastructure-and-php-applications.md). This article provides an overview of techniques to secure PHP on IIS. -- [Secure Content in IIS Through File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md). This article, provides guidance for using access control lists (ACLs) to secure content. -- [Secure Content in IIS Through Impersonation](secure-content-in-iis-through-impersonation.md). This article describes how to use impersonation to help secure content. -- [Set ACLs Through the Manifest.xml File](../../get-started/planning-for-security/set-acls-through-the-manifestxml-file.md). While hosters typically use the command line to set ACLs, it is also possible to use the Manifest.xml file. -- [Secure Your SQL Server Database](secure-your-sql-server-database.md). If you use Microsoft® SQL Server® as your database, you must create and implement an effective security plan. This article touches on a few areas of particular interest to Web hosters. -- [Ensure Security Isolation for Web Sites](../../manage/configuring-security/ensure-security-isolation-for-web-sites.md). The recommendation for isolating PHP Web sites in a shared hosting environment is consistent with all general security isolation recommendations for IIS. Isolating Web sites is particularly important in a shared hosting environment. -- [Use Request Filtering](../../manage/configuring-security/use-request-filtering.md). Request filtering is designed and optimized for security scenarios. -- [Secure PHP with Configuration Settings](secure-php-with-configuration-settings.md). You can configure PHP settings to tighten the security of a PHP installation; this article recommends settings you can use. -- [Enable PHP Applications to Make Application-Level Access Control Decisions](enable-php-applications-to-make-application-level-access-control-decisions.md). You can expose key access control information to a PHP application to facilitate application-level access control. diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above.md b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above.md deleted file mode 100644 index 880dcbc5e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: "Improve PHP Error Messages in IIS 7" -author: rick-anderson -description: "PHP errors often do not provide sufficient detail to help diagnose errors that occur within the framework. These include basic errors such as 404 Not Found...." -ms.date: 11/15/2009 -ms.assetid: 81876084-11f4-4d05-b394-ab9df10064e6 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above -msc.type: authoredcontent ---- -# Improve PHP Error Messages in IIS 7 - -by Tali Smith - -PHP errors often do not provide sufficient detail to help diagnose errors that occur within the framework. These include basic errors such as 404 Not Found. Because of this, the default "detailed error" experience for PHP applications may be ineffective for troubleshooting basic errors. - -Internet Information Services (IIS) improves PHP error handling by intercepting common error conditions and providing redirection for common HTTP status codes. - -By default, IIS is configured to return detailed error messages to local clients and to return generic error messages to remote clients. This is done to allow effective troubleshooting locally, while protecting production applications from disclosing sensitive details to remote clients when errors occur. - -IIS generates very detailed error messages for most errors. These contain, at minimum, information about the request and the error, including which module generated the error and during which part of the request processing. For errors caused by IIS and its built-in modules, the errors also contain likely resolutions. This dramatically simplifies the troubleshooting process for most errors. - -This article, based on the hands-on labs in the [PHP on Windows Training Kit](https://www.microsoft.com/downloads/details.aspx?FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb&DisplayLang=en), describes how IIS takes care of basic errors handling and how IIS diagnoses application-level errors by enabling PHP error messages. - -## Basic Error Handling - -IIS improves PHP error handling by intercepting common error conditions and providing redirection for common HTTP status codes. - -Note that IIS also support error messages generated by application frameworks, which often offer application-specific information to help diagnose application errors. For example, Microsoft® ASP.NET takes advantage of this to provide detailed exception stack traces and other information. - -If you request the page `http://localhost:84/notfound.php` from Windows® Internet Explorer®, you get a default "Not Found" error—a non-descriptive 404 error page. - -![Screenshot of a browser window with a non-descriptive 404 error message displayed.](improve-php-error-messages-in-iis-7-and-above/_static/image1.jpg) -*Figure 1: A non-descriptive 404 error message* - -The default IIS "Not Found" error message provides useful information to help diagnose the error condition; it correctly identifies the error and suggests solutions for most common error conditions by providing information such as the source (module, notification) of the error and background information such as the URL, mapped physical path, and the authentication method being used. For example: - -- Response information: HTTP 404 Not Found. -- Detailed error information: The module (IIS Web Core), the Notification (MapRequestHandler), the handler (StaticFileHandler), and the error code (0x80070002 – File Not Found). -- Request information: The requested URL and the physical path `C:\inetpub\troubleshootingPhp\notfound.txt`. -- The "Most likely causes" section correctly suggests the most likely error cause to be: "The directory or file specified does not exist on the Web server". -- The "Things you can try" section suggests the corresponding solution: "Create the content on the Web server". - -![Screenshot of a browser window displaying a detailed 404 error message.](improve-php-error-messages-in-iis-7-and-above/_static/image3.jpg) -*Figure 2: Detailed 404 error message* - -You can also get IIS detailed errors for some PHP errors by configuring IIS to perform some additional validation of PHP requests. - -To configure IIS to provide additional validation of PHP requests, use the following steps: - -1. Switch to the **IIS Manager**. If it is closed, click **Start**,and then select **Internet Information Services (IIS) Manager**. -2. In the tree view on the left, click the server node. -3. Under **IIS**, double-click **Handler Mappings** to edit the PHP handler mapping. -4. Right-click the **PHP via FastCGI** entry, and then click **Edit**. -5. Click **Request Restrictions**. -6. Select the **Invoke handler only if request is mapped to** check box. -7. Leave the **File** option button selected. -8. Click **OK** twice. -9. Click **Yes** in the **Edit Module Mapping** dialog box. -10. To test, trigger a "Not Found" condition again to verify that the PHP 404 error is now handled by IIS, providing more detail. Using **Internet Explorer**, request `http://localhost:84/notfound.php` (this page does not exist). -11. You receive an IIS detailed error indicating that the Notfound.php page was not found on the server. - - An IIS 401.3 Unauthorized detailed error also provides information; it indicates that the request does not have the permission to view the page due to access control list (ACL) configuration and provides an extensive explanation of how to resolve this issue. - - ![Screenshot of a browswer window with an unauthorized detailed error displayed.](improve-php-error-messages-in-iis-7-and-above/_static/image5.jpg) - *Figure 3: An Access Denied error* - -## Enable PHP Error Messages to Diagnose Application-Level Errors - -Configuring IIS to validate requests causes IIS to attempt to open the PHP script file corresponding to the request URL and generates detailed error messages for any conditions that preclude this. This typically includes: - -- File not found -- Access denied due to incorrect permissions -- Access denied due to insufficient authentication -- For most other error conditions, especially those that occur at the application level, IIS detailed error messages do not contain sufficient information to help diagnose the error effectively. - -The biggest examples of such errors are script parsing and script interpretation errors. While you can force IIS detailed error messages for these errors, this typically does not provide any value in diagnosing the root cause of the error. In these cases, you must rely on the information provided by PHP to diagnose these errors. - -By default, PHP is not configured to display these errors to the response to prevent disclosure of sensitive information. - -Notethat for local debugging, you can enable PHP error display to diagnose PHP errors while debugging. Consider disabling PHP error display for production applications. - -If you request a page with a script error, you receive the IIS detailed error message. This happens because by default PHP does not generate a response with the error details, so IIS inserts its generic "500 Server Error" detailed error. While this error correctly suggests that PHP has returned a 500 error code, it does not provide application-specific information about what caused the error. - -You can configure PHP to display errors in responses. - -1. Using **Windows® Explorer**, browse to `C:\PHP`. -2. Open the **Php.ini** filein the PHP installation directory. -3. Find and set the **display\_errors = On** directive: - - [!code-xml[Main](improve-php-error-messages-in-iis-7-and-above/samples/sample1.xml)] -4. Save and close the file. -5. Reset IIS. Click **Start**,and then select **Command Prompt**, right click and select **Run** **as administrator** to open a command-line window. -6. Type **iisreset.exe** -7. Press **Enter**. - -If you request a page with a script error now, you get a PHP parse error: - -[!code-xml[Main](improve-php-error-messages-in-iis-7-and-above/samples/sample2.xml)] - -If you see only the default Internet Explorer HTTP 500 Internal Server Error page, you must disable friendly error messages. Within Internet Explorer Go to **Tools**, **Internet Options**, **Advanced** tab, and then clear the **Show friendly HTTP error messages** check box. - -Note that PHP also provides options for customizing default error handling or completely overriding it. - -*Note: This article uses material from the [PHP on Windows Training Kit](https://www.microsoft.com/downloads/details.aspx?FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb&DisplayLang=en), published on August 25, 2009.* - -## See also - -- [PHP: Error Handling and Logging](http://www.php.net/errorfunc) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image1.jpg deleted file mode 100644 index b98bae2e5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image3.jpg deleted file mode 100644 index aac278c7c..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image5.jpg deleted file mode 100644 index 849dd0f4f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample1.xml deleted file mode 100644 index 622f920cc..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample1.xml +++ /dev/null @@ -1,19 +0,0 @@ -<< -; Print out errors (as a part of the output). For production web sites, -; you're strongly encouraged to turn this feature off, and use error logging -; instead (see below). Keeping display_errors enabled on a production web site -; may reveal security information to end users, such as file paths on your Web -; server, your database schema or other information. -; -; possible values for display_errors: -; -; Off - Do not display any errors ; stderr - Display errors to STDERR (affects only CGI/CLI binaries!) -; On or stdout - Display errors to STDOUT (default) -; -; To output errors to STDERR with CGI/CLI: -; display_errors = "stderr" -; -; Default -; -display_errors = On ->> \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample2.xml b/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample2.xml deleted file mode 100644 index d404c4ff4..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/improve-php-error-messages-in-iis-7-and-above/samples/sample2.xml +++ /dev/null @@ -1,3 +0,0 @@ -<< - -Parse error: parse error in C:\inetpub\troubleshootingPhp\error.php on line 3 >> \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md deleted file mode 100644 index 51ec00d91..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: "Install and Configure MySQL for PHP Applications on IIS 7" -author: ruslany -description: "While Microsoft ® SQL Server ® 2008 is the recommended database to use when hosting PHP applications on an Internet Information Services 7 (IIS 7) and above..." -ms.date: 02/14/2008 -ms.assetid: c65623d5-5bf5-4bed-8dbc-87245bb621bc -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above -msc.type: authoredcontent ---- -# Install and Configure MySQL for PHP Applications on IIS 7 - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Introduction - -While Microsoft® SQL Server® 2008 is the recommended database to use when hosting PHP applications on an Internet Information Services 7 (IIS 7) and above Web server, you can also use MySQL as the database. Currently, many popular PHP applications use MySQL Server for data storage. Using MySQL requires hosting providers to include MySQL database support with the hosting packages. - -MySQL cannot currently be installed with the Microsoft® Web Platform Installer (Web PI). This article provides guidance for installing MySQL manually. - -## Install MySQL Server on Windows Server 2008 or Windows Server 2008 R2 - -It is recommended that you install MySQL on a dedicated server rather than installing MySQL on the same server that is running IIS. The separation of database server and Web server makes overall installation more secure and manageable and avoids resource contentions between the database and Web server processes. - -1. Download **[MySQL Community Server](https://dev.mysql.com/downloads/)**. We recommend downloading Windows® Installer. -2. Start **Windows Installer**, or extract all the files from the archive, and then start **Setup.exe**. -3. You can use a **Typical Setup** or customize the installation to suit your needs. -4. Once the installation wizard is completed, it is recommended that you leave the **Configure the MySQL Server now** check box selected. - -## Configure a MySQL Instance - -1. Run the **MySQL Server Instance Configuration Wizard**, and then choose the configurations options that most closely match your environment. - For more information, see the [Server Instance Configuration Wizard](https://dev.mysql.com/doc/workbench/en/wb-mysql-connections-server-management-wizard.html). - Best practice recommendations are as follows: - - - Click **Next** in the **Instance Configuration Wizard**. - - Select **Detailed Configuration**, and then click **Next**. - - Select a server type that best suits your environment. It is recommended to set up a separate MySQL server; when prompted to select a server type, select **Dedicated MySQL Server Machine**, and then click **Next**. - - Select a database option, and then click **Next**. - - - Select either the **Multifunctional Database** or **Transactional Database Only** options if you are using the InnoDB storage engine or the high-speed MyISAM storage engine (for example, if the Web applications on your server require multi-statement transactions, advanced isolation levels and row-level locking, foreign key constraints, or atomic, consistent, isolated, and durable [ACID] features). These options provides fully ACID transactional capabilities, but at the cost of more aggressive usage of disk space and memory. - - Otherwise, use the **Non-Transactional Database Only** option, which is optimized for high-performance SELECT operations. It has low overhead, in terms of memory usage and disk utilization, but at the cost of not supporting transactions. - - Choose the option that sets the number of concurrent connections you need. - - > [!NOTE] - > Connections require memory; if the number you choose is too big, your server may not have enough memory. - - You may adjust networking settings to suit your environment or accept defaults, and then click **Next**. - - Select the default character set that best suits you, and then click **Next**. - - We recommend enabling both Windows options here. Select both check boxes, and then click **Next**. - - Type the *password* you want to use for the root account, and then click **Next**. - - Click **Execute** to apply your settings. - - Click **Finish** to close the wizard. - -- For PHP to work with MySQL, it is necessary to perform the following modifications to the **Php.ini** file: - - - Confirm that the **extension\_dir** points to the folder where all PHP loadable extensions are located, frequently in the Ext folder (for example, extension\_dir=".\ext"). - - Enable dynamic extension for MySQL by uncommenting the corresponding line for the MySQL extension: **extension=php\_mysql.dll** - - c. Save and close the **Php.ini** file. - -### Secure MySQL - -1. Remove the anonymous database account (if it exists). Open the MySQL command prompt by clicking **Start -> All Programs -> MySQL -> MySQL Server 5.1 -> MySQL Command Line Client**: -2. Enter the *password* for the root account. -3. Once logged on to MySQL, use the following sequence of commands: - - [!code-sql[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample1.sql)] -4. Next, restrict the root account to log on only from localhost. Open a MySQL command prompt, and use the following sequence of commands: - - [!code-sql[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample2.sql)] -5. Change the name of the root user with the following sequence of commands from the command prompt: - - [!code-sql[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample3.sql)] - -## Provision the User and Database - -1. To provision a new user, type the following command from the MySQL command prompt: - - [!code-console[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample4.cmd)] -2. The newly created user does not have any privileges on the MySQL server by default. To create a new database, type the following command: - - [!code-console[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample5.cmd)] -3. To grant access to this database for a particular user, type the following command: - - [!code-console[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample6.cmd)] - -## Configure PHP to Access MySQL - -1. Open the `c:\php\php.ini` file with your favorite text editor. -2. Uncomment the following lines by removing the semicolon: - - [!code-console[Main](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample7.cmd)] -3. Restart the IIS service by clicking on **Start**, selecting the **Search Field**, typing **iisreset**, and then pressing ENTER. -4. If all went well, you should see the **mysqli** section on the PHP information page created earlier `http://localhost/phpinfo.php`. - - ![Table listing Mysqli version information.](install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image1.jpg) - - *Figure 1: The mysqli section on the PHP information page* - -## Best Practices for MySQL - -- **Enable TCP/IP Networking** — This is the default. Keep the TCP port that MySQL uses to listen at 3306. If the database will be running on a separate system from the Web server, select the **Add firewall exception for this port** check box. -- **Include Bin Directory in Windows PATH** — This makes the MySQL utilities available from the command prompt or from Windows PowerShell™. -- **Create an Anonymous Account** — The default is to keep this disabled. Adding anonymous user support may create a security risk for the database; additionally, enabling anonymous users causes the GRANT statements used to set up database to be unreliable. - -## See also - -- [MySQL Server Web site](https://dev.mysql.com/doc/) -- [Using the MySQL Installation Wizard](https://dev.mysql.com/doc/mysql-installation-excerpt/8.0/en/) -- [Installing MySQL from a Noinstall Zip Archive](https://dev.mysql.com/doc/refman/5.0/en/windows-install-archive.html) -- [MySQL Windows Installation](https://dev.mysql.com/doc/refman/5.0/en/windows-installation.html) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image1.jpg deleted file mode 100644 index f182b5b46..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image2.jpg deleted file mode 100644 index f182b5b46..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample1.sql b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample1.sql deleted file mode 100644 index da64d881a..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample1.sql +++ /dev/null @@ -1,6 +0,0 @@ -mysql> use mysql; -Database changed -mysql> DELETE FROM user WHERE user = ''; -Query OK, 2 rows affected (0.03 sec) -mysql> FLUSH PRIVILEGES; -Query OK, 0 rows affected (0.05 sec) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample2.sql b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample2.sql deleted file mode 100644 index 8fa5a190f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample2.sql +++ /dev/null @@ -1,6 +0,0 @@ -mysql> use mysql; -Database changed -mysql> DELETE FROM user WHERE user = 'root' AND host = '%'; -Query OK, 2 rows affected (0.03 sec) -mysql> FLUSH PRIVILEGES; -Query OK, 0 rows affected (0.05 sec) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample3.sql b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample3.sql deleted file mode 100644 index 0a1f892d9..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample3.sql +++ /dev/null @@ -1,7 +0,0 @@ -mysql> USE mysql; -Database changed -mysql> UPDATE user SET user='johndoe' WHERE user='root'; -Query OK, 1 row affected (0.19 sec) -Rows matched: 1 Changed: 1 Warnings: 0 -mysql> FLUSH PRIVILEGES; -Query OK, 0 rows affected (0.23 sec) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample4.cmd deleted file mode 100644 index 0b2495f8d..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample4.cmd +++ /dev/null @@ -1,2 +0,0 @@ -mysql>CREATE USER ‘some_username’ IDENTIFIED BY ‘some_password’; -Query OK, 0 rows affected (0.00 sec) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample5.cmd deleted file mode 100644 index c1c1b8b71..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample5.cmd +++ /dev/null @@ -1,2 +0,0 @@ -mysql>CREATE DATABASE IF NOT EXISTS some_database_name; -Query OK, 1 row affected (0.00 sec) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample6.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample6.cmd deleted file mode 100644 index e7aaea930..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample6.cmd +++ /dev/null @@ -1,16 +0,0 @@ -mysql> GRANT ALTER, - -> ALTER ROUTINE, - -> CREATE, - -> CREATE ROUTINE, - -> CREATE TEMPORARY TABLES, - -> CREATE VIEW, - -> DELETE, - -> DROP, - -> EXECUTE, - -> INDEX, - -> INSERT, - -> LOCK TABLES, - -> SELECT, - -> UPDATE, - -> SHOW VIEW - ON some_database_name.* TO 'some_username'; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample7.cmd deleted file mode 100644 index 9e008b3d8..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above/samples/sample7.cmd +++ /dev/null @@ -1,3 +0,0 @@ -extension=php_mysqli.dll -extension=php_mbstring.dll -extension=php_mcrypt.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php.md deleted file mode 100644 index 3791cb665..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: "Install and Configure PHP" -author: rick-anderson -description: "Introduction The fastest and easiest way to install PHP on Internet Information Services (IIS) is by using the Microsoft ® Web Platform Installer (Web PI). W..." -ms.date: 11/15/2009 -ms.assetid: 2fbe0165-17a4-4cad-9bb8-ee04d7f118f3 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php -msc.type: authoredcontent ---- -# Install and Configure PHP - -by Tali Smith - -The fastest and easiest way to install PHP on Internet Information Services (IIS) is by using the Microsoft® Web Platform Installer (Web PI). Web PI completely automates setting up IIS, FastCGI, and the latest version of PHP from the php.net Web site. With Web PI, you can navigate to the "Web Platform" tab and select "PHP" under "Framework and Runtimes" customize link. Alternately, use the instructions that follow as guidance for installing PHP with Windows® Installer or using a compressed (Zip) file installation. - -There are two builds for each PHP version: one is thread-safe, and one is not (referred to as the non-thread-safe [NTS] version). The thread-safe version is designed for environments where the Web server core can keep the PHP engine in memory, running multiple treads of execution for different Web requests simultaneously. The architecture of IIS and the FastCGI extension provide an isolation model that keeps requests separate, removing the need for a thread-safe version. The NTS version does not have any of the code that allows PHP to manage multiple threads. As a result, there is a performance improvement on IIS when using the NTS version when compared to the tread-safe version because the NTS version avoids unnecessary thread-safety checks (FastCGI ensures a single-threaded execution environment). - -## Install PHP - -There are two main ways to install PHP on a Windows®-based computer: download the Windows Installer or use the Windows Zip file from the [PHP Web site](https://www.php.net/downloads.php). Either method will get PHP working, but both have some extra steps that are needed to make PHP work well. - -### Windows Installer - -The Windows Installer version can get a complete PHP environment up and running, but the installation of extensions can be confusing. By default, no extensions are installed, and this can adversely affect the usefulness of the PHP installation. Alternately, all of the extensions can be installed; this results in an unstable system because some of the extensions can conflict with others. It is generally easier to use the Zip file installation. - -### Zip File Installation - -To use the Zip file installation, follow the instructions in [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md). The Zip file installation installs many of the extensions that are available for the Windows Installer version; however, none of the extensions are enabled until their entries in the Php.ini file are set up. - -1. Download the [latest non-thread-safe Zip file package](https://www.php.net/downloads.php) with binaries of PHP. Under **Windows Binaries**, click on the most current PHP non-thread-safe Zip package to download the PHP files. -2. Unpack the files to a directory of your choice (for example, `C:\PHP`) on your IIS server. -3. Rename the **Php.ini-recommended** to **php.ini**. -4. Open the **Php.ini** file in a text editor, then uncomment and modify settings as follows: - - - Set **fastcgi.impersonate = 1**. - FastCGI under IIS supports the ability to impersonate security tokens of the calling client. This allows IIS to define the security context that the request runs under. - - Set **cgi.fix\_pathinfo = 0** - The **cgi.fix\_pathinfo** provides **PATH\_INFO/PATH\_TRANSLATED** support for Common Gateway Interface (CGI). Setting this to 1 will cause PHP CGI to fix its paths to conform to the specification. - - Set **cgi.force\_redirect = 0**. - - Set **open\_basedir** to point to a folder or network path where the content of the Web site(s) is located. - - Set **extension\_dir** to point to a location where PHP extensions reside. For PHP 5.2.X, this is typically **extension\_dir = "./ext"**. - - Set **error\_log="C:php\_errors.log"** - This can help with troubleshooting. - - Enable the required PHP extension by un-commenting corresponding lines. More information follows in the section, [Extensions](#Extensions_1). - - ![Screenshot of the Extensions text file contents.](install-and-configure-php/_static/image1.jpg) - *Figure 1 Windows extensions* -5. Click on **Start**, **Settings**, **Control Panel**, and then double-click on the **System** icon (using the class view). -6. Click on the **Advanced system settings** link in the left column. -7. From the **System Properties** window, click on the **Advanced** tab, and then click on the **Environment Variables** button at the bottom. -8. Select the **Path** variable from the **System Variables** section, and then click on **Edit**. Add: `c:\php` to your system path. - - ![Screenshot of the Edit System Variable dialog. Path is highlighted.](install-and-configure-php/_static/image3.jpg) - *Figure 2: Edit System Variable* -9. Click **OK** until you have exited the System Properties window. -10. Start IIS Manager by clicking on **Start**, **Programs**, **Administrative Tools**, and then **Internet Information Services (IIS) Manager**. -11. From the **IIS Manager**, click on the *hostname* of your server in the **Connections** panel on the left. -12. Double-click on the **Handler Mappings** icon. - - ![Screenshot of a browser window with I I S Manager in a tab. An arrow points to the Handler Mapping icon.](install-and-configure-php/_static/image5.jpg) - *Figure 3: Internet Information Services (IIS) Manager* -13. From the **Handler Mappings** **Actions** panel, click on **Add Module Mapping**. - - ![Screenshot of the I I S Manager screen. Handler Mappings are shown in the main pane and an arrow points to the Actions pane.](install-and-configure-php/_static/image7.jpg) - *Figure 4: Handler Mappings* -14. Type the following information into the appropriate text boxes, and then click **OK**. - - - Request path: **\*.php** - - Module **: FastCGImodule** - - Executable: **C:\php\php-cgi.exe** - - Name: **FastCGI** - - ![Screenshot of the Add Module Mapping dialog.](install-and-configure-php/_static/image1.gif) - - *Figure 5: Add Script Map* -15. Click **OK**, and then click **Yes.** -16. In the left panel, click on your server's *hostname*, and then double-click on the **Default Document** icon. -17. From the **Actions** panel on the right, click **Add**. -18. Enter **index.php** as the new default document name, and then click **OK**. -19. Enter **default.php** as the new default document name, and then click **OK**. -20. In the left panel, click on your server's *hostname*. -21. In the **Actions** panel on the right, click **Restart**. -22. Create a new text document, and save it as `c:\inetpub\wwwroot\phpinfo.php` with the following content: - - [!code-xml[Main](install-and-configure-php/samples/sample1.xml)] -23. You should now see the PHP information page at `http://localhost/phpinfo.php`. - - ![Screenshot of the P H P information page.](install-and-configure-php/_static/image9.jpg) - *Figure 6: PHP information page* - - - -## Extensions - -It is important to determine which extensions are needed by the applications that will be running and then to limit the installed extensions to only those. For a typical open-source application installation, for example, the following extensions are installed: - -- **Database Extensions** — Most open-source applications that use MySQL for a database engine use either the *php\_mysql* or the *php\_mysqli* extensions. For new development work, either of these extensions work well, or consider using the PDO versions of the MySQL driver (PDO is a PHP extension providing a data-access abstraction layer that can be used with a variety of databases); this extra layer of abstraction provides a richer set of object database functionality and controls. If Microsoft® SQL Server® (or an express version, such as Microsoft® SQL Server® 2008 Express or Microsoft® SQL Server® 2005 Express Edition) is the database engine, use the *php\_mssql* extension for open-source applications. For new development work, use the PDO version of the SQL driver. -- **Image Handling Extensions** — Many of the open-source applications that enable work with images make use of the GD2 extension – *php\_gd2*, which has a number of good basic image manipulation application programming interfaces (APIs). Some applications use the [ImageMagick application and libraries](http://www.imagemagick.org/script/index.php). There is also a *php\_exif* library for working with the extended information that modern digital cameras store within the images. -- **Internationalization and Localization Extensions** &mdash- The two most commonly used extensions for i18n and l10n are *php\_mbstring* (Multi-Byte String) and *php\_gettext* (Native Language Support). Many of the open-source applications use one or both of these. -- **Web Services Extensions** — Choose the Web services extensions based on the services desired. For PHP, the SOAP extension is widely used. The XML-RPC extension is often used in conjunction with SOAP and other services. - -## PHP.INI File Settings - -The Php.ini file provides PHP with configuration and environmental information. Below are a number of settings for the Php.ini file that help PHP work better with Windows. - -### Required Settings - -- **extension\_dir = <PATH TO EXTENSIONS>** The extension\_dir needs to point to the directory where the PHP extensions are stored. The path can be fully qualified (for example, `C:\PHP\ext`) or relative (for example, .\ext). Extensions that are specified lower in the Php.ini file need to be located in the extension\_dir. If the extensions specified are not in the extension\_dir, then PHP will give a warning message at the start of script execution, and the application may show errors because of the missing functionality. -- **extension = xxxxxx.dll** For each extension enabled, a corresponding extension= directive that tells PHP which extensions in the extension\_dir to load at startup time is necessary. -- **log\_errors=On** PHP errors can also go through the PHP error logging facility. This can be used to send errors to a file or to a service (for example, syslog) and works with the error\_logdirective described below. When running under IIS, log\_errors must be enabled with a valid error\_log. Otherwise, FastCGI considers any startup messages (which may be benign) as an error condition, which generates an HTTP 500 return error code to the browser. -- **error\_log=<path\_to\_error\_log\_file"** The error\_log needs to specify the fully qualified, or relative, path to the file where the PHP error log is stored. This file needs to be writable for the IIS service. The most common places for this file are in various temporary directories (for example, `C:\inetpub\temp\php-errors.log`). That puts the log in a place that IIS can use, and also keeps the log close to where PHP applications are running. -- **cgi.force\_redirect = 0** This directive is required for running under IIS. It is a directory security facility required by many other Web servers; however, enabling it under IIS will cause the PHP engine to fail on Windows. -- **cgi.fix\_pathinfo = 1** This lets PHP access real path info following the CGI specification. The IIS FastCGI implementation needs this extension set. -- **fastcgi.impersonate = 1** FastCGI under IIS supports the ability to impersonate security tokens of the calling client. This allows IIS to define the security context that the request runs under. -- **fastcgi.logging = 0** FastCGI logging should be disabled on IIS. If it is left enabled, then any messages of any class are treated by FastCGI as error conditions, which will cause IIS to generate an HTTP 500 exception. - -### Optional Settings - -- **max\_execution\_time=##** This directive sets the maximum amount of time that can be taken executing any given script. The default is 30 seconds. Some applications need more time to process batch operations (for example, Gallery2 loading multiple images from a remote location). However, setting the execution time higher than 300 seconds is not advised because there are often other parts of the connection that cannot support such a long execution time. -- **memory\_limit=###M** The amount of memory available for the PHP process (in MB). The default is 128 MB, which is appropriate for most PHP applications. -- **display\_errors=Off** This directive determines whether to include any error messages in the stream that it returns to the Web server. If turned on, PHP will send the classes of errors that are defined with the **error\_reporting** directive back to IIS as part of the error stream. Many of the open-source applications bypass error reporting by executing commands prefaced with @. This allows the applications to control error handling. -- **Mail functions** PHP is configured by default to send outbound mail through an SMTP server located on the same system as the Web server. Note that most Windows installations usually have the Web and mail servers on separate systems. - -## Enable PHP Session State - -1. In **Windows® Explorer**, create the **session** subdirectory in the PHP installation directory. -2. Right-click the **session** directory, and select **Properties**. -3. In the **Security** tab, click **Edit**. -4. Click **Add**, and enter **IIS\_IUSRS** for **Enter the object names to select**. -5. Click **OK**. -6. Select the **Modify** permission check box, and click **OK**. - - ![Screenshot of the Permissions for session dialog.](install-and-configure-php/_static/image3.gif) - *Figure 7: Permissions for session folder* -7. Click **OK** in the **Session Properties** window. -8. Open **php.ini** in the PHP installation directory, and set the **session.save\_path** setting to the **session** subdirectory: - - [!code-console[Main](install-and-configure-php/samples/sample2.cmd)] -9. Save and close the file. -10. Click **Start**, and then select **Command Prompt**. -11. Type **runas /user:administrator cmd.exe** to enable elevated permissions. -12. Type **iisreset** at the command prompt, and then press the ENTER key. - - ![Screenshot of the Administrator Command Prompt window.](install-and-configure-php/_static/image11.jpg) - *Figure 8: IISRESET command* - - Note that PHP uses file-based session state by default. You can modify a number of additional session settings, including whether cookie or URL sessions should be used, and whether sessions are created on the first request or need to be explicitly created. -13. Test the session state by using Windows Explorer, navigate to `C:\inetpub\wwwroot`. -14. Create a folder and rename it **phpapp**. -15. Create **session.php** in the **phpapp** directory. -16. Paste the following into it: - - [!code-xml[Main](install-and-configure-php/samples/sample3.xml)] -17. Save and close the file. -18. Start **Internet Explorer**, and navigate to `http://localhost/phpapp/session.php`. - - ![Screenshot of a browser window showing the session state in a tab.](install-and-configure-php/_static/image5.gif) - *Figure 9: Using session state* -19. Observe that the counter is 1. -20. Request `http://localhost/phpapp/session.php` again, or press **F5**. - - ![Screenshot of a browser window showing the updated session state in a tab.](install-and-configure-php/_static/image7.gif) - *Figure 10: Using session state* -21. Observe that the counter is 2. - -> [!NOTE] -> *This article uses information from "*[*Using FastCGI to Host PHP Applications on IIS 7.0 and Above*](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md#InstallPHP)*" by Ruslan Yakushev, published on December 5, 2007.* - -## See also - -- [PHP on Windows Training Kit](https://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb). -- [Installing PHP on Windows Server 2008](https://www.microsoft.com/video/en/us/details/7293e003-91c5-4e50-a3c9-ff47b3c62bbc). -- [PHP on IIS7](https://php.iis.net/). -- [Deploying IIS 7.5 + FASTCGI + PHP on Server Core](https://blogs.msdn.com/philpenn/archive/2009/07/19/deploying-iis-7-5-fastcgi-php-on-server-core.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.gif b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.gif deleted file mode 100644 index acc502d76..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.jpg deleted file mode 100644 index 447a3cc02..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image11.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image11.jpg deleted file mode 100644 index d89fa43fe..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image12.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image12.jpg deleted file mode 100644 index d89fa43fe..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.gif b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.gif deleted file mode 100644 index 8dbf58f4f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.jpg deleted file mode 100644 index 859d4f878..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.gif b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.gif deleted file mode 100644 index f9200b0a3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.jpg deleted file mode 100644 index 776cf7195..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.gif b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.gif deleted file mode 100644 index e251a32bf..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.jpg deleted file mode 100644 index eecb64147..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image9.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image9.jpg deleted file mode 100644 index 0ea42ee96..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample1.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample1.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample2.cmd deleted file mode 100644 index 5c0603718..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -session.save_path = "C:\php\session" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample3.xml b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample3.xml deleted file mode 100644 index e1d1e8830..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php/samples/sample3.xml +++ /dev/null @@ -1,7 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above.md b/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above.md deleted file mode 100644 index e535f89c1..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: "Install and Configure SQL Server 2008 for PHP Applications on IIS 7" -author: rick-anderson -description: "PHP is a widely used, easy-to-learn, open-source scripting language. Microsoft ® SQL Server ® is a powerful and robust relational model database server that..." -ms.date: 11/15/2009 -ms.assetid: 322bf487-da24-463a-ac46-d526e179fe2a -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/install-and-configure-sql-server-2008-for-php-applications-on-iis-7-and-above -msc.type: authoredcontent ---- -# Install and Configure SQL Server 2008 for PHP Applications on IIS 7 - -by Tali Smith - -## Introduction - -PHP is a widely used, easy-to-learn, open-source scripting language. Microsoft® SQL Server® is a powerful and robust relational model database server that can handle terabytes of data. Together, PHP and SQL Server can be used to create and support database-driven Web sites that can handle significant traffic and data. - -Although you can install an instance of SQL Server on a computer that is running Internet Information Services 7 (IIS 7) or above, this is typically done only for small Web sites that have a single server computer. Most Web sites have their middle-tier IIS systems on one server or cluster of servers and their databases on a separate server or federation of servers. - -To access a SQL Server database from within PHP scripts, you must have the SQL Server Driver for PHP, which can be installed with the Microsoft® Web Platform Installer (Web PI), or downloaded from [here](https://www.microsoft.com/downloads/details.aspx?familyid=CCDF728B-1EA0-48A8-A84A-5052214CAAD9&displaylang=en). - -## Why Use SQL Server? - -While it is possible to use MySQL as the database component, Microsoft offers a highly compelling solution for the data requirements of PHP-based applications. With the advent of the SQL Server Driver for PHP, you can take advantage of the efficient, reliable, and intelligent capabilities of Microsoft SQL Server. - -Hosters and large Web properties need a manageable enterprise-class database solution to support: - -- Effective monitoring and management of Web customers. -- Maximum server utilization for low-cost operations. -- Flexible platform options for developers. -- Consistently increasing scale-out needs. -- Efficient management of large groups of servers. - -SQL Server 2008 can meet these needs by providing enterprise-class availability and scalability and a low total cost of ownership (TCO). - -- **Increase scalability.** Scale out with unlimited memory and database size, which helps hosting companies offer support for multi-tenancy and customers with growing data needs. Scale out with support for up to four CPUs to maximize the utilization of hardware resources. -- **Ensure availability**. Help ensure availability by using log shipping to automatically back up data on separate server s or keep multiple read servers online to better handle large amounts of Web traffic. One-way merge and transactional replication provides enterprise-class data availability. **Lower TCO.** Help increase overall profit margins through low monthly licensing costs, enhanced publishing tools for fast customer deployment, and manageability tools for reduced administration. Businesses can take advantage of the low cost of Microsoft® SQL Server® 2008 Web for their core enterprise installations. -- **Automate tasks and policies.** - Use *Policy-Based Management* to define configuration policies and apply them to servers, databases, tables, and other targets. - Use the *performance data collector* to identify problematic customer applications and pinpoint causes for performance degradation. - Use *SQL Agent* to reduce the amount of time spent on administrative tasks by scheduling and executing events like server backups. -- **Streamline administration.** - Use the *service broker* to distribute applications across your servers to help balance the load while the applications seamlessly functions as a whole for easier scale out. - Use *Windows PowerShell™* to automate server administration and application development more easily, giving administrators a common scripting language across Windows®, IIS, and SQL Server to save time. -- **Use built-in business intelligence**. Use basic SQL Server 2008 Reporting Services features to create unique report layouts. The new visualization enhancements in Reporting Services further enrich the reports and provide greater insight. -- **Take advantage of platform flexibility.** - Use *ADO.NET Data Services* support to expose data through Web services using existing tools and processes. This helps hosters support customers with mixed applications like ASP and PHP. - Use *FTS (full text search)* for fast and flexible indexing for keyword-based query of text stored in SQL Server for enterprise search functionality. - -## SQL Server Versions - -SQL Server 2008 is available in several editions, including two editions that are free. Most applicable to Web hosters are: - -- **Microsoft SQL Server 2008 Web.** - Microsoft SQL Server 2008 Web has been designed to provide a robust backend to Web systems. Its feature set includes policy-based management tools, automated security policy enforcement, and performance data collection tools. Although this edition can only address four CPUs, there are no limits on memory or database size. -- **Microsoft® SQL Server® 2008 Express.** - This free edition provides an entry-level database (4 GB in size) that is ideal for learning, developing and powering desktop computers, Web and small server applications, and for redistribution by independent software vendors (ISVs). Built on the SQL Server 2008 Database Engine, it supports stored procedures, triggers, functions, and views, and it stores a variety of business data with native support for relational data, XML, FILESTREAM, and spatial data. This edition can address one CPU and has a limit of 1 GB of memory. - - - -## Install SQL Server 2008 with Web PI - -The fastest and easiest way to install a database component for a Windows-based PHP Web platform is by using Web PI. Web PI can install the latest versions of SQL Server Express (a scaled-down, free edition of SQL Server, which includes the core database engine) and the Microsoft SQL Server Driver for PHP with just a few clicks. You can simply navigate to the "Web Platform" tab and select "SQL Server Express 2008 with Service Pack 1" under the "Databases" customize link. Web PI can also install and set up IIS, FastCGI, and the latest version of PHP from the php.net site. - -## Install SQL Server 2008 Manually - -Alternately, you can manually set up SQL Server as the database component of the Microsoft® Web Platform. The SQL Server Installation Wizard is based on Windows® Installer. It provides a single feature tree for installation of all SQL Server components, so that you do not have to install them individually. SQL Server 2008 can also be installed from the command prompt or with a configuration file. - -For instructions, see: [How to: Install SQL Server 2008](https://technet.microsoft.com/library/ms143219.aspx). - -## Links for Further Information - -- [SQL 2008 for Hosters](../../web-hosting/configuring-servers-in-the-windows-web-platform/sql-2008-for-hosters.md). -- [Hardware and Software Requirements for Installing SQL Server 2008](https://technet.microsoft.com/library/ms143506.aspx). -- [Editions and Components of SQL Server 2008.](https://technet.microsoft.com/library/ms144275.aspx) -- [SQL Server 2008 home page](https://www.microsoft.com/sqlserver/2008/en/us/default.aspx). -- [SQL Server Developer Center library](https://msdn.microsoft.com/library/bb545450.aspx). -- [SQL Server Best Practices](https://technet.microsoft.com/sqlserver/bb671430.aspx). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md deleted file mode 100644 index a03eb447f..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: "Install PHP and FastCGI Support on Server Core" -author: rick-anderson -description: "FastCGI is a language-independent, scalable, open extension to Common Gateway Interface (CGI) that improves performance. The FastCGI extension is installable..." -ms.date: 01/30/2008 -ms.assetid: 3a89b36f-8b6a-490e-b7fe-b34b26d24864 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core -msc.type: authoredcontent ---- -# Install PHP and FastCGI Support on Server Core - -by IIS Team - -## Introduction - -FastCGI is a language-independent, scalable, open extension to Common Gateway Interface (CGI) that improves performance. The FastCGI extension is installable onto Server Core and enables application frameworks such as PHP to achieve improved performance and stability on Internet Information Services 7 (IIS 7) and above. Installing FastCGI when hosting PHP applications is very strongly recommended. In this example, we install FastCGI support to prepare the server to host our PHP application. - -## Install FastCGI Support - -1. To install FastCGI and Static Content Web Server support, type the following text into the Server Core system's command line, and then press ENTER: - - [!code-console[Main](install-php-and-fastcgi-support-on-server-core/samples/sample1.cmd)] -2. Type the following text into the Server Core system's command line and press ENTER: - - [!code-console[Main](install-php-and-fastcgi-support-on-server-core/samples/sample2.cmd)] -3. AppCmd.exe is the command-line tool included with IIS. AppCmd.exe can be found in the `%WinDir%\System32\InetSrv` directory. Use AppCmd.exe commands to create the PHP/FastCGI handler mapping from the Server Core's command line (note that this is case sensitive): - - [!code-console[Main](install-php-and-fastcgi-support-on-server-core/samples/sample3.cmd)] -4. Depending on the PHP installation location, paths to executables on the hard disk may require updates. Note that the AppCmd.exe example commands above assume that PHP installation is in the D:\PHP directory. - -## Install PHP on IIS 7 and Above - -1. Download the latest [PHP release](https://www.php.net/downloads.php). -2. In the section titled "Windows Binaries," select the archive with the **.zip** file extension. Note that the Server Core lacks a graphical user interface (GUI), and has no Web browser. -3. Uncompress the archive's contents to a location accessible by the Server Core system, which is likely to be a network file share. -4. Create a directory in which to copy the uncompressed files, for example: - - [!code-console[Main](install-php-and-fastcgi-support-on-server-core/samples/sample4.cmd)] - -5. Copy the entire contents of the PHP archive you uncompressed previously into the `%SystemDrive%\PHP` directory. -6. Execute the following command: - - [!code-console[Main](install-php-and-fastcgi-support-on-server-core/samples/sample5.cmd)] - -## Test the PHP Configuration - -1. From the command line, start **Notepad.exe**. In the empty file, type or paste the following text: - - [!code-xml[Main](install-php-and-fastcgi-support-on-server-core/samples/sample6.xml)] -2. Save the file as **phpinfo.php** to `c:\inetpub\wwwroot\`. -3. From a connected computer, open a browser window, and go to `http://%systemhost%/phpinfo.php`. -4. A page appears showing the PHP configuration. - - [![Screenshot of the P H P Configuration page. This page shows information on P H P Version five dot two dot four.](install-php-and-fastcgi-support-on-server-core/_static/image2.jpg)](install-php-and-fastcgi-support-on-server-core/_static/image1.jpg) - *Figure 1: PHP page* - -> [!NOTE] -> *This article updates [IIS 7.0 and Above on Server Core](../../manage/working-with-server-core/iis-70-on-server-core.md) by Tobin Titus, published on September 11, 2009.* - -## See also - -- [Setting Up FastCGI for PHP](../running-php-applications-on-iis/set-up-fastcgi-for-php.md) -- [Videocast: Using IIS 7 and Above with Windows Server Core](../../manage/working-with-server-core/using-iis-with-windows-server-core.md) -- [Installing PHP on Windows Vista® with FastCGI](installing-php-on-windows-vista-with-fastcgi.md) -- [Using FastCGI to Host PHP Applications on IIS 6.0](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md) -- [Configuring FastCGI Extension for IIS 6.0](configuring-the-fastcgi-extension-for-iis-60.md) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image1.jpg deleted file mode 100644 index acf03afba..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image2.jpg deleted file mode 100644 index acf03afba..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample1.cmd deleted file mode 100644 index 4435293b7..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -Start /w ocsetup IIS-WebServerRole \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample2.cmd deleted file mode 100644 index b53da789e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -Start /w ocsetup IIS-CGI \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample3.cmd deleted file mode 100644 index 48ee99432..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample3.cmd +++ /dev/null @@ -1,3 +0,0 @@ -AppCmd set config /section:system.webServer/fastCGI /+[fullPath='d:\php\php-cgi.exe'] - -AppCmd set config /section:system.webServer/handlers /+[name='PHP-FastCGI',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='d:\php\php-cgi.exe',resourceType='Either'] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample4.cmd deleted file mode 100644 index 5c4bb8288..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -%SystemDrive%\PHP \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample5.cmd deleted file mode 100644 index b7543cafe..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -rename %SystemDrive%\PHP\PHP.INI-Recommended %SystemDrive%\PHP\PHP.INI \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample6.xml b/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample6.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-php-and-fastcgi-support-on-server-core/samples/sample6.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php.md deleted file mode 100644 index 48aa8301e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: "Install the Microsoft Drivers for PHP for SQL Server" -author: david-puglielli -description: "Introduction The Microsoft Drivers for PHP for SQL Server are designed to enable reliable, scalable integration with SQL Server for PHP applications on..." -ms.date: "02/06/2020" -ms.assetid: 2e1b4523-a32f-4390-bf9f-552f21ecc93b -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php -msc.type: authoredcontent ---- -# Install the SQL Server Driver for PHP - -by Tali Smith - -## Introduction - -The Microsoft Drivers for PHP for SQL Server are designed to enable reliable, scalable integration with SQL Server for PHP applications on Windows, Linux, and macOS platforms. The drivers are PHP extensions that allow reading from and writing to SQL Server databases in all editions of SQL Server (including Express editions) within PHP scripts. Two drivers are available: The SQLSRV driver provides a procedural interface for interacting with SQL Server. The PDO_SQLSRV driver implements PHP's object-oriented PDO interface for working with databases. - -The drivers' application programming interface (API) includes support for Active Directory authentication, transactions, parameter binding, streaming, metadata access, Unicode data handling, and error handling. The drivers rely on the Microsoft ODBC Driver for SQL Server to communicate with SQL Server. The drivers also support Microsoft SQL Azure Database, enabling developers to build PHP applications with relational capabilities using SQL Azure Database. - -The Microsoft Drivers for PHP for SQL Server download is freely available to all SQL Server users. Releases and source code for the drivers are available from the [Github project page](https://github.com/microsoft/msphpsql). Full documentation for the drivers is available on [Microsoft Learn](/sql/connect/php/microsoft-php-driver-for-sql-server); what follows is a brief overview of installation and configuration on Windows and IIS. - -## System Requirements - -Full details on the system requirements for all supported versions of the driver can be found on the [system requirements page](/sql/connect/php/system-requirements-for-the-php-sql-driver). The following software is required: - -- On the client machine: - - A supported Windows, Linux, or macOS operating system - - A supported version of PHP - - A supported version of the Microsoft ODBC Driver for SQL Server - - A Web server configured to run PHP -- On the server: - - A supported version of SQL Server or Azure SQL Database - -## Install the Drivers - -The Microsoft Drivers for PHP for SQL Server can be installed using the [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx). To download and install the drivers manually instead, perform the following steps: - -1. Download and run the installation package from the appropriate link on the [download page](/sql/connect/php/download-drivers-php-sql-server). -2. Enter a directory to extract the package into when prompted. -3. Open the directory you chose in step 3 and copy the required dll libraries to your PHP extension directory. The filenames indicate which PHP version, threadedness, and architecture each dll file is for. For example, `php_sqlsrv_73_ts_x64.dll` is the 64-bit SQLSRV driver for thread-safe (ts) PHP 7.3. -4. Download and install the Microsoft ODBC Driver for SQL Server from the appropriate link on the [ODBC download page](/sql/connect/odbc/download-odbc-driver-for-sql-server). -5. Edit your `php.ini` file to add the following lines in the `Extensions` section: - - [!code-console[Main](install-the-sql-server-driver-for-php/samples/sample1.cmd)] - - Substitute the names of the files you copied to your PHP extension directory as required. Full instructions for loading the drivers can be found [here](/sql/connect/php/loading-the-php-sql-driver). -6. Start a command prompt as administrator and run `iisreset` to restart your IIS server. - -## Configure the Drivers - -1. Retrieve the current configuration settings for the SQLSRV driver using the [`sqlsrv_get_config` function](/sql/connect/php/sqlsrv-get-config), or for the PDO_SQLSRV driver using the [`PDO::getAttribute` function](/sql/connect/php/pdo-getattribute). -2. Change the configuration settings for the SQLSRV driver using the [`sqlsrv_configure` function](/sql/connect/php/sqlsrv-configure), or for the PDO_SQLSRV driver using the [`PDO::setAttribute` function](/sql/connect/php/pdo-setattribute). -3. Ensure that the drivers are loaded and verify the configuration settings by running a script that calls the phpinfo() function: - - 1. Open a text file, and copy the following code into it: - - [!code-xml[Main](install-the-sql-server-driver-for-php/samples/sample2.xml)] - 2. Save the file as `info.php` in the IIS root directory. - 3. Open a browser, and go to `http://localhost/info.php`. - 4. Scroll down the resulting page to find the `sqlsrv` and `pdo_sqlsrv` sections. Confirm that the drivers are loaded and the configuration settings are set to the default values (see Figure 1). - - ![Table showing local and master value configuration settings.](install-the-sql-server-driver-for-php/_static/image2.jpg) - - *Figure 1: SQL Server configuration settings page* - -## Create a Connection to the Database - -When using the SQLSRV driver, the [`sqlsrv_connect()` function](/sql/connect/php/sqlsrv-connect) is used to establish a connection to the server. When using the PDO_SQLSRV driver, the [`PDO::__construct` function](/sql/connect/php/pdo-construct) is used to establish a connection to the server. - -Connections can be made using [Windows authentication](/sql/connect/php/how-to-connect-using-windows-authentication), [SQL Server authentication](/sql/connect/php/how-to-connect-using-sql-server-authentication), or [Azure Active Directory authentication](/sql/connect/php/azure-active-directory). The default is to use Windows authentication. In most scenarios, this means that the Web server's process identity or thread identity (if the Web server is using impersonation) is used to connect to the server, not a user's identity. - -## Links for Further Information - -- [Microsoft Drivers for PHP for SQL Server](https://github.com/microsoft/msphpsql) -- [Download the Microsoft Drivers for PHP for SQL Server](/sql/connect/php/download-drivers-php-sql-server) -- [Overview of the Microsoft Drivers for PHP for SQL Server](/sql/connect/php/overview-of-the-php-sql-driver) -- [Programming Guide](/sql/connect/php/programming-guide-for-php-sql-driver) -- [SQLSRV Example Application](/sql/connect/php/example-application-sqlsrv-driver) -- [PDO_SQLSRV Example Application](/sql/connect/php/example-application-pdo-sqlsrv-driver) -- [PHP Homepage](http://php.net/) -- [Whitepaper: Accessing SQL Server Databases with PHP](https://social.technet.microsoft.com/wiki/contents/articles/1258.accessing-sql-server-databases-from-php.aspx) -- [Drivers for SQL Server Team Blog](https://techcommunity.microsoft.com/t5/SQL-Server/bg-p/SQLServer/label-name/SQLServerDrivers) -- [SQL Azure Team Blog](https://techcommunity.microsoft.com/t5/Azure-SQL-Database/bg-p/Azure-SQL-Database) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image1.jpg deleted file mode 100644 index 9dc7c15e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image2.jpg deleted file mode 100644 index 9dc7c15e4..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample1.cmd deleted file mode 100644 index 2b5730b37..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -Extension=php_sqlsrv.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample2.xml b/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample2.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/install-the-sql-server-driver-for-php/samples/sample2.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md b/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md deleted file mode 100644 index 055fa5ce8..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Installing PHP on Windows Vista with FastCGI" -author: ruslany -description: "Microsoft IIS 7.0 for Windows Vista SP1 now includes a built-in FastCGI component. To get detailed information on how to use FastCGI component to host PHP ap..." -ms.date: 12/18/2007 -ms.assetid: 8c54faaa-76bf-4697-82dd-711e3aa0e259 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi -msc.type: authoredcontent ---- -# Installing PHP on Windows Vista with FastCGI - -by [Ruslan Yakushev](https://github.com/ruslany) - -## FastCGI support in Windows Vista - -Microsoft IIS 7.0 for Windows Vista SP1 now includes a built-in FastCGI component. To get detailed information on how to use FastCGI component to host PHP applications on Windows Server 2008 or Windows Vista SP1 refer to this [article](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md "PHP on IIS7"). - -[![Warning that states that you need Vista S P 1 for Fast C G I support on I I S 7.](installing-php-on-windows-vista-with-fastcgi/_static/image2.gif)](installing-php-on-windows-vista-with-fastcgi/_static/image1.gif) IIS7.0 included in Windows Vista (not SP1) does not include FastCGI component. In order to get FastCGI support on IIS7.0 in Windows Vista it is necessary to upgrade to Vista SP1. - -## Getting More Information - -To discuss the FastCGI Support for IIS, or file bug reports, use the FastCGI forums: - -- [IIS 6 FastCGI forum](https://forums.iis.net/1103.aspx) -- [IIS 7.0 FastCGI forum](https://forums.iis.net/1104.aspx) - -To see a list of known issues with FastCGI in IIS, see [**known issues**](https://forums.iis.net/1103.aspx). - -To get more information regarding running various PHP applications on IIS, see: - -- [PHP on IIS portal](https://php.iis.net/) -- [PHP community forum](https://forums.iis.net/1102.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image1.gif b/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image1.gif deleted file mode 100644 index 4a6ac0c4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image2.gif b/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image2.gif deleted file mode 100644 index 4a6ac0c4e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/installing-php-on-windows-vista-with-fastcgi/_static/image2.gif and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis.md b/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis.md deleted file mode 100644 index 6603057bf..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "Run Multiple Versions of PHP on IIS" -author: rick-anderson -description: "The ability to run multiple versions of PHP on one Internet Information Services (IIS) server can provide advantages when using the Microsoft ® Web Platform...." -ms.date: 11/15/2009 -ms.assetid: 48072e62-df8d-4278-866f-a68a4242e957 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis -msc.type: authoredcontent ---- -# Run Multiple Versions of PHP on IIS - -by Tali Smith - -## Introduction - -The ability to run multiple versions of PHP on one Internet Information Services (IIS) server can provide advantages when using the Microsoft® Web Platform. Some PHP applications rely on functions or features that are available only in certain versions of PHP. If you want to host these applications on one server, you must run different PHP versions side by side. The ability to run multiple versions of PHP on one IIS server also lets you test the newest release of PHP before deploying it to your live Web sites. - -The IIS FastCGI handler fully supports running multiple versions of PHP on the same server. You can either use a different extension for each PHP version (for example, .php406 and .php411), or you can use multiple sites with the same base directory and then map the .php extension to the different PHP versions. Note, however, that maintaining multiple instances of PHP means more administrative overhead and more complicated troubleshooting. It is important to consider the consequences carefully before adding extra PHP instances. - -## Configure the Environment Variables - -To run multiple versions of PHP on IIS, start by configuring the environment variables. For example, to use PHP 4 you must ensure that both the path to the PHP 4 root directory and the path to the dynamic-link libraries (DLLs) directory are included in your Path environment variable: - -1. Right-click on **My Computer**. -2. Select **Properties**. -3. Click on the **Advanced** tab. -4. Click on the **Environment Variables** button. -5. In the **System Variables** pane, scroll down until you see the **Path** variable. -6. Select the **Path** variable, and then click the **Edit** button. -7. At the beginning of the **Variable Value** field, type the names of the full paths to the PHP 4 root directory and to the DLLs directory. The path names must be separated by a semicolon. - - You must remove the PHPRC environment variable, because it tells PHP where to look for the Php.ini configuration file. If you have already set the PHPRC variable, follow the procedure above, but instead of editing the **Path** variable, select the **PHPRC** variable, and then press **Delete**. - -## Create FastCGI Application Process Pools - -Next, you create FastCGI application process pools. For example, suppose you want to support PHP 4.4.8, PHP 5.2.1, and PHP 5.2.5 non-thread-safe. Place the corresponding PHP binaries in separate folders on the file system (for example, `C:\php448\`, `C:\php521\` and `C:\php525nts`), and then create FastCGI application process pools for each PHP version: - -[!code-console[Main](run-multiple-versions-of-php-on-iis/samples/sample1.cmd)] - -If you have three Web sites (site1, site2, and site3) and each site must use a different PHP version, you can define handler mappings on each site to reference a corresponding FastCGI application process pool. Note that each FastCGI process pool is uniquely identified by a combination of fullPath and arguments properties. - -[!code-console[Main](run-multiple-versions-of-php-on-iis/samples/sample2.cmd)] - -> [!NOTE] -> *This article uses material from "[Using FastCGI to Host PHP Applications on IIS 7.0](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md)" published on June 26, 2009.* - -## Links for Further Information - -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md). -- [Another reason that IIS ROCKS and PHP is better on Microsoft Windows!](https://blogs.msdn.com/joestagner/archive/2005/10/30/487051.aspx) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample1.cmd deleted file mode 100644 index 49757df97..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample1.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php448\php.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php521\php-cgi.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php525nts\php-cgi.exe'] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample2.cmd deleted file mode 100644 index 35360f672..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/run-multiple-versions-of-php-on-iis/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config site1 –section:system.webServer/handlers /+"..[name=’PHP448_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php448\php.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site2 –section:system.webServer/handlers /+"..[name=’PHP521_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php521\php-cgi.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site3 –section:system.webServer/handlers /+"..[name=’PHP525nts_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php525nts\php-cgi.exe’,resourceType=’Either’] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation.md b/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation.md deleted file mode 100644 index e97ea17ae..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Secure Content in IIS Through Impersonation -author: rick-anderson -description: Describes how to secure content in IIS through FastCGI impersonation to prevent PHP scripts across multiple IIS websites from accessing each other's files. -ms.date: 11/15/2009 -ms.assetid: fadbe064-4cbf-49ec-9439-ce6633f3a155 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation -msc.type: authoredcontent ---- -# Secure Content in IIS Through Impersonation - -by Tali Smith - -## Introduction - -The access control list (ACL) is a list of permissions associated with an object. Each of these permission entries is called an access control entry (ACE); an ACE contains permissions associated with a particular object for a particular identity. For example, for file system objects, you can set ACLs on files/directories on an NTFS file system. - -You can use graphical user interface (GUI) tools (such as My Computer or Windows® Explorer) to set or edit ACLs. Simply right-click any file or folder resource from one of these tools, select **Properties**, and then click the **Security tab** to see a graphical representation of the ACL on the resource you chose. From this dialog box, you can apply or remove group or user permissions to system resources such as files and folders. You can also use a command-line utility Cacl.exe to display or modify file ACLs. - -For the basics of ACLs, see [Secure Content in IIS through File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md). - -## Impersonation and File System Access - -It is recommended that you enable FastCGI impersonation in PHP when using IIS. This is controlled by the **fastcgi.impersonate** directive in the Php.ini file. When impersonation is enabled, PHP performs all the file system operations on behalf of the user account that has been determined by IIS authentication; this ensures that even if the same PHP process is shared across multiple IIS Web sites, the PHP scripts in those Web sites cannot access each other's files as long as different user accounts are used for IIS authentication on each Web site. - -For example, in its default configuration, IIS has anonymous authentication enabled with the built-in user account IUSR used as a default identity. This means that in order for IIS to execute PHP scripts, it is necessary to grant the IUSR account read permission on those scripts. If PHP applications need to perform write operations on certain files or write files into some folders, then the IUSR account should have write permission to those. - -To determine which user account is used as an anonymous identity in IIS, use the following command (replace the "Default Web Site" with the name of your IIS Web site). In the output XML configuration element, look for the userName attribute. - -[!code-xml[Main](secure-content-in-iis-through-impersonation/samples/sample1.xml)] - -Note that if the userName attribute is not present in the <anonymousAuthentication> element or is set to an empty string, then the application pool identity is used as an anonymous identity for that Web site. - -To modify the permissions settings on files and folders, use the Windows Explorer user interface or the **icacls** command. - -[!code-console[Main](secure-content-in-iis-through-impersonation/samples/sample2.cmd)] - -*Note: This article uses material from "[Securing Content in IIS through File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md)" by Nazim Lala*, *published on March 17, 2009.* - -## Links for Further Information - -- [Application Packaging Guide for the Windows Web Application Gallery](../../develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md). -- [Understanding the Built-In User and Group Accounts in IIS 7 and Above](../../get-started/planning-for-security/understanding-built-in-user-and-group-accounts-in-iis.md). -- [PHP on Windows Training Kit (August 2009)](https://www.microsoft.com/downloads/details.aspx?FamilyID=c8498c9b-a85a-4afa-90c0-593d0e4850cb&DisplayLang=en). -- [Access Control Lists](/windows/win32/secauthz/access-control-lists). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample1.xml b/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample1.xml deleted file mode 100644 index 05e3e2805..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample1.xml +++ /dev/null @@ -1,15 +0,0 @@ -C:\>%windir%\System32\inetsrv>appcmd.exe list config "Default Web Site" /section:anonymousAuthentication - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample2.cmd deleted file mode 100644 index 315424d09..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-content-in-iis-through-impersonation/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M) - -processed file: C:\inetpub\wwwroot\upload - -Successfully processed 1 files; Failed processing 0 files \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings.md b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings.md deleted file mode 100644 index 3245eb17e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: "Secure PHP with Configuration Settings" -author: rick-anderson -description: "PHP code can be embedded in your Web pages along with HTML code. When your Web server receives a request for a page, the page is first given to the PHP handl..." -ms.date: 11/15/2009 -ms.assetid: 60b399b7-e8d9-4f0a-8fd8-37899808f69b -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings -msc.type: authoredcontent ---- -# Secure PHP with Configuration Settings - -by Tali Smith - -## Introduction - -PHP code can be embedded in your Web pages along with HTML code. When your Web server receives a request for a page, the page is first given to the PHP handler. The PHP handler outputs HTML code without modification and executes any PHP commands. Any HTML code generated by the PHP commands is also output. This results in a Web page with content that has been customized on the server before being sent to the requestor. - -The capabilities of PHP also make it a potential security risk because data is actively fetched, received, and processed from anywhere on the Internet. Attackers may attempt to send in malicious data and scripts and trick your server into fetching malicious scripts and running them. Attackers may also attempt to read and write files on your server to take control of the Web site and use it for their own purposes. - -You can configure PHP settings to tighten the security of a PHP installation and help protect the Web site from malicious attacks. The Php.ini file specifies the configuration settings PHP uses when it is running on your Web site. The Php.ini file determines what things PHP scripts are allowed to do and what the scripts are prohibited from doing. Table 1 summarizes settings that affect security. More detailed explanations of the setting follow. - -| **Setting** | **Description** | -| --- | --- | -| allow\_url\_fopen=Off allow\_url\_include=Off | Disable remote URLs (which may cause code injection vulnerabilities) for file handling functions. | -| register\_globals=Off | Disable register\_globals. | -| open\_basedir="c:\inetpub\" | Restrict where PHP processes can read and write on a file system. | -| safe\_mode=Off safe\_mode\_gid=Off | Disable safe mode. | -| max\_execution\_time=30 max\_input\_time=60 | Limit script execution time. | -| memory\_limit=16M upload\_max\_filesize=2M post\_max\_size=8M max\_input\_nesting\_levels=64 | Limit memory usage and file sizes. | -| display\_errors=Off log\_errors=On error\_log="C:\path\of\your\choice" | Configure error messages and logging. | -| fastcgi.logging=0 | Internet Information Services (IIS) FastCGI module will fail the request when PHP sends any data on stderr by using FastCGI protocol. Disabling FastCGI logging will prevent PHP from sending error information over stderr, and generating 500 response codes for the client. | -| expose\_php=Off | Hide presence of PHP. | - -Table 1: Recommended Php.ini settings - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample1.cmd)] - -This setting is very important because it prevents URLs from being used in statements such as include(). Setting allow\_url\_fopen to "Off" means that only files that reside within your Web site can be included; you cannot include a file from a different server, but neither can other people through Remote File Inclusion (RFI) attacks. (In an RFI attack, someone embeds a URL in an HTTP request hoping that your script is tricked into running theirs.) A command such as `include("http://website.com/page.php")`, for example, is not allowed to execute. - -Include a file from your own site by specifying its path and filename. For example, if you have a URL include line, convert it to: - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample2.cmd)] - -$\_SERVER['DOCUMENT\_ROOT'] is a superglobal variable set to be the root folder of your site. (Note that there is no trailing "/"; you must provide a leading "/" in '/page.php'.) - -If you want to include static content from another one of your Web sites, such as `include('http://myothersite.com/includes/footer.php')`, make a copy of that content in the current site and then include it locally. - -Note that if you must include content from a remote site using URLs and need to set allow\_url\_fopen = On, look for alternative ways to gain some protection from RFI attacks. - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample3.cmd)] - -These settings specify that all errors and warnings get logged to your error log text file and specify that none of the errors or warnings get displayed on any Web page that is sent out from your server. Errors should not be displayed publicly because they can help someone figure out how to attack your server. Always check your error log when you are testing new code. - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample4.cmd)] - -This defines the path and fie to which your PHP errors and warnings are logged. You should use a text file for error logging, but note that the text file will accumulate errors indefinitely until you empty it. Keep the error log file in an area of your Web site that is not publicly accessible. - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample5.cmd)] - -With this setting, the headers that accompany outgoing pages do not reveal that PHP is running or its version. - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample6.cmd)] - -For example, for the URL `http://site.com/index.php?variable=***value***`, the variable passes into your script with its value set to ***value*** when register\_globals is "On." When register\_globals is "Off," however, variables do not automatically pass into your script's variable list. This makes it much more difficult for an attacker to inject code into your script. - -[!code-console[Main](secure-php-with-configuration-settings/samples/sample7.cmd)] - -This setting is not in the "recommended Php.ini" file. It restricts the permissions with which PHP scripts run. Some third-party scripts do not run properly when safe\_mode is set to "On." Note that beginning with PHP 6 safe\_mode does not exist. - -## View the PHP Settings - -You can get a complete report of all your PHP settings. - -1. Create a text file with a **.php** extension: - - [!code-xml[Main](secure-php-with-configuration-settings/samples/sample8.xml)] -2. Upload it to your server into (preferably) a password-protected folder. -3. Open your Web browser, and type the *path* into the address bar: - - [!code-console[Main](secure-php-with-configuration-settings/samples/sample9.cmd)] -4. Enter your *user name* and *password* to access the protected folder and view the result page. -5. Save or print the result page to your local computer for reference. -6. Delete the **.php** file from your server. - -## See also - -- [How to change configuration settings](http://ie.php.net/configuration.changes). -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md#PHP_Security_Recommendations_). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample1.cmd deleted file mode 100644 index 0cc901e6a..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -allow_url_fopen = Off \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample2.cmd deleted file mode 100644 index 55e1372e5..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -include($_SERVER['DOCUMENT_ROOT'] . '/page.php'); \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample3.cmd deleted file mode 100644 index e9a7a3620..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample3.cmd +++ /dev/null @@ -1,4 +0,0 @@ -DISPLAY_ERRORS =Off -display_startup_errors = Off -log_errors = On -error_reporting = E_ALL \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample4.cmd deleted file mode 100644 index 60d8a95a8..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -error_log = /home/yourUserID/public_html/phperr.txt \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample5.cmd deleted file mode 100644 index 1bcbd7a5b..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -expose_php = Off \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample6.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample6.cmd deleted file mode 100644 index 1c70d0cfc..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample6.cmd +++ /dev/null @@ -1 +0,0 @@ -register_globals = Off \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample7.cmd deleted file mode 100644 index a03c0ba66..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ -safe_mode = Off \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample8.xml b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample8.xml deleted file mode 100644 index c9f5eeb12..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample8.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample9.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample9.cmd deleted file mode 100644 index e4ae3ec3b..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-php-with-configuration-settings/samples/sample9.cmd +++ /dev/null @@ -1 +0,0 @@ -http://yoursite.com/whatever/filename.php \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-infrastructure-and-php-applications.md b/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-infrastructure-and-php-applications.md deleted file mode 100644 index 0c7f03e85..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-infrastructure-and-php-applications.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Secure Your Infrastructure and PHP Applications -author: rick-anderson -description: Describes how to secure your infrastructure and PHP applications hosted on IIS through a variety of methods. -ms.date: 11/15/2009 -ms.assetid: 3a346c3c-f9cc-49a5-9768-8ddd497935bb -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/secure-your-infrastructure-and-php-applications -msc.type: authoredcontent ---- -# Secure Your Infrastructure and PHP Applications - -by Tali Smith - -Security is always a consideration; it is critical to make careful security considerations when you implement and maintain your Web sites, infrastructure, and PHP applications. Internet Information Services 7 (IIS 7) and above offers many ways to [configure security](../../manage/configuring-security/index.md), including [dynamic IP restrictions](../../manage/configuring-security/using-dynamic-ip-restrictions.md), [application pool identities](../../manage/configuring-security/application-pool-identities.md), and [Secure Sockets Layer (SSL)](../../manage/configuring-security/how-to-set-up-ssl-on-iis.md). - -The following techniques are some additional ways to secure PHP on IIS. - -## Secure File Access - -You can secure your IIS sites through access control list (ACL)–based security measures: - -- Structure your Web application folders in a logical manner. Create new directories for each file type, setting ACLs on each directory, and let the files inherit the ACLs. Managing and maintaining a Web application with individual ACLs for each file in the system is more difficult. For greater control, isolate separate folders that might need read-write access from anonymous users. -- By default, ACLs on the FTP and SMTP directories (`C:\inetpub\ftproot` and `C:\inetpub\mailroot`, respectively) are set at Everyone (Full Control); consider modifying these ACLs with tighter security. To save space on your IIS volume, place the FTP and SMTP folders on a different volume than the IIS server if you want to support Everyone (Write). Alternately, use Windows® 2000 disk quotas to limit the amount of data you can write to the FTP and SMTP folders. -- Mark the ACLs on the IIS-generated log files (`%systemroot%\system32\logfiles`) Administrators (Full Control), System (Full Control), Everyone (Read-Write Control); this helps prevent intruders from deleting information to cover their tracks. -- Disable or remove all IIS-installed sample Web applications. (Sample sites to help developers learn are not installed by default.) Never install sample sites on a production server because of the many well-identified security risks they present. Though some sample Web applications are installed so that you can access them only from `http://localhost` or IP address 127.0.0.1, remove them. For example, the IISSamples, IISHelp, and Data Access virtual directories and their associated folders are sample sites that should not reside on production servers. - -See [Secure Content in IIS Through File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md) for more information. - -## Use Per-Site PHP Configuration - -The FastCGI handler makes it possible to use a different Php.ini file for every application mapping. You can customize your PHP configuration around the specific requirements of your users or your PHP applications, letting you tighten configuration. - -## Separate IIS User Accounts and Application Pools - -Segregate users and PHP applications by using different user accounts and application pools; this helps keep users and PHP applications from interfering with each other. Keeping user accounts and application pools separate also helps isolate PHP crashes to the specific user or application that caused the issue. - -## Limit NTFS Permissions - -Consider using the NTFS Deny permission to restrict access for your IIS users; configure your IIS user account so that it only has permissions to the files and directories it needs to access, and everything else is set to Deny. If you have also separated IIS user accounts and application pools, you can make it nearly impossible for one user or application to access files of another user or application like the **safe\_mode** PHP directive used by many UNIX-based Web hosts. Note that it is more common to exclude the user or group from the ACL instead of configuring them to have explicit Deny permissions. It is best to plan your permission structure very carefully and make a backup of your system state. - -## Use URL Rewriting - -You can improve security with URL rewriting. To avoid the possibility of session hijacking or fixation, keep the session ID in a cookie instead of rewriting the session ID into the URL, and add a second unique token into the URL. Associate this new token value with the session ID, and store it in server session state. Whenever the user makes a request back to the server, the request must include the matching second token or the server considers the request a forgery. For more information, see [Improving Security with URL Rewriting](https://www.microsoft.com/security/blog/2009/04/09/improving-security-with-url-rewriting/). - -## Modify Configuration Settings - -You can configure PHP settings to tighten the security of a PHP installation and help protect the Web site from malicious attacks. The Php.ini file specifies the configuration settings PHP uses when it is running on your Web site. The Php.ini file determines what the PHP scripts are allowed to do and what the scripts are prohibited from doing. - -- Enable only the PHP extensions that your applications are going to use. Some PHP directives, such as register\_globals and allow\_url\_fopen, can pose security risks and should be disabled, if possible. Also, ensure the expose\_php directive is off so that PHP does not expose that it is installed on your server. -- Customize your PHP configuration so that only the functions and classes used by your application are enabled. Use the disable\_functions and disable\_classes PHP directives to supply a list of comma-separated functions and classes that you want to disable. -- Limit the **max\_execution\_time**, **max\_input\_time**, **memory\_limit**, **post\_max\_size** and **upload\_max\_filesize** to only what you need and what your server can handle. - -## Restrict HTTP Verbs and Use Request Filtering - -Consider restricting which HTTP verbs can be used by enabling only the verbs needed when configuring your PHP application mapping in IIS. For most PHP applications, you only need to enable GET, HEAD, and POST. You can use URLScan v3.1, a security tool that restricts the types of HTTP requests processed by IIS. By blocking specific HTTP requests, URLScan helps prevent potentially harmful requests from being processed by Web applications on the server. URLScan v3.1 can scan query strings and can customize rules to scan parts of your HTTP requests. URLScan v3.1 is installed as an Internet Server Application Programming Interface (ISAPI) filter on IIS. See [Using URLScan](../../extensions/working-with-urlscan/index.md) for more information. - -All the core features of URLScan into the Request Filtering module, which also includes a Hidden Segments feature which lets you define which segments are "servable." The Request Filtering module inspects known malicious patterns in the requests and prevents such requests from being serviced if the module determines that the requests may be harmful. For example, this module lets you filter requests that are double escaped, filter requests that use certain HTTP verbs, or block requests to specific folders. You can enforce tighter security policies on your Web servers with the Request Filtering module. You can also [configure WebDAV with request filtering](../../publish/using-webdav/how-to-configure-webdav-with-request-filtering.md). - -## Links for Further Information - -- [Secure Content Publishing](https://www.iis.net/overview/security/securecontentpublishing). diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database.md b/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database.md deleted file mode 100644 index d27b4d3bd..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: "Secure Your SQL Server Database" -author: rick-anderson -description: "If you use Microsoft ® SQL Server ® as your database, you must create and implement an effective security plan. There is a wealth of information about how to..." -ms.date: 11/15/2009 -ms.assetid: 58dc712c-8707-4c10-a48c-58d4df35ae6f -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database -msc.type: authoredcontent ---- -# Secure Your SQL Server Database - -by Tali Smith - -## Introduction - -If you use Microsoft® SQL Server® as your database, you must create and implement an effective security plan. There is a wealth of information about how to secure a SQL Server database; this article touches on a few areas of particular interest to Web hosters and provides links for further information. - -Securing SQL Server can be viewed as a series of steps involving four areas: the platform, authentication, objects (including data), and applications that access the system. - -## Platform and Network Security - -The platform for SQL Server includes the physical hardware and networking systems connecting clients to the database servers and the binary files that are used to process database requests. - -### Physical Security - -Best practices for physical security strictly limit access to the physical server and hardware components. For example, use locked rooms with restricted access for the database server hardware and networking devices. In addition, limit access to backup media by storing it at a secure off-site location. - -Implementing physical network security starts with keeping unauthorized users off the network. The following table contains more information about networking security information. - -| **For information about** | **See** | -| --- | --- | -| Networking and SQL Server | [Network Protocols and Tabular Data Stream (TDS) Endpoints](https://msdn.microsoft.com/library/ms191220.aspx) | -| Specifying and restricting ports that are used for SQL Server | [Configuring Server Network Protocols and Net-Libraries](https://msdn.microsoft.com/library/ms177485.aspx) | -| Restricting network access to SQL Server | [Restricting Network Access](https://msdn.microsoft.com/library/ms174507.aspx) | -| Microsoft® SQL Server® Compact 3.5 Service Pack 1 (SP1) and network access to other SQL Server editions | [Configuring and Securing the Server Environment in SQL Server Compact 3.5 SP1 Books Online](https://www.microsoft.com/downloads/details.aspx?FamilyId=07829770-73A7-41E4-880D-E74B1A353623&displaylang=en) | -| Backup and restore strategies | [Security Considerations for Backup and Restore (SQL Server)](https://msdn.microsoft.com/library/ms190964.aspx) | - -### System Security - -Operating system service packs and upgrades include important security enhancements. Apply all updates and upgrades to the operating system after you test them with the database applications. - -Firewalls also provide effective ways to implement security. Logically, a firewall is a separator or restrictor of network traffic, which can be configured to enforce your organization's data security policy. If you use a firewall, you increase security at the operating system level by providing a chokepoint where your security measures can be focused. - -The following table contains more information about how to use a firewall with SQL Server. - -| **For information about** | **See** | -| --- | --- | -| Configuring a firewall to work with SQL Server | [How to: Configure a Windows® Firewall for Database Engine Access](https://msdn.microsoft.com/library/ms175043.aspx) | -| Configuring a firewall to work with Microsoft® SQL Server® Integration Services | [Configuring a Windows Firewall for Integration Services Access](https://msdn.microsoft.com/library/ms137861.aspx) | -| Configuring a firewall to work with Microsoft® SQL Server® Analysis Services | [How to: Configure Windows Firewall for Analysis Services Access](https://msdn.microsoft.com/library/ms174937.aspx) | -| Configuring a firewall to work with Microsoft® SQL Server® Reporting Services | [Server Deployment Checklist](https://msdn.microsoft.com/library/ms159689.aspx) | -| Opening specific ports on a firewall to enable access to SQL Server | [Opening Ports in the Firewall](https://msdn.microsoft.com/library/ms345310.aspx) | - -Surface-area reduction is a security measure that involves stopping or disabling unused components. Surface-area reduction helps improve security by providing fewer avenues for potential attacks on a system. The key to limiting the surface area of SQL Server includes running required services that have "least privilege" by granting services and users only the appropriate rights. - -The following table contains more information about services and system access. - -| **For information about** | **See** | -| --- | --- | -| Services required for SQL Server | [Setting Up Windows® Service Accounts](https://msdn.microsoft.com/library/ms143504.aspx) | -| Restricting server logon access | [Restricting Interactive Logon Access](https://msdn.microsoft.com/library/ms175588.aspx) | -| Local administration rights | [Granting Local Administrative Rights](https://msdn.microsoft.com/library/ms174494.aspx) | - -For Internet Information Services (IIS), additional steps are required to help secure the surface of the platform. - -The following table contains information about SQL Server and Internet Information Services. - -| **For information about** | **See** | -| --- | --- | -| IIS security with SQL Server Compact 3.5 SP1 | [IIS Security in SQL Server Compact 3.5 SP1 Books Online](https://technet.microsoft.com/library/bb283235.aspx) | -| Using Web services in SQL Server and IIS | [Best Practices for Using Native XML Web Services](https://msdn.microsoft.com/library/ms190399.aspx) | -| Report servers and Internet access | [Planning for Extranet or Internet Deployment](https://msdn.microsoft.com/library/ms159272.aspx) | -| Setting up forms security on a report server | [Readme\_Security Extension Sample](https://msdn.microsoft.com/library/ms160724.aspx) | -| Reporting Services Authentication | [Authentication in Reporting Services](https://msdn.microsoft.com/library/ms152899.aspx) | -| SQL Server Compact 3.5 SP1 and IIS access | [Internet Information Services Security Flowchart in SQL Server Compact 3.5 SP1 Books Online](https://technet.microsoft.com/library/ms172389.aspx) | - -### SQL Server Operating System Files Security - -SQL Server uses operating system files for operation and data storage. Best practices for file security require that you restrict access to these files. - -The following table contains information about these files. - -| **For information about** | **See** | -| --- | --- | -| SQL Server program files | [File Locations for Default and Named Instances of SQL Server](https://msdn.microsoft.com/library/ms143547.aspx) | -| Database file security | [Securing Data and Log Files](https://msdn.microsoft.com/library/ms189128.aspx) | -| Analysis Services file security | [Securing Program Files, Common Components, and Data Files](https://msdn.microsoft.com/library/ms174838.aspx) | - -SQL Server service packs and upgrades provide enhanced security. To determine the latest available service pack available for SQL Server, see the [SQL Server](https://go.microsoft.com/fwlink/?LinkID=31629) Web site. - -You can use the following script to determine the service pack installed on the system. - -[!code-sql[Main](secure-your-sql-server-database/samples/sample1.sql)] - -## Principals and Database Object Security - -Principals are the individuals, groups, and processes granted access to SQL Server. "Securables" are the server, database, and objects the database contains. Each has a set of permissions that can be configured to help reduce the SQL Server surface area. - -The following table contains information about principals and securables. - -| **For information about** | **See** | -| --- | --- | -| Server and database users, roles, and processes | [Principals (Database Engine)](https://msdn.microsoft.com/library/ms181127.aspx) | -| Server and database objects security | [Securable](https://msdn.microsoft.com/library/ms190401.aspx) | -| The SQL Server security hierarchy | [Permissions Hierarchy (Database Engine)](https://msdn.microsoft.com/library/ms191465.aspx) | - -For more information about database and application security, see [Identity and Access Control (Database Engine)](https://msdn.microsoft.com/library/bb510418.aspx). - -### Encryption and Certificates - -Encryption does not solve access control problems. However, encryption enhances security by limiting data loss even in the rare occurrence that access controls are bypassed. For example, if the database host computer is misconfigured and a malicious user obtains sensitive data, such as credit card numbers, that stolen information might be useless if it is encrypted. - -The following table contains more information about encryption in SQL Server. - -| **For information about** | **See** | -| --- | --- | -| The encryption hierarchy in SQL Server | [Encryption Hierarchy](https://msdn.microsoft.com/library/ms189586.aspx) | -| Encrypting SQL Server connections | [Encrypting Connections to SQL Server](https://msdn.microsoft.com/library/ms189067.aspx) | -| Implementing secure connections | [How to: Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager)](https://msdn.microsoft.com/library/ms191192.aspx) | -| Encryption functions | [Cryptographic Functions (Transact-SQL)](https://msdn.microsoft.com/library/ms173744.aspx) | -| Implementing encryption | [Encryption How-to Topics](https://msdn.microsoft.com/library/aa337557.aspx) | -| Setting up Analysis Services for data encryption | [Requiring Data Encryption](https://msdn.microsoft.com/library/ms175415.aspx) | - -Certificates are software "keys" shared between two servers that enable secure communications by way of strong authentication. You can create and use certificates in SQL Server to enhance object and connection security. - -The following table contains information about how to use certificates with SQL Server. - -| **For information about** | **See** | -| --- | --- | -| Using a certificate for secure connections | [Configuring Certificate for Use by SSL](https://msdn.microsoft.com/library/ms186362.aspx) | -| Creating a certificate for use by SQL Server | [CREATE CERTIFICATE (Transact-SQL)](https://msdn.microsoft.com/library/ms187798.aspx) | -| Using a certificate with SQL Server Service Broker | [Certificates and Service Broker](https://msdn.microsoft.com/library/ms166096.aspx) | -| Using a certificate with database mirroring | [Using Certificates for Database Mirroring](https://msdn.microsoft.com/library/ms191477.aspx) | - -## Application Security - -SQL Server security best practices include writing secure client applications. For more information about server access and SQL Server client applications, see [Developer's Guide (Database Engine)](/sql/relational-databases/database-engine-tutorials?view=sql-server-ver16&preserve-view=true). - -For more information about how to help secure client applications at the networking layer, see [Client Network Configuration](https://msdn.microsoft.com/library/ms190611.aspx). - -For more information about how to write applications that use native XML services, see [Writing Client Applications](https://msdn.microsoft.com/library/ms190173.aspx). - -## SQL Server Security Tools, Utilities, Views, and Functions - -SQL Server provides tools, utilities, views, and functions that can be used to configure and administer security. - -### SQL Server Security Tools and Utilities - -The following table contains information about SQL Server tools and utilities that you can use to configure and administer security. - -| **For information about** | **See** | -| --- | --- | -| Connecting to, configuring, and controlling SQL Server | [Introducing SQL Server Management Studio](https://msdn.microsoft.com/library/ms174173.aspx) | -| Connecting to SQL Server and running queries at the command prompt | [sqlcmd Utility](https://msdn.microsoft.com/library/ms162773.aspx) | -| Network configuration and control for SQL Server | [SQL Server Configuration Manager](https://msdn.microsoft.com/library/ms174212.aspx) | -| Enabling and disabling features by using policy-based management | [Administering Servers by Using Policy-Based Management](https://msdn.microsoft.com/library/bb510667.aspx) | -| Manipulating symmetric keys for a report server | [rskeymgmt Utility](https://msdn.microsoft.com/library/ms162822.aspx) | - -### SQL Server Security Catalog Views and Functions - -The Database Engine exposes security information in several views and functions that are optimized for performance and utility. - -The following table contains information about security views and functions. - -| **For information about** | **See** | -| --- | --- | -| SQL Server security catalog views, which return information about database-level and server-level permissions, principals, roles, and so on. In addition, there are catalog views that provide information about encryption keys, certificates, and credentials. | [Security Catalog Views (Transact-SQL)](https://msdn.microsoft.com/library/ms178542.aspx) | -| SQL Server security functions, which return information about the current user, permissions, and schemas | [Security Functions (Transact-SQL)](https://msdn.microsoft.com/library/ms186236.aspx) | -| SQL Server security dynamic management views | [Security-Related Dynamic Management Views and Functions (Transact-SQL)](https://msdn.microsoft.com/library/bb677257.aspx) | - -## Links for Further Information - -- [Securing SQL Server](https://msdn.microsoft.com/library/bb283235.aspx) -- [Security Considerations for a SQL Server Installation](https://msdn.microsoft.com/library/ms144228.aspx) -- [Secure Deployment (Database Engine)](https://msdn.microsoft.com/library/bb522545.aspx) -- [Security and Protection (Database Engine)](https://msdn.microsoft.com/library/bb510589.aspx) -- [Security Enhancements in Microsoft SQL Server 2008 video](https://mediadl.microsoft.com/mediadl/IISNET/Media/Security%20Enhancements%20in%20Microsoft%20SQL%20Server%202008.wmv) -- [SQL Server 2008 for Hosters](../../web-hosting/configuring-servers-in-the-windows-web-platform/sql-2008-for-hosters.md) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database/samples/sample1.sql b/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database/samples/sample1.sql deleted file mode 100644 index cdbbde2b4..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/secure-your-sql-server-database/samples/sample1.sql +++ /dev/null @@ -1,2 +0,0 @@ -SELECT CONVERT(char(20), SERVERPROPERTY('productlevel')); -GO \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md deleted file mode 100644 index 5c7b87fb5..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "Setting Up a Database for a PHP Application on IIS" -author: rick-anderson -description: "SQL Server is a database built and supported by Microsoft. Many PHP applications support SQL Server as their back end data repository. These instructions ass..." -ms.date: 01/14/2008 -ms.assetid: e307bd5a-a9da-4b89-ab4f-2e18acab3d55 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis -msc.type: authoredcontent ---- -# Setting Up a Database for a PHP Application on IIS - -by Eric Woersching - -## Set Up a SQL Server Database from Microsoft SQL Server Management Studio Express - -SQL Server is a database built and supported by Microsoft. Many PHP applications support SQL Server as their back end data repository. These instructions assume that you already have SQL Server installed and running. For this walkthrough, we used SQL Server® 2005. You can also use MySQL, SQL Server® Express or others. - -Before starting the install, create a database on your database server. Also create a user and grant this user ownership permission to the database. If you are using SQL Server 2005, then open Microsoft SQL Server Management Studio and click "New Query" button. Enter the following script into the query window (this script creates the database and user). - -[!code-sql[Main](setting-up-a-database-for-a-php-application-on-iis/samples/sample1.sql)] - -In addition, grant the newly created user the db\_owner permissions to my\_DB database: - -[![Screenshot shows the Database User dialog box for my_D B user, with d b_owner selected as a Role Member.](setting-up-a-database-for-a-php-application-on-iis/_static/image3.jpg)](setting-up-a-database-for-a-php-application-on-iis/_static/image1.jpg) - -## Setup a MySQL Database from the Command Line - -MySQL is a popular database supported by most PHP applications as their back end data repository. These instructions assume that you already have MySQL installed and running. - -Before starting the installation procedure for your PHP application, create a database on your server. Also create a database user and grant this user ownership permission to the database. First, log on to your MySQL server with a command similar to the following (you must log on with an account with admin privileges; in our case 'root'): - -[!code-console[Main](setting-up-a-database-for-a-php-application-on-iis/samples/sample2.cmd)] - -You then must provide the password to your root or admin account on the MySQL server. - -Next, create a database for the your application at the MySQL prompt after logging in: - -[!code-console[Main](setting-up-a-database-for-a-php-application-on-iis/samples/sample3.cmd)] - -To create the database, download the MySql GUI-Tools from: . Then you can create the database using a simple `create database cslh` command using the MySQL Query Browser. - -Next, create the account that will be used with your PHP application to access this particular database: - -[!code-console[Main](setting-up-a-database-for-a-php-application-on-iis/samples/sample4.cmd)] - -This command creates the account, sets the password, and sets the privileges all in one line: - -- `GRANT ALL PRIVILEGES ON my_DB.*` - This statement says to allow all privileges for the account but only for the 'my\_DB' database and all of its tables. -- `TO 'my_DBuser'@'%'` - This statement specifies the account name and which machines can login with this account. In this case, 'my\_DBuser' is the name of the account that will be created and '%' means that you can login to the account from anywhere. If '%' was replaced with localhost or a specific IP address you could only login to the database from that location. -- `IDENTIFIED BY 'my_DBpass';` - This statement sets the password for the account to 'my\_DBpass' and ends the entire command with a semi-colon. - -> [!NOTE] -> Refer to the MySQL documentation for more complete information on managing user accounts and privileges. diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image1.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image1.jpg deleted file mode 100644 index 463b7fe07..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image2.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image2.jpg deleted file mode 100644 index 463b7fe07..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image3.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image3.jpg deleted file mode 100644 index 463b7fe07..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image4.jpg b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image4.jpg deleted file mode 100644 index 463b7fe07..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample1.sql b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample1.sql deleted file mode 100644 index 4e1438049..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample1.sql +++ /dev/null @@ -1,17 +0,0 @@ -USE [master] -GO - -CREATE DATABASE my_DB -GO - -CREATE LOGIN [my_DBuser] -WITH PASSWORD=N'pass@word1', - DEFAULT_DATABASE=[my_DB], - CHECK_EXPIRATION=OFF, - CHECK_POLICY=OFF -GO - -USE [my_DB] -GO - -CREATE USER [my_DBuser] FOR LOGIN [my_DBuser] WITH DEFAULT_SCHEMA=[dbo] \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample2.cmd deleted file mode 100644 index ef56c5509..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -c:\> mysql -u root -p \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample3.cmd deleted file mode 100644 index acfaa6fbe..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -mysql>CREATE DATABASE my_DB; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample4.cmd deleted file mode 100644 index 8ff92ff9e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -mysql> GRANT ALL PRIVILEGES ON my_DB.* TO 'my_DBuser'@'%' IDENTIFIED BY 'my_DBpass'; \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php.md deleted file mode 100644 index bcd0f64c3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php.md +++ /dev/null @@ -1,188 +0,0 @@ ---- -title: "Use the Windows Cache Extension for PHP" -author: ruslany -description: "Introduction The Windows Cache Extension for PHP is a PHP accelerator that is used to significantly increase the speed of PHP applications running on the Win..." -ms.date: 09/01/2009 -ms.assetid: 22a3d794-4052-4af9-ac04-43130bac2f35 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php -msc.type: authoredcontent ---- -# Use the Windows Cache Extension for PHP - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Introduction - -The Windows Cache Extension for PHP is a PHP accelerator that is used to significantly increase the speed of PHP applications running on the Windows® operating system. Any PHP application can take advantage of the functionality provided by the Windows Cache Extension for PHP without any code modifications. All that is required is that the extension is enabled and loaded by the PHP engine. - -The Windows Cache Extension includes three different types of caches: - -- **PHP Opcode Cache** - PHP is a script processing engine that reads an input stream of data that contains text and/or PHP instructions and produces another stream of data, most commonly in the HTML format. This means that on a Web server, the PHP engine reads, parses, compiles, and executes a PHP script each time that it is requested by a Web client. The reading, parsing, and compilation operations put additional load on the Web server's CPU and file system and thus affect the overall performance of a PHP Web application. The PHP bytecode (opcode) cache is used to store the compiled script bytecode in shared memory so that it can be reused by the PHP engine for subsequent executions of the same script. -- **File Cache** - Even with the PHP bytecode cache enabled, the PHP engine has to accesses the script files on a file system. When PHP scripts are stored on a remote universal naming convention (UNC) file share, the file operations introduce a significant performance overhead. The Windows Cache Extension for PHP includes a file cache that is used to store the content of the PHP script files in shared memory, which reduces the amount of file system operations performed by PHP engine. -- **Relative File Path Cache** - PHP scripts very often include or operate with files by using relative file paths. Every relative file path has to be converted to an absolute file path by the PHP engine. When a PHP application uses many PHP files and accesses them by relative paths, the operation of resolving relative paths to absolute paths may have a negative impact on the application's performance. The Windows Cache Extension for PHP provides a relative file path cache, which is used to store the mappings between relative and absolute file paths, thereby reducing the number of relative path resolutions that the PHP engine has to perform. - -## Install the Windows Cache Extension for PHP - -There are two packages for the extension: one package is for PHP versions 5.2.X, and the other package is for PHP 5.3.X. Make sure that you use the appropriate package for your version of PHP. - -The extension packages can be found at: - -[Windows Cache Extension 1.0 for PHP 5.2](https://www.microsoft.com/downloads/details.aspx?FamilyID=6feb7f6a-7dcb-4083-bb7a-d8b22ba2d3d8&displaylang=en) - -[Windows Cache Extension 1.0 for PHP 5.3](https://www.microsoft.com/downloads/details.aspx?FamilyID=ba2e0d7a-02ce-42be-a7a3-2baa5d666bf7&displaylang=en) - -1. Unpack the package that is appropriate for the PHP version you are using. -2. Copy the **Php\_wincache.dll** file into the PHP extensions folder. Typically this folder is called "ext" and it is located in the same folder with all PHP binary files. For example: - - [!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample1.cmd)] -3. Using a text editor, open the **Php.ini** file, which is usually located in the same folder where all PHP binary files are. For example: - - [!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample2.cmd)] -4. Add the following line at the end of the **Php.ini** file: - - [!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample3.cmd)] -5. Save and close the Php.ini file. -6. Recycle your Internet Information Services (IIS) application pools for PHP to pick up the configuration changes. -7. To check that the extension has been enabled, create a file called **phpinfo.php** with the following PHP code that calls phpinfo() function: - - [!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample4.cmd)] -8. Save the Phpinfo.php file in the root folder of an IIS Web site that uses PHP. -9. Open a browser and make a request to `http://yoursitename/phpinfo.php`. -10. Search within the returned Web page for a section called "wincache". If the extension is enabled, then you should see the configuration settings provided by the Windows Cache Extension for PHP. - -> [!IMPORTANT] -> Do not forget to remove the **Phpinfo.php** file from the Web site's root folder after you have confirmed that extension has been enabled. - -## Compatibility Notes - -The extension is supported only on the following configurations: - -Windows operating system: - -- Windows® XP Service Pack 3 (SP3) with IIS 5.1 and FastCGI Extension -- Windows Server® 2003 with IIS 6.0 and FastCGI Extension -- Windows Vista® SP1 with IIS 7.0 and FastCGI Module -- Windows Server® 2008 with IIS 7.0 and FastCGI Module -- Windows® 7 with IIS 7 and FastCGI Module -- Windows Server® 2008 R2 with IIS 7.0 and FastCGI Module - -PHP: - -- PHP 5.2.X, Non-thread-safe build -- PHP 5.3 X86, Non-thread-safe VC9 build - -> [!IMPORTANT] -> The Windows Cache Extension can only be used when IIS is configured to run PHP via FastCGI. - -## Configuration Settings - -The following table lists and describes the configuration settings provided by the Windows Cache Extension for PHP: - -### Table 1 : Configuration Settings - -| **Setting** | **Default** | **Minimum** | **Maximum** | **Changeable** | **Description** | -| --- | --- | --- | --- | --- | --- | -| wincache.fcenabled | 1 (On) | 0 (Off) | 1 (On) | PHP\_INI\_ALL | Enables or disables the file cache functionality. | -| wincache.fcachesize | 24 | 5 | 85 | PHP\_INI\_SYSTEM | Defines the maximum memory size (in megabytes) that is allocated for the file cache. If the total size of all the cached files exceeds the value specified in this setting, then most stale files will be removed from the file cache. | -| wincache.maxfilesize | 256 | 10 | 2048 | PHP\_INI\_SYSTEM | Defines the maximum allowed size (in kilobytes) for a single file to be cached. If a file size exceeds the specified value, the file will not be cached. This setting applies to the file cache only. | -| wincache.ocenabled | 1 (On) | 0 (Off) | 1 (On) | PHP\_INI\_ALL | Enables or disables the opcode cache functionality | -| wincache.ocachesize | 96 | 15 | 255 | PHP\_INI\_SYSTEM | Defines the maximum memory size (in megabytes) that is allocated for the opcode cache. If the cached opcode size exceeds the specified value, then most stale opcode will be removed from the cache. Note that the opcode cache size must be at least 3 times bigger than file cache size. If that is not the case the opcode cache size will be automatically increased. | -| wincache.filecount | 4096 | 1024 | 16384 | PHP\_INI\_SYSTEM | Defines how many files are expected to be cached by the extension, so that appropriate memory size is allocated at the startup time. If the number of files exceeds the specified value, the Windows Cache Extension for PHP will re-allocate more memory as needed. | -| wincache.chkinterval | 30 | 2 | 300 | PHP\_INI\_SYSTEM | Defines how often (in seconds) the Windows Cache Extension for PHP checks for file changes in order to refresh the cache. | -| wincache.ttlmax | 1200 | 60 | 7200 | PHP\_INI\_SYSTEM | Defines the maximum time to live (in seconds) for a cached entry without being used. | -| wincache.ignorelist | no value | no value | no value | PHP\_INI\_ALL | Defines a list of files that should not be cached by the Windows Cache Extension for PHP. The files list is specified by using file names only, separated by the pipe symbol - "|". For example: `wincache.ignorelist = "index.php|misc.php|admin.php"` | -| wincache.namesalt | no value | no value | no value | PHP\_INI\_SYSTEM | Defines a string that will be used when naming the cached objects that are stored in shared memory. This is used to avoid conflicts that may be caused if other applications within an IIS worker process try to access shared memory. | - -## Configure FastCGI for Optimal Performance - -The FastCGI module in IIS has a configuration setting [maxInstances](../../configuration/system.webServer/fastCgi/application/index.md) that controls the number of concurrently running Php-cgi.exe processes that IIS creates to process PHP requests. To achieve optimal performance, it is recommended that you fine tune this setting for your specific environment, starting with 8–10 instances per CPU core (for example, maxInstances=32 for a quad-core CPU). - -The Windows Cache Extension for PHP caches the compiled PHP opcode in the shared memory, which helps to avoid redoing of such CPU intensive operations as parsing and compiling of the PHP source code. This means that when Windows Cache Extension for PHP is enabled, fewer CPU cycles are required for a Web server to process PHP requests. Because of that, the previously configured value for the FastCGI maxInstances setting may not be adequate to load the server's CPU completely, and it may be necessary to increase the value further. - -To increase the maxInstances value on IIS 7, run this command from an elevated command prompt: - -[!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample5.cmd)] - -> [!NOTE] -> Replace the fullPath with the path to **Php-cgi.exe** on your server. - -Alternatively, you can edit the `` section of the **ApplicationHost.config** file located at `C:\Windows\System32\inetsrv\config\` folder: - -[!code-xml[Main](use-the-windows-cache-extension-for-php/samples/sample6.xml)] - -To increase the maxInstances value on IIS 5.1 and IIS 6.0 run this command: - -[!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample7.cmd)] - -> [!NOTE] -> Replace the section name if necessary. - -Alternatively, you can edit the **Fcgiext.ini** file located at `C:\Windows\System32\inetsrv\` folder: - -[!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample8.cmd)] - -When you measure the performance of the Windows Cache Extension for PHP, make sure to monitor the CPU usage. If you see that the CPU is not fully utilized, try increasing the FastCGI maxInstances setting to get better performance. - -## Extension Functions - -The Windows Cache Extension for PHP provides several functions that can be called from a PHP script to return extension-specific information about the cache internals. These functions are listed below: - -### Table 2: Extension Functions - -| **Function Name** | **Description** | **Return Values** | -| --- | --- | --- | -| array wincache\_fcache\_fileinfo() | Retrieves information about files cached in the file cache | An array of cached files and metadata or FALSE on failure | -| array wincache\_fcache\_meminfo() | Retrieves information about file cache memory usage | An array of data about memory usage or FALSE on failure | -| array wincache\_ocache\_fileinfo() | Retrieves information about files cached in the opcode cache | An array of cached files and metadata or FALSE on failure | -| array wincache\_ocache\_meminfo() | Retrieves information about memory usage by the opcode cache | An array of data about memory usage or FALSE on failure | -| array wincache\_rplist\_fileinfo() | Retrieves information about cached mappings between relative file paths and corresponding absolute file paths | An array of cached relative file paths or FALSE on failure | -| array wincache\_rplist\_meminfo() | Retrieves information about memory usage by the relative file path cache | An array of data about memory usage or FALSE on failure | -| array wincache\_refresh\_if\_changed() | Refreshes the cache entries for the files, whose names were passed in the input argument. If no argument is specified then refreshes all the entries in the cache | Returns TRUE on success or FALSE on failure | - -## Example: Obtain Cache Information - -To retrieve information about entries in the file cache, use the following code: - -[!code-xml[Main](use-the-windows-cache-extension-for-php/samples/sample9.xml)] - -This will produce output similar to the following: - -[!code-csharp[Main](use-the-windows-cache-extension-for-php/samples/sample10.cs)] - -## Example: Refresh a Cache Entry - -Windows Cache Extension for PHP performs regular checks on the cached files to ensure that if any file has changed, then the corresponding entry in the cache is updated. By default, this check is performed every 30 seconds. For example, suppose you have a PHP script that updates another PHP script that stores application configuration settings. After the new configuration settings have been saved to a file, the application might still use the old settings until the cache is refreshed. It would be preferable to refresh the cache right after the file has been changed. - -The following example shows how you can refresh a cache entry: - -[!code-xml[Main](use-the-windows-cache-extension-for-php/samples/sample11.xml)] - -## Use the Windows Cache Extension for PHP Statistics Script - -The installation package for Windows Cache Extension 1.0 for PHP includes a PHP script, **wincache.php**, that can be used to obtain cache information and statistics. - -![Screenshot that shows Windows Cache Extension statistics.](use-the-windows-cache-extension-for-php/_static/image1.png) - -If the Windows Cache Extension for PHP was installed via Web Platform Installer, then this script is located in `%SystemDrive%\Program Files\IIS\Windows Cache for PHP\`. On a 64-bit version of the Windows Server operating system, the script is located in `%SystemDrive%\Program Files (x86)\IIS\Windows Cache` for PHP. If the extension was installed manually, then the **Wincache.php** will be located in the same folder from which the content of the installation package was extracted. - -To use **Wincache.php**, copy it into a root folder of your Web site or into any subfolder. To protect the script, open it in any text editor and change the values for the USERNAME and PASSWORD constants. If any other IIS authentication is enabled on the server then follow the instructions in the comments: - -[!code-console[Main](use-the-windows-cache-extension-for-php/samples/sample12.cmd)] - -> [!IMPORTANT] -> Always protect the **wincache.php** script by using either the built-in authentication or the server's authentication mechanism. Leaving this script unprotected may compromise the security of your web application and web server. - -> [!NOTE] -> This article updates: "Using Windows Cache Extension for PHP" by Ruslan Yakushev, published on October, 2009. - -## See also - -- [IIS 7.0 Output Caching](../../manage/managing-performance-settings/walkthrough-iis-output-caching.md) -- [IIS7 Output Caching for Dynamic Content - Speed Up Your ASP and PHP Applications](https://blogs.iis.net/bills/archive/2007/05/02/iis7-output-caching-for-dynamic-content-dramatically-speed-up-your-asp-and-php-applications.aspx) -- [Windows Cache Extension for PHP](https://www.iis.net/downloads/microsoft/wincache-extension) -- [Windows Cache Extension 1.0 for PHP 5.2 - RC.](https://www.microsoft.com/downloads/details.aspx?FamilyID=6feb7f6a-7dcb-4083-bb7a-d8b22ba2d3d8&displaylang=en) -- [Windows Cache Extension 1.0 for PHP 5.3 - RC.](https://www.microsoft.com/downloads/details.aspx?FamilyID=ba2e0d7a-02ce-42be-a7a3-2baa5d666bf7&displaylang=en) -- [Improving Performance with Native Output Caching](../../manage/managing-performance-settings/improving-performance-with-native-output-caching.md) diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/_static/image1.png b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/_static/image1.png deleted file mode 100644 index 184eb8493..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample1.cmd deleted file mode 100644 index 0f3ef03d3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -"C:\Program Files\PHP\ext" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample10.cs b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample10.cs deleted file mode 100644 index 7ac2e23c3..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample10.cs +++ /dev/null @@ -1,21 +0,0 @@ -Array -( - [total_file_count] => 1 - - [total_hit_count] => 0 - [total_miss_count] => 1 - [file_entries] => Array - ( - [1] => Array - ( - [file_name] => C:\inetpub\wwwroot\checkcache.php - [add_time] => 1 - [use_time] => 0 - [last_check] => 1 - [hit_count] => 1 - [function_count] => 0 - [class_count] => 0 - ) - [2] => Array (...iterates for each cached file) - ) -) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample11.xml b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample11.xml deleted file mode 100644 index 9862b3f0d..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample11.xml +++ /dev/null @@ -1,10 +0,0 @@ -' ); -fclose( $handle ); -wincache_refresh_if_changed( array($filename) ); - -?> \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample12.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample12.cmd deleted file mode 100644 index e73406534..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample12.cmd +++ /dev/null @@ -1,26 +0,0 @@ -/** - * ======================== CONFIGURATION SETTINGS ============================== - * If you do not want to use authentication for this page, set USE_AUTHENTICATION to 0. - * If you use authentication then replace the default password. - */ -define('USE_AUTHENTICATION', 1); -define('USERNAME', 'wincache'); -define('PASSWORD', 'wincache'); - -/** - * The Basic PHP authentication will work only when IIS is configured to support - * Anonymous Authentication' and nothing else. If IIS is configured to support/use - * any other kind of authentication like Basic/Negotiate/Digest etc, this will not work. - * In that case use the array below to define the names of users in your - * domain/network/workgroup which you want to grant access to. - */ -$user_allowed = array('DOMAIN\user1', 'DOMAIN\user2', 'DOMAIN\user3'); - -/** - * If the array contains string 'all', then all the users authenticated by IIS - * will have access to the page. Uncomment the below line and comment above line - * to grant access to all users who gets authenticated by IIS. - */ -/* $user_allowed = array('all'); */ - -/** ===================== END OF CONFIGURATION SETTINGS ========================== */ \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample2.cmd deleted file mode 100644 index 3563589a2..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\Program Files\PHP\php.ini" \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample3.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample3.cmd deleted file mode 100644 index 20776e19e..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -extension=php_wincache.dll \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample4.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample4.cmd deleted file mode 100644 index c5620bac1..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -php phpinfo(); ?> \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample5.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample5.cmd deleted file mode 100644 index 3bc137fce..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample5.cmd +++ /dev/null @@ -1,3 +0,0 @@ -appcmd.exe set config -section:system.webServer/fastCgi -/[fullPath='C:\PHP\php-cgi.exe',arguments=''].maxInstances:"32" -/commit:apphost \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample6.xml b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample6.xml deleted file mode 100644 index 4e9ede1e7..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample6.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample7.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample7.cmd deleted file mode 100644 index c388a628c..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ ->cscript C:\windows\system32\inetsrv\fcgiconfig.js -set -section:"PHP" –MaxInstances:32 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample8.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample8.cmd deleted file mode 100644 index 56c2b5932..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample8.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[PHP] -ExePath=C:\PHP\php-cgi.exe -;some other settings may go here -MaxInstances=32 \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample9.xml b/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample9.xml deleted file mode 100644 index a7acaecd6..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/use-the-windows-cache-extension-for-php/samples/sample9.xml +++ /dev/null @@ -1,5 +0,0 @@ -
-
-
\ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/using-php-manager-for-iis-to-setup-and-configure-php.md b/iis/application-frameworks/install-and-configure-php-on-iis/using-php-manager-for-iis-to-setup-and-configure-php.md deleted file mode 100644 index e34217d64..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/using-php-manager-for-iis-to-setup-and-configure-php.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "Using PHP Manager for IIS to setup and configure PHP" -author: ruslany -description: "From the Downloads page select the installation package that is appropriate for your target machine. Download and run the installer, which will install and r..." -ms.date: 6/1/2020 -ms.assetid: 9e07564f-3c41-4d22-ba76-3daaf0847db9 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/using-php-manager-for-iis-to-setup-and-configure-php -msc.type: authoredcontent ---- - -# Using PHP Manager for IIS to setup and configure PHP - -by [Ruslan Yakushev](https://github.com/ruslany), [Lex Li](https://github.com/lextm) - -PHP Manager is not a Microsoft-owned or supported product. -### Installation - -From the [Downloads](https://github.com/phpmanager/phpmanager/releases) page select the installation package that is appropriate for your target machine. Download and run the installer, which will install and register PHP Manager's binaries with IIS. Note that only IIS versions 7.0 and above are supported. After installation is complete, launch the IIS Manager and find the "PHP Manager" feature: - -[http://www.phpmanager.xyz/latest/_images/phpmanager.png](http://www.phpmanager.xyz/latest/_images/phpmanager.png) - -When opened, the "PHP Manager" feature provides a configuration overview for the PHP installation that is registered with IIS and is currently active. If no PHP is registered with IIS, then the only action that can be performed is the registation of a new PHP version. - -### Registering PHP with IIS - -To register a new PHP version with IIS, first you need to download the zip archive with PHP binaries from [http://windows.php.net/](http://windows.php.net/) and then extract the files from it into a folder of your choice. Note that you can also install PHP by using [Web Platform Installer](https://php.iis.net/) or the Windows installer from [http://windows.php.net/](http://windows.php.net/) - the PHP Manager can be used to manage those PHP installations as well. - -Click on "**Register new PHP version**" task and then provide the full path to the location of the main php executable file: **php-cgi.exe**: - -[http://www.phpmanager.xyz/latest/_images/register.png](http://www.phpmanager.xyz/latest/_images/register.png) - -After clicking OK the new PHP version will be registered with IIS and will become active. This means that all the sites on this IIS server by default will use this PHP version. - -### Validating existing PHP installations and fixing configuration issues - -In order for PHP to run properly on IIS there is a set of recommended settings that need to be configured in IIS and PHP. PHP Manager checks if all of the recommended settings are configured correctly. If some settings are not configured properly then you can use PHP Manager to fix those settings. - -When some configuration settings are configured incorrectly you will see a warning message when you open PHP Manager: - -[http://www.phpmanager.xyz/latest/_images/warning.png](http://www.phpmanager.xyz/latest/_images/warning.png) - -After clicking on "View Recommendations" link you can see all the configuration issues that exist in your PHP installation. You can review each issue description and the recommended corrective action. You can also select which configuration issues you want to be fixed: - -[http://www.phpmanager.xyz/latest/_images/fixed.png](http://www.phpmanager.xyz/latest/_images/fixed.png) - -### Switching between PHP versions - -After multiple PHP versions have been registered with IIS, you can use PHP Manager to easily switch between the versions on a server and site level. This means that you can configure some IIS sites to use one PHP version, while other sites use different version. - -[http://www.phpmanager.xyz/latest/_images/switch.png](http://www.phpmanager.xyz/latest/_images/switch.png) - -### Checking phpinfo() output - -phpinfo() function in PHP provides very detailed information about all aspects of PHP runtime configuration. To check the phpinfo() output from within PHP Manager use the "**Check phpinfo()**" task. - - - -### Configuring Error Reporting - -You can use PHP Manager to configure error reporting level in PHP. If IIS is used on a development machine then you may want to use verbose error reporting in order to see all the errors, warnings and notices from your PHP application right away. If IIS is used as a production server, then error reporting level is less verbose and errors are logged in a log file, but never communicated to HTTP client. - -[http://www.phpmanager.xyz/latest/_images/error.png](http://www.phpmanager.xyz/latest/_images/error.png) - -### Configuring Runtime Limits - -Various timeouts and limits can be configured in the "**PHP Runtime Limits**" page: - -[http://www.phpmanager.xyz/latest/_images/limits.png](http://www.phpmanager.xyz/latest/_images/limits.png) - -### Configuring All PHP Settings - -All existing PHP settings can be added, removed and modified in the "**PHP Settings**" page. - -[http://www.phpmanager.xyz/latest/_images/settings.png](http://www.phpmanager.xyz/latest/_images/settings.png) - -### Enabling or Disabling PHP Extensions - -PHP extensions can be enabled or disabled in the "**PHP Extensions**" page: - -[http://www.phpmanager.xyz/latest/_images/extentions.png](http://www.phpmanager.xyz/latest/_images/extentions.png) \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications.md b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications.md deleted file mode 100644 index 34f7d38e1..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "Walkthrough - Set Up MySQL 5.1 for PHP applications" -author: ruslany -description: "Overview This article provides a basic step by step guide on how to install and configure MySQL on the Windows Operating System. For more detailed instructio..." -ms.date: 03/18/2009 -ms.assetid: 361e07d9-1737-4f84-890b-406bd8c51506 -msc.legacyurl: /learn/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications -msc.type: authoredcontent ---- -# Walkthrough - Set Up MySQL 5.1 for PHP applications - -by [Ruslan Yakushev](https://github.com/ruslany) - -## Overview - -This article provides a basic step by step guide on how to install and configure MySQL on the Windows Operating System. For more detailed instructions about installing and configuring MySQL on Windows refer to the [official MySQL documentation](http://dev.mysql.com/doc/refman/5.1/en/windows-installation.html). - -## Downloading and Installing MySQL - -The MySQL binaries and installer can be downloaded from the [official MySQL site](http://dev.mysql.com/downloads/mysql/5.1.html). The instructions in this article are based on MySQL version 5.1 Community Edition installed with the Windows MSI installer. - -Run the installer and choose the installation option. For a majority of the cases, the typical installation is sufficient: - -![Screenshot of the My S Q L Setup Wizard screen with the Typical Setup type selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image2.png) - -However, if you want to control which components get installed or if you want to use a non-default installation path then choose the "Custom" option. - -When the installation is complete, make sure to check the box to "Configure the MySQL Server now". This will launch the "MySQL Server Instance Configuration Wizard" that will guide you through the configuration process for the MySQL instance. - -![Screenshot of the My S Q L Server Setup Wizard on the Wizard Completed page.](walkthrough-set-up-mysql-51-for-php-applications/_static/image4.png) - -## Configuring MySQL instance - -Follow these steps in the "MySQL Server Instance Configuration Wizard" to optimize the MySQL configuration for the kind of tasks you expect it to perform. - -On the first page of the wizard choose "Detailed Configuration": - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the configuration type page. The Detailed Configuration type is selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image6.png) - -On the next page choose the server type option: - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the server instance page. The Developer Machine option is selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image8.png) - -Choose the "Database Usage" option: - -![Screenshot of the My S Q L Server Instance Configuation Wizard on the database usage page. Non-Transactional Database Only is selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image10.png) - -The Database usage options control what kind of database storage engine is used on the server: - -- MyISAM – Optimized for high performance SELECT operations. It has low overhead in terms of memory usage and disk utilization, but at the cost of not supporting transactions -- InnoDB – Provides fully ACID transactional capabilities, but at the cost of more aggressive usage of disk space and memory - -For an in-depth comparison of these database engines, refer to [MySQL Storage Engine Architecture](http://dev.mysql.com/tech-resources/articles/storage-engine/part_1.html). As a general recommendation – if the web applications on your server require multi-statement transactions, advanced isolation levels and row-level locking, foreign key constraints, or otherwise have a requirement for ACID features -- use InnoDB. Otherwise, use MyISAM. - -Next choose the number of concurrent connections to the server: - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the concurrent connections page. Decision Support (D S S)/O L A P is selected. ](walkthrough-set-up-mysql-51-for-php-applications/_static/image12.png) - -On the next page choose networking options : - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the networking options page. Enable T C P/I P Networking and Enable Strict Mode are selected. ](walkthrough-set-up-mysql-51-for-php-applications/_static/image14.png) - -If you have mysql and web server on the same machine you may consider not enabling TCP/IP networking and instead use named pipes. Note though that some PHP applications may require TCP connection to MySQL. Refer to the application's documentation to confirm if it supports named pipes connection to MySQL. - -Choose the default charset to use when creating new databases: - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the default character page. Standard Character Set is selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image16.png) - -Next ensure that MySQL will be configured as a Windows Service: - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the Windows options page. Install as a Windows Service and Include Bin Directory in Windows Path are selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image18.png) - -Optionally, you can add the MySQL Bin directory to the Windows PATH environment variable. That will make it easier to launch MySQL tools from the command line. - -Finally provide the password for the database administrative account, which in called "root" in MySQL. Make sure that you leave the "Create an Anonymous Account" checkbox cleared: - -![Screenshot of the My S Q L Server Instance Configuration Wizard on the security options page. Modify Security Settings is selected.](walkthrough-set-up-mysql-51-for-php-applications/_static/image20.png) - -On the next page click "Execute" to apply all the configuration settings and to start the MySQL service: - -![Screenshot of the My S Q L Server Instance Configuration Wizard completion page.](walkthrough-set-up-mysql-51-for-php-applications/_static/image22.png) - -Now you can logon to MySQL by opening a command line window and typing: - -[!code-console[Main](walkthrough-set-up-mysql-51-for-php-applications/samples/sample1.cmd)] - -If MySQL was configured correctly then the MySQL prompt will be shown: - -[!code-console[Main](walkthrough-set-up-mysql-51-for-php-applications/samples/sample2.cmd)] diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image1.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image1.png deleted file mode 100644 index e0870dec3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image1.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image10.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image10.png deleted file mode 100644 index e0870dec3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image10.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image11.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image11.png deleted file mode 100644 index e0870dec3..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image11.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image12.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image12.png deleted file mode 100644 index 749788e54..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image12.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image13.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image13.png deleted file mode 100644 index 749788e54..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image13.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image14.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image14.png deleted file mode 100644 index e16a0ebf9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image14.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image15.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image15.png deleted file mode 100644 index e16a0ebf9..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image15.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image16.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image16.png deleted file mode 100644 index 44b7e336f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image16.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image17.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image17.png deleted file mode 100644 index 44b7e336f..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image17.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image18.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image18.png deleted file mode 100644 index fc02be1d5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image18.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image19.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image19.png deleted file mode 100644 index fc02be1d5..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image19.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image2.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image2.png deleted file mode 100644 index 4641d634e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image2.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image20.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image20.png deleted file mode 100644 index 7a8262ead..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image20.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image21.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image21.png deleted file mode 100644 index 7a8262ead..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image21.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image22.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image22.png deleted file mode 100644 index e9ce96d57..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image22.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image23.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image23.png deleted file mode 100644 index e9ce96d57..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image23.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image3.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image3.png deleted file mode 100644 index 4641d634e..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image3.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image4.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image4.png deleted file mode 100644 index 5d468c738..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image4.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image5.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image5.png deleted file mode 100644 index 5d468c738..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image5.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image6.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image6.png deleted file mode 100644 index 65f0d3acb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image6.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image7.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image7.png deleted file mode 100644 index 65f0d3acb..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image7.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image8.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image8.png deleted file mode 100644 index 0aada6064..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image8.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image9.png b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image9.png deleted file mode 100644 index 0aada6064..000000000 Binary files a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/_static/image9.png and /dev/null differ diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample1.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample1.cmd deleted file mode 100644 index 5b32ed03c..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample1.cmd +++ /dev/null @@ -1,2 +0,0 @@ -mysql -u root -p -Enter password: ****** \ No newline at end of file diff --git a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample2.cmd b/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample2.cmd deleted file mode 100644 index ce548c8de..000000000 --- a/iis/application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 3 -Server Version 5.1.32-community MySQL Community Server (GPL) -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. -mysql> \ No newline at end of file diff --git a/iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md b/iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md index 6b81d1f95..c1eb69226 100644 --- a/iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md +++ b/iis/application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md @@ -26,9 +26,7 @@ To get the most from this tutorial, you must have access to a computer that is r ## Step 1: Install the IIS Web Server -You can use the Web Platform Installer (Web PI) to install IIS, and applications that run on IIS. Because the Web PI installs the latest versions of available Web Platform offerings, with just a few simple clicks you can download and install any new tools or updates. To learn more about the Web PI, see [Learn more and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). - -You can also perform this procedure by using the Windows user interface (UI) or from a command line. +You can perform this procedure by using the Windows user interface (UI) or from a command line. ### To install IIS on Windows Server 2012 by using the UI @@ -463,6 +461,5 @@ Test your website thoroughly to ensure that it functions as expected. Then consi - [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) - [Build a Static Website on IIS](../../manage/creating-websites/scenario-build-a-static-website-on-iis.md) - [Build an ASP.NET Website on IIS](../scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) -- [Build a PHP Website on IIS](../scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) - [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) - [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md deleted file mode 100644 index 6d0b909e8..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md +++ /dev/null @@ -1,289 +0,0 @@ ---- -title: "Best Practices for PHP on the Microsoft Web Platform" -author: rick-anderson -description: "Introduction There are various steps you can take to optimize Windows Server 2008 R2 or Windows Server 2008, IIS 7 and above, and FastCGI performance for you..." -ms.date: 11/15/2009 -ms.assetid: 75b33d8e-3c3e-472e-9973-b41ced1a7ebb -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform -msc.type: authoredcontent ---- -# Best Practices for PHP on the Microsoft Web Platform - -by Tali Smith - -## Introduction - -There are various steps you can take to optimize Windows Server 2008 R2 or Windows Server 2008, IIS 7 and above, and FastCGI performance for your Web workloads and PHP applications. These procedures can be generally be performed from the UI by running Appcmd.exe commands in a command-line window and editing configuration files directly or by writing Windows® Management Instrumentation (WMI) scripts. - -## Configure PHP Process Recycling Behavior - -Make sure that FastCGI always recycles the php-cgi.exe processes before the native PHP recycling kicks in. The FastCGI process recycling behavior is controlled by the configuration property **instanceMaxRequests**. This property specifies how many requests the FastCGI process will process before recycling. PHP also has a similar process recycling functionality that is controlled by an environment variable **PHP\_FCGI\_MAX\_REQUESTS**. By setting **instanceMaxRequests** to be smaller or equal to **PHP\_FCGI\_MAX\_REQUESTS**, you can ensure that the native PHP process recycling logic will never kick in. - -The FastCGI settings can be configured either by using IIS Manager or by using the command-line tool **AppCmd**. - -### Use IIS Manager - -1. To configure FastCGI recycling settings by using IIS Manager, you need to install Administration Pack for IIS, and then select **FastCGI Settings** at the server level. - - ![Screenshot of the I I S Manager window.](best-practices-for-php-on-the-microsoft-web-platform/_static/image1.jpg) - - *Figure 1 IIS Manager, FastCGI Settings* -2. Next, select the FastCGI application that you want to configure, and then click **Edit** in the **Actions** pane on right-hand side. - - ![Screenshot of the I I S Manager window showing Fast C G I Settings in the main pane.](best-practices-for-php-on-the-microsoft-web-platform/_static/image3.jpg) - - *Figure 2 FastCGI Settings page* -3. In the **Edit FastCGI** **Application** dialog box, set **InstanceMaxRequest** to **10000**, and then click on the **browse** button next to the **EnvironmentVariables** setting. - - ![Screenshot of the Edit Fast C G I Application dialog. Environment variables is highlighted.](best-practices-for-php-on-the-microsoft-web-platform/_static/image5.jpg) - - *Figure 3 Edit FastCGI Application dialog box* -4. Add the **PHP\_FCGI\_MAX\_REQUESTS** environment variable and set its value to **10000**. - - > [!NOTE] - > If you do not configure these settings, then the following default settings are used: **InstanceMaxRequests** of 200, **PHP\_FCGI\_MAX\_REQUESTS** of 500 (on most PHP builds). - - ![Screenshot of the Environment Variables Collection Editor dialog.](best-practices-for-php-on-the-microsoft-web-platform/_static/image7.jpg) - - *Figure 4 Environment Variables Collection Editor* - -### Use the Command Line - -To configure the recycling behavior of FastCGI and PHP via **appcmd**, use the following commands: - -[!code-console[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample1.cmd)] - -## Disable Unneeded Services and Processes - -If the server running Windows Server 2008 R2 or Windows Server 2008 will be a dedicated Web server, there are various steps you can take to optimize performance for your Web workloads. Note that these procedures can be performed easily and quickly from the UI or from a command line. - -Make sure any unneeded roles and features in the Windows Server 2008 installation are not installed. Remove processes such as: - -- Microsoft Find Fast and other search indexing services. -- Three-dimensional (3-D) screen savers (which may occupy CPU resources). -- Unused networking protocols. -- Unneeded mail servers. -- Unused antivirus scanners and hardware drivers for mice and infrared ports. - -To use the UI, click **Start**, click **Services**, and then scroll down to the service you want to disable and click **Properties**. Click the arrow under **Startup type**, and then click **Disabled**. - -> [!NOTE] -> Test the Web server for correct operation after you disable each service to make sure that you did not disable a service you want to continue to use. Also, note any services that are dependent on the service you want to stop. - -There is also command-line–based management in Windows Server 2008. Prior versions of Windows provided few if any dependency checks when users had to add/remove server roles or other software. A simple command in Windows Server 2008 can provide server administrators with a listing of the components that will be added or removed. The server manager command also provides a mechanism for performing unattended installation of server roles and features. You can choose to install a single role or feature or combine installation of multiple roles/features via an XML answer file. You can now easily gather information on the installed roles and/or features of any given server and export those results to XML for documentation. You can also determine what server components will be affected by the installation or removal of a server role or feature. - -## Optimize Server Performance - -To optimize Windows Server 2008 or Windows Server 2008 R2 performance, you can: - -- Run the IIS pageable code in working memory to maximize the data throughput. -- Run the IIS process (Inetinfo.exe) as a background service. -- Disable IIS logging. - -### Minimize IIS logging - -Unless required, disable logging on Web sites, virtual directories, files, and folders. You can use the UI or the command line. When logging is switched on, there is a constant appending of text files on the server that details everything about the Web sites. This is necessary if you are monitoring bandwidth though; switch on logging periodically to keep an eye on sites and the bandwidth they use, then switch off logging at all other times. There is generally no need to keep logging on permanently, unless you do want to constantly monitor bandwidth. - -To use the UI, open the IIS Manager and navigate to the level you want to manage. In **Features View**, double-click **Logging**. On the **Logging** page, in the **Actions** pane, click **Disable** to disable logging. - -To use the command line to disable logging, use the following syntax: - -[!code-console[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample2.cmd)] - -## Enable Bandwidth Throttling - -With increasing numbers of sites offering media content, the bandwidth costs for many businesses can be very high. In addition, a large percentage of media bandwidth is wasted because the media content sent to the client is never really used. It is common for users browsing video sites to watch only part of a video before moving on to the next video or leaving the page. However, a Web server using progressive download to deliver the video will typically send significantly more data than is required for those few seconds of play time. Most of that data never gets used. - -For example, if your videos on average only get 5 seconds of viewing time but deliver (buffer) 30 seconds worth of video data in those 5 seconds, you are potentially wasting more than 80 percent of your bandwidth. - -### Use the Bit Rate Throttling Module - -IIS includes a Bit Rate Throttling Module, which automatically detects the encoding rate of the most popular video types. You can control how much data you would like to pre-send to the client in order to eliminate initial buffering delays (fast start) and at what percentage of the encoded rate you would like to deliver the content. You can also configure many other options, such as maximum bandwidth and concurrent connections, and control the module programmatically. - -![Screenshot showing the bandwidth throttling graph.](best-practices-for-php-on-the-microsoft-web-platform/_static/image9.jpg) - -*Figure 5 Bandwidth throttling* - -### Limit the number of connections to site - -You can also limit the number of connections available to individual Web sites. - -1. From the IIS Manager, expand the Web server and click to select the Web site. -2. Click **Limits…** in the Actions pane -3. Check the box for Limit number of connections -4. Enter the number of connections that you want to allow. Note that each connected client uses approximately four concurrent connections. -5. Click **OK.** - -### Enable CPU monitoring - -You can also enable CPU monitoring to monitor and to automatically shut down worker processes that consume large amounts of CPU time. - -1. From the IIS Manager, expand the Web server and select an Application Pool. -2. Click Advanced Settings from the Actions tab. -3. In the **Limit** box in the **CPU** section, and type the value that you want. -4. Click **OK**. - -## Use HTTP Keep-Alives - -The HTTP keep-alive response header improves Web server performance by keeping a client/server connection open across multiple requests to the server. The open connection improves performance when a client makes multiple requests for Web page content, because the server can return the content for each request more quickly. Otherwise, the server has to open a new connection for every request. By default, the HTTP keep-alive response header is enabled in IIS. - -1. From the IIS Manager and navigate to the level you want to manage. -2. In **Features View**, double-click **HTTP Response Headers**. -3. On the **HTTP Response Headers** page, in the **Actions** pane, click **Set Common Headers**. -4. In the **Set Common HTTP Response Headers** dialog box, select the **Enable HTTP keep-alive** check box, and then click **OK**. - -To enable the HTTP keep-alive header from the command line, use the following syntax: - -[!code-console[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample3.cmd)] - -## Use HTTP Compression - -One of the most effective ways to reduce the bandwidth needed to deliver the application responses is to use HTTP compression. This can reduce the size of the response by a substantial amount, often by a factor of 10 when applied to easily compressible text content such as HTML. Since compression is based on Content-Encoding negotiation defined in the HTTP 1.1 protocol, enabling it is safe for clients that do not support compression—these clients simply receive an uncompressed version of the content. - -IIS provides the two compression features: - -- Static compression -- Dynamic compression - -Static compression pre-compresses static content and saves it on disk, thereby allowing future requests to serve compressed content directly without compression overhead. Dynamic compression compresses the response in real time and therefore enables compression for responses generated by applications. Any application framework on IIS can take advantage of dynamic compression—including ASP, ASP.NET, or PHP. - -Dynamic compression usually does not have a prohibitive CPU overhead. In fact, dynamic compression often causes less than 5 percent of the total CPU utilization on a busy server. Dynamic compression can be deployed somewhat liberally to allow for maximum bandwidth savings for any application workloads. - -You can further optimize compression overhead by configuring the compression strength in order to achieve the desired compression versus CPU overhead ratio. - -You can configure HTTP compression by using the UI, by running Appcmd.exe commands in a command-line window, by editing configuration files directly, or by writing WMI scripts. - -For example, to enable dynamic content compression from the command line, type the following and press ENTER: - -[!code-console[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample4.cmd)] - -To enable compression on a particular site from the UI, select the site, and then, from the Work pane, select the Compression management tool. Choose whether you want to compress static content, dynamic content, or both. - -![Screenshot of the I I S Manager showing the Compression dialog in the main pane.](best-practices-for-php-on-the-microsoft-web-platform/_static/image11.jpg) - -*Figure 6 HTTP compression* - -## Use Forms Authentication - -This feature secures the application and the static image files and works well for sites or applications on public Web servers that receive many requests. This authentication mode lets you manage client registration and authentication at the application level, instead of relying on the authentication mechanisms provided by the operating system. You can use the built-in membership database or a custom membership provider. - -In the past, people would often protect the application pages themselves and leave images and media content open for public access. It wasn't easy to extend the same Internet-based authentication scheme to static content unless the static content was served through custom handlers. Even this wasn't a perfect solution, as you would often lose performance and static content features such as static compression and ranged request support. - -With IIS, you can configure Forms Authentication and URL Authorization rules once for the entire site, and you know that your ASPX pages, PHP scripts, HTML files, and media content is protected from unauthorized access. - -You can enable Forms Authentication by using the UI, running Appcmd.exe in a command-line window, by editing configuration files directly, or by writing WMI scripts. - -1. From the IIS Manager, navigate to the level you want to manage. -2. In **Features View**, double-click **Authentication**. -3. On the **Authentication** page, select **Forms Authentication**. -4. In the **Actions** pane, click **Enable** to use Forms Authentication with the default settings. - - ![Screenshot of the I I S Manager screen showing the Authentication dialog in the main pane.](best-practices-for-php-on-the-microsoft-web-platform/_static/image13.jpg) - - *Figure 7 Forms Authentication* - -To enable or disable Forms Authentication from the command line, use the following syntax: - -[!code-console[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample5.cmd)] - -## Manage IIS 7.0 and above with the PowerShell Provider - -The IIS PowerShell Provider is a Windows PowerShell snap-in that allows you to manage IIS configuration and run-time data. It gives easy access to Web-Sites, Application Pools, Web applications, Virtual Directories, request in flight, Worker Processes, and .NET Application Domains within Worker Processes. - -Microsoft Windows PowerShell command-line shell and scripting language helps IT professionals achieve greater control and productivity. Using a new admin-focused scripting language, more than 130 standard command-line tools, and consistent syntax and utilities, Windows PowerShell allows IT professionals to more easily control system administration and accelerate automation. Windows PowerShell is built on top of the .NET common language runtime (CLR) and the .NET Framework, accepting and returning .NET objects. - -Figure 8 shows how to use the PowerShell Provider to create a new IIS application. - -![Screenshot of the PowerShell console screen.](best-practices-for-php-on-the-microsoft-web-platform/_static/image15.jpg) - -*Figure 8 PowerShell Management Console* - -The IIS PowerShell Provider allows you to: - -- Create Web sites, Web applications, virtual directories, and application pools. -- Change simple configuration properties on Web sites, Web applications, virtual directories, and application pools. -- Add and change complex configuration settings. -- Query run-time data (Web site state, application pool state, currently executing requests). -- Execute advanced configuration tasks, scripting, and integration with other PowerShell snap-ins and features. -- Search and discover configuration settings. - -For example, you can create a new application pool from the PowerShell Provider. This only requires the name to be specified. - -[!code-powershell[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample6.ps1)] - -For more information, see the article "[Managing IIS with the IIS 7.0 and Above PowerShell Snap-in](../../manage/powershell/index.md)." - -## Extend IIS 7 and Above - -The IIS architecture is designed to be extensible from top to bottom, allowing you to replace any part of the built-in feature set with a custom implementation that suits your needs. As a result, instead of providing a patchwork of plug-in points, IIS implements all of its own features on top of the public extensibility model. This design is found throughout the platform, from the modular Web server engine itself to the configuration system to the IIS Manager console. - -Often, the desired Web workload requires additional functionality that may not be part of the built-in IIS feature set. Or, in some cases, the application may require a customized set of functionality for which the built-in features are not flexible enough. Because all of the IIS features are built on public extensibility APIs, you can replace any of them with a custom implementation that best fits your needs. - -### Extend the IIS Manager - -Developers can extend the IIS Manager by providing a UI for their custom components and having that UI fully integrated into IIS Manager in the same way as any out-of-the-box IIS component. By using the IIS Manager extensibility, API developers can take advantage of remote management capabilities for their components for free. - -IIS Manager has built-in remote administration capabilities. Using HTTPS between the IIS Manager and the remote server, this feature includes the ability to define trusted users in IIS Manager and have identities securely stored in the IIS configuration, Windows security accounts manager (SAM) or Active Directory, or a .NET provider. - -Unlike other tools that also support remote administration, the IIS Manager remote administration architecture offers several key advantages. First, it allows users who are not administrators on the server to manage sites and applications over which they have control. Second, the IIS Manager remoting mechanism uses HTTPS, instead of DCOM, which is easier to expose through corporate firewalls. Together, these two capabilities make the IIS Manager attractive for delegated remote management of IIS Web sites, especially in shared Web-hosting environments. - -The IIS Manager provides an extensible architecture on which most of the built-in IIS Manager features are based. To facilitate the remote management scenario, each management feature consists of two parts: the client-side components that provide the UI experience inside IIS Manager, and the server-side component that provides the actual management services. The server-side service is loaded inside IIS Manager for local management scenarios or inside the Web Management Service in remote management scenarios. In the latter case, IIS Manager handles the required communication between the components in IIS Manager on the client machine and the service running inside WmSvc on the target server machine. - -### Extend the configuration schema - -Extending the configuration schema can help manage your application. You can automate deployment of the application script to a virtual directory, or configure the role used to authorize users for caption editing, either system wide or for each Web site or application. Extending the schema involves adding a simple .xml file in the `%SystemRoot%\system32\inetsrv\config\schema` directory on your computer. The IIS\_schema.xml file is already present in this directory and can be used as an example to set up your own schema. Create a file named CUSTOM\_schema.xml and set it up, and then register the section in the applicationHost.config. This involves adding just one line in the applicationHost.config. - -## Use a Non-Thread-Safe Build of PHP - -A best practice is to use a non-thread-safe build of PHP with IIS FastCGI, available in PHP 5.2.1 or greater. There are two builds for each PHP version. One is thread safe, and one isn't, referred to as the Non-Thread-Safe (NTS) version. The thread-safe version is designed for environments where the Web server core can keep the PHP engine in memory, running multiple treads of execution for different Web requests simultaneously. The architecture of IIS and the FastCGI extension provide an isolation model that keeps requests separate, removing the need for a thread-safe version. The NTS doesn't have any of the code that allows PHP to manage multiple threads. As a result, you will see a performance improvement on IIS when using the NTS version as compared to the tread-safe version. - -IIS had always supported PHP but in a way that precluded many real-life PHP applications from being hosted in production environments. This was due to limitations in the two ways IIS offered for running PHP applications: using the Common Gateway Interface (CGI) protocol or using the PHP ISAPI extension. - -Because CGI requires a separate process for each request, apps hosted using CGI would perform poorly on Windows. Conversely, PHP apps using the IIS high-performance multithreaded ISAPI interface would often suffer from instability due to the lack of thread safety in some popular PHP extensions. - -In an attempt to solve these problems, the IIS team developed the FastCGI component. The open FastCGI protocol allows PHP and many other application frameworks that require a single-threaded environment (including Ruby on Rails, Perl, and Python) to run more reliably on IIS. Unlike the standard CGI implementation, FastCGI enables process reuse by maintaining a pool of worker processes, each processing no more than one request at a time, thus resulting in much-improved performance. FastCGI also benefitted from a community-centric development and testing model. - -## Set the Default Document - -IIS uses a configuration file named web.config. This file can be placed at any point within an application, and is used to include Web server directives that affect that directory and the ones below it. Many applications currently distribute the file .htaccess, which provides a similar set of capabilities. You can use the web.config file to identify the default document for your application, as follows: - -[!code-xml[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample7.xml)] - -The bold **remove** entry in this example is required. If there is a previous definition for Index.php, this will remove it and place the new one at the top of the default document list. If there isn't a previous one, the remove will be ignored. - -## Use the URL Rewriter Module - -IIS includes a URL Rewriter module comprising a complete, expression-based engine for rewriting rules. These rules can be configured manually or by using the IIS Manager. The URL Rewriter module can import and convert mod\_rewrite rules. - -A typical simple rewrite rule, which converts all requests that come in to *http.example.com* into `http://www.example.com`, is shown in the following code: - -[!code-xml[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample8.xml)] - -## Use the Request Filtering Module - -IIS uses the Request Filtering module to limit browser access to files or directories based upon specified criteria. The URL Filtering module is a powerful engine for securing access to various URLs and requests. - -An example of how to use request filtering to block access to certain types of files, such as include or log files, follows: - -[!code-xml[Main](best-practices-for-php-on-the-microsoft-web-platform/samples/sample9.xml)] - -## IIS 6.0 and 5.1 - -Earlier versions of IIS do not have the URL Rewriter module. One of the major uses for this module is to limit access to certain files and / or directories. For the older versions of IIS, it is possible to provide similar protections. - -## Links for Further Information - -- [Optimize IIS Performance (IIS 7)](https://technet.microsoft.com/library/cc770381(WS.10).aspx). -- [Windows Server Performance Team Blog](/archive/blogs/winserverperformance/tuning-windows-server-2008-for-php) -- [Top 10 Performance Improvements in IIS 7.0](https://technet.microsoft.com/magazine/2008.09.iis.aspx). -- [Enable or Disable Logging (IIS 7)](https://technet.microsoft.com/library/cc754631.aspx). -- [IIS 7.0 Bit Rate Throttling Module Released](https://weblogs.asp.net/scottgu/archive/2008/03/18/iis-7-0-bit-rate-throttling-module-released.aspx) -- [Bit Rate Throttling is now released](https://blogs.iis.net/vsood/archive/2008/03/15/bit-rate-throttling-is-now-released.aspx). -- [Configuring HTTP Compression in IIS 7](https://technet.microsoft.com/library/cc771003.aspx). -- [Build Web Server Solutions with End-To-End Extensibility](/archive/msdn-magazine/2008/launch/build-web-server-solutions-with-end-to-end-extensibility) -- [How to Get Started Extending Module Properties for IIS 7.0 and Above in IIS Manager](../../develop/extending-the-management-ui/how-to-get-started-extending-module-properties-for-iis-in-iis-manager.md). -- [How to Take Advantage of the IIS 7.0 and Above Integrated Pipeline](../building-and-running-aspnet-applications/how-to-take-advantage-of-the-iis-integrated-pipeline.md) -- [Enable Forms Authentication (IIS 7)](https://technet.microsoft.com/library/cc771077.aspx). -- [How to Use Request Filtering](../../manage/configuring-security/use-request-filtering.md). -- [Importing Apache mod\_rewrite Rules](../../extensions/url-rewrite-module/importing-apache-modrewrite-rules.md). -- [Translating .htaccess Content to IIS web.config](../install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md). diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image1.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image1.jpg deleted file mode 100644 index 0fa977e97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image10.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image10.jpg deleted file mode 100644 index c98672c24..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image11.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image11.jpg deleted file mode 100644 index 110fb5a0e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image12.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image12.jpg deleted file mode 100644 index 110fb5a0e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image13.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image13.jpg deleted file mode 100644 index 4ff9154e3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image14.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image14.jpg deleted file mode 100644 index 4ff9154e3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image15.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image15.jpg deleted file mode 100644 index 961009620..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image16.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image16.jpg deleted file mode 100644 index 961009620..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image2.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image2.jpg deleted file mode 100644 index 0fa977e97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image3.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image3.jpg deleted file mode 100644 index c03192682..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image4.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image4.jpg deleted file mode 100644 index c03192682..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image5.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image5.jpg deleted file mode 100644 index e7325a0d3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image6.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image6.jpg deleted file mode 100644 index e7325a0d3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image7.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image7.jpg deleted file mode 100644 index fe9dbede7..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image8.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image8.jpg deleted file mode 100644 index fe9dbede7..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image9.jpg b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image9.jpg deleted file mode 100644 index c98672c24..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample1.cmd b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample1.cmd deleted file mode 100644 index 18763229f..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample1.cmd +++ /dev/null @@ -1,3 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='c:\{php_folder}\php-cgi.exe'].instanceMaxRequests:10000 - -C:\>%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='C:\{php_folder}\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS' \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample2.cmd b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample2.cmd deleted file mode 100644 index 03278640a..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\windows\system32\inetsrv>appcmd set config /section:httpLogging /dontLog:True \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample3.cmd b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample3.cmd deleted file mode 100644 index 7192f5ff1..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\Windows\System32\inetsrv>appcmd set config /section:httpProtocol /allowKeepAlive:true | false \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample4.cmd b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample4.cmd deleted file mode 100644 index f8dd53f8d..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\Windows\System32\inetsrv>appcmd set config /section:urlCompression /doDynamicCompression:True \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample5.cmd b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample5.cmd deleted file mode 100644 index 6ee665bbb..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\Windows\System32\inetsrv>appcmd set config /commit:WEBROOT /section:system.web/authentication /mode: None | Windows | Passport | Forms \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample6.ps1 b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample6.ps1 deleted file mode 100644 index b0283297b..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample6.ps1 +++ /dev/null @@ -1,4 +0,0 @@ -PS IIS:\> new-item AppPools\DemoAppPool -Name State ----- ----- -DemoAppPool \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample7.xml b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample7.xml deleted file mode 100644 index d902c3556..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample7.xml +++ /dev/null @@ -1,10 +0,0 @@ - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample8.xml b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample8.xml deleted file mode 100644 index dda46c5be..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample8.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample9.xml b/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample9.xml deleted file mode 100644 index 7ee775673..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform/samples/sample9.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server.md b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server.md deleted file mode 100644 index 180e3bc60..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server.md +++ /dev/null @@ -1,217 +0,0 @@ ---- -title: "Build a High-Performance PHP Stack with Windows IIS and Zend Server" -author: rick-anderson -description: "This article was written by Vikram Vaswani of Zend Technologies Ltd. If you're a Web application developer, you've undoubtedly heard of PHP, the open-source..." -ms.date: 05/18/2009 -ms.assetid: 1e7be0f8-c245-4460-b9ba-e246f1797999 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server -msc.type: authoredcontent ---- -# Build a High-Performance PHP Stack with Windows IIS and Zend Server - -by Vikram Vaswani - -This article was written by Vikram Vaswani of Zend Technologies Ltd. - -If you're a Web application developer, you've undoubtedly heard of PHP, the open-source Web programming language. PHP is an extremely popular tool for building dynamic, data-driven Web applications, as it's easy to learn, interconnects with a wide variety of RDBMSs (including Oracle, MySQL and Microsoft SQL Server), and comes with excellent documentation and deep community support. - -There's only one glitch: setting up a full-fledged PHP development environment under Windows typically requires one to download, install and then configure various bits of software to talk nicely to one another. This process is something that novice developers often struggle with, and it can produce a fair amount of frustration when things don't work "out of the box". - -This is not a problem entirely without solutions. The Microsoft Web Platform offers one answer, but it certainly isn't the only one. There's also another option that you might like to consider: Zend Server, a Windows-based PHP stack that plays well with Microsoft Internet Information Services (IIS), Microsoft SQL Server and MySQL. And over the next few pages, I'm going to show you how to use it to build a high-performance, enterprise-ready PHP+Windows stack. - -## Getting Started - -To quote its official Web site ([http://www.zend.com/en/products/server/](http://www.zend.com/en/products/server/)), Zend Server is "a complete, enterprise-ready Web Application Server for running and managing PHP applications that require a high level of reliability, performance and security." Simply put, it provides a consistent and reliable PHP stack that can be easily deployed in both Windows and \*NIX environments. This stack includes the latest version of PHP, some optional components (Apache, MySQL and Zend Framework), and support for Microsoft IIS, Java, and various databases, including Oracle, MySQL, DB2 and Microsoft SQL Server. All versions of Zend Server come with the Zend Optimizer+ opcode caching engine to significantly speed up PHP performance. - -Zend Server comes in two flavors, which may broadly be classified as 'commercial' and 'community'. The commercial version, known simply as Zend Server, requires purchase of a commercial license, which entitles you to software updates and technical support, in addition to goodies like page (URL) caching, automatic application alerts and diagnostics. The community version, known as Zend Server CE, is available free of charge, but lacks some of the "extras" in the commercial version. - -Your choice of server flavor will usually be defined by your needs (and your budget). If you're a PHP hobbyist or planning to use the server for non-critical PHP applications, Zend Server CE will probably meet all your needs. If, on the other hand, you're running critical enterprise applications and/or need technical support for your PHP environment, a commercial Zend Server license will probably serve you better. Both versions are available for Windows environments and, regardless of which one you choose, you'll get all of the following: - -- All-in-one installation package: Zend Server provides all the key components of a PHP stack in a single point-and-click installation package. This is ideal for novice developers just getting started with PHP; it's also useful for experienced programmers who need to set up a test or development system with minimum fuss. -- Web-based administration: Zend Server comes with an integrated administration panel that allows administrators to monitor server status using a standard Web browser. This graphical administration panel also provides a handy way to change server configuration, set and reset PHP configuration variables, and enable or disable PHP modules. -- Debugging and performance tools: Zend Server includes a number of additional components to improve application performance and make development and debugging easier. These components include Zend Optimizer+, a performance accelerator; Zend Data Cache, a data caching API; Zend Debugger, a full-featured script debugger; and Zend Java Bridge, a PHP/Java connector. All these components can be selectively enabled or disabled from the server administration console at run-time. The commercial version of Zend Server also includes event monitoring and page caching, to improve performance and reduce downtime in network environments. -- Certified PHP stack: The version of PHP that ships with Zend Server is tested and certified by Zend Technologies. This ensures a consistent development environment across various platforms. Having the support and reputation of a major software vendor behind the product also significantly increases the comfort level of project managers and customers who are dipping their toes into PHP-based application development for the first time. The commercial version of Zend Server also includes regular updates and security fixes, to ensure that your PHP applications remains up-to-date and protected. - -Enough with the advertising...let's kick the tires on this thing and see how it works! - -## Installing Zend Server - -To get started with Zend Server, download the Windows installation package from the [Zend Technologies Web site](http://www.zend.com/en/products/server/downloads). While you're there, you should request a free trial license key - this license is valid for 30 days and allows you to try out all the features of the commercial product. The product will automatically revert to a CE-like version, with some features disabled, once the license runs out. - -If you're using Windows XP Professional, Windows Vista or Windows Server 2008, IIS is included with your operating system (although it is an optional installation on Windows Vista). For purposes of this article, I'll assume that you're installing Zend Server on Windows Vista with Microsoft IIS 7.0. If you're using a different version of the operating system, relax - the Windows installation package also works with Windows XP Professional (IIS 5.1 and IIS 6.0) and Windows Server 2008 (IIS 7.5), with no changes necessary. I'll also assume that you have both MySQL 5.1 and Microsoft SQL Server Express 2008 installed on your system. If you don't, you can get Microsoft SQL Server Express 2008 free of charge from [the Microsoft Web site](https://www.microsoft.com/express/sql/download/), and MySQL 5.1 from [the MySQL Web site](http://www.mysql.com/) or via the Zend Server installer. - -Get things rolling by starting up the installer. You should see a welcome screen, as below: -[![Screenshot that shows the Zend Server Installer wizard.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image2.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image1.jpg) - -Accept the license terms, and choose a Custom Installation. -[![Screenshot that shows the Setup Type page. Custom is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image4.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image3.jpg) - -At this point, you can choose which of the various Zend Server components should be installed. It's definitely worth keeping the bundled performance and monitoring tools, such as Zend Optimizer+ and Zend Monitor, and it's a good idea to install Zend Framework, which provides a set of ready-made components that simplify PHP development. I'll be showing you how to hook your PHP scripts up to Microsoft SQL Server Express and MySQL a little further along, so also install the MS-SQL Native Client, MySQL and phpMyAdmin if you don't already have them. -[![Screenshot that shows the Custom Setup page. M S S Q L Native Client is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image6.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image5.jpg) - -Next, configure Zend Server to integrate with your existing IIS web server installation. If you're using Windows XP Professional, Windows Vista or Windows Server 2008, IIS should already be installed and working on your system. -[![Screenshot of the Web Server page. Configure existing I I S Web Server is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image8.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image7.jpg) - -Confirm your choices, and let the installer go to work downloading files and setting things up. -[![Screenshot that shows the installation progress of the file download.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image10.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image9.jpg) - -Once done, the installer will display a success message and allow you to immediately start the Zend Server process. -[![Screenshot that says Zend Server was successfully installed. Start working with Zend Server is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image12.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image11.jpg) - -Since this is its first run, Zend Server will prompt for an administrator password, as well as your license key. -[![Screenshot that shows the Mozilla internet browser. The browser is open to the Welcome to Zend Server page.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image14.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image13.jpg) - -Enter the requested information and you'll be transferred to the server administration panel. - -## Understanding The Zend Server Administration Panel - -Zend Server is fully configurable via its Web-based administration panel, which is typically found at `http://localhost/ZendServer/` and is broadly divided into four sections: - -**Monitor**: Think of the Monitor section as a one-stop shop for anything and everything related to the server's current status and health. The aptly-named Dashboard provides a quick overview of recent PHP events, such as errors and warnings, as well as information on the current status of the various Zend add-on components. This section is also the place to go to view phpinfo() output and server error logs. Under Zend Server CE, the event monitoring tools are absent. -[![Screenshot of Zend Server administration panel. The Monitor section is shown. Recent Events, System Overview, and Tasks sections are displayed.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image17.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image16.jpg) - -**Rule Management**: Two of the key selling points of Zend Server can be found in the Rule Management section: the built-in URL caching system, and the event monitoring system. The Rule Management -> Monitoring section is ground zero for the event monitor. It allows the administrator to set up "watch rules" for PHP requests and trigger actions on certain conditions, such as an uncaught exception or unusually-high memory consumption. In a similar vein, the Rule Management -> Caching section allows administrators to define URL patterns that, when encountered, are automatically cached to improve performance. These two features offer huge benefits to administrators tasked with managing business-critical applications in an enterprise environment; however, it's worth noting that they're not included in Zend Server CE. -[![Screenshot of Zend Server administration panel. The Rule Management section is shown. The Monitoring section and Caching section headings are at the top. The Caching section is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image20.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image19.jpg) - -**Server Setup**: The Server Setup section is where administrators head when they need to change server parameters. This section allows an administrator to turn on or off the various Zend performance and optimization components, such as Zend Optimizer+, Zend Page Cache and Zend Debugger. It also provides a graphical interface to the php.ini configuration file, making it easy to alter PHP configuration variables or enable PHP extensions. Finally, it also allows administrators to configure allow or deny rules for the Zend Studio remote debugging client, as well as to integrate Zend Studio with the event monitoring system to relay information on PHP events. Under Zend Server CE, the event monitoring tools are absent. -[![Screenshot of Zend Server administration panel. The Server Setup section is shown. Under the Server Setup heading are the tabs Components, Extensions, Directives, Debugger, and Monitor. The Directives tab is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image23.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image22.jpg) - -**Administration**: The Administration section provides tools to change the administrator password and update the license key. It also reports on available updates, and allows the administrator to install these with a single click. Under Zend Server CE, these update management tools are absent. -[![Screenshot of Zend Server administration panel. The Administration section is shown. At the top there are the Password and Licenses tab and the Updates tab. The Password and Licenses tab is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image26.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image25.jpg) - -## Building A Simple Application...Or Two - -Now that you know your way around Zend Server, let's put together a simple PHP script to check that everything's working as it should. Using a text editor, create a file containing the following PHP code: - -[!code-xml[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample1.xml)] - -Save this file as whoami.php in the site root folder (typically, `C:\inetpub\wwwroot\`), and then browse to `http://localhost/whoami.php`. You should see something like this: -[![Screenshot of local host slash who am i dot p h p page. Text on the page says Hello world, this is P H P speaking.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image29.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image28.jpg) - -This is a very basic "Hello World" script in PHP: the echo statement simply prints a string to the output device - in this case, the browser. - -How about something a little more complicated, to demonstrate the power of PHP scripting? Here's a PHP script for a simple guessing game: a Web form that invites the user to try and guess the name of a breakfast item. The item itself is randomly selected from a pre-defined array on each iteration. Here's the code (guess.php): - -[!code-html[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample2.html)] - -This script begins by defining an array containing various common breakfast items, and initializing a session with the session\_start() function. This session is used to store a randomly-selected item from the array. A Web form prompts the user to guess the item; on submission, the user's input is stored in the $\_POST array. The script then reads the user's input from the $\_POST array, tests it against the value stored in the session, and displays a message indicating if the guess is correct or not. The strlen() and substr() functions, which respectively return string length and string segments, are used to provide hints to help the user along. - -Here's what it looks like: -[![Screenshot of who am i dot p h p web page. What's For Breakfast is written at the top. In the Your guess box is the text eggs above the submit button.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image31.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image30.jpg) - -[![Screenshot of the local host slash whoami dot p h p web page. In the text box the header What's For Breakfast is written. Above the Your guess text box is the text Correct!](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image33.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image32.jpg) - -## Integrating With Microsoft SQL Server - -One of the reasons for PHP's popularity as a Web scripting language has been its strong support for a variety of different RDBMSs...and Microsoft SQL Server is no exception! In this section, you'll see just how easy it is to get started building data-driven Web applications with PHP, by connecting to an MS-SQL database, reading records from it and displaying them as an HTML page. - -To activate MS-SQL support under Zend Server, there's really only one step: enable PHP's mssql extension, which is included with Zend Server but disabled by default. To do this, log in to the Zend Server administration console at `http://localhost/ZendServer/`, and visit the Server Setup -> Extensions section. Find the entry for mssql and turn it on. -[![Screenshot of the Zend Server administration console. The Server Setup tab is selected. The Extensions section is selected. The M S S Q L extension is highlighted and a button to Turn on the extension is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image35.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image34.jpg) - -You will be prompted to restart PHP. Do so via the button at the bottom right of the page. PHP will restart, and the extension will now be enabled. -[![Screenshot of the Zend Server administration console. The message Please wait while P H P is being restarted is shown over the Server Setup tab.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image38.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image37.jpg) - -Once you've got the module enabled, initialize a new database and populate it with some data. With SQL Server Express 2008, the easiest way to do this is to import from a file containing structured data, such as a CSV-formatted file. [Here's an example](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/books1.zip) of one such file. - -To import this data, start the SQL Server Import and Export Wizard, and select Flat File Source as the data source. Browse for and select the input CSV file. Remember that the first row of the file contains the field names. -[![Screenshot of the S Q L Server Import and Export Wizard. Flat File Source is selected in the data source box. In the Header row delimiter box C R L F is highlighted.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image41.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image40.jpg) - -Create a new database named 'library' to hold this data. -[![Screenshot of the S Q L Import and Export Wizard. The Create Database prompt is shown. In the Name box the text library is written.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image43.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image42.jpg) - -[![Screenshot of the S Q L Server Import and Export Wizard. The Choose a Destination prompt is shown. In the Database box the text library is highlighted.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image45.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image44.jpg) - -Set the destination table name, and preview the data to ensure that it will be imported correctly. -[![Screenshot of the S Q L Server Import and Export Wizard. The Select Source Tables and Views prompt is shown. The Source checkbox is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image47.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image46.jpg) - -[![Screenshot of S Q L Server Import and Export Wizard. The Data View prompt is shown. A list of Sample data is shown in the text box under the headings Author, Title, and Price.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image49.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image48.jpg) - -Confirm the settings, and proceed to import the data. -[![Screenshot of the S Q L Server Import and Export Wizard. The execution was successful is written at the top. Three columns titled Action, Status, and Message are displayed.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image51.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image50.jpg) - -You can verify that the data has been correctly imported through the sqlcmd command-line tool, as below: - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample3.cmd)] - -Now, try reading and displaying these records using PHP (mssql.php): - -[!code-html[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample4.html)] - -This script begins by opening a connection to the database server using the mssql\_connect() function with the server name and administrator credentials. It then selects the newly-minted library database with mssql\_select\_db(), and executes a query on the database with the mssql\_query() function. - -The number of records returned by the query are obtained via a call to mssql\_num\_rows(). If one or more records are present, a loop is used to iterate over the result set, returning individual records as objects via mssql\_fetch\_object(). Individual fields of each record can now be accessed as object properties; it's then fairly simple to present these field values as an HTML table. Once all the records in the result set have been processed, the connection is closed with mssql\_close(). - -Here's what the output looks like in a Web browser: -[![Screenshot of Firefox web browser page. The output table is displayed with text in two columns.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image53.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image52.jpg) - -## Integrating With MySQL - -Built-in MySQL support (as well as the option to download and install MySQL during the Zend Server installation process) means that it's also extremely easy to create MySQL-backed PHP applications with Zend Server. To illustrate, let's port the example in the previous section to use MySQL instead of Microsoft SQL Server Express. - -The first step is to create a database, and a table to hold the data. Do this by opening a command prompt window and connecting to the MySQL server using the MySQL command-line client. - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample5.cmd)] - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -[!code-sql[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample6.sql)] - -Import the raw data into this table from the CSV file using the LOAD DATA INFILE command. - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample7.cmd)] - -Create a MySQL user with privileges to access this database. - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample8.cmd)] - -Log in as the new user and check that the data has been imported with a quick SELECT. - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample9.cmd)] - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -[!code-console[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample10.cmd)] - -Now, all that's left is to do the same thing using PHP. Here's the code (mysql.php): - -[!code-html[Main](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample11.html)] - -This script begins by opening a connection to the database server using the mysqli\_connect() function with the user account credentials created in the previous step. It then executes a query on the database with the mysqli\_query() function. The number of records returned by the query are obtained via a call to mysqli\_num\_rows(), and a loop is used to iterate over the result set, returning individual records as objects via mysqli\_fetch\_object(). Individual fields of each record can now be accessed as object properties. - -Here's what the output looks like in a Web browser: -[![Screenshot of the Firefox web browser. The output table is displayed. Two columns of text are shown.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image55.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image54.jpg) - -As the previous two examples illustrate, it's extremely easy to create PHP applications that interact with different database systems using the built-in tools provided with Zend Server. - -## Improving Performance with Page Caching - -One of Zend Server's key benefits is its built-in page caching system, which automatically caches the HTML output generated by PHP scripts on the basis of pre-specified caching rules. This feature significantly boosts performance when used with applications that run lots of PHP code to generate their pages (think your average CMS). This page caching system is easily configurable by the server administrator from the Zend Server administration panel once the application is installed and deployed; it's not necessary to change any application-level code to enable this feature. - -To illustrate how this works, let's try installing and benchmarking a popular PHP application with Zend Server. The application in question is Wordpress, a popular PHP/MySQL blogging platform, and you can download it free of charge from the Wordpress Web site ([http://www.wordpress.org/](http://www.wordpress.org/)). The following discussion assumes that you have successfully installed Wordpress 2.7.1; detailed installation instructions can be obtained from the Web site ([http://codex.wordpress.org/Installing\_WordPress](http://codex.wordpress.org/Installing_WordPress)). Note that you will need to activate PHP's mysql extension through the Zend Server administration panel (Server Setup -> Extensions) before beginning the installation process. - -Assuming you've got it all set up, log in to the Wordpress administration area and adjust the permalink settings to use search-engine friendly URLs (Settings -> Permalink Settings): -[![Screenshot of the Firefox web browser. The Wordpress administration web page is displayed. The Permalink Settings page is shown. The Day and name setting is selected.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image58.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image57.jpg) - -Now, create a new post (Posts -> Add New). -[![Screenshot of the Wordpress adminstration area page. The Edit Post page is shown. A pop up window with the text Post updated, Continue editing below or go back is written.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image61.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image60.jpg) - -While you're at it, create a new category (for example, 'holiday') for your post and publish it to that category. -[![Screenshot of the Categories web page of the Wordpress website. In the Category Name box, the text holiday is written.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image64.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image63.jpg) - -Visit your Wordpress site, select the category (note down the URL, you'll need it a little further along) and you should see your newly-created post(s). -[![Screenshot of the Wordpress site. The heading Archive for the holiday Category is shown.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image67.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image66.jpg) - -Now, let's quantitatively analyze the benefit of Zend Server's page caching system, by benchmarking performance using the Microsoft Web Capacity Analysis Tool (WCAT) ([https://www.iis.net/1466/ItemPermalink.ashx](https://www.iis.net/downloads/community/2007/05/wcat-63-x86)). First, visit the Zend Server administration panel and turn off all the Zend performance components under Server Setup -> Components, including the Zend Page Cache and the Zend Optimizer+. -[![Screenshot of the Zend Server panel. A pop up window is shown at the top with the text The component Zend Page Cache will be turned off after restarting your P H P is written.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image70.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image69.jpg) - -Now, run WCAT with the category URL you noted earlier, using 20 virtual clients and warmup/duration/cooldown periods of 180/180/30 seconds (example scenario and configuration files can be downloaded here; these are based on information obtained from [the IIS.net forum post](https://forums.iis.net/t/1150332.aspx). From the output below, it's clear that the server tops out at 11.52 transactions/second, with an average response time of 1736 ms. -[![Screenshot of the Web Capacity Analysis Tool page. Under Summary is information on Transactions per second, Pathlength per transaction, Context Switches per Transaction, and more.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image73.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image72.jpg) - -[![Screenshot of the Web Capacity Analysis Tool page. Information on Time Analysis, Response Time Analysis, and Request per Response Statistics is shown.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image76.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image75.jpg) - -Now, let's see if we can improve that number. Visit the Zend Server administration panel and turn on the Zend Page Cache and Zend Optimizer+. Restart PHP, and then enter a new caching rule (Rule Management -> Caching) for your Wordpress installation, as in the following image: -[![Screenshot of the Web Capacity Analysis Tool. The Contents and Summary categories are shown. The Context Switches per Transaction and Context Switches per Request categories are flagged.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image79.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image78.jpg) - -[![Screenshot of the Web Capacity Analysis Tool. The Time Analysis, Response Time Analysis, and Request per Response Statistics categories are displayed.](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image82.jpg)](build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image81.jpg) - -As the above examples demonstrate, Zend Server provides a fully-functional, enterprise-ready PHP stack for Windows, one that plays well with all of the most common database systems, including Microsoft SQL Server and MySQL. A Web-based administration panel and event monitor makes server configuration and maintenance simple, and built-in page caching and code acceleration features can improve PHP's default performance by orders of magnitude. Have fun playing with it...and happy coding! diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/books1.zip b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/books1.zip deleted file mode 100644 index 8633b828c..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/books1.zip and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image1.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image1.jpg deleted file mode 100644 index 6bd345c1f..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image10.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image10.jpg deleted file mode 100644 index 2dd349dc0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image10.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image11.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image11.jpg deleted file mode 100644 index 6d49ae62a..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image11.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image12.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image12.jpg deleted file mode 100644 index 6d49ae62a..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image12.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image13.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image13.jpg deleted file mode 100644 index c2f8f8002..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image13.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image14.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image14.jpg deleted file mode 100644 index c2f8f8002..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image14.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image15.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image15.jpg deleted file mode 100644 index c2f8f8002..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image15.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image16.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image16.jpg deleted file mode 100644 index 771569f40..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image16.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image17.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image17.jpg deleted file mode 100644 index 771569f40..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image17.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image18.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image18.jpg deleted file mode 100644 index 771569f40..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image18.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image19.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image19.jpg deleted file mode 100644 index c6174d20e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image19.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image2.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image2.jpg deleted file mode 100644 index 6bd345c1f..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image20.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image20.jpg deleted file mode 100644 index c6174d20e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image20.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image21.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image21.jpg deleted file mode 100644 index c6174d20e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image21.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image22.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image22.jpg deleted file mode 100644 index ad0fec733..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image22.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image23.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image23.jpg deleted file mode 100644 index ad0fec733..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image23.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image24.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image24.jpg deleted file mode 100644 index ad0fec733..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image24.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image25.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image25.jpg deleted file mode 100644 index c94be77cd..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image25.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image26.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image26.jpg deleted file mode 100644 index c94be77cd..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image26.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image27.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image27.jpg deleted file mode 100644 index c94be77cd..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image27.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image28.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image28.jpg deleted file mode 100644 index 82e859668..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image28.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image29.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image29.jpg deleted file mode 100644 index 82e859668..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image29.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image3.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image3.jpg deleted file mode 100644 index ef5070ae1..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image30.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image30.jpg deleted file mode 100644 index 7f9663151..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image30.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image31.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image31.jpg deleted file mode 100644 index 7f9663151..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image31.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image32.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image32.jpg deleted file mode 100644 index bdfbaeda0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image32.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image33.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image33.jpg deleted file mode 100644 index bdfbaeda0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image33.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image34.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image34.jpg deleted file mode 100644 index 208ec3042..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image34.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image35.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image35.jpg deleted file mode 100644 index 208ec3042..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image35.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image36.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image36.jpg deleted file mode 100644 index 208ec3042..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image36.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image37.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image37.jpg deleted file mode 100644 index 5909904c4..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image37.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image38.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image38.jpg deleted file mode 100644 index 5909904c4..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image38.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image39.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image39.jpg deleted file mode 100644 index 5909904c4..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image39.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image4.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image4.jpg deleted file mode 100644 index ef5070ae1..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image40.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image40.jpg deleted file mode 100644 index 8de37ff3b..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image40.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image41.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image41.jpg deleted file mode 100644 index 8de37ff3b..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image41.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image42.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image42.jpg deleted file mode 100644 index 46567a14c..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image42.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image43.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image43.jpg deleted file mode 100644 index 46567a14c..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image43.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image44.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image44.jpg deleted file mode 100644 index 4e9611d15..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image44.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image45.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image45.jpg deleted file mode 100644 index 4e9611d15..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image45.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image46.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image46.jpg deleted file mode 100644 index b341ba10c..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image46.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image47.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image47.jpg deleted file mode 100644 index b341ba10c..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image47.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image48.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image48.jpg deleted file mode 100644 index 510345ff0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image48.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image49.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image49.jpg deleted file mode 100644 index 510345ff0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image49.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image5.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image5.jpg deleted file mode 100644 index 57e004767..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image50.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image50.jpg deleted file mode 100644 index 70ec45dab..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image50.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image51.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image51.jpg deleted file mode 100644 index 70ec45dab..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image51.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image52.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image52.jpg deleted file mode 100644 index 556699f97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image52.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image53.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image53.jpg deleted file mode 100644 index 556699f97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image53.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image54.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image54.jpg deleted file mode 100644 index a33061dc9..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image54.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image55.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image55.jpg deleted file mode 100644 index a33061dc9..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image55.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image56.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image56.jpg deleted file mode 100644 index a33061dc9..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image56.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image57.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image57.jpg deleted file mode 100644 index 24cf60bd8..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image57.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image58.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image58.jpg deleted file mode 100644 index 24cf60bd8..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image58.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image59.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image59.jpg deleted file mode 100644 index 24cf60bd8..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image59.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image6.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image6.jpg deleted file mode 100644 index 57e004767..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image60.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image60.jpg deleted file mode 100644 index 910fdf464..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image60.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image61.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image61.jpg deleted file mode 100644 index 910fdf464..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image61.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image62.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image62.jpg deleted file mode 100644 index 910fdf464..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image62.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image63.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image63.jpg deleted file mode 100644 index 7edd91b4e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image63.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image64.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image64.jpg deleted file mode 100644 index 7edd91b4e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image64.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image65.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image65.jpg deleted file mode 100644 index 7edd91b4e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image65.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image66.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image66.jpg deleted file mode 100644 index aec621551..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image66.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image67.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image67.jpg deleted file mode 100644 index aec621551..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image67.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image68.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image68.jpg deleted file mode 100644 index aec621551..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image68.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image69.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image69.jpg deleted file mode 100644 index dcfbce06a..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image69.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image7.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image7.jpg deleted file mode 100644 index 6135c1ec7..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image70.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image70.jpg deleted file mode 100644 index dcfbce06a..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image70.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image71.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image71.jpg deleted file mode 100644 index dcfbce06a..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image71.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image72.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image72.jpg deleted file mode 100644 index e3aee8801..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image72.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image73.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image73.jpg deleted file mode 100644 index e3aee8801..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image73.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image74.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image74.jpg deleted file mode 100644 index e3aee8801..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image74.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image75.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image75.jpg deleted file mode 100644 index 517181944..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image75.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image76.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image76.jpg deleted file mode 100644 index 517181944..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image76.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image77.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image77.jpg deleted file mode 100644 index 517181944..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image77.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image78.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image78.jpg deleted file mode 100644 index e5bcffeb3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image78.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image79.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image79.jpg deleted file mode 100644 index e5bcffeb3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image79.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image8.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image8.jpg deleted file mode 100644 index 6135c1ec7..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image80.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image80.jpg deleted file mode 100644 index e5bcffeb3..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image80.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image81.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image81.jpg deleted file mode 100644 index 4b702a885..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image81.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image82.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image82.jpg deleted file mode 100644 index 4b702a885..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image82.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image9.jpg b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image9.jpg deleted file mode 100644 index 2dd349dc0..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/_static/image9.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample1.xml b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample1.xml deleted file mode 100644 index f31023ea9..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample1.xml +++ /dev/null @@ -1,3 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample10.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample10.cmd deleted file mode 100644 index 74bd4d7ab..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample10.cmd +++ /dev/null @@ -1,14 +0,0 @@ -mysql> USE library -Database changed - -mysql> SELECT * FROM books LIMIT 0,5; -+----+--------------------+-----------------------------------+---------+ -| id | author | title | price | -+----+--------------------+-----------------------------------+---------+ - | 1 | Arthur Conan Doyle | A Study In Scarlet | $35.00 - | 2 | John Grisham | A Time To Kill | $50.00 - | 3 | Sue Townsend | Adrian Mole: From Minor To Major | $97.00 - | 4 | Sue Townsend | Adrian Mole: The Wilderness Years | $97.00 - | 5 | Enid Blyton | Adventure Of The Strange Ruby | $16.00 -+----+--------------------+-----------------------------------+---------+ -5 rows in set (0.00 sec) \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample11.html b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample11.html deleted file mode 100644 index 72cea6bb0..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample11.html +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - '; - while ($row = mysqli_fetch_object($result)) { - echo ''; - echo '' . $row->author . ''; - echo '' . $row->title . ''; - echo ''; - } - echo ''; - } - - // close connection - mysqli_close($db); - ?> - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample2.html b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample2.html deleted file mode 100644 index 069e7f6f3..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample2.html +++ /dev/null @@ -1,45 +0,0 @@ - - - - -

What's For Breakfast?

- -
- -
- - - -
- Your guess:
-
- -
- Hint: characters, - beginning with '' - and ending with '' - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample3.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample3.cmd deleted file mode 100644 index 52b87731b..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample3.cmd +++ /dev/null @@ -1,10 +0,0 @@ -C:\>sqlcmd -S .\SQLEXPRESS - -1> USE library -2> GO -Changed database context to 'library' - -1> SELECT COUNT(*) FROM books -2> GO ------------- - 28 \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample4.html b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample4.html deleted file mode 100644 index c25eff93a..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample4.html +++ /dev/null @@ -1,43 +0,0 @@ - - - - - - - '; - while ($row = mssql_fetch_object($query)) { - echo ''; - echo '' . $row->Author . ''; - echo '' . $row->Title . ''; - echo ''; - } - echo ''; - } - - // close connection - mssql_close($db); - ?> - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample5.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample5.cmd deleted file mode 100644 index 69579ff26..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample5.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\Program Files\MySQL\bin>mysql -u root -p -Enter password: -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 1 -Server version: 5.1.30-community MySQL Community Server (GPL) \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample6.sql b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample6.sql deleted file mode 100644 index 2171f2555..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample6.sql +++ /dev/null @@ -1,13 +0,0 @@ -mysql> CREATE DATABASE library; -Query OK, 1 row(s) affected (0.01 sec) - -mysql> USE library; -Database changed - -mysql> CREATE TABLE books ( - -> id INT(4) AUTO_INCREMENT PRIMARY KEY, - -> author VARCHAR(255), - -> title VARCHAR(255), - -> price VARCHAR(30) - -> ); -Query OK, 0 rows affected (0.05 sec) \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample7.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample7.cmd deleted file mode 100644 index 8b43a0e03..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample7.cmd +++ /dev/null @@ -1,5 +0,0 @@ -mysql> LOAD DATA INFILE 'G:\\books.csv' INTO TABLE books - -> FIELDS TERMINATED BY ',' IGNORE 1 LINES - -> (author, title, price); -Query OK, 28 rows affected (0.00 sec) -Records: 28 Deleted: 0 Skipped: 0 Warnings: 0 \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample8.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample8.cmd deleted file mode 100644 index ca3bfd740..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -mysql> GRANT ALL ON library.* TO library@localhost IDENTIFIED BY 'bookworm'; \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample9.cmd b/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample9.cmd deleted file mode 100644 index 173f2d588..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/build-a-high-performance-php-stack-with-windows-iis-and-zend-server/samples/sample9.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\Program Files\MySQL\bin>mysql -u library -p -Enter password: ******* -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 3 -Server version: 5.1.30-community MySQL Community Server (GPL) \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior.md b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior.md deleted file mode 100644 index c2ac72c6c..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Configure PHP Process Recycling Behavior" -author: rick-anderson -description: "Introduction Make sure that FastCGI always recycles the php-cgi.exe processes before the native PHP recycling kicks in. The FastCGI process recycling behavio..." -ms.date: 11/15/2009 -ms.assetid: 2caf4f65-32b2-454e-8613-c9e90b178363 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior -msc.type: authoredcontent ---- -# Configure PHP Process Recycling Behavior - -by Tali Smith - -## Introduction - -Make sure that FastCGI always recycles the php-cgi.exe processes before the native PHP recycling kicks in. The FastCGI process recycling behavior is controlled by the configuration property **instanceMaxRequests**. This property specifies how many requests the FastCGI process will process before recycling. PHP also has a similar process recycling functionality that is controlled by an environment variable **PHP\_FCGI\_MAX\_REQUESTS**. By setting **instanceMaxRequests** to be smaller or equal to **PHP\_FCGI\_MAX\_REQUESTS**, you can ensure that the native PHP process recycling logic will never kick in. - -The FastCGI settings can be configured either by using IIS Manager or by using the command-line tool AppCmd. - -## Use the IIS Manager - -1. To configure FastCGI recycling settings by using IIS Manager, you must install Administration Pack for IIS 7.0 and above, and then select FastCGI Settings at the server level. - - ![Screenshot of I I S Manager window with application icons displayed in features view.](configure-php-process-recycling-behavior/_static/image1.jpg) - *Figure 1: IIS Manager, FastCGI Settings* -2. Next, select the FastCGI application that you want to configure, and then click **Edit** in the **Actions** pane on the right side. - - ![Screenshot of I I S Manager window with Fast C G I Settings tab displayed.](configure-php-process-recycling-behavior/_static/image3.jpg) - *Figure 2: FastCGI Settings page* -3. In the **Edit FastCGI Application** dialog box, set **InstanceMaxRequest** to **10000,** and then click on the **browse** button next to the **EnvironmentVariables** setting. - - ![Screenshot of Edit Fast C G I Application dialog box with Enviornment Variables setting highlighted.](configure-php-process-recycling-behavior/_static/image5.jpg) - *Figure 3: Edit FastCGI Application dialog box* -4. Add the **PHP\_FCGI\_MAX\_REQUESTS** environment variable, and set its value to **10000**. - > [!NOTE] - > If you do not configure these settings, then the following default settings are used: **InstanceMaxRequests** of 200, **PHP\_FCGI\_MAX\_REQUESTS** of 500 (on most PHP builds). - - ![Screenshot of the Environment Variables Collection Editor dialog box. The P H P F F C G I Max Requests setting and value are highlighted.](configure-php-process-recycling-behavior/_static/image7.jpg) - *Figure 4: Environment Variables Collection Editor dialog box* - -## Use the Command Line - -To configure the recycling behavior of FastCGI and PHP via **appcmd**, use the following commands: - -[!code-console[Main](configure-php-process-recycling-behavior/samples/sample1.cmd)] - -[!code-console[Main](configure-php-process-recycling-behavior/samples/sample2.cmd)] - -## Links for Further Information - -- [Using FastCGI to Host PHP Applications on IIS 7.0 and Above](../install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md). diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image1.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image1.jpg deleted file mode 100644 index 0fa977e97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image2.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image2.jpg deleted file mode 100644 index 0fa977e97..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image2.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image3.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image3.jpg deleted file mode 100644 index c03192682..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image3.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image4.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image4.jpg deleted file mode 100644 index c03192682..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image4.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image5.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image5.jpg deleted file mode 100644 index fa140cb54..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image5.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image6.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image6.jpg deleted file mode 100644 index fa140cb54..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image6.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image7.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image7.jpg deleted file mode 100644 index 2c0f159ee..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image7.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image8.jpg b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image8.jpg deleted file mode 100644 index 2c0f159ee..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/_static/image8.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample1.cmd b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample1.cmd deleted file mode 100644 index 5c083bfb4..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='c:\{php_folder}\php-cgi.exe'].instanceMaxRequests:10000 \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample2.cmd b/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample2.cmd deleted file mode 100644 index 193303e4e..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/configure-php-process-recycling-behavior/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='C:\{php_folder}\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS' \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/develop-on-iis-7-and-above.md b/iis/application-frameworks/running-php-applications-on-iis/develop-on-iis-7-and-above.md deleted file mode 100644 index 2b6bcd5a5..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/develop-on-iis-7-and-above.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: "Develop on IIS 7" -author: rick-anderson -description: "The following articles provide information about developing on Internet Information Services 7 (IIS 7) and above. Use Development Tools Microsoft® Visual Stu..." -ms.date: 11/15/2009 -ms.assetid: 5ef68c30-c8cf-4988-9a6e-f05948bf1db6 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/develop-on-iis-7-and-above -msc.type: authoredcontent ---- -# Develop on IIS 7 - -by Tali Smith - -The following articles provide information about developing on Internet Information Services 7 (IIS 7) and above. - -## Use Development Tools - -Microsoft® Visual Studio® provides several options for working with IIS when developing Web sites and Web applications. In Microsoft® Visual Studio® 2008, the Web site and Web application features support IIS in Windows® 7, Windows Vista®, and Windows Server® 2008 operating system environments. In addition, the Web Deployment Project 2008 also provides support for IIS. - -The following topics address development tools; - -- [Visual Studio 2008 with IIS 7 and Above](../../develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md). -- [Microsoft® Visual Studio® 2005 with IIS 7 and Above](../../develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md). -- [Using Visual Studio 2008 with IIS 7.0 and Above](../../develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md). -- [Using Visual Studio 2005 with IIS 7.0 and Above](../../develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md). - -## Extend IIS 7 and Above - -IIS is built with a completely modular architecture on top of rich extensibility APIs. This enables developers to easily add, remove, and even replace built-in IIS components with hand-crafted ones that are specifically suited for any given Web site. It has never been so easy to plug code deep into the IIS core pipeline and extend IIS in ways that were impossible before. - -For example, a few lines of code allow developers to write modules or handlers that provide new authentication and authorization schemes, do run-time or security analysis of incoming requests, and inspect responses. But to provide a real value-add, these modules must be manageable via programming interfaces, command-line tools, and a user interface. - -### Runtime Extensibility - -- [An End-to-End Extensibility Example for IIS 7.0 and Above Developers](../../develop/runtime-extensibility/an-end-to-end-extensibility-example-for-iis-developers.md). -- [Developing IIS 7.0 and Above Modules and Handlers with the .NET Framework](../../develop/runtime-extensibility/developing-iis-modules-and-handlers-with-the-net-framework.md). -- [Sample: Web Analytics Tracking Module](../../develop/runtime-extensibility/sample-web-analytics-tracking-module.md). -- [Extending Web Server Functionality in .NET.](../../develop/runtime-extensibility/extending-web-server-functionality-in-net.md) -- [Develop a Native C\C++ Module for IIS 7.0 and Above](../../develop/runtime-extensibility/develop-a-native-cc-module-for-iis.md). -- [Developing a Module Using .NET](../../develop/runtime-extensibility/developing-a-module-using-net.md). -- [How to Add Tracing to IIS 7.0 and Above Managed Modules](../../develop/runtime-extensibility/how-to-add-tracing-to-iis-managed-modules.md). -- [Sample: Image Watermark Module](../../develop/runtime-extensibility/sample-image-watermark-module.md). - -### Extend the Management UI - -- [Overview of MWA and MWM for IIS 7.0 and Above](../../develop/extending-the-management-ui/overview-of-mwa-and-mwm-for-iis.md). -- [How to Create a Simple IIS Manager Module](../../develop/extending-the-management-ui/how-to-create-a-simple-iis-manager-module.md). -- [How to Get Started Extending Module Properties for IIS 7.0 and Above in IIS Manager](../../develop/extending-the-management-ui/how-to-get-started-extending-module-properties-for-iis-in-iis-manager.md). -- [Understanding UI Extension Authoring](../../develop/extending-the-management-ui/understanding-ui-extension-authoring.md) - -### Extend the Configuration - -- [Configuration Extensibility](../../develop/extending-iis-configuration/configuration-extensibility.md). -- [Extending IIS Configuration](../../develop/extending-iis-configuration/extending-iis-configuration.md). -- [Extending IIS 7.0 and Above Schema and Accessing the Custom Sections Using MWA](../../develop/extending-iis-configuration/extending-iis-schema-and-accessing-the-custom-sections-using-mwa.md). - -### Develop for FTP 7.5 - -Microsoft has created a new File Transfer Protocol (FTP) service that has been completely rewritten for Windows Server® 2008. This new FTP service incorporates many new features that enable Web authors to publish content better than before, and offers Web administrators more security and deployment options. - -The new FTP 7.5 service supports extensibility that allows you to extend the built-in functionality that ships with the FTP service. More specifically, FTP 7.5 supports creating your own authentication and authorization providers. You can also create providers for custom FTP logging and for determining the home directory information for your FTP users. - -For managed code (C#), see: - -- [How to Use Managed Code (C#) to Create a Simple FTP Authentication Provider](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-authentication-provider.md). -- [How to Use Managed Code (C#) to Create a Simple FTP Home Directory Provider](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-home-directory-provider.md). -- [How to Use Managed Code (C#) to Create a Simple FTP Logging Provider](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-logging-provider.md). -- [How to Use Managed Code (C#) to Create an FTP Authentication Provider using an XML Database](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-using-an-xml-database.md). -- [How to Use Managed Code (C#) to Create an FTP Provider that Sends an Email when Files are Uploaded](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-sends-an-email-when-files-are-uploaded.md). -- [How to Use Managed Code (C#) to Create an FTP Authentication Provider with Dynamic IP Restrictions](../../develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-with-dynamic-ip-restrictions.md). - -For native code (C++), see: - -- [How to Use Native Code (C++) to Create a Simple FTP Authentication Provider](../../develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-authentication-provider.md). -- [How to Use Native Code (C++) to Create a Simple FTP Home Directory Provider](../../develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-home-directory-provider.md). -- [How to Use Native Code (C++) to Create a Simple FTP Logging Provider](../../develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-logging-provider.md). - -For managed code (Microsoft® Visual Basic®), see: - -- [How to Use Managed Code (Visual Basic) to Create a Simple FTP Home Directory Provider](../../develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-home-directory-provider.md). -- [How to Use Managed Code (Visual Basic) to Create a Simple FTP Logging Provider.](../../develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-logging-provider.md) diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above.md b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above.md deleted file mode 100644 index 71980abf5..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "Enable PHP Syntax Highlighting on IIS 7" -author: rick-anderson -description: "You can configure Internet Information Services 7 (IIS 7) and above to output syntax-highlighted source code for PHP files stored on the Web server or Web si..." -ms.date: 11/15/2009 -ms.assetid: cf9e7b8e-a97b-42f7-823b-a8bdff7afbc2 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above -msc.type: authoredcontent ---- -# Enable PHP Syntax Highlighting on IIS 7 - -by Tali Smith - -You can configure Internet Information Services 7 (IIS 7) and above to output syntax-highlighted source code for PHP files stored on the Web server or Web site. This feature is useful in development environments because you can quickly make the source code accessible to other team members. - -> [!NOTE] -> You should not attempt these procedures on any Internet-accessible Web site as this greatly compromises the security of your Web application. - -The HTTP requests for the PHP source code are usually identified by the .phps file extension (for example, `http://localhost/index.phps`). You must configure IIS to understand and handle the HTTP requests with this extension. There are two options for this: create an IIS handler mapping for \*.phps or use the [IIS URL Rewrite Module](https://www.iis.net/downloads/microsoft/url-rewrite "Download the IIS URL Rewrite Module"). - -## Configure IIS Handler Mapping - -The PHP executable supports a command-line argument "-s" that is used to display color, syntax-highlighted source code for any PHP script. You can create a handler mapping for "\*.phps" and use C:\[path to PHP installation]\php-cgi.exe|-s as the executable: - -![Screenshot of the Add Module Mapping dialog with settings to create the handler mapping.](enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.jpg) -*Figure 1: Add Module Mapping* - -Next, rename or copy the .php file to a .phps file, and then request the .phps file from a Web browser. - -## Use IIS URL Rewrite Module - -If you do not want to rename each .php file to .phps, you can use the IIS URL Rewrite rule and a simple PHP script. In the root directory of your Web site, create a file called **highlighter.phpb**, and then copy the following code into the file: - -[!code-xml[Main](enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample1.xml)] - -After that, add the following rewrite rule to the **Web.config** file located at the root directory of your Web site: - -[!code-xml[Main](enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample2.xml)] - -Now, if you request a URL that has an extension of .phps, the highlighted source code is returned in response, provided that the corresponding .php file exists under the Web site's root directory. - -![Screenshot of a browser window showing the highlighted source code.](enable-php-syntax-highlighting-on-iis-7-and-above/_static/image3.gif) -*Figure 2: Highlighted code response* - -This article is based on the blog post "[Enable PHP Syntax Highlighting on IIS 7](https://blogs.iis.net/ruslany/archive/2009/10/07/enable-php-syntax-highlighting-on-iis-7.aspx)" by Ruslan Yakushev, published on October 7, 2009. diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.gif b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.gif deleted file mode 100644 index 4a6ac0c4e..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.gif and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.jpg b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.jpg deleted file mode 100644 index ae7f4b576..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image1.jpg and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image3.gif b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image3.gif deleted file mode 100644 index 8a4192971..000000000 Binary files a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/_static/image3.gif and /dev/null differ diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample1.xml b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample1.xml deleted file mode 100644 index e31764a03..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample1.xml +++ /dev/null @@ -1,6 +0,0 @@ - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample2.xml b/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample2.xml deleted file mode 100644 index e82ecd026..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/enable-php-syntax-highlighting-on-iis-7-and-above/samples/sample2.xml +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/running-php-applications-on-iis/how-to-develop-on-the-microsoft-web-platform.md b/iis/application-frameworks/running-php-applications-on-iis/how-to-develop-on-the-microsoft-web-platform.md deleted file mode 100644 index 7cc615d90..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/how-to-develop-on-the-microsoft-web-platform.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "How to Develop on the Microsoft Web Platform" -author: rick-anderson -description: "The Windows ® and Linux operating systems approach Web development in different ways. Linux is easily configured, and it lets enthusiasts get “under the hood..." -ms.date: 11/15/2009 -ms.assetid: b174c188-7477-4995-a6f1-a5ede62d6915 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/how-to-develop-on-the-microsoft-web-platform -msc.type: authoredcontent ---- -# How to Develop on the Microsoft Web Platform - -by Tali Smith - -The Windows® and Linux operating systems approach Web development in different ways. Linux is easily configured, and it lets enthusiasts get "under the hood" and tweak every aspect of the environment. Scripting languages, with their ability to morph and adapt, can automate the tweaking of the system. In contrast, the Windows-based, Microsoft® Web Platform is not designed to be tweaked by going to bare metal. Instead, the system is monitored, controlled, and modified by using well-defined interfaces, plug-in boards, and so on. Scripting languages are most often used in Windows to drive systems through APIs not through the modification of configuration files. Understanding this difference in philosophy is key to the effective use of scripting languages on the Windows-based platform. - -Until now, PHP developers may have written their applications on Windows, reaping the benefits of the intuitive user interfaces, but then used the open-source Linux-Apache-MySQL-PHP (LAMP) platform to run their applications. With FastCGI support native to Windows Server® 2008, and available as an extension for Windows Server® 2003, PHP developers now have a strong platform in Windows Server for both developing and running Web applications. - -The following articles provide guidance for software developers using the Microsoft Web Platform: - -- [Provision Web Sites for PHP Applications Using Managed Code](provision-web-sites-for-php-applications-using-managed-code.md). This article describes how to implement the provisioning aspect of features such as File Transfer Protocol (FTP) capabilities, creation of virtual directories, and the amount of disk space through C#. -- [Package an Application for the Windows® Web Application Gallery](../../develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md). This article describes how to prepare your application for the [Windows Web App Gallery](https://www.microsoft.com/web/gallery/). -- [Reference for the Web Application Package](../../develop/windows-web-application-gallery/reference-for-the-web-application-package.md). This article provides in-depth information to support the guidance in [Package an Application for the Windows Web Application Gallery](../../develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md). -- [Integrate the Windows Web Application Gallery in to a Control Panel](../../develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md). This article describes how you can integrate the Windows Web Application Gallery applications in your application. -- [Enable PHP Syntax Highlighting](enable-php-syntax-highlighting-on-iis-7-and-above.md). You can configure Internet Information Services 7 (IIS 7) and above to output syntax-highlighted source code for PHP files stored on the Web server or Web site. This feature can be very useful in development environments because you can quickly make the source code accessible to other team members. - -Additional resources for developers can be found in: - -- [Develop on IIS 7 and Above](develop-on-iis-7-and-above.md). This article provides links to information that is useful for software developers. diff --git a/iis/application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above.md b/iis/application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above.md deleted file mode 100644 index b65143e42..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "MIX08: Partying with PHP on Microsoft Internet Information Services 7" -author: drewby -description: "This video is from the MIX08 conference. http://visitmix.com Discover the advantages of running PHP applications on Microsoft Internet Information Services...." -ms.date: 05/09/2008 -ms.assetid: eceb0ea2-79cb-4b63-9b65-320ee6405462 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/mix08-partying-with-php-on-microsoft-internet-information-services-7-and-above -msc.type: video ---- -# MIX08: Partying with PHP on Microsoft Internet Information Services 7 - -by [Drew Robbins](https://github.com/drewby) - -This video is from the MIX08 conference. Discover the advantages of running PHP applications on Microsoft Internet Information Services. Learn how to take advantage of the integrated pipeline and .NET functionality, and use the new remote management tools. diff --git a/iis/application-frameworks/running-php-applications-on-iis/provision-web-sites-for-php-applications-using-managed-code.md b/iis/application-frameworks/running-php-applications-on-iis/provision-web-sites-for-php-applications-using-managed-code.md deleted file mode 100644 index 30bacaa2e..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/provision-web-sites-for-php-applications-using-managed-code.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Provision Web Sites for PHP Applications Using Managed Code" -author: rick-anderson -description: "Initially, a new user account must be established for the customer. Once the account has been set up, the customer decides which features and options the sit..." -ms.date: 11/15/2009 -ms.assetid: 3e29df44-2469-420f-869f-16554215ef62 -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/provision-web-sites-for-php-applications-using-managed-code -msc.type: authoredcontent ---- -# Provision Web Sites for PHP Applications Using Managed Code - -by Tali Smith - -Initially, a new user account must be established for the customer. Once the account has been set up, the customer decides which features and options the site should incorporate: for example, how much disk space, FTP capability, creation of virtual directories, and whether or not databases are required. You can also build control panels or dashboard applications that let customers create and manage these features. - -While there are a number of ways that these capabilities can be implemented into the Control Panel, [Provisioning Sample in C#](../../manage/provisioning-and-managing-iis/provisioning-sample-in-c.md) describes how to implement the provisioning aspect of these features through managed code. The article describes how to provision a new user account, create content storage, create an application pool, create a site, create a binding, creat a root application, creat a virtual directory, and create an FTP site. - -## Links for Further Information - -- [Create a Web Site (IIS 7).](https://technet.microsoft.com/library/cc772350(WS.10).aspx) -- [Managing Applications in IIS 7](/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc771654(v=ws.10)). -- [An Introduction to Windows PowerShell and IIS 7.0 and Above](../../manage/powershell/an-introduction-to-windows-powershell-and-iis.md). -- [Provisioning Web Sites on IIS 7.0 and Above](../../manage/creating-websites/index.md). -- [Web Site Deployment Made Easy](../../get-started/introduction-to-iis/web-site-deployment-made-easy.md). -- [Hosting Services Code Sample](../../manage/provisioning-and-managing-iis/index.md). -- [Code Samples and Scripts](../../manage/provisioning-and-managing-iis/index.md). diff --git a/iis/application-frameworks/running-php-applications-on-iis/set-up-fastcgi-for-php.md b/iis/application-frameworks/running-php-applications-on-iis/set-up-fastcgi-for-php.md deleted file mode 100644 index 505e86d60..000000000 --- a/iis/application-frameworks/running-php-applications-on-iis/set-up-fastcgi-for-php.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Set Up FastCGI for PHP" -author: rick-anderson -description: "Improved performance and greater reliability for PHP applications is ensured by the new FastCGI component for IIS 7.0 and previous versions. This tutorial co..." -ms.date: 02/24/2008 -ms.assetid: 4909cba3-10bd-40e4-907c-699f9a325f0a -msc.legacyurl: /learn/application-frameworks/running-php-applications-on-iis/set-up-fastcgi-for-php -msc.type: video ---- -# Set Up FastCGI for PHP - -by IIS Team - -Improved performance and greater reliability for PHP applications is ensured by the new FastCGI component for IIS 7.0 and previous versions. This tutorial covers installing PHP 5.2.1 and the new FastCGI component to IIS 7.0 in Windows Vista. diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis.md deleted file mode 100644 index e829bf191..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Configure a PHP Website on IIS" -author: rmcmurray -description: "To install an IIS web server and configure it for PHP web applications, follow these steps: Install IIS and PHP, Configure PHP Settings, and Configure PHP Ap..." -ms.date: 04/14/2013 -ms.assetid: d4b9179e-834f-44b0-b26f-bb34f2539d16 -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis -msc.type: authoredcontent ---- -# Configure a PHP Website on IIS - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -## Overview - -To install an IIS web server and configure it for PHP web applications, follow the steps listed. - -- [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) -- [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md) -- [Step 3: Configure PHP Application Security](configuring-step-3-configure-php-application-security.md) - -For planning information to review before deployment, see [Plan a PHP Website on IIS](plan-a-php-website-on-iis.md). For more information, see [Build a PHP Website on IIS](overview-build-a-php-website-on-iis.md). - -## Software Requirements - -To get the most from this scenario, you must have access to a computer running one of the following operating systems: - -- Windows Server® 2012 -- Windows® 8 diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php.md deleted file mode 100644 index 62d07f67d..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: "Configuring Step 1: Install IIS and PHP" -author: rmcmurray -description: "In this step of building a PHP website, you install IIS and FastCGI, download and install PHP and the WinCache extension, and upload your PHP application." -ms.date: 04/14/2013 -ms.assetid: 73b8ec4b-7af9-482a-9fef-f0b8200926e7 -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php -msc.type: authoredcontent ---- -# Configuring Step 1: Install IIS and PHP - -by Keith Newman and [Robert McMurray](https://github.com/rmcmurray) - -In this step of building a PHP website, you install IIS and FastCGI, download and install PHP and the WinCache extension, and upload your PHP application. - -When you are done, make sure that IIS and the PHP are installed, and your PHP application has been added to your website. Then go on to [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md). - - - -## 1.1. Install IIS - -To install IIS, use the following steps: - -### To install IIS on Windows Server 2012 - -1. On the **Start** page, click the **Server Manager** tile, and then click **OK**. -2. In **Server Manager**, select **Dashboard**, and click **Add roles and features**. -3. In the **Add Roles and Features Wizard**, on the **Before You Begin** page, click **Next**. -4. On the **Select Installation Type** page, select **Role-based or Feature-based Installation** and click **Next** -5. On the **Select Destination Server** page, select **Select a server from the server pool**, select your server, and click **Next**. -6. On the **Select Server Roles** page, select **Web Server (IIS)**, and then click **Next**. -7. On the **Select Features** page, note the preselected features that are installed by default, and then select **CGI**. This selection also installs FastCGI, which is recommended for PHP applications. -8. Click **Next**. -9. On the **Web Server Role (IIS)** page, click **Next**. -10. On the **Select Role Services** page, note the preselected role services that are installed by default, and then click **Next**. - - > [!NOTE] - > You only have to install the IIS 8 default role services for a static-content web server. - -11. On the **Confirm Installation Selections** page, confirm your selections, and then click **Install**. -12. On the **Installation Progress** page, confirm that your installation of the Web Server (IIS) role and required role services completed successfully, and then click **Close**. -13. To verify that IIS installed successfully, type the following into a web browser: - - `http://localhost` - - You should see the default IIS Welcome page. - -### To install IIS on Windows 8 - -1. On the **Start** page, type **Control Panel**, and then click the **Control Panel** icon in the search results. -2. In **Control Panel**, click **Programs**, and then click **Turn Windows features on or off**. -3. In the **Windows Features** dialog box, click **Internet Information Services**, note the preselected features that are installed by default, and then select **CGI**. This selection also installs FastCGI, which is recommended for PHP applications. -4. Click **OK**. -5. To verify that IIS installed successfully, type the following into a web browser: - - `http://localhost` - - You see the default IIS Welcome page. - - - -## 1.2. Download and Install PHP Manually - -The procedures in this section guide you to install PHP Manually: - -- Download PHP and the WinCache extension. -- Install PHP and WinCache. -- Add the PHP installation folder to the Path environment variable. -- Set up a handler mapping for PHP. -- Add default document entries for PHP. -- Test your PHP installation. - -To keep this procedure simple, install the WinCache extension but do not configure it. You will configure and test WinCache in [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md). - -### To download and install PHP and WinCache - -1. Open your browser to [Windows for PHP Download Page](https://windows.php.net/download/) and download the PHP non-thread-safe zip package. -2. Download the WinCache extension from the [List of Windows Extensions for PHP](https://sourceforge.net/projects/wincache/). -3. Extract all files in the PHP .zip package to a folder of your choice, for example `C:\PHP\`. -4. Extract the WinCache .zip package to the PHP extensions folder (\ext), for example `C:\PHP\ext`. The WinCache .zip package contains one file (Php\_wincache.dll). -5. Open **Control Panel**, click **System and Security**, click **System**, and then click **Advanced system settings**. -6. In the **System Properties** window, select the **Advanced** tab, and then click **Environment Variables**. -7. Under **System variables**, select **Path**, and then click **Edit**. -8. Add the path to your PHP installation folder to the end of the **Variable value**, for example `;C:\PHP`. Click **OK**. -9. Open IIS Manager, select the hostname of your computer in the **Connections** panel, and then double-click **Handler Mappings**. -10. In the **Action** panel, click **Add Module Mapping**. -11. In **Request path**, type **\*.php**. -12. From the **Module** menu, select FastCgiModule. -13. In the **Executable** box, type the full path to Php-cgi.exe, for example `C:\PHP\Php-cgi.exe`. -14. In **Name**, type a name for the module mapping, for example **FastCGI**. -15. Click **OK**. -16. Select the hostname of your computer in the **Connections** panel, and double-click **Default Document**. -17. In the **Action** panel, click **Add**. Type **Index.php** in the **Name** box, and then click **OK**. -18. Click **Add** again. Type **Default.php** in the **Name** box, and then click **OK**. - -### To test your PHP installation - -1. Open a text editor, for example Notepad, as Administrator. -2. In a new file, type the following text: `` -3. Save the file as `C:\inetpub\wwwroot\Phpinfo.php`. -4. Open a browser and enter the following URL: - - `http://localhost/phpinfo.php` - - A nicely formatted webpage is displayed showing the current PHP settings. - - - -## 1.3. Add Your PHP Application - -Once you have IIS and PHP installed, you can add a PHP application to your web server. This section describes how to set up your PHP application on an IIS web server with PHP installed. It does not explain how to develop a PHP application. - -### To add a PHP web application - -1. Open IIS Manager. - - - For Windows Server 2012, on the **Start** page click the **Server Manager** tile, and then click **OK**. On the **Server Manager Dashboard**, click the **Tools** menu, and then click **Internet Information Services (IIS) Manager**. - - For Windows 8, on the **Start** page type **Control Panel**, and then click the **Control Panel** icon in the search results. On the **Control Panel** screen, click **System and Security**, click **Administrative Tools**, and then **click Internet Information Services (IIS) Manager**. -2. In the **Connections** pane, right-click the **Sites** node in the tree, and then click **Add Website**. -3. In the **Add Website** dialog box, type a friendly name for your website in the **Site name** box. -4. If you want to select a different application pool than the one listed in the **Application Pool** box, click **Select**. In the **Select Application Pool** dialog box, select an application pool from the **Application Pool** list and then click **OK**. -5. In the **Physical path** box, type the physical path of the website's folder, or click the browse button (**...**) to navigate the file system to find the folder. -6. If the physical path that you entered in step 5 is to a remote share, click **Connect as** to specify credentials that have permission to access the path. If you do not use specific credentials, select the **Application user (pass-through authentication)** option in the **Connect As** dialog box. -7. Select the protocol for the website from the **Type** list. -8. The default value in the **IP address** box is **All Unassigned**. If you must specify a static IP address for the website, type the IP address in the **IP address** box. -9. Type a port number in the **Port** text box. -10. Optionally, type a host header name for the website in the **Host Header** box. -11. If you do not have to make any changes to the site, and you want the website to be immediately available, select the **Start Web site immediately** check box. -12. Click **OK**. - -## See also - -- [Configure a PHP Website on IIS](configure-a-php-website-on-iis.md) -- [Step 1: Plan IIS Web Server and PHP Installation](planning-step-1-plan-iis-web-server-and-php-installation.md) -- [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md) -- [Step 3: Configure PHP Application Security](configuring-step-3-configure-php-application-security.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-2-configure-php-settings.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-2-configure-php-settings.md deleted file mode 100644 index 82279e643..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-2-configure-php-settings.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "Configuring Step 2: Configure PHP Settings" -author: rmcmurray -description: "In this step of building a PHP website on IIS, you configure the WinCache PHP extension, configure PHP settings, and download and configure any other PHP ext..." -ms.date: 04/14/2013 -ms.assetid: 599f2304-e4d7-4185-a972-15c5eabf915b -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-2-configure-php-settings -msc.type: authoredcontent ---- -# Configuring Step 2: Configure PHP Settings - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -In this step of building a PHP website on IIS, you configure the WinCache PHP extension, configure PHP settings, and download and configure any other PHP extensions that your application requires. - -When you complete these tasks, continue to [Step 3: Configure PHP Application Security](configuring-step-3-configure-php-application-security.md). - - -## 2.1. Configure WinCache - -Before you perform this procedure, you should download in install PHP and WinCache as described in [1.2 Download and Install PHP](configuring-step-1-install-iis-and-php.md#12). For more information about WinCache, see [2.1. Plan WinCache Configuration](planning-step-2-plan-php-settings.md#21). - -### To configure the WinCache PHP extension - -1. In Windows Explorer, open your PHP installation folder, for example `C:\PHP`. -2. Choose either the **php.ini - development** or **php.ini - production** file, and rename it **php.ini**. -3. In a text editor, open the php.ini file and added the following line at the end of the file: `extension = php_wincache.dll`. -4. Save and close the php.ini file. -5. Recycle the IIS Application Pools for PHP to pick up the configuration changes. - -### To view WinCache configuration and other PHP settings - -1. Open a text editor. -2. In a new file, type the following text: `` -3. Save the file as `c:\inetpub\wwwroot\phpinfo.php`. -4. Open a browser and enter the following URL: - - `http://localhost/phpinfo.php` - - A nicely formatted web page is displayed showing the current PHP settings. The WinCache settings appear in a section called **wincache**. - -**Warning**: Delete the phpinfo.php file when it's no longer needed. - - -## 2.2. Configure Other PHP Settings - -The following procedure explains how to configure PHP settings in the php.ini file. For more information about PHP settings, see [2.2. Plan other PHP settings](planning-step-2-plan-php-settings.md#22). - -### To configure a PHP setting - -1. In Windows Explorer, open your PHP installation folder, for example `C:\PHP`. -2. In a text editor, open the php.ini file. -3. Search the file for the setting you want to change. - - If the setting is commented out (line begins with a semicolon [;]), delete the semicolon and set the value. If you can't find the setting, add the line to the end of the file. -4. Save and close the php.ini file. -5. Recycle the IIS Application Pools for PHP to pick up the configuration changes. - - -## 2.3. Configure PHP Extensions - -The following procedure shows how to download and install a PHP extension. For information about PHP extensions, see [2.3 Plan PHP Extensions](planning-step-2-plan-php-settings.md#23). - -### To configure a PHP extension - -1. Download the PHP extension you want from the list of Windows extensions for PHP. -2. Extract the extension zip package to the PHP extensions folder (\ext), for example `C:\PHP\ext`. -3. In Windows Explorer, open your PHP installation folder, for example `C:\PHP`. -4. In a text editor, open the php.ini file. -5. Search the file for the extension you want to configure. If the extension is commented out (line begins with a semicolon [;]), delete the semicolon. If you can't find the extension, add it to the end of the file. A line that adds an extension is in the form: `extension = extension_name.dll`. For example: `extension = php_soap.dll`. -6. Save and close the php.ini file. -7. Recycle the IIS Application Pools for PHP to pick up the configuration changes. - -## See Also - -- [Configure a PHP Website on IIS](configure-a-php-website-on-iis.md) -- [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md) -- [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) -- [Step 3: Configure PHP Application Security](configuring-step-3-configure-php-application-security.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security.md deleted file mode 100644 index ed4fba017..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: "Configuring Step 3: Configure PHP Application Security" -author: rmcmurray -description: "In this last step in building a PHP website on IIS, you configure PHP settings, web server settings, and PHP application settings that improve your website s..." -ms.date: 04/14/2013 -ms.assetid: bfe133a7-7b27-48b0-acb1-30a1bf883426 -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security -msc.type: authoredcontent ---- -# Configuring Step 3: Configure PHP Application Security - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -In this last step in building a PHP website on IIS, you configure PHP settings, web server settings, and PHP application settings that improve your website security. - - -## 3.1. Configure PHP Settings for Security - -The following procedure shows you how to configure PHP settings in the php.ini file. For information about security-related PHP settings, see [3.1. PHP Configuration Settings for Security](planning-step-3-plan-php-application-security.md#31). - -### To configure a PHP setting for security - -1. In Windows Explorer, open your PHP installation folder, for example `C:\PHP`. -2. In a text editor, open the php.ini file. -3. Search the file for the setting you want to change. - - If the setting is commented out (line begins with a semicolon [;]), delete the semicolon and set the value. If you can't find the setting, add the line to the end of the file. -4. Save and close the php.ini file. -5. Recycle the IIS Application Pools for PHP to pick up the configuration changes. - - -## 3.2. Configure Web Server and PHP Application Security - -This section shows how to configure several web server and application settings for IIS. These settings include isolating web applications, enabling per-site PHP configurations, and using request filtering. For more information about web server and PHP application security settings, see [3.2. Web Server and PHP Application Security](planning-step-3-plan-php-application-security.md#32). - -### Isolate Web Applications - -Implement the following recommendations to isolate websites and web applications on your server. - -- Use one application pool per website or web application. -- Limit access to site folders and files to the application pool identity. -- Set up a separate PHP temp folder per site and only give access to the application pool identity. -- Make sure to set an ACL (access control list) on each site root to allow only access to the application pool identity. - -If you have more than one application per application pool, consider creating enough application pools and moving some of the applications to the new pools. - -#### To create an application pool - -1. Open IIS Manager. -2. In the **Connections** pane, click **Application Pools**. -3. In the **Actions** pane, click **Add Application Pool**. -4. In the **Name** box, type a unique name for the application pool. -5. Under **.NET Framework version**, select **No Managed Code**. -6. Select the **Managed pipeline mode**. The **Integrated** mode is recommended. -7. Click **OK**. - -#### To move an application to another application pool - -1. Open IIS Manager. -2. In the **Connections** page, select the website or web application you want to move. -3. In the **Actions** pane, click **Basic Settings**. -4. On the **Edit Site** dialog, click **Select** to open the **Select Application Pool** dialog, and then select the application pool from the **Application pool** menu. -5. Click **OK** to close the **Select Application Pool** dialog, and click **OK** to close the **Edit Site** menu. - -#### To add an application pool identity to a folder or file ACL - -1. Open Windows Explorer and navigate to the folder or file. -2. Right click the folder or file, and then click **Properties**. -3. Select the **Security** tab, and then click **Edit**. -4. Click **Add**, click **Locations**, and select your server as the location to search. -5. In the **Enter the object names to select** box, type **IIS APPPOOL\applicationPoolName**, where *applicationPoolName* is the application pool identity. -6. Click **OK**, click **OK**, and click **OK** again to close the dialogs. - -### Enable Per-site PHP Configuration - -When you have multiple PHP applications on an IIS web server, you can improve security by configuring a PHP process pool and a php.ini file for each application. This section explains how to configure process pools and multiple pnp.ini files by using an **applicationHost.config** file. - -#### Per-site PHP Process Pools - -When each website has its own application pool, which is a recommended practice on IIS, it is possible to associate a dedicated FastCGI process pool with each website. This association is done in the **fastCgi** section of the **applicationHost.config** file. A FastCGI process pool is uniquely identified by the combination of **fullPath** and **arguments** attributes of the **application** element. To create several FastCGI process pools for the same process executable, such as php-cgi.exe, use the **arguments** attribute to distinguish the process pool definitions. With php-cgi.exe processes, use the command line switch "-d" to define an INI entry for a PHP process. And use this switch to set a PHP setting that makes the arguments string unique. - -For example, if there are two Web sites "website1" and "website2" that must have their own set of PHP settings, define the FastCGI process pools as follows: - -[!code-xml[Main](configuring-step-3-configure-php-application-security/samples/sample1.xml)] - -In this example the PHP setting `open_basedir` is used to distinguish between the process pool definitions. The setting also enforces that the PHP executable for each process pool can perform file operations only within the root folder of the corresponding website. - -Therefore, the PHP handler mapping for website1 is as follows: - -[!code-xml[Main](configuring-step-3-configure-php-application-security/samples/sample2.xml)] - -And the handler mapping for website2 is as follows: - -[!code-xml[Main](configuring-step-3-configure-php-application-security/samples/sample3.xml)] - -#### Specifying Php.ini Location - -When the PHP process starts, it determines the location of the configuration php.ini file by using various settings. The [PHP documentation](http://www.php.net/manual/en/configuration.php) provides a detailed description of the PHP startup process. One of the places where the PHP process searches for the php.ini location is the PHPRC environment variable. If the PHP process finds a php.ini file in the path that is specified in this environment variable, it will use it. Otherwise, the PHP process will revert to using the default location of the php.ini file. This environment variable can be used to allow hosting customers to use their own versions of php.ini files. - -For example, if there are two websites, "website1" and "website2," that are located at the following file paths: `C:\WebSites\website1` and `C:\WebSites\website2`, you can configure the php-cgi.exe process pools in the **fastCgi** section of the **applicationHost.config** file as follows: - -[!code-xml[Main](configuring-step-3-configure-php-application-security/samples/sample4.xml)] - -This way website1 can have its own version of the php.ini file that is located in the `C:\WebSites\website1`, while website2 can have its own version of the php.ini file that is located in `C:\WebSites\website2`. This configuration also ensures that if a php.ini file cannot be found in the location that is specified by the PHPRC environment variable, then PHP will use the default php.ini file that is located in the same folder where the php-cgi.exe is located. - -### Use Request Filtering - -For information about how to configure request filtering, see [Configure Request Filtering in IIS](../../manage/configuring-security/configure-request-filtering-in-iis.md). - -## See Also - -- [Configure a PHP Website on IIS](configure-a-php-website-on-iis.md) -- [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md) -- [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) -- [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample1.xml b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample1.xml deleted file mode 100644 index a985ddb19..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample1.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample2.xml b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample2.xml deleted file mode 100644 index 8a7692953..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample2.xml +++ /dev/null @@ -1,10 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample3.xml b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample3.xml deleted file mode 100644 index 01efb7e1a..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample3.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample4.xml b/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample4.xml deleted file mode 100644 index 8612acb47..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-3-configure-php-application-security/samples/sample4.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md deleted file mode 100644 index 88ea7c844..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "Overview: Build a PHP Website on IIS" -author: rmcmurray -description: "This document contains an overview of the Build a PHP website on IIS scenario. It also contains links to additional information and community resources relat..." -ms.date: 04/14/2013 -ms.assetid: 6da818a0-c6f2-4a37-a122-0373c4b18f2d -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis -msc.type: authoredcontent ---- -# Overview: Build a PHP Website on IIS - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -This document contains an overview of the **Build a PHP website on IIS** scenario. It also contains links to additional information and community resources related to the scenario. - -## Scenario Description - -This scenario shows how to plan and configure a PHP website on an IIS 8 webserver. It is divided into two phases: a plan and design phase, and an install and configure phase. In the plan and design phase, you are provided the information needed to make informed decisions about web server installation, PHP settings, and basic application security. In the install and configure phase, you are guided through the procedures required to install IIS, add a PHP application, and configure IIS and PHP. - -This scenario does not cover how to write a PHP application. - -## In This Scenario - -- [Plan a PHP Website on IIS](plan-a-php-website-on-iis.md) - - - [Step 1: Plan IIS Web Server and PHP Installation](planning-step-1-plan-iis-web-server-and-php-installation.md) - - [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md) - - [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md) -- [Configure a PHP Website on IIS](configure-a-php-website-on-iis.md) - - - [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) - - [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md) - - [Step 3: Configure PHP Application Security](configuring-step-3-configure-php-application-security.md) - - - -## Practical Applications - -Whether you are an IT professional, a web developer, or you just want to set up your own webserver, this scenario can help you install IIS and configure it to serve your PHP web application. - -## Software Requirements - -To get the most from this scenario, you must have access to a computer running one of the following operating systems: - -- Windows Server® 2012 -- Windows® 8 - -## See Also - -The following table contains links to resources related to this scenario. - -| Content type | References | -| --- | --- | -| **Deployment** | [Deployment to a Hosting Provider](https://www.asp.net/web-forms/tutorials/deployment-to-a-hosting-provider/deployment-to-a-hosting-provider-introduction-1-of-12) | [Web Deploy 2.0](https://www.iis.net/downloads/microsoft/web-deploy) | -| **Operations** | [IIS.NET](https://www.iis.net/) | [IIS Learning Center](https://www.iis.net/learn) | -| **Tools and Settings** | Microsoft.IIs.PowerShell.Provider namespace | -| **Community Resources** | [IIS Blogs](https://blogs.iis.net/) | [IIS Forums](https://forums.iis.net/) | [Robert McMurray's Blog](https://blogs.msdn.com/b/robert_mcmurray/) | [Scott Forsyth's Blog](https://blogs.iis.net/owscott/default.aspx) | [Steve Schofield's Blog](https://blogs.iis.net/steveschofield/default.aspx) | -| **Related Technologies** | [ASP.NET](https://www.asp.net/) | [ASP.NET Web Projects](https://msdn.microsoft.com/library/ywdtth2f.aspx) | diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/plan-a-php-website-on-iis.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/plan-a-php-website-on-iis.md deleted file mode 100644 index 3ac9f3b77..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/plan-a-php-website-on-iis.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Plan a PHP Website on IIS" -author: rmcmurray -description: "To develop a plan for installing an IIS web server and configuring it for PHP web applications, follow these steps listed: Plan IIS Web Server and PHP Instal..." -ms.date: 04/14/2013 -ms.assetid: 85e4ce42-5661-4f6e-ad3a-4d09a6aef0ae -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/plan-a-php-website-on-iis -msc.type: authoredcontent ---- -# Plan a PHP Website on IIS - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -## Overview - -To develop a plan for installing an IIS web server and configuring it for PHP web applications, follow the steps listed. - -- [Step 1: Plan IIS Web Server and PHP Installation](planning-step-1-plan-iis-web-server-and-php-installation.md) -- [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md) -- [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md) - -After you have reviewed these planning steps, see [Configure a PHP Website on IIS](configure-a-php-website-on-iis.md). For more information, see [Build a PHP Website on IIS](overview-build-a-php-website-on-iis.md). - -## Software Requirements - -To get the most from this scenario, you must have access to a computer running one of the following operating systems: - -- Windows Server® 2012 -- Windows® 8 diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-1-plan-iis-web-server-and-php-installation.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-1-plan-iis-web-server-and-php-installation.md deleted file mode 100644 index 18816f362..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-1-plan-iis-web-server-and-php-installation.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: "Planning Step 1: Plan IIS Web Server and PHP Installation" -author: rmcmurray -description: "The first step in planning to build a PHP website on IIS 8 is to determine how to install IIS along with the CGI module, where to download and install the ap..." -ms.date: 04/14/2013 -ms.assetid: b484d7e9-eedf-4ea3-90be-5c14a0f5201d -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-1-plan-iis-web-server-and-php-installation -msc.type: authoredcontent ---- -# Planning Step 1: Plan IIS Web Server and PHP Installation - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -The first step in planning to build a PHP website on IIS 8 is to determine how to install IIS along with the CGI module, where to download and install the appropriate PHP version, and how to add your application files to IIS. - -When you are done with these tasks, record your design decisions before going on to [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md). - - -## 1.1. Plan to Install IIS - -To support PHP applications on an IIS web server, install the default configuration of IIS and the CGI module. The CGI module contains both CGI (Common Gateway Interface protocol) and FastCGI. FastCGI is a high-performance extension to CGI and is recommended for PHP applications. Once your machine has this IIS configuration installed, you can download and install PHP. - -> [!IMPORTANT] -> To install IIS 8 on either Windows Server® 2012 or Windows® 8, you must sign on as a member of the Administrators group. - - -## 1.2. Plan to Download and Install PHP - -The simplest way to install PHP is to use Web Platform Installer (Web PI). Web PI installs the latest version of PHP along with any dependencies that version requires. To learn more about the Web PI, see [Learn More and Install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). - -To add PHP support manually to your IIS web server, download and install the PHP runtime version that you require. You can download Windows versions of PHP from the [PHP for Windows](http://windows.php.net/) site. - -There are two builds for each PHP version: one is thread-safe, and the other is non-thread-safe. The thread-safe version is designed for environments where the web server keeps the PHP engine in memory, running multiple treads of execution simultaneously. The architecture of IIS and the FastCGI extension provide an isolation model that keeps requests separate, removing the need for a thread-safe version of PHP. The non-thread-safe version of PHP gives better performance on IIS with FastCGI install than does the tread-safe version. - -PHP offers several extensions that extend its base functionality. One extension is important for PHP web applications that run on IIS-the Windows Cache Extension for PHP (WinCache). WinCache is a PHP accelerator that is used to increase the speed of PHP applications that run on Windows and Windows Server. Once the WinCache is enabled and loaded by the PHP engine, PHP applications can take advantage of the functionality without any code modifications. - -You can download WinCache extension from the [PHP for Windows](https://sourceforge.net/projects/wincache/) site. - - -## 1.3. Plan to Add a PHP Application - -An application is a grouping of content at the root level of a website or a grouping of content in a separate folder under the website root directory. When you add an application in IIS 8, you designate a directory as the *application root*, or starting point, for the application. Then specify properties specific to that particular application, such as the application pool that the application runs in. - -To configure your PHP application on an IIS website, provide the following information: - -- **Alias**: The alias is used as part of the application root URL and should be short and descriptive. For example, the alias *marketing* added to the default website on the local host computer, would produce the following URL: `//localhost/marketing`. -- **Application pool**: An application pool enables an application or a group of applications to run in isolation from one or more applications in another application pool. -- **Physical path**: The local path to the application files on the server. - -## See Also - -- [Plan a PHP Website on IIS](plan-a-php-website-on-iis.md) -- [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) -- [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md) -- [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings.md deleted file mode 100644 index b9f7aff3d..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: "Planning Step 2: Plan PHP Settings" -author: rmcmurray -description: "In this phase of building your PHP website, plan to set up the WinCache PHP extension, determine what configuration settings you require for PHP, and what PH..." -ms.date: 04/14/2013 -ms.assetid: 5baccb6d-183b-4b1b-839f-4db5a32acbd9 -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings -msc.type: authoredcontent ---- -# Planning Step 2: Plan PHP Settings - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -In this phase of building your PHP website, plan to set up the WinCache PHP extension, determine what configuration settings you require for PHP, and what PHP extensions your application requires. - -When you are done with these tasks, record your design decisions before going on to [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md). - - -## 2.1. Plan WinCache Configuration - -WinCache is a PHP extension that accelerates PHP applications, which run on Windows and Windows Server. For the most installations, the WinCache extension must be added to the php.ini file and no other configuration is required. However, if you want more control, WinCache offers many configuration settings. You can see a full list of setting in the [WinCache Runtime Configuration](http://us2.php.net/manual/en/wincache.configuration.php) page. - - -## 2.2. Plan Other PHP Settings - -Configuration and environmental settings for PHP are contained within the Php.ini, which is located in the PHP folder that you create during installation, for example `C:\PHP`. The following sections contain a number of settings for the Php.ini file that help PHP work better with Windows. - -### Required Settings - -- **extension\_dir = <PATH TO EXTENSIONS>**: The extension\_dir points to the directory where the PHP extensions are stored. The path can be fully qualified (for example, `C:\PHP\ext`) or relative (for example, .\ext). Extensions that are specified lower in the Php.ini file are located in the extension\_dir. If the extensions specified are not in the extension\_dir, then PHP displays a warning message at the start of script execution, and the application may show errors because of the missing functionality. -- **extension = xxxxxx.dll**: For each extension enabled, a corresponding extension= directive that tells PHP which extensions in the extension\_dir to load at startup time is necessary. -- **log\_errors = On**: PHP errors can also go through the PHP error logging facility. This can be used to send errors to a file or to a service (for example, syslog) and works with the error\_log directive described below. When running under IIS, log\_errors must be enabled with a valid error\_log. Otherwise, FastCGI considers any startup -- **error\_log = <path\_to\_error\_log\_file>**: The error\_log must specify the fully qualified, or relative, path to the file where the PHP error log is stored. This file must be writable for the IIS service. The most common places for this file are in various temporary directories (for example, `C:\inetpub\temp\php-errors.log`). That puts the log in a place that IIS can use and keeps the log close to where PHP applications are running. -- **cgi.force\_redirect = 0**: This directive is required for running under IIS. It is a directory security facility that is required by many other web servers. However, enabling it under IIS causes the PHP engine to fail on Windows. -- **cgi.fix\_pathinfo = 1**: This setting lets PHP access real path information per the CGI specification. The IIS FastCGI implementation needs this extension set. -- **fastcgi.impersonate = 1**: FastCGI under IIS supports the ability to impersonate security tokens of the calling client. This setting allows IIS to define the security context that the request runs under. -- **fastcgi.logging = 0**: FastCGI logging should be disabled when you use PHP with IIS. If it is left enabled, then any messages of any class are treated by FastCGI as error conditions, which causes IIS to generate an HTTP 500 exception. - -### Optional Settings - -- **max\_execution\_time = ##**: This directive sets the maximum amount of time that can be taken executing any given script. The default is 30 seconds. Some applications need more time to process batch operations (for example, Gallery2 loading multiple images from a remote location). However, setting the execution time higher than 300 seconds is not advised because there are often other parts of the connection that cannot support such a long execution time. -- **memory\_limit = ###M**: The amount of memory available for the PHP process (in MB). The default is 128 MB, which is sufficient for most PHP applications. -- **display\_errors = Off**: This directive determines whether to include any error messages in the stream that it returns to the web server. If turned on, PHP sends the classes of errors that are defined with the error\_reporting directive back to IIS as part of the error stream. Many of the open-source applications bypass error reporting by executing commands prefaced with @. This setting allows the applications to control error handling. -- **Mail functions**: PHP is configured by default to send outbound mail through an SMTP server that is located on the same system as the web server. Most Windows installations usually have the web and mail servers on separate systems. - - -## 2.3. Plan PHP Extensions - -It is important to determine which extensions are required by the applications you intend to run, and then to limit the installed extensions to those extensions only. For example, a typical open-source PHP application might require the following types of extensions: - -- **Database Extensions**: Open-source applications that use MySQL for a database engine use either the php\_mysql or the php\_mysqli extension. For new development work, either of these extensions work well. Consider using the PDO versions of the MySQL driver. PDO is a PHP extension that provides a data-access abstraction layer that can be used with various databases. Microsoft provides PHP drivers for SQL server that you can download. To learn more about PHP drivers for SQL Server, see [Microsoft Drivers for PHP for SQL Server](/sql/connect/php/download-drivers-php-sql-server?view=sql-server-ver16&preserve-view=true). -- **Image Handling Extensions**: Open-source applications that enable work with images use the GD2 extension - php\_gd2, which has several application programming interfaces (APIs) for basic image manipulation. Some applications use the [ImageMagick](http://www.imagemagick.org/script/index.php) application and libraries. There is also a php\_exif library for working with the extended information that modern digital cameras store within the images. -- **Internationalization and Localization Extensions**: The two most commonly used extensions for i18n and l10n are php\_mbstring (Multi-Byte String) and php\_gettext (Native Language Support). Many of the open-source applications use one or both of these extensions. -- **Web Services Extensions**: Choose the web services extensions based on the services desired. For PHP, the SOAP extension is widely used. The XML-RPC extension is often used with SOAP and other services. - -To view the entire list of PHP extensions available for applications that run on Windows platforms, see the complete list of Windows extensions for PHP. - -## See Also - -- [Plan a PHP Website on IIS](plan-a-php-website-on-iis.md) -- [Step 2: Configure PHP Settings](configuring-step-2-configure-php-settings.md) -- [Step 1: Plan IIS Web Server and PHP Installation](planning-step-1-plan-iis-web-server-and-php-installation.md) -- [Step 3: Plan PHP Application Security](planning-step-3-plan-php-application-security.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security.md b/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security.md deleted file mode 100644 index 4aa21b40f..000000000 --- a/iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: "Planning Step 3: Plan PHP Application Security" -author: rmcmurray -description: "In this phase of Building a PHP website on IIS, consider what PHP configuration settings, web server settings, and PHP application settings you need to stren..." -ms.date: 04/14/2013 -ms.assetid: 9a259178-7fde-4bda-bd7a-17caf6a0df80 -msc.legacyurl: /learn/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security -msc.type: authoredcontent ---- -# Planning Step 3: Plan PHP Application Security - -by [Keith Newman and Robert McMurray](https://github.com/rmcmurray) - -In this phase of Building a PHP website on IIS, consider what PHP configuration settings, web server settings, and PHP application settings you need to strengthen security. - -When you are done with these tasks, record your design decisions before going on to [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md). - - -## 3.1. PHP Configuration Settings for Security - -The dynamic capabilities of PHP also make it a potential security risk because data is actively fetched, received, and processed from anywhere on the Internet. Attackers may attempt to send in malicious data and scripts and trick your server into fetching malicious scripts and running them. Attackers may also attempt to read and write files on your server to take control of the web site and use it for their own purposes. - -You can configure PHP settings to tighten the security of a PHP installation and help protect the website from malicious attacks. The Php.ini file specifies the configuration settings PHP uses when it is running on your website. The Php.ini file determines what PHP scripts are allowed to do and prohibited from doing. - -This section describes the configuration settings that help to protect your PHP applications. - -### Disable File Handling for Remote URLs - -`allow_url_fopen = Off` -`allow_url_include = Off` - -This setting is very important because it prevents URLs from being used in statements such as include(). Setting **allow\_url\_fopen** to "Off" means that only files that reside within your website can be included. You can't include a file from a different server, but neither can other people through Remote File Inclusion (RFI) attacks. In an RFI attack, someone embeds a URL in an HTTP request hoping that your script is tricked into running theirs. A command such as `include("http://website.com/page.php")`, for example, is not allowed to execute. - -Include a file from your own site by specifying its path and filename. For example, if you have a URL **include** line, convert it to: `include($_SERVER['DOCUMENT_ROOT'] . '/page.php');` - -The code segment `$_SERVER['DOCUMENT_ROOT']` is a superglobal variable set to the root folder of your site. (Note that there is no trailing "/"; you must provide a leading "/" in '/page.php'.) - -If you want to include static content from another one of your websites, such as `include('http://myothersite.com/includes/footer.php')`, make a copy of that content in the current site and then include it locally. - -### Disable Register\_Globals - -`register_globals = Off` - -This setting makes it difficult for an attacker to inject code into your script. For example, in `URL http://site.com/index.php?variable=value`, the variable passes into your script with its value set to **value** when **register\_globals** is **On**. When **register\_globals** is **Off**, however, variables do not automatically pass into your script's variable list. - -### Restrict File System Read/Write - -`open_basedir = "c:\inetpub\"` - -This setting restricts PHP scripts from accessing files outside the specified base directory. - -### Disable Safe Mode - -`safe_mode = Off` -`safe_mode_gid = Off` - -This setting restricts the permissions with which PHP scripts run. Some third-party scripts do not run properly when safe\_mode is set to "On." Note that beginning with PHP 6 safe\_mode does not exist. - -### Limit Script Execution Time - -`max_execution_time = 30` -`max_input_time = 60` - -These settings control the number of seconds a script is allowed to run and parse user input. These settings help prevent poorly written scripts from typing up the server. - -### Limit Memory Usage and File Size - -`memory_limit = 16M` -`upload_max_filesize = 2M` -`post_max_size = 8M` -`max_input_nesting_levels = 64` - -These settings help manage memory and input/output efficiently. In addition, they prevent poorly written scripts from hogging memory and handling huge files. - -### Configure Error Logging - -`display_errors = Off` -`display_startup_errors = Off` `log_errors = On` -`error_log = "C:\path\of\your\choice"` - -These settings specify that all errors and warnings get logged to your error log text file and specify that none of the errors or warnings get displayed on any web page that is sent out from your server. Errors should not be displayed publicly because they can help someone figure out how to attack your server. Always check your error log when you are testing new code. - -### Enable FastCGI Impersonation - -`fastcgi.impersonate = 1` - -This setting enables IIS to impersonate the security tokens of calling client and define the security context that is used to run the request. - -### Disable FastCGI Logging - -`fastcgi.logging = 0` - -The FastCGI module will fail the request when PHP sends any data on **stderr** by using FastCGI protocol. Disabling FastCGI logging will prevent PHP from sending error information over **stderr**, and generating 500 response codes for the client. - -### Hide PHP Presence - -`expose_php = Off` - -With this setting, the headers that accompany outgoing pages do not reveal that PHP is running or its version. - - -## 3.2. Web Server and PHP Application Security - -### Isolate Web Applications - -One of the most effective ways to improve security for your web application is to isolate it from other applications on your web server. An application pool has its own worker process, which processes requests and runs application code. The worker process has a security identifier (SID). And each application pool has a unique application-pool identity. By default, when you create a web application, a new application pool is also created with the same name as the application. If you keep web applications in separate application pools, you can isolate them from one another. - -Web application isolation entails the following: - -- Site isolation: Separate different applications into different sites with different application pools. -- Least privilege: Run your worker process as a low privileged identity (virtual application pool identity) that is unique per site. -- Temp isolation: Set up a separate PHP temp folder per site and only give access to appropriate process identity. -- Content isolation: Make sure to set an ACL (access control list) on each site root to allow only access to the appropriate process identity - -> [!TIP] -> It is a good idea to host your website and web application content on a drive other than your system drive (C:). - -### Enable Per-site PHP Configuration - -The FastCGI handler makes it possible to use a different Php.ini file for every application mapping. You can customize your PHP configuration around the specific requirements of your users or your PHP applications, letting you tighten configuration. - -### Use Request Filtering - -The request filtering module inspects known malicious patterns in the requests and prevents such requests from being serviced if the module determines that the requests may be harmful. For example, this module lets you filter requests that are double escaped, filter requests that use certain HTTP verbs, or block requests to specific folders. You can enforce tighter security policies on your web servers with the request filtering module. For more information about request filtering, see [Configure Request Filtering in IIS](../../manage/configuring-security/configure-request-filtering-in-iis.md). - -## See Also - -- [Plan a PHP Website on IIS](plan-a-php-website-on-iis.md) -- [Step 1: Install IIS and PHP](configuring-step-1-install-iis-and-php.md) -- [Step 1: Plan IIS Web Server and PHP Installation](planning-step-1-plan-iis-web-server-and-php-installation.md) -- [Step 2: Plan PHP Settings](planning-step-2-plan-php-settings.md) -- [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-1-install-iis-and-asp-net-modules.md b/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-1-install-iis-and-asp-net-modules.md index 509f3b50f..fd77b2bcb 100644 --- a/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-1-install-iis-and-asp-net-modules.md +++ b/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/configuring-step-1-install-iis-and-asp-net-modules.md @@ -27,8 +27,6 @@ This section describes how to install IIS and the modules that support ASP.NET a > [!IMPORTANT] > To install IIS on either Windows Server 2012 or Windows 8, you must sign on as a member of the Administrators group. -If you prefer, you could use the Web Platform Installer (Web PI) to install IIS and third-party applications that run on IIS. Because the Web PI installs the latest versions of available Web Platform offerings, with just a few simple clicks you can download and install any new tools or updates. To learn more about the Web PI, see [Learn more and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). - If you support web applications written using ASP.NET 2 to 3.5, install .NET 3.5 before installing IIS and ASP.NET modules. ### To install .NET 3.5 on Windows Server 2012 or Windows 8 diff --git a/iis/configuration/moduleProviders/index.md b/iis/configuration/moduleProviders/index.md index a6d28afcd..eff9e5ec1 100644 --- a/iis/configuration/moduleProviders/index.md +++ b/iis/configuration/moduleProviders/index.md @@ -101,4 +101,4 @@ The following code examples add a managed module provider named ContosoProvider ### VBScript -[!code-vb[Main](index/samples/sample5.vb)] +[!code-vb[Main](index/samples/sample5.vbs)] diff --git a/iis/configuration/moduleProviders/index/samples/sample5.vb b/iis/configuration/moduleProviders/index/samples/sample5.vb deleted file mode 100644 index 7d2b6f980..000000000 --- a/iis/configuration/moduleProviders/index/samples/sample5.vb +++ /dev/null @@ -1,12 +0,0 @@ -var adminManager = new ActiveXObject("Microsoft.ApplicationHost.WritableAdminManager"); -adminManager.CommitPath = "MACHINE/WEBROOT"; -adminManager.SetMetadata("pathMapper", "AdministrationConfig"); -var moduleProvidersSection = adminManager.GetAdminSection("moduleProviders", "MACHINE/WEBROOT"); - -var moduleProvidersCollection = moduleProvidersSection.Collection; -var addElement = moduleProvidersCollection.CreateNewElement("add"); -addElement.Properties.Item("name").Value = "ContosoProvider"; -addElement.Properties.Item("type").Value = "Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73"; -moduleProvidersCollection.AddElement(addElement); - -adminManager.CommitChanges(); \ No newline at end of file diff --git a/iis/configuration/moduleProviders/index/samples/sample5.vbs b/iis/configuration/moduleProviders/index/samples/sample5.vbs new file mode 100644 index 000000000..055d0a7f6 --- /dev/null +++ b/iis/configuration/moduleProviders/index/samples/sample5.vbs @@ -0,0 +1,12 @@ +Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager") +adminManager.CommitPath = "MACHINE/WEBROOT" +adminManager.SetMetadata "pathMapper", "AdministrationConfig" +Set modulesSection = adminManager.GetAdminSection("modules", "MACHINE/WEBROOT") + +Set moduleProvidersCollection = modulesSection.Collection +Set addElement = moduleProvidersCollection.CreateNewElement("add") +addElement.Properties.Item("name").Value = "ContosoProvider" +addElement.Properties.Item("type").Value = "Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73" +moduleProvidersCollection.AddElement(addElement) + +adminManager.CommitChanges() diff --git a/iis/configuration/modules/add.md b/iis/configuration/modules/add.md index c22aafb59..e10125da3 100644 --- a/iis/configuration/modules/add.md +++ b/iis/configuration/modules/add.md @@ -1,5 +1,5 @@ --- -title: "Adding Modules <add>" +title: "Adding Modules <add> element" author: rick-anderson description: "Overview The <add> element of the <modules> element adds a module to the collection of feature modules that are available in IIS Manager when a u..." ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: c9292951-00fe-4767-9dfd-709e076a5bca msc.legacyurl: /configreference/modules/add msc.type: config --- -# Adding Modules <add> +# Adding Modules <add> element ## Overview diff --git a/iis/configuration/system.applicationHost/applicationPools/add/environmentVariables/add.md b/iis/configuration/system.applicationHost/applicationPools/add/environmentVariables/add.md index 8a66ed360..34bde7b85 100644 --- a/iis/configuration/system.applicationHost/applicationPools/add/environmentVariables/add.md +++ b/iis/configuration/system.applicationHost/applicationPools/add/environmentVariables/add.md @@ -1,5 +1,5 @@ --- -title: Adding Environment Variables <add> +title: Adding Environment Variables <add> element author: rick-anderson description: Provides an overview of the <add> element of the <environmentVariables> element and its properties. ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: 41182993-2366-42b0-94b5-ebb940b873f8 msc.legacyurl: /configreference/system.applicationhost/applicationpools/add/environmentvariables/add msc.type: config --- -# Adding Environment Variables <add> +# Adding Environment Variables <add> element ## Overview diff --git a/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/environmentVariables/add.md b/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/environmentVariables/add.md index f478b238f..98ded063a 100644 --- a/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/environmentVariables/add.md +++ b/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/environmentVariables/add.md @@ -1,5 +1,5 @@ --- -title: Adding Environment Variables <add> +title: Adding Environment Variables <add> default element author: rick-anderson description: Provides an overview of the default <add> element of the <environmentVariables> element and its properties. ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: 49145f4f-5892-4667-aba4-b9615b8e0e8d msc.legacyurl: /configreference/system.applicationhost/applicationpools/applicationpooldefaults/environmentvariables/add msc.type: config --- -# Adding Environment Variables <add> +# Adding Environment Variables <add> default element ## Overview diff --git a/iis/configuration/system.applicationHost/sites/site/ftpServer/security/index.md b/iis/configuration/system.applicationHost/sites/site/ftpServer/security/index.md index c15109979..10777a093 100644 --- a/iis/configuration/system.applicationHost/sites/site/ftpServer/security/index.md +++ b/iis/configuration/system.applicationHost/sites/site/ftpServer/security/index.md @@ -1,5 +1,5 @@ --- -title: "FTP Security <security>" +title: "FTP Security <security> element" author: rick-anderson description: "Overview The <security> element defines the parent element for the security options of FTP sites, and contains the following child elements, which are..." ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: a910cf6f-5593-4122-bdb9-462f08f4ea76 msc.legacyurl: /configreference/system.applicationhost/sites/site/ftpserver/security msc.type: config --- -# FTP Security <security> +# FTP Security <security> element ## Overview diff --git a/iis/configuration/system.applicationHost/sites/siteDefaults/bindings/binding.md b/iis/configuration/system.applicationHost/sites/siteDefaults/bindings/binding.md index df818112d..255958333 100644 --- a/iis/configuration/system.applicationHost/sites/siteDefaults/bindings/binding.md +++ b/iis/configuration/system.applicationHost/sites/siteDefaults/bindings/binding.md @@ -76,7 +76,7 @@ You can add default `` elements within the `` element in the | --- | --- | | `bindingInformation` | Required string attribute.

Specifies information to communicate with a site. For example, a Web site binding includes the IP address (or unspecified IP addresses), the port number, and an optional host header used to communicate with the site. | | `protocol` | Required string attribute.

Specifies the protocol for communicating with a site. | -| `sslFlags` | Optional uint attribute.

Specifies the type of binding used for Secure Sockets Layer (SSL) certificates.
  • A value of "0" specifies that the secure connection be made using an IP/Port combination. Only one certificate can be bound to a combination of IP address and the port.
  • A value of "1" specifies that the secure connection be made using the port number and the host name obtained by using Server Name Indication (SNI).
  • A value of "2" specifies that the secure connection be made using the centralized SSL certificate store without requiring Server Name Indicator (SNI)
  • A value of "3" specifies that the secure connection be made using the centralized SSL certificate store while requiring Server Name Indicator (SNI)
Centralized SSL certificate support enables you to create a centralized certificate store that can contain multiple certificate files. You can name the certificate files to correspond to the host names that they contain. This enables you to create a binding that only requires a port, rather than an IP/port or a host name/port combination. When a request comes in, IIS matches the port, determines the host name from the request, and searches the centralized certificate store for a certificate file with a matching name. It uses that certificate.

With a Server Name Indicator (SNI), the host name is exchanged as part of the SSL handshake. SNI is enabled in the Add Site Binding dialog box when you add a binding with a type of HTTPS. This is especially useful for SSL connections that host multiple servers on a single network address.

The default value is `0`. | +| `sslFlags` | Optional `uint` attribute that works like flags type, with the following possible flags:
Value Description
0 The secure connection made using an IP/Port combination. Only one certificate can be bound to a combination of IP address and the port.
1 The secure connection made using the port number and the host name obtained by using Server Name Indication (SNI).
2 The secure connection be made using the centralized SSL certificate store.
4 Disable HTTP/2.
8 Disable OCSP Stapling.
16 Disable QUIC.
32 Disable TLS 1.3 over TCP.
64 Disable Legacy TLS.
Centralized SSL certificate support enables creating a centralized certificate store that can contain multiple certificate files. The certificate files can be named to correspond to the host names that they contain. This enables creating a binding that only requires a port, rather than an IP/port or a host name/port combination. When a request comes in, IIS matches the port, determines the host name from the request, and searches the centralized certificate store for a certificate file with a matching name. It uses that certificate.

With a Server Name Indicator (SNI), the host name is exchanged as part of the SSL handshake. SNI is enabled in the **Add Site Binding** dialog box when adding a binding with a type of HTTPS. This is useful for SSL connections that host multiple servers on a single network address.

Values greater than 4 are only supported in IIS 10 version 1809 and higher. The default value is `0`. | ### Child Elements diff --git a/iis/configuration/system.ftpServer/security/index.md b/iis/configuration/system.ftpServer/security/index.md index 385bf7bae..76ea54bbb 100644 --- a/iis/configuration/system.ftpServer/security/index.md +++ b/iis/configuration/system.ftpServer/security/index.md @@ -1,5 +1,5 @@ --- -title: "FTP Security <security>" +title: "FTP Security <security> section group" author: rick-anderson description: "Overview The <security> section group resides in the <system.ftpServer> section and contains elements that configure security settings on an Inte..." ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: 23bbc004-53ef-4898-9197-7af7db0177c6 msc.legacyurl: /configreference/system.ftpserver/security msc.type: config --- -# FTP Security <security> +# FTP Security <security> section group; ## Overview diff --git a/iis/configuration/system.webServer/fastCgi/application/environmentVariables/environmentVariable.md b/iis/configuration/system.webServer/fastCgi/application/environmentVariables/environmentVariable.md index 0e15cfd40..c9481321f 100644 --- a/iis/configuration/system.webServer/fastCgi/application/environmentVariables/environmentVariable.md +++ b/iis/configuration/system.webServer/fastCgi/application/environmentVariables/environmentVariable.md @@ -264,10 +264,6 @@ The following configuration sample adds a global FastCGI handler mapping for PHP > > [!code-xml[Main](environmentVariable/samples/sample3.xml)] -Additional information and examples about how to configure FastCGI settings for PHP are discussed in the following walkthrough: - -> [Using FastCGI to Host PHP Applications on IIS 7](/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis) - ## Sample Code diff --git a/iis/configuration/system.webServer/fastCgi/application/environmentVariables/index.md b/iis/configuration/system.webServer/fastCgi/application/environmentVariables/index.md index 2b05a68a2..856b6b7f0 100644 --- a/iis/configuration/system.webServer/fastCgi/application/environmentVariables/index.md +++ b/iis/configuration/system.webServer/fastCgi/application/environmentVariables/index.md @@ -258,10 +258,6 @@ The following configuration sample adds a global FastCGI handler mapping for PHP > > [!code-xml[Main](index/samples/sample3.xml)] -Additional information and examples about how to configure FastCGI settings for PHP are discussed in the following walkthrough: - -- [Using FastCGI to Host PHP Applications on IIS 7](/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis) - ## Sample Code diff --git a/iis/configuration/system.webServer/fastCgi/application/index.md b/iis/configuration/system.webServer/fastCgi/application/index.md index 5827a606f..6596764f6 100644 --- a/iis/configuration/system.webServer/fastCgi/application/index.md +++ b/iis/configuration/system.webServer/fastCgi/application/index.md @@ -302,10 +302,6 @@ The following configuration sample adds a global FastCGI handler mapping for PHP > > [!code-xml[Main](index/samples/sample3.xml)] -Additional information and examples about how to configure FastCGI settings for PHP are discussed in the following walkthrough: - -> [Using FastCGI to Host PHP Applications on IIS 7](/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis) - ## Sample Code diff --git a/iis/configuration/system.webServer/fastCgi/index.md b/iis/configuration/system.webServer/fastCgi/index.md index e53a57730..891ccbaf7 100644 --- a/iis/configuration/system.webServer/fastCgi/index.md +++ b/iis/configuration/system.webServer/fastCgi/index.md @@ -255,10 +255,6 @@ The following configuration sample adds a global FastCGI handler mapping for PHP > FastCGI settings can be configured per-site through the use of specially formatted FastCGI application and by handler mappings, which are distinguished by matching the **fullPath** and **arguments** attributes for an `` element with the corresponding **scriptProcessor** attribute in the `` mapping for the FastCGI process. To create these mappings, the settings in the **fullPath** and **arguments** attributes for an `` element must be added to the **scriptProcessor** attribute in the `` mapping for the FastCGI process and separated by the pipe "|" character. This combination serves as a unique key for each FastCGI application. For example, the following configuration excerpt shows two example <fastCgi>/<application> elements and their corresponding <handlers> mappings for two site-specific PHP handlers: > [!code-xml[Main](index/samples/sample3.xml)] -Additional information and examples about how to configure FastCGI settings for PHP are discussed in the following walkthrough: - -> [Using FastCGI to Host PHP Applications on IIS 7](/iis/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis) - ## Sample Code The following code samples add a FastCGI application for PHP, set the **instanceMaxRequests** attribute to "10000," and set the `PHP_FCGI_MAX_REQUESTS` environment variable to "10000." Each sample also adds a global FastCGI handler mapping for PHP files to IIS and specifies the full path to a FastCGI executable file. diff --git a/iis/configuration/system.webServer/modules/add.md b/iis/configuration/system.webServer/modules/add.md index ce5f09c7d..5d9e9d293 100644 --- a/iis/configuration/system.webServer/modules/add.md +++ b/iis/configuration/system.webServer/modules/add.md @@ -1,5 +1,5 @@ --- -title: "Adding Modules <add>" +title: "Adding Modules <add> element for for Internet Information Services (IIS) 7" author: rick-anderson description: "Overview The <add> element of the <modules> collection adds a module to the list of modules for Internet Information Services (IIS) 7. Compatibil..." ms.date: 09/26/2016 @@ -7,7 +7,7 @@ ms.assetid: 1d3db48a-771a-43c5-aa86-4e346f527b93 msc.legacyurl: /configreference/system.webserver/modules/add msc.type: config --- -# Adding Modules <add> +# Adding Modules <add> element for for Internet Information Services (IIS) 7; ## Overview @@ -69,7 +69,7 @@ The `` element of the `` collection is included in the default ins | Attribute | Description | | --- | --- | | `name` | Required string attribute.

Specifies the unique name of a managed module on the Web server. | -| `preCondition` | Optional string attribute. Specifies conditions under which the module will run.

The **preCondition** attribute can be one or more of the following possible values. If you specify more than one value, separate the values with a comma (,).

Value Description
bitness32 Specify the bitness32 value when the module is a 32-bit .dll file. IIS should load the handler only for worker processes that run in WOW64 mode (32-bit simulation) on a 64-bit operating system.
bitness64 Specify the bitness64 value when the module is a 64-bit .dll file. IIS should load the handler only for worker processes that run in 64-bit mode.
integratedMode Specify the integratedMode value when the module should respond only to requests in application pools that are configured to use the integrated request-processing pipeline.
ISAPIMode Specify the ISAPIMode value when the module should respond only to requests in application pools that are configured to use Classic mode.
managedHandler Specify the managedHandler value when the module should process requests only for managed resources, such as .aspx files, and should not respond to requests for non-managed resources, such as .html files.
runtimeVersion1.1 Specify the runtimeVersionv1.1 value when the module should respond only to requests in application pools that are configured to use .NET Framework version 1.1.
runtimeVersion2.0 Specify the runtimeVersionv2.0 value when the module should respond only to requests in application pools that are configured to use .NET Framework version 2.0.
| +| `preCondition` | Optional string attribute. Specifies conditions under which the module will run.

The **preCondition** attribute can be one or more of the following possible values. If you specify more than one value, separate the values with a comma (,).

Value Description
bitness32 Specify the bitness32 value when the module is a 32-bit .dll file. IIS should load the handler only for worker processes that run in WOW64 mode (32-bit simulation) on a 64-bit operating system.
bitness64 Specify the bitness64 value when the module is a 64-bit .dll file. IIS should load the handler only for worker processes that run in 64-bit mode.
integratedMode Specify the integratedMode value when the module should respond only to requests in application pools that are configured to use the integrated request-processing pipeline.
ISAPIMode Specify the ISAPIMode value when the module should respond only to requests in application pools that are configured to use Classic mode.
managedHandler Specify the managedHandler value when the module should process requests only for managed resources, such as .aspx files, and should not respond to requests for non-managed resources, such as .html files.
runtimeVersionv1.1 Specify the runtimeVersionv1.1 value when the module should respond only to requests in application pools that are configured to use .NET Framework version 1.1.
runtimeVersionv2.0 Specify the runtimeVersionv2.0 value when the module should respond only to requests in application pools that are configured to use .NET Framework version 2.0.
runtimeVersionv4.0 Specify the runtimeVersionv4.0 value when the module should respond only to requests in application pools that are configured to use .NET Framework version 4.0.
| | `type` | Optional string attribute.

Specifies the managed type of a managed module. The type attribute does not apply to native modules. | ### Child Elements diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-authentication-provider.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-authentication-provider.md index d83d14a8c..0b4071746 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-authentication-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-authentication-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use managed code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the Web site by using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-home-directory-provider.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-home-directory-provider.md index 56d34f2a6..990531bee 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-home-directory-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-home-directory-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use managed code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-logging-provider.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-logging-provider.md index 8f5aaeaf1..39ba118be 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-logging-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-a-simple-ftp-logging-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use managed code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-using-an-xml-database.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-using-an-xml-database.md index 894f90008..291872291 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-using-an-xml-database.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-using-an-xml-database.md @@ -22,11 +22,7 @@ This walkthrough will lead you through the steps to use managed code to an FTP a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) - +2. The new FTP 7.5 service must be installed. 3. You must have FTP publishing enabled for a site. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-with-dynamic-ip-restrictions.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-with-dynamic-ip-restrictions.md index d760b7c9a..ca834081e 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-with-dynamic-ip-restrictions.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-authentication-provider-with-dynamic-ip-restrictions.md @@ -25,10 +25,7 @@ This walkthrough will lead you through the steps to use managed code to an FTP a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the [https://www.iis.net/](https://www.iis.net/) Web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. > [!IMPORTANT] > As mentioned earlier in this walkthrough, the latest version of the FTP 7.5 service ***must be*** installed in order to use the provider in this walkthrough. A version FTP 7.5 was released on August 3, 2009 that addressed an issue where the local and remote IP addresses in the **IFtpLogProvider.Log()** method were incorrect. Because of this, using an earlier version of the FTP service will prevent this provider from working. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-sends-an-email-when-files-are-uploaded.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-sends-an-email-when-files-are-uploaded.md index ee4a82f8d..dce94b2c9 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-sends-an-email-when-files-are-uploaded.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-c-to-create-an-ftp-provider-that-sends-an-email-when-files-are-uploaded.md @@ -31,10 +31,7 @@ When an FTP client sends a file to the FTP service, the client will send a STOR The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must use Visual Studio 2008. > [!NOTE] diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-home-directory-provider.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-home-directory-provider.md index be6cbd7a7..7aedec511 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-home-directory-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-home-directory-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use managed code to create a The following items are required to complete the procedures in this article: 1. IIS 7 or above must be installed on your server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. If you are using Windows Server 2008, you can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-logging-provider.md b/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-logging-provider.md index 4a8efee0b..ee999260d 100644 --- a/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-logging-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-managed-code-visual-basic-to-create-a-simple-ftp-logging-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use managed code in Visual B The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-authentication-provider.md b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-authentication-provider.md index c19899e8a..6c9fd3d59 100644 --- a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-authentication-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-authentication-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use native code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the [https://www.iis.net/](https://www.iis.net/) web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-home-directory-provider.md b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-home-directory-provider.md index bfc603b5d..db520bd12 100644 --- a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-home-directory-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-home-directory-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use native code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the [https://www.iis.net/](https://www.iis.net/) web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-logging-provider.md b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-logging-provider.md index 37db84a94..47346db92 100644 --- a/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-logging-provider.md +++ b/iis/develop/developing-for-ftp/how-to-use-native-code-c-to-create-a-simple-ftp-logging-provider.md @@ -22,10 +22,7 @@ This walkthrough will lead you through the steps to use native code to create a The following items are required to complete the procedures in this article: 1. IIS 7.0 or above must be installed on your Windows Server 2008 server, and the Internet Information Services (IIS) Manager must also be installed. -2. The new FTP 7.5 service must be installed. You can download and install the FTP 7.5 service from the [https://www.iis.net/](https://www.iis.net/) web site using one of the following links: - - - [FTP 7.5 for IIS (x86)](https://go.microsoft.com/fwlink/?LinkId=143196) - - [FTP 7.5 for IIS (x64)](https://go.microsoft.com/fwlink/?LinkId=143197) +2. The new FTP 7.5 service must be installed. 3. You must create a root folder for FTP publishing. 4. You must use Visual Studio 2008. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq.md deleted file mode 100644 index 6ca287535..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "Acquia Drupal FAQ" -author: rick-anderson -description: "WebMatrix Beta supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set..." -ms.date: 07/06/2010 -ms.assetid: fa41913f-66c4-4ace-9312-bfd55679c7bf -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq -msc.type: authoredcontent ---- -# Acquia Drupal FAQ - -by Faith A - -WebMatrix Beta supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing Acquia Drupal - -#### Q: How do I install Acquia Drupal? - -A: To install Acquia Drupal, use the following steps: - -1. Open WebMatrix Beta and select **Site from Web Gallery**. -2. Select the **CMS** category on the left-hand side. -3. Find **Acquia Drupal** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. -6. Note: If you use a database name, username or password that contains certain special characters, you will receive an error when browsing to the application. Follow the workaround listed below.. - -#### Q: How do I publish my Acquia Drupal website? - -A: To publish a Acquia Drupal website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -## Common Issues - -#### Q: Why do I get a "The service is unavailable" error when browsing to the website? - -A: You will see this error if you are publishing to a database server where the database name, username or password contains the following special characters: - -[!code-console[Main](acquia-drupal-faq/samples/sample1.cmd)] - -This is because those characters are used by the application to parse the file, so it fails unless the characters are escaped properly. - -To resolve this issue, it is recommended that you use your hosting control panel to change your password to one without the special characters. - -If this is not possible, you can workaround the issue by creating a copy of the *settings.php* that will be used for the remote web site: - -1. Go to the **Files** workspace. -2. Navigate to the /sites/default folder. -3. Copy and paste the *settings.php* file to create a copy. -4. Rename the *settings - Copy.php* file to *settings.php.local*. -5. Open *settings.php* and find the line that begins with. - - [!code-powershell[Main](acquia-drupal-faq/samples/sample2.ps1)] -6. Change the line to escape special characters, you will find the hex replacements listed in *settings.php*. - - For example, change the following line: - - [!code-powershell[Main](acquia-drupal-faq/samples/sample3.ps1)] - - to: - - [!code-powershell[Main](acquia-drupal-faq/samples/sample4.ps1)] -7. Click **Save** on the **Quick Access Toolbar** or press Ctrl + S. -8. Using a text editor, modify the WebMatrix Beta parameters file so that the Publish will not incorrectly replace this value: - - 1. In Windows Explorer, navigate to %userprofile%\appdata\ - 2. First, make a copy of the *parameters.xml* file as a backup. - 3. Open *parameters.xml* in a text or XML editor. - 4. Find the below lines: - - [!code-xml[Main](acquia-drupal-faq/samples/sample5.xml)] - 5. Comment out the <parameterEntry> line: - - [!code-xml[Main](acquia-drupal-faq/samples/sample6.xml)] - 6. Save the changes to the file. - 7. Publish again. - 8. After publishing, browse to your remote web site to verify that the application works. -9. To switch to the local *settings.php* so that the application works on your client machine: - - 1. Rename *settings.php* to *settings.php.remote*. - 2. Rename *settings.php.local* to *settings.php*. - 3. Click **Run** or press F12 to open the site in your default web browser. -10. You will need to switch these files every time you publish. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample1.cmd b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample1.cmd deleted file mode 100644 index 8313e2ad4..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -: / @ + ( ) ? = & \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample2.ps1 b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample2.ps1 deleted file mode 100644 index a8a1fdf9f..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample2.ps1 +++ /dev/null @@ -1 +0,0 @@ -$db_url (not * $db_url) \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample3.ps1 b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample3.ps1 deleted file mode 100644 index 6d99292d3..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample3.ps1 +++ /dev/null @@ -1 +0,0 @@ -$db_url = 'mysql://username:pass@/word@server/databasename'; \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample4.ps1 b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample4.ps1 deleted file mode 100644 index 6d4adb724..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample4.ps1 +++ /dev/null @@ -1 +0,0 @@ -$db_url = 'mysql://username:pass%40%2fword@server/databasename'; \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample5.xml b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample5.xml deleted file mode 100644 index 2ad68c213..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample5.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample6.xml b/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample6.xml deleted file mode 100644 index 6296a794e..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/acquia-drupal-faq/samples/sample6.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/atomsite-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/atomsite-faq.md deleted file mode 100644 index 9bc681e57..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/atomsite-faq.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: AtomSite FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding AtomSite installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: efcc228a-b43c-4730-bdaa-9824bbd6f956 -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/atomsite-faq -msc.type: authoredcontent ---- -# AtomSite FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing AtomSite - -#### Q: How do I install AtomSite? - -A: To install AtomSite, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **CMS** category on the left-hand side. -3. Find **AtomSite** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my AtomSite website? - -A: To publish a AtomSite website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. After previewing the changes, click **Continue**. - -## Known Issues - -**Issue:** Some links in AtomSite are broken after you download a published site -**Workaround:** This is a known issue. A workaround is to perform a string replace for service.config, users.config, and all .xml files of the remote URL string (i.e. `http://myhost.com/atomsite`) to the local one (i.e. `http://localhost:1239`). diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/blogenginenet-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/blogenginenet-faq.yml deleted file mode 100644 index 37c7d9677..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/blogenginenet-faq.yml +++ /dev/null @@ -1,55 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "BlogEngine.NET FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 94b2ff9c-de00-4e0e-add9-de807a33d626 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/blogenginenet-faq - msc.type: authoredcontent - ms.topic: faq -title: BlogEngine.NET FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - -sections: - - name: Installing and Publishing BlogEngine.NET - questions: - - question: | - How do I install BlogEngine.NET? - answer: | - To install BlogEngine.NET, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Blogs** category on the left-hand side. - 3. Find **BlogEngine.NET** in the list and install it. - - - question: | - How do I publish my BlogEngine.NET website? - answer: | - To publish a BlogEngine.NET website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Because BlogEngine.NET has a default connection string that is not used, you will need to enter a fake connection string. - For example: `"Data Source=empty;database=empty;uid=empty;pwd=empty"` - 4. Click **Validate Connection** to ensure that the settings are correct. - 5. Click **Publish**. - 6. After previewing the changes, click **Continue**. Make sure that you do not select the database to be published. - - - name: Common Issues - questions: - - question: | - Why do I get a validation error when trying to edit or add blog posts? - answer: | - If you are publishing to a server where the web site is configured to run in a .NET 4 application pool or you changed your local site to run in .NET 4, you will receive this error because the application requires .NET 2.0. - - > **Error**: Ooops! An unexpected error has occurred. - > - > The error will also contain the message: "A potentially dangerous Request.Form value was detected from the client (ctl00$cphAdmin$txtContent$TinyMCE1$txtContent=" - - To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/dasblog-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/dasblog-faq.yml deleted file mode 100644 index 5c3b35453..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/dasblog-faq.yml +++ /dev/null @@ -1,41 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "dasBlog FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 58bc054e-ca8e-49e1-97ca-e5c56c327327 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/dasblog-faq - msc.type: authoredcontent - ms.topic: faq -title: dasBlog FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing dasBlog - - -sections: - - name: Ignored - questions: - - question: How do I install dasBlog? - answer: | - To install dasBlog, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **dasBlog** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - - - question: How do I publish my dasBlog website? - answer: | - To publish a dasBlog website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. After previewing the changes, click **Continue**. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/dotnetnuke-community-edition-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/dotnetnuke-community-edition-faq.md deleted file mode 100644 index 9ffb9e44c..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/dotnetnuke-community-edition-faq.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: DotNetNuke ® Community Edition FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding DotNetNuke installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: 8dfb5763-f82a-4d05-9b9e-99b9fa4cdb13 -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/dotnetnuke-community-edition-faq -msc.type: authoredcontent ---- -# DotNetNuke ® Community Edition FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing DotNetNuke Community Edition - -### Q: How do I install DotNetNuke Community Edition? - -A: To install DotNetNuke Community Edition, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **CMS** category on the left-hand side. -3. Find **DotNetNuke® Community Edition** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -### Q: How do I publish my DotNetNuke Community Edition website? - -A: To publish a DotNetNuke Community Edition website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -## Known Issues - -**Issue**: Some links are not visible in DotNetNuke after publishing or downloading the site. If you publish or download a DotNetNuke site, you may need to clear the cache to get the new links to appear on the site. - -**Workaround**: - -1. Log in as Host. -2. Go to the host menu and select "Host Settings" -3. Scroll down and expand the "Performance Settings" under "Advanced Settings" -4. Click the "Clear Cache" Link for pages. -5. Go to the bottom of the page and restart the application. - -**Issue**: "Download published site…" fails with a database error - If you try to download an application from a server and you have administrator credentials in the database connection string in the Publish Settings dialog, you may see this error in the publish log: - 1:28:29 PM: An error occurred during execution of the database script. The approximate location of the error was between lines '3260' and '3262' of the script. The verbose log may have more information about the error. The command started with : - 1:28:29 PM: CREATE LOGIN [MACHINE\Administrator] FROM WINDOW - 1:28:29 PM: [https://go.microsoft.com/fwlink/?LinkId=178587](https://go.microsoft.com/fwlink/?LinkId=178587) - -**Workaround**: - -Publish the site in the first place using non-administrator credentials for the database in Publish Settings. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-faq.yml deleted file mode 100644 index 99785d92f..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-faq.yml +++ /dev/null @@ -1,50 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Gallery FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 7f484192-47a7-456b-ae81-592b8787241b - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/gallery-faq - msc.type: authoredcontent - ms.topic: faq -title: Gallery FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing Gallery - - -sections: - - name: Ignored - questions: - - question: | - How do I install Gallery? - answer: | - To install Gallery, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Galleries** category on the left-hand side. - 3. Find **Gallery** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my Gallery website? - answer: | - To publish a Gallery website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue:** Gallery gives a "Service is unavailable" error after publishing - **Workound:** In WebMatrix, click Publish Settings and add a slash "\" after the server name. Publish the application again. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq.yml deleted file mode 100644 index 83d5593b8..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq.yml +++ /dev/null @@ -1,69 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Gallery Server Pro FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: c37a0bcf-3870-4c29-a544-890dc473633f - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq - msc.type: authoredcontent - ms.topic: faq -title: Gallery Server Pro FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - -sections: - - name: Installing and Publishing Gallery Server Pro - questions: - - question: | - How do I install Gallery Server Pro? - answer: | - To install Gallery Server Pro, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Galleries** category on the left-hand side. - 3. Find **Gallery Server Pro** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my Gallery Server Pro website? - answer: | - To publish a Gallery Server Pro website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - - name: Common Issues - questions: - - question: | - Why do I get a "500 Internal Server Error" when browsing to my website? - answer: | - If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - - > **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. - > - > [!NOTE] - > For security reasons, this error will contain less information when you browse to your web site on a remote machine. - > - > ![image1](gallery-server-pro-faq/_static/image1.png) - - To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. - - - question: | - Why do I get a JavaScript error when trying to browse my website? - answer: | - If your web site's application pool is configured to run in Classic mode, you will receive this error because Gallery Server Pro requires Integrated mode. You will also see the following error message displayed: - - > **Error**: JavaScript error 'dgLogin' is undefined. - > - > ![image3](gallery-server-pro-faq/_static/image3.png) - - To resolve this issue, use your hosting control panel to set your application pool to Integrated mode. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image3.png b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image3.png deleted file mode 100644 index 6a271d40d..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image3.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image4.png b/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image4.png deleted file mode 100644 index 6a271d40d..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/gallery-server-pro-faq/_static/image4.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/joomla-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/joomla-faq.md deleted file mode 100644 index eb962c353..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/joomla-faq.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Joomla! FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding Joomla installation and configuration. -ms.date: 07/06/2010 -ms.assetid: d06d5158-13c1-44f0-a0b6-6c8e45e60f75 -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/joomla-faq -msc.type: authoredcontent ---- -# Joomla! FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing Joomla - -#### Q: How do I install Joomla? - -A: To install Joomla, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **CMS** category on the left-hand side. -3. Find **Joomla!** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my Joomla website? - -A: To publish a Joomla website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/kentico-cms-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/kentico-cms-faq.md deleted file mode 100644 index 02605926e..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/kentico-cms-faq.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Kentico CMS FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding Kentico installation and configuration. -ms.date: 07/06/2010 -ms.assetid: 3131eb91-0922-4349-a88e-67bec389f74a -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/kentico-cms-faq -msc.type: authoredcontent ---- -# Kentico CMS FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing Kentico CMS - -#### Q: How do I install Kentico CMS? - -A: To install Kentico CMS, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **CMS** category on the left-hand side. -3. Find **Kentico CMS for ASP.NET** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my Kentico CMS website? - -A: To publish a Kentico CMS website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -**Once Kentico is published, you need to add a license and update the domain in the published site for the application to work correctly.** diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/kooboo-cms-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/kooboo-cms-faq.yml deleted file mode 100644 index 5300a813b..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/kooboo-cms-faq.yml +++ /dev/null @@ -1,74 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Kooboo CMS FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 10afd33c-34c6-4198-8e26-f445838a784a - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/kooboo-cms-faq - msc.type: authoredcontent - ms.topic: faq -title: Kooboo CMS FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing Kooboo CMS - -sections: - - name: Installing and Publishing Kooboo CMS - questions: - - question: | - How do I install Kooboo CMS? - answer: | - To install Kooboo CMS, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **Kooboo CMS** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my Kooboo CMS website? - answer: | - To publish a Kooboo CMS website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue:** You see a "Server Error" when browsing to the site - - The application has 4 connection strings, but only 1 will be updated when publishing. - - **Workaround:** To resolve this issue, use the following steps: - - 1. Using WebMatrix, create a copy of the web.config that will be used for the remote web site: - - 1. Go to the **Files** workspace. - 2. Copy and paste the *web.config* to create a copy. - 3. Rename *Web - Copy.config* to *web.config.local*. - 4. Open *web.config* and make sure all connection strings use the same remote database server. - 5. Click **Save** on the **Quick Access Toolbar** or press Ctrl + S. - 6. Publish again. - 7. After publishing, browse to your remote web site to verify that the application works. - 2. To switch to the local web.config so that the application works on your client machine: - - 1. Rename *web.config* to *web.config.remote*. - 2. Rename *web.config.local* to *web.config*. - 3. Click **Run** or press F12 to open the site in your default web browser. - 3. You will need to switch these files every time you publish. - - **Issue:** "Download published site…" fails with a database error - If you try to download an application from a server and you have administrator credentials in the database connection string in the Publish Settings dialog, you may see this error in the publish log: - 1:28:29 PM: An error occurred during execution of the database script. The approximate location of the error was between lines '3260' and '3262' of the script. The verbose log may have more information about the error. The command started with : - 1:28:29 PM: CREATE LOGIN [MACHINE\Administrator] FROM WINDOW - 1:28:29 PM: [https://go.microsoft.com/fwlink/?LinkId=178587](https://go.microsoft.com/fwlink/?LinkId=178587) - **Workaround:** Publish the site in the first place using non-administrator credentials for the database in Publish Settings. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq.md deleted file mode 100644 index 25da0ae65..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Mayando FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding Mayando installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: 3c94f680-9725-4f82-a1ae-514e8fd662ba -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/mayando-faq -msc.type: authoredcontent ---- -# Mayando FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing Mayando - -#### Q: How do I install Mayando? - -A: To install Mayando, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **Galleries** category on the left-hand side. -3. Find **Mayando** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my Mayando website? - -A: To publish a Mayando website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -## Common Issues - -#### Q: Why do I get a "500 Internal Server Error" when browsing to my website? - -A: If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - -> **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. -> -> ![Screenshot of an Internal Server Error message with Detailed Error Information and Config Source.](mayando-faq/_static/image1.png) - -To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/mayando-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq.yml deleted file mode 100644 index 907b48bd4..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq.yml +++ /dev/null @@ -1,82 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "mojoPortal FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 8d68812d-0a95-4464-bbbf-5034c65a5aa8 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq - msc.type: authoredcontent - ms.topic: faq -title: mojoPortal FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - -sections: - - name: Installing and Publishing mojoPortal - questions: - - question: | - How do I install mojoPortal? - answer: | - To install mojoPortal, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **mojoPortal** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my mojoPortal website? - answer: | - To publish a mojoPortal website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - - name: Common Issues - questions: - - question: | - Why do I get a "We're sorry but a server error has occurred while processing..." message when browsing to my website? - answer: | - If you are publishing to a server where your website is running in Medium trust (most hosting providers run in Medium trust), you will see this error message. - - To resolve this issue, use the following steps: - - 1. Go to the **Files** workspace. - 2. Copy and paste the *web.config* file to create a copy. - 3. Rename the *web - Copy.config* file to *web.config.bak*. - 4. Renane *web.mediumtrust.config* to *web.config*. - 5. Publish your website again. - - - question: | - Why do I get a "500 Internal Server Error" when browsing to my website? - answer: | - If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - - > **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. - > - > ![image1](mojoportal-faq/_static/image1.png) - - To resolve this issue, use the following steps: - - 1. Use your hosting control panel to set your .NET framework version to 2.0 or 3.5. - 2. Alternately, using WebMatrix, you can convert the application to use .NET 4: - - 1. Go to the **Site** workspace. - 2. Open "Site Settings" by selecting the site node in the navigation pane. - 3. Set the Framework version to .NET 4. - 4. Click **Save** on the **Quick Access Toolbar** or press Ctrl + S. - 5. Go to the **Files** workspace. - 6. Rename *web.config* to *web.config.bak*. - 7. Rename *web.net4.config* to *web.config*. - 8. Click **Run** or press F12 to verify that the application works. - 9. Publish again. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/mojoportal-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/moodle-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/moodle-faq.yml deleted file mode 100644 index 48aeae6ba..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/moodle-faq.yml +++ /dev/null @@ -1,49 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Moodle FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: e40b32aa-2a85-4453-b226-2e2cb8741c8b - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/moodle-faq - msc.type: authoredcontent - ms.topic: faq -title: Moodle FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing Moodle - - -sections: - - name: Ignored - questions: - - question: | - How do I install Moodle? - answer: | - To install Moodle, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **Moodle** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my Moodle website? - answer: | - To publish a Moodle website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue:** Moodle website layout and links are broken after publishing - **Workaround:** Add a trailing slash ‘/' to the Site Name field in Publish Settings and publish again. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/my-web-pages-starter-kit-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/my-web-pages-starter-kit-faq.yml deleted file mode 100644 index bc6b18df1..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/my-web-pages-starter-kit-faq.yml +++ /dev/null @@ -1,45 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "My Web Pages Starter Kit FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 65103c7d-909c-44fb-aa6e-934d2d97c67b - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/my-web-pages-starter-kit-faq - msc.type: authoredcontent - ms.topic: faq -title: My Web Pages Starter Kit FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing My Web Pages Starter Kit - - -sections: - - name: Ignored - questions: - - question: | - How do I install My Web Pages Starter Kit? - answer: | - To install My Web Pages Starter Kit, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **My Web Pages Starter Kit** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my My Web Pages Starter Kit website? - answer: | - To publish a My Web Pages Starter Kit website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/nopcommerce-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/nopcommerce-faq.yml deleted file mode 100644 index a701b2de3..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/nopcommerce-faq.yml +++ /dev/null @@ -1,54 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "nopCommerce FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: a2224aa1-721e-4fff-9e71-da93e790b502 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/nopcommerce-faq - msc.type: authoredcontent - ms.topic: faq -title: nopCommerce FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing nopCommerce - -sections: - - name: Ignored - questions: - - question: | - How do I install nopCommerce? - answer: | - To install nopCommerce, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **eCommerce** category on the left-hand side. - 3. Find **nopCommerce** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my nopCommerce website? - answer: | - To publish a nopCommerce website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue:** Publishing nopCommerce fails with a database error similar to this one: "Insert into the nop\_log table failed" - **Workaround:** 1) In WebMatrix, click Run to start nopCommerce locally. - 2) Log into the administration page - 3) Click the "System" menu - 4) Click the "Log" option. - 5) Click the "Clear Log" button. - 6) Publish nopCommerce again. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq.md deleted file mode 100644 index 3a6ab808d..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: nService FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding nService installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: 6a66077a-b338-48bc-a336-90f43288401e -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/nservice-faq -msc.type: authoredcontent ---- -# nService FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing nService - -#### Q: How do I install nService? - -A: To install nService, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **Tools** category on the left-hand side. -3. Find **nService** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my nService website? - -A: To publish a nService website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -## Common Issues - -#### Q: Why do I get a "500 Internal Server Error" when browsing to my website? - -A: If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - -> **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. -> -> ![Screenshot of a Server Error page displaying a 500 Internal Server Error.](nservice-faq/_static/image1.png) - -To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/nservice-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/phpbb-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/phpbb-faq.md deleted file mode 100644 index 6e3120838..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/phpbb-faq.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: phpBB FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding phpBB installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: ed03be9b-b0b1-4845-bb4e-b1355989af0d -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/phpbb-faq -msc.type: authoredcontent ---- -# phpBB FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing phpBB - -#### Q: How do I install phpBB? - -A: To install phpBB, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **Forums** category on the left-hand side. -3. Find **phpBB** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my phpBB website? - -A: To publish a phpBB website, use the following steps: - -1. Prior to publishing the application, you should remove the install directory or only the application's administrative console will be available: - - 1. Go to the **Files** workspace. - 2. In the navigation pane, select the directory called *install* and press the delete key. -2. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -3. On the **Publishing Settings** dialog, enter the server info you received from your web host. -4. Click **Validate Connection** to ensure that the settings are correct. -5. Click **Publish**. -6. If you have not published your database before, select the Database checkbox. -7. After previewing the changes, click **Continue**. - -## Known Issues - -**Issue:** phpBB gives a "Service is unavailable" error after publishing -**Workound:** In WebMatrix, click Publish Settings and add a slash "\" after the server name. Publish the application again. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq.yml deleted file mode 100644 index 684876f78..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq.yml +++ /dev/null @@ -1,56 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "ResourceBlender.NET FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 32d1cc8e-a907-4e15-8224-515f99884ece - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq - msc.type: authoredcontent - ms.topic: faq -title: ResourceBlender.NET FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - -sections: - - name: Installing and Publishing ResourceBlender.NET - questions: - - question: | - How do I install ResourceBlender.NET? - answer: | - To install ResourceBlender.NET, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Tools** category on the left-hand side. - 3. Find **ResourceBlender.NET** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my ResourceBlender.NET website? - answer: | - To publish a ResourceBlender.NET website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - - name: Common Issues - questions: - - question: | - Why do I get a "500 Internal Server Error" when browsing to my website? - answer: | - If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - - > **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. - > - > ![image1](resourceblendernet-faq/_static/image1.png) - - To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/resourceblendernet-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/screwturn-wiki-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/screwturn-wiki-faq.yml deleted file mode 100644 index 1b8b83981..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/screwturn-wiki-faq.yml +++ /dev/null @@ -1,45 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "ScrewTurn Wiki FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: ac716127-6e0e-4b9f-af69-d0e3626c1527 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/screwturn-wiki-faq - msc.type: authoredcontent - ms.topic: faq -title: ScrewTurn Wiki FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing ScrewTurn Wiki - - -sections: - - name: Ignored - questions: - - question: | - How do I install ScrewTurn Wiki? - answer: | - To install ScrewTurn Wiki, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Wiki** category on the left-hand side. - 3. Find **ScrewTurn Wiki** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my ScrewTurn Wiki website? - answer: | - To publish a ScrewTurn Wiki website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/silverstripe-cms-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/silverstripe-cms-faq.yml deleted file mode 100644 index 8f73ac1d8..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/silverstripe-cms-faq.yml +++ /dev/null @@ -1,48 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "SilverStripe CMS FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 376a2ffa-1dde-4527-9f83-1bfcd276d8b6 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/silverstripe-cms-faq - msc.type: authoredcontent - ms.topic: faq -title: SilverStripe CMS FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing SilverStripe CMS - -sections: - - name: Installing and Publishing SilverStripe CMS - questions: - - question: | - How do I install SilverStripe CMS? - answer: | - To install SilverStripe CMS, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **SilverStripe CMS** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my SilverStripe CMS website? - answer: | - To publish a SilverStripe CMS website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue:** Silverstripe CMS gives a "HTTP 500 PHP FCGI Error" when you download a published site - **Workaround:** Skip the silverstripe-cache/manifest\_main in Publish Preview after you click on "Download published site …". This file is used for caching purposes and is specific to each computer. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq.yml deleted file mode 100644 index df843b39f..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq.yml +++ /dev/null @@ -1,71 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Sitefinity Community Edition FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: c1fcf431-49b4-4ef8-b939-3984544355d4 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq - msc.type: authoredcontent - ms.topic: faq -title: Sitefinity Community Edition FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - -sections: - - name: Installing and Publishing Sitefinity Community Edition - questions: - - question: | - How do I install Sitefinity Community Edition? - answer: | - To install Sitefinity Community Edition, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **Sitefinity Community Edition** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - Note: If you choose MySQL during the browser installation process, you will need to update the web.config: - - 1. Go to the **Files** workspace. - 2. Find the following entry: - - ```xml - - ``` - - 3. Modify the providerName to work with MySQL: - - ```xml - - ``` - - - question: | - How do I publish my Sitefinity Community Edition website? - answer: | - To publish a Sitefinity Community Edition website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. For the connection string, you need to copy the connection string from web.config (it will be pointing to a .mdf file in your website) and paste it into the dialog, otherwise publishing will fail. - 4. Click **Validate Connection** to ensure that the settings are correct. - 5. Click **Publish**. - 6. After previewing the changes, click **Continue**. - - - name: Common Issues - questions: - - question: | - Why do I get a "500 Internal Server Error" when browsing to my website? - answer: | - If you are publishing to a server where the web site is configured to run in a .NET 4 application pool, you will receive this error because the application requires .NET 2.0. You will also see the following error message displayed: - - > **Error**: The requested page cannot be accessed because the related configuration data for the page is invalid. - > - > ![image1](sitefinity-community-edition-faq/_static/image1.png) - - To resolve this issue, use your hosting control panel to set your .NET framework version to 2.0 or 3.5. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image1.png b/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image1.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image2.png b/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image2.png deleted file mode 100644 index ab00f79ed..000000000 Binary files a/iis/develop/installingpublishing-apps-with-webmatrix/sitefinity-community-edition-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/subtext-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/subtext-faq.yml deleted file mode 100644 index b4202e512..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/subtext-faq.yml +++ /dev/null @@ -1,57 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Subtext FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: d1ea5645-fdf1-41a1-b445-23fe909d516c - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/subtext-faq - msc.type: authoredcontent - ms.topic: faq -title: Subtext FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing Subtext - - -sections: - - name: Ignored - questions: - - question: | - How do I install Subtext? - answer: | - To install Subtext, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Blogs** category on the left-hand side. - 3. Find **Subtext** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my Subtext website? - answer: | - To publish a Subtext website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - - ## Known Issues - - **Issue**: Subtext gives a "Server Error in '/' Application" when you download a published site - - **Workaround #1**: Open up the site's web.config file and replace the user ID and password in the database connection string with the SQL Server administrator credentials (i.e. "sa" credentials). - - **Workaround #2**: Give the user account you are logged in with db\_owner permissions. - - 1. Install SQL Server Management Studio using the Web Platform Installer - 2. Connect to your local SQL server (.\SQLEXPRESS by default) - 3. Click Databases > [localSubtextDatabase] > Security > Users > [localSubtextuser - default is "subtextuser"] and right-click for properties. Check the box for "db\_owner" in the role membership section. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/sugarcrm-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/sugarcrm-faq.yml deleted file mode 100644 index 593afb253..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/sugarcrm-faq.yml +++ /dev/null @@ -1,45 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "SugarCRM FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 920dcfb3-f125-4273-aa3d-2c260347f9cf - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/sugarcrm-faq - msc.type: authoredcontent - ms.topic: faq -title: SugarCRM FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing SugarCRM - - -sections: - - name: Ignored - questions: - - question: | - How do I install SugarCRM? - answer: | - To install SugarCRM, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **Tools** category on the left-hand side. - 3. Find **SugarCRM** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: | - How do I publish my SugarCRM website? - answer: | - To publish a SugarCRM website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. - diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/umbraco-cms-faq.yml b/iis/develop/installingpublishing-apps-with-webmatrix/umbraco-cms-faq.yml deleted file mode 100644 index 7dbb36157..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/umbraco-cms-faq.yml +++ /dev/null @@ -1,46 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Umbraco CMS FAQ" - author: rick-anderson - description: "WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Be..." - ms.date: 07/06/2010 - ms.assetid: 03d91b1a-9581-43bc-b960-7a66c18da397 - msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/umbraco-cms-faq - msc.type: authoredcontent - ms.topic: faq -title: Umbraco CMS FAQ -summary: | - by Faith A - - WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - - ## Installing and Publishing Umbraco CMS - - -sections: - - name: Ignored - questions: - - question: How do I install Umbraco CMS? - answer: | - To install Umbraco CMS, use the following steps: - - 1. Open WebMatrix and select **Site from Web Gallery**. - 2. Select the **CMS** category on the left-hand side. - 3. Find **Umbraco CMS** in the list and install it. - 4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. - 5. Follow the instructions to complete installation. - - - question: How do I publish my Umbraco CMS website? - answer: | - To publish a Umbraco CMS website, use the following steps: - - 1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. - 2. On the **Publishing Settings** dialog, enter the server info you received from your web host. - - > [!NOTE] - > Umbraco CMS is only supported at the root of a web site, such as contoso.com. It will not work when installed to a sub-directory, such as contoso.com/application. - - 3. Click **Validate Connection** to ensure that the settings are correct. - 4. Click **Publish**. - 5. If you have not published your database before, select the Database checkbox. - 6. After previewing the changes, click **Continue**. diff --git a/iis/develop/installingpublishing-apps-with-webmatrix/wordpress-faq.md b/iis/develop/installingpublishing-apps-with-webmatrix/wordpress-faq.md deleted file mode 100644 index 9dd7865c6..000000000 --- a/iis/develop/installingpublishing-apps-with-webmatrix/wordpress-faq.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: WordPress FAQ -author: rick-anderson -description: Provides a list of frequently asked questions and answers regarding WordPress installation, configuration, and known issues. -ms.date: 07/06/2010 -ms.assetid: 05415d6c-c1f1-4a0c-9e92-2d14a5b8fbb6 -msc.legacyurl: /learn/develop/installingpublishing-apps-with-webmatrix/wordpress-faq -msc.type: authoredcontent ---- -# WordPress FAQ - -by Faith A - -WebMatrix supports installing open source community applications from the Web Application Gallery, and publishing to hosting providers, including a set of Beta partner hosting providers. This FAQ contains information about installing and publishing, as well as any issues that may occur after publishing. - -## Installing and Publishing WordPress - -#### Q: How do I install WordPress? - -A: To install WordPress, use the following steps: - -1. Open WebMatrix and select **Site from Web Gallery**. -2. Select the **Blogs** category on the left-hand side. -3. Find **WordPress** in the list and install it. -4. In any workspace, on the **Home** tab, in the **Site** group, click **Run** or press F12 to open the site in your default web browser. -5. Follow the instructions to complete installation. - -#### Q: How do I publish my WordPress website? - -A: To publish a WordPress website, use the following steps: - -1. In any workspace, on the **Home** tab, in the **Site** group, click **Publish**. -2. On the **Publishing Settings** dialog, enter the server info you received from your web host. -3. Click **Validate Connection** to ensure that the settings are correct. -4. Click **Publish**. -5. If you have not published your database before, select the Database checkbox. -6. After previewing the changes, click **Continue**. - -Known Issues - -**Issue:** Wordpress fail to publish with a database error indicating that a particular line of SQL could not be processed -WebMatrix installs MySQL with the UTF-8 character set by default. If you install MySQL on your own, and the character set is not UTF-8 (e.g. it may be Latin1), publishing databases may fail -**Workaround:** 1) Change the character set for MySQL to UTF-8. [More information](http://dev.mysql.com/doc/refman/5.0/en/charset-server.html). -2) Re-install the application -3) Re-publish the application diff --git a/iis/develop/runtime-extensibility/sample-web-analytics-tracking-module.md b/iis/develop/runtime-extensibility/sample-web-analytics-tracking-module.md index b6a829703..b79e76ebe 100644 --- a/iis/develop/runtime-extensibility/sample-web-analytics-tracking-module.md +++ b/iis/develop/runtime-extensibility/sample-web-analytics-tracking-module.md @@ -69,4 +69,4 @@ The configuration UI for the Web Analytics module looks as below: ![Screenshot of Web Analytics Tracking Configuration dialog box with tracking script populating the field.](sample-web-analytics-tracking-module/_static/image5.png) -After the module has been configured, we can see how it works by requesting the web page from the server by using [WFetch](https://www.microsoft.com/downloads/details.aspx?FamilyID=b134a806-d50e-4664-8348-da5c17129210&displaylang=en). The output from web server contains the tracking script before the closing <body /> tag:![Screenshot of W Fetch U I displaying output from web server and tracking script populating the Log Output field.](sample-web-analytics-tracking-module/_static/image6.png) +After the module has been configured, we can see how it works by requesting the web page from the server by using WFetch. The output from web server contains the tracking script before the closing <body /> tag:![Screenshot of W Fetch U I displaying output from web server and tracking script populating the Log Output field.](sample-web-analytics-tracking-module/_static/image6.png) diff --git a/iis/develop/troubleshooting-webmatrix/issues-with-sql-server-express-or-mysql-when-using-webmatrix-or-webpi_1298.md b/iis/develop/troubleshooting-webmatrix/issues-with-sql-server-express-or-mysql-when-using-webmatrix-or-webpi_1298.md deleted file mode 100644 index e8476b8d1..000000000 --- a/iis/develop/troubleshooting-webmatrix/issues-with-sql-server-express-or-mysql-when-using-webmatrix-or-webpi_1298.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Issues with SQL Server Express or MySQL when using WebMatrix or WebPI" -author: chrissfanos -description: "The following article will grow to cover issues when using SQL Server Express or MySQL and WebMatrix or WebPI (Web Platform Installer) Issue : The SA (SQL Ex..." -ms.date: 07/18/2012 -ms.assetid: 24dcd427-0585-4afd-aa79-298f63a0d7f9 -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/issues-with-sql-server-express-or-mysql-when-using-webmatrix-or-webpi_1298 -msc.type: authoredcontent ---- -# Issues with SQL Server Express or MySQL when using WebMatrix or WebPI - -by [Chris Sfanos](https://github.com/chrissfanos) - -The following article will grow to cover issues when using SQL Server Express or MySQL and WebMatrix or WebPI (Web Platform Installer) - -***Issue***: The SA (SQL Express) or root (MySQL) password you entered (or have stored) is not valid - -***Error Message***: The specified password for user account 'SA'/'root' is not valid or failed to connect to the database server - -***Potential solutions*** - -1. The password you entered may not match the required security settings of SQL Express or MySQL. The following articles detail the password strength requirements: - - 1. SQL Express: [https://msdn.microsoft.com/library/ms161959.aspx](https://msdn.microsoft.com/library/ms161959.aspx) - 2. MySQL: No complexity requirements -2. The password that WebMatrix or WebPI has stored does not match the database you are trying to connect to - - 1. Delete the reg key that is storing the password (hashed) and try the install again - 2. Delete the mysql\_pwd or sql\_pwd key stored at HKCU\Software\Microsoft\WebPlatformInstaller diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing.md b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing.md deleted file mode 100644 index 5a444b82e..000000000 --- a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Microsoft WebMatrix: Certificate errors during publishing" -author: bilalaslam -description: "If you are publishing using Web Deploy, WebMatrix helps you publish your site securely by checking the certificate of the remote server and prompting you if..." -ms.date: 11/11/2010 -ms.assetid: 8e6e3caf-c2a3-4bca-9879-229c3846c126 -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing -msc.type: authoredcontent ---- -# Microsoft WebMatrix: Certificate errors during publishing - -by [Bilal Aslam](https://github.com/bilalaslam) - -If you are publishing using Web Deploy, WebMatrix helps you publish your site securely by checking the certificate of the remote server and prompting you if any issues are detected. For example, you may see the following security prompt when publishing a site: - -[![Screenshot of a Certificate Error, showing the Accept Certificate and Reject Certificate options.](microsoft-webmatrix-certificate-errors-during-publishing/_static/image3.png)](microsoft-webmatrix-certificate-errors-during-publishing/_static/image1.png) - -If you wish to continue publishing your site, click 'Accept Certificate'. You will not be prompted again while WebMatrix is open, but you will be prompted if you close and reopen WebMatrix. If you do not want to be prompted about certificate errors for this site, click "Save this certificate for future sessions of WebMatrix". - -If you do NOT wish to continue publishing your site, click 'Reject Certificate'. Publishing will stop immediately. diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image1.png b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image1.png deleted file mode 100644 index 604f6c5eb..000000000 Binary files a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image1.png and /dev/null differ diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image2.png b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image2.png deleted file mode 100644 index 604f6c5eb..000000000 Binary files a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image2.png and /dev/null differ diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image3.png b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image3.png deleted file mode 100644 index 604f6c5eb..000000000 Binary files a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image3.png and /dev/null differ diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image4.png b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image4.png deleted file mode 100644 index 604f6c5eb..000000000 Binary files a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-certificate-errors-during-publishing/_static/image4.png and /dev/null differ diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-database-errors-while-publishing-and-downloading-sites.md b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-database-errors-while-publishing-and-downloading-sites.md deleted file mode 100644 index 93f6ebc3d..000000000 --- a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-database-errors-while-publishing-and-downloading-sites.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: "Microsoft WebMatrix: Database errors while publishing and downloading sites" -author: bilalaslam -description: "Microsoft WebMatrix includes the ability to transfer your site's database to and from a remote server. This article contains tips for when you encouter error..." -ms.date: 01/09/2011 -ms.assetid: 3498e1fb-f467-46f4-bf44-60e8e7615905 -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/microsoft-webmatrix-database-errors-while-publishing-and-downloading-sites -msc.type: authoredcontent ---- -# Microsoft WebMatrix: Database errors while publishing and downloading sites - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Introduction - -Microsoft WebMatrix includes the ability to transfer your site's database to and from a remote server. This article contains tips for when you encouter errors during a database transfer. - -## Tips - -Check that the username and password in the database connection string in Publish Settings is correct. Click 'Validate Connection' to verify that WebMatrix can connect to the database. - -If you are transferring a MySQL database, ensure that MySQL has default collation of UTF-8. WebMatrix automatically sets this collation if it installs MySQL. Further reading: [http://dev.mysql.com/doc/refman/5.0/en/charset-server.html](http://dev.mysql.com/doc/refman/5.0/en/charset-server.html) - -If you are still stuck, we recommending posting a question on the [WebMatrix Forum](https://forums.iis.net/1166.aspx). diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-my-documents-on-network-shares.md b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-my-documents-on-network-shares.md deleted file mode 100644 index 3e5c9048f..000000000 --- a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-my-documents-on-network-shares.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: "Microsoft WebMatrix: My Documents on network shares" -author: rick-anderson -description: "When your 'My Documents' folder is pointing to a network share, Windows translates the location automatically. This is so that applications such as WebMatrix..." -ms.date: 01/11/2011 -ms.assetid: 7ecaa7ab-e6d1-4b8b-8d74-6296e45b0d2d -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/microsoft-webmatrix-my-documents-on-network-shares -msc.type: authoredcontent ---- -# Microsoft WebMatrix: My Documents on network shares - -by Faith A - -When your "My Documents" folder is pointing to a network share, Windows translates the location automatically. This is so that applications such as WebMatrix or IIS Express can simply request the special folder and Windows takes care of the rest. - -While this works fine in most circumstances, there are cases that do not work. When My Documents points to a network share, this is supported. - -However it will not work when My Documents points to a mapped drive (like Z:), which then points to a network share. - -This problem is due to the way that Windows calculates the path for the special folder. We block this case because IIS Express will not work properly in this case. - -The workaround is to point your "My Documents" directly to the network share. diff --git a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility.md b/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility.md deleted file mode 100644 index 0cf501ec0..000000000 --- a/iis/develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: "Microsoft WebMatrix: Publish Compatibility" -author: bilalaslam -description: "Microsoft WebMatrix includes a feature called Publish Compatibility, which can help determine if your site is compatible with a web hosting provider. To chec..." -ms.date: 11/11/2010 -ms.assetid: a0133dfc-265b-42b7-adc4-4f92421e2a8a -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/microsoft-webmatrix-publish-compatibility -msc.type: authoredcontent ---- -# Microsoft WebMatrix: Publish Compatibility - -by [Bilal Aslam](https://github.com/bilalaslam) - -Microsoft WebMatrix includes a feature called Publish Compatibility, which can help determine if your site is compatible with a web hosting provider. To check your site's compatibility with a web hosting provider: - -1. Create or open a site in WebMatrix -2. Provide publish settings in the Publish Settings dialog -3. Click Publish > Check Compatibility... in the ribbon dropdown menu. - -Publish Compatibility will find out what components your site depends on, and then check if they are available on the web hosting provider. For example, if your site includes a Microsoft SQL Server database, then Publish Compatibility will verify that a Microsoft SQL Server database is available on the web hosting provider using the connection string you provided in the Publish Settings Dialog. - -This is a summary of what Publish Compatibility checks: - -| Site Dependency | Checked by Publish Compatibility? | What to do if the compatibility test fails | -| --- | --- | --- | -| Simple HTML page | **Y** | Check the Destination URL field in Publish Settings | -| ASP.NET | **Y**, but not checked if publishing protocol is FTP | Check if your hosting provider supports ASP.NETCheck if your hosting provider has given you permissions to change your IIS application pool's .NET framework version and pipeline mode | -| PHP | **Y** | Check if your hosting provider supports PHP | -| SQL Server database | **Y**, but not checked if publishing protocol is FTP since FTP does not support transferring SQL Server database | Check the database connection string in the Publish Settings dialog | -| MySQL database | **Y**, but not checked if publishing protocol is FTP since FTP does not support transferring MySQL databases | Check the database connection string in the Publish Settings dialog | -| MySQL driver for PHP | **Y** | Check if your hosting provider supports connecting to MySQL databases using PHP | -| SQL Server driver for PHP | **Y** | Check if your hosting provider supports connecting to SQL Server databases using PHP | -| URL Rewrite | **Y** | Check if your hosting provider supports URL Rewrite | -| ASP.NET MVC | N | Not currently checked by Publish Compatibility | - -## Known Issues - -**Issue:** If you publish an app (e.g. mysite/myapp) that has a different .NET version from the site (e.g. mysite), the Publish Compatibility check that runs on first publish does NOT set the .NET version. This may result is errors when you browse to your published application - -**Workaround:** Run Publish Compatibility again, which will update the remote site's .NET version as needed. diff --git a/iis/develop/troubleshooting-webmatrix/webmatrix-mdf-migration.md b/iis/develop/troubleshooting-webmatrix/webmatrix-mdf-migration.md deleted file mode 100644 index fa43a55fc..000000000 --- a/iis/develop/troubleshooting-webmatrix/webmatrix-mdf-migration.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "WebMatrix MDF Migration" -author: rick-anderson -description: "Symptom: You see a Database Migration Required message when you are trying to download a database from SQL Azure into a local MDF database. For example, when..." -ms.date: 06/06/2012 -ms.assetid: 4e53bfb5-2e62-4e7e-a2a9-b342f9b35594 -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/webmatrix-mdf-migration -msc.type: authoredcontent ---- -# WebMatrix MDF Migration - -by Faith A - -**Symptom:** You see a Database Migration Required message when you are trying to download a database from SQL Azure into a local MDF database. - -For example, when you install an application such as DotNetNuke, the default installation uses an MDF file. You can publish this directly to a remote site and SQL server, including SQL Azure. If you have published the site to SQL Azure and then click the Download button in order to sync remote changes, then you will see this message. - -This is because you cannot migrate a SQL Azure database back into an attached MDF file. To resolve this issue, click on the Databases workspace, select the local database and click Migrate in the ribbon. - -The migration will not affect your data or schema. Once migration is complete, you can click Download. diff --git a/iis/develop/troubleshooting-webmatrix/when-publishing-a-site-from-webmatrix-using-the-ftp-protocol-some-files-are-not-listed-in-the-publish-preview-dialog.md b/iis/develop/troubleshooting-webmatrix/when-publishing-a-site-from-webmatrix-using-the-ftp-protocol-some-files-are-not-listed-in-the-publish-preview-dialog.md deleted file mode 100644 index 4f37f0e07..000000000 --- a/iis/develop/troubleshooting-webmatrix/when-publishing-a-site-from-webmatrix-using-the-ftp-protocol-some-files-are-not-listed-in-the-publish-preview-dialog.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "When publishing a site from WebMatrix, some files are not listed in the dialog" -author: bilalaslam -description: "When publishing a site from WebMatrix using the FTP protocol, some files are not listed in the Publish Preview dialog. How to reproduce Publish site from to..." -ms.date: 02/07/2011 -ms.assetid: 693e4539-1261-4ad7-afa7-a876fdc4135e -msc.legacyurl: /learn/develop/troubleshooting-webmatrix/when-publishing-a-site-from-webmatrix-using-the-ftp-protocol-some-files-are-not-listed-in-the-publish-preview-dialog -msc.type: authoredcontent ---- -# When publishing a site from WebMatrix, some files are not listed in the dialog - -by [Bilal Aslam](https://github.com/bilalaslam) - -When publishing a site from WebMatrix using the FTP protocol, some files are not listed in the Publish Preview dialog. - -## How to reproduce - -- Publish site from to Remote Server 1 using the FTP protocol. -- Change a single file associated, foo.html, with the site on Remote Server 1 (for example, by using an FTP client to download the file, modify it, and upload it again). -- Publish site to Remote Server 1 using the FTP protocol. Notice that foo.html does not show up in the Publish Preview dialog because WebMatrix does not recognize it as being changes. - -## Resolution - -When publishing using the FTP protocol, WebMatrix by default keeps track of files that are changed on the local computer. This makes all FTP transfers after the first transfer faster because WebMatrix does not need to obtain a folder list from the remote server to determine what files are different. - -There are two resolutions available: - -### 1) (Recommended) Clear the cached list of changed files - -1. Close WebMatrix. -2. Open the IIS Express configuration directory in Explorer: %USERPROFILE%\IISExpress\config\PublishUI -3. Open the folder named after your site. For example, if your site is named Bakery, open the bakery folder. -4. Open the folder named after your remote server. For example, if you are publishing to [ftp.contoso.com](ftp://ftp.contoso.com/), open the [ftp.contoso.com](ftp://ftp.contoso.com/) folder. -5. Delete the CSV file in this folder. -6. Open WebMatrix and try publishing again. - -### 2) Disable the feature - -1. Open WebMatrix. -2. Click the Application Menu in the top-left corner of the window. -3. Click Options. -4. Click Publishing. -5. Uncheck "Make FTP faster by only publishing the files that have changed on this computer". - - > [!NOTE] - > This will make FTP transfers significantly slower. diff --git a/iis/develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md b/iis/develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md index 15ff6932a..74dca2e30 100644 --- a/iis/develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md +++ b/iis/develop/using-visual-studio-with-iis/using-visual-studio-2005-with-iis.md @@ -174,7 +174,7 @@ For more information on using the FTP server included in Windows Vista and Windo You can use the Remote Site option if you have shared the IIS Web site you want to publish to using Front Page Server Extensions. Unlike the FTP Site option, you can create and edit IIS applications and virtual directories when using this option. -[Front Page Server Extensions for IIS 7.0](https://go.microsoft.com/fwlink/?LinkId=86544) are available as a free download for Windows Vista and Windows Server 2008. For more information on installing and enabling Front Page Server Extensions for IIS Web sites, see [Installing Front Page Server Extensions for IIS](https://go.microsoft.com/fwlink/?LinkId=88546). +Front Page Server Extensions for IIS 7.0 are available as a free download for Windows Vista and Windows Server 2008. For more information on installing and enabling Front Page Server Extensions for IIS Web sites, see [Installing Front Page Server Extensions for IIS](https://go.microsoft.com/fwlink/?LinkId=88546). To quickly enable a remote Web site to be used with the "Remote Site" option in Visual Studio, do the following: diff --git a/iis/develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md b/iis/develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md index a84ff57de..f5a6407c2 100644 --- a/iis/develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md +++ b/iis/develop/using-visual-studio-with-iis/using-visual-studio-2008-with-iis.md @@ -163,7 +163,7 @@ For more information on using the FTP server included in Windows Vista and Windo You can use the Remote Site option if you have shared the IIS Web site you want to publish to using Front Page Server Extensions. Unlike the FTP Site option, you can create and edit IIS applications and virtual directories when using this option. -[Front Page Server Extensions for IIS 7](https://go.microsoft.com/fwlink/?LinkId=86544) are available as a free download for Windows Vista and Windows Server 2008. For more information on installing and enabling Front Page Server Extensions for IIS Web sites, see [Installing Front Page Server Extensions for IIS](https://go.microsoft.com/fwlink/?LinkId=88546). +Front Page Server Extensions for IIS 7 are available as a free download for Windows Vista and Windows Server 2008. For more information on installing and enabling Front Page Server Extensions for IIS Web sites, see [Installing Front Page Server Extensions for IIS](https://go.microsoft.com/fwlink/?LinkId=88546). To quickly enable a remote Web site to be used with the "Remote Site" option in Visual Studio, do the following: diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website.md b/iis/develop/using-webmatrix/analyze-requests-to-your-website.md deleted file mode 100644 index 7817d52ce..000000000 --- a/iis/develop/using-webmatrix/analyze-requests-to-your-website.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: "Analyze Requests to Your Website" -author: rick-anderson -description: "[This is preliminary documentation and is subject to change.] Overview This walkthrough shows you how to analyze requests to your website using the Requests..." -ms.date: 07/06/2010 -ms.assetid: 3c483e52-2bc4-4066-98d2-de7caaa3a240 -msc.legacyurl: /learn/develop/using-webmatrix/analyze-requests-to-your-website -msc.type: authoredcontent ---- -# Analyze Requests to Your Website - -by [Diana Nguyen](https://twitter.com/dianaaanguyen) - -[This is preliminary documentation and is subject to change.] - -## Overview - -This walkthrough shows you how to analyze requests to your website using the Requests feature in WebMatrix Beta. This feature lets you view the status of requests in real-time, including detailed information like the verb, URL, time elapsed, and more. You can identify where errors are occurring, and resolve these errors immediately. For example, if you see an error in your browser, you can use the Requests feature to see if more information is available about the error. This will help you to diagnose and troubleshoot the error. - -IIS Express uses the following HTTP status codes: - -- Status code 2xx = Success -- Status code 3xx = Information (Redirect) -- Status code 4xx = Error (Client) -- Status code 5xx = Error (Server) - -> [!NOTE] -> For additional information about HTTP status codes, see the [HTTP status codes in IIS 7.0](https://support.microsoft.com/kb/943891) article in Microsoft Knowledge Base. - -### Prerequisites - -You must have the following installed to complete the procedures in this walkthrough: - -- Windows XP or a later version. -- WebMatrix Beta 1 or a later version. - -For information about how to install WebMatrix Beta, see [Microsoft Web Platform Installer 3.0](https://go.microsoft.com/fwlink/?LinkID=145510). - -## Monitoring Your Site - -When you make requests, you can view the results in real-time so that you can identify errors that are easy to fix, discover dependencies, and learn about your website. - -1. To start WebMatrix, in Windows, click **Start** > **All Programs** > **Microsoft WebMatrix Beta**. -2. On the WebMatrix Beta **Quick Start** page, open your site by choosing it from **My Sites**. - > [!NOTE] - > If you do not already have a site, you can open the default site (Website1) or add a new one by choosing **Site from Web Gallery**, **Site From Template**, or **Site From Folder**. - - [![Screenshot that shows the Web Matrix Beta Quick Start page.](analyze-requests-to-your-website/_static/image3.png)](analyze-requests-to-your-website/_static/image1.png) - - WebMatrix opens your site. This walkthrough uses the Bakery website as an example. - - [![Screenshot that shows Web Matrix for the Bakery website example.](analyze-requests-to-your-website/_static/image7.png)](analyze-requests-to-your-website/_static/image5.png) -3. On the **Home** tab, click **Requests**. -4. View your site in a browser by using one of the following: - - - On the **Home** tab, click **Run**. - - Press **F12**. -5. View the results of your request in the content pane. - - [![Screenshot that shows Capture Requests selected in the Requests tab.](analyze-requests-to-your-website/_static/image11.png)](analyze-requests-to-your-website/_static/image9.png) - - While viewing the results, you can also do the following: - - - Search the list of results for specific request types, such as "304.0". - - In the ribbon, in the **Requests** tab, click **Only Errors** to show only the results that are errors. Click **Only Errors** again to show the full list of results. - - Click **Ignore Images** to ignore the results that are related to image errors, such as 404.0 File Not Found, where the image doesn't exist on the Web server. Click **Ignore Images** again to show the full list of results. - - [![Screenshot that shows Ignore Images selected in the Requests tab.](analyze-requests-to-your-website/_static/image15.png)](analyze-requests-to-your-website/_static/image13.png) -6. In the list, select a request to view detailed information about the request, such as the status, details, and recommendations. If the request is an error, this will help you diagnose and fix the cause. - - [![Screenshot that shows Capture Requests selected in the Requests tab. The seventh item listed is selected.](analyze-requests-to-your-website/_static/image19.png)](analyze-requests-to-your-website/_static/image17.png) -7. If the request is an error, click **Edit** in the subpane to open the file that contains the error and fix the file. - You can also click **More Information** to get more information about the HTTP status code and possible solutions to the error from the Microsoft Support web page. -8. After you resolve the error, return to the **Site** workspace and open **Requests** again. Click **Clear All** to remove the cached requests. - - [![Screenshot that shows Web Matrix for the Bakery website example. Clear All is selected on the toolbar.](analyze-requests-to-your-website/_static/image23.png)](analyze-requests-to-your-website/_static/image21.png) -9. When you re-run the page, the resolved error will no longer appear in the results list. diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image1.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image1.png deleted file mode 100644 index 2d76c0717..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image10.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image10.png deleted file mode 100644 index 9731e30c2..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image10.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image11.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image11.png deleted file mode 100644 index 9731e30c2..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image11.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image12.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image12.png deleted file mode 100644 index 9731e30c2..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image12.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image13.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image13.png deleted file mode 100644 index c5e837999..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image13.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image14.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image14.png deleted file mode 100644 index c5e837999..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image14.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image15.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image15.png deleted file mode 100644 index c5e837999..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image15.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image16.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image16.png deleted file mode 100644 index c5e837999..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image16.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image17.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image17.png deleted file mode 100644 index 7cb74b0ef..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image17.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image18.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image18.png deleted file mode 100644 index 7cb74b0ef..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image18.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image19.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image19.png deleted file mode 100644 index 7cb74b0ef..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image19.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image2.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image2.png deleted file mode 100644 index 2d76c0717..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image20.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image20.png deleted file mode 100644 index 7cb74b0ef..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image20.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image21.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image21.png deleted file mode 100644 index 416d5eb8f..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image21.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image22.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image22.png deleted file mode 100644 index 416d5eb8f..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image22.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image23.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image23.png deleted file mode 100644 index 416d5eb8f..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image23.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image24.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image24.png deleted file mode 100644 index 416d5eb8f..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image24.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image3.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image3.png deleted file mode 100644 index 2d76c0717..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image3.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image4.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image4.png deleted file mode 100644 index 2d76c0717..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image4.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image5.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image5.png deleted file mode 100644 index d7b873eec..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image5.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image6.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image6.png deleted file mode 100644 index d7b873eec..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image6.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image7.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image7.png deleted file mode 100644 index d7b873eec..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image7.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image8.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image8.png deleted file mode 100644 index d7b873eec..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image8.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image9.png b/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image9.png deleted file mode 100644 index 9731e30c2..000000000 Binary files a/iis/develop/using-webmatrix/analyze-requests-to-your-website/_static/image9.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application.md b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application.md deleted file mode 100644 index d2dbeb19c..000000000 --- a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "Create a Website from a Gallery Application" -author: rmcmurray -description: "Microsoft has created a new authoring tool for the web named 'WebMatrix,' which is focused on c..." -ms.date: 07/06/2010 -ms.assetid: 125b64c2-ea67-415e-8745-d48e0ad3a363 -msc.legacyurl: /learn/develop/using-webmatrix/create-a-website-from-a-gallery-application -msc.type: authoredcontent -ROBOTS: NOINDEX,NOFOLLOW ---- -# Create a Website from a Gallery Application - -by [Robert McMurray](https://github.com/rmcmurray) - -[!include[outdatedContent](../../includes/outdatedContentWarning.md)] - -Microsoft has created a new authoring tool for the web named "WebMatrix," which is focused on creating websites the way that you want to create them. You can create websites from scratch or a template, or you can use one of several popular open source applications. WebMatrix Beta lets you download an application from an application gallery, customize it for your needs, analyze it for broken links, optimize it for the web, and deploy it to your hosting provider. (And if you don't have a hosting provider, WebMatrix Beta can help you find one!) - -From your first look at WebMatrix Beta you will see how different it really is. With WebMatrix Beta you can manage all your website's content, databases, and Search Engine Optimization (SEO) reports from a single, user-friendly interface. It doesn't matter if you're using ASP.NET, PHP, or HTML - WebMatrix Beta has your developer needs covered. - -## Installing WebMatrix Beta - -To install WebMatrix Beta, you can use Microsoft's Web Platform Installer (WebPI 3.0 Beta), which is a free application that makes it easy to install and configure web-related technologies. You can install the Web Platform Installer from the [WebMatrix Beta download page](https://go.microsoft.com/fwlink/?LinkId=195938). - -Run the Web Platform Installer, select **Getting Started**, click **Install WebMatrix**, and you're ready to go! - -[![](create-a-website-from-a-gallery-application/_static/image4.png)](create-a-website-from-a-gallery-application/_static/image2.png) - -## Creating a New Website Using an Open Source Application from the Gallery - -WebMatrix Beta is fully integrated with Microsoft's [Web Application Gallery](https://www.microsoft.com/web/gallery/), and since WebMatrix Beta takes care of all the setup work and application dependencies, all you need to do is to pick your application, customize it for your needs, and publish it to your web server. WebMatrix Beta even helps you select an Internet hosting company to fit your needs. For example, if you want to create a new website all you need to do is open WebMatrix Beta and launch the **Site from Web Gallery** wizard. - -[![](create-a-website-from-a-gallery-application/_static/image8.png)](create-a-website-from-a-gallery-application/_static/image6.png) - -You can select from a large number of popular, free, and open source applications. For example, just click **WordPress**, and then click **OK**. It's that easy. - -[![](create-a-website-from-a-gallery-application/_static/image12.png)](create-a-website-from-a-gallery-application/_static/image10.png) - -WebMatrix Beta may ask you for some additional configuration information during the installation process for an open source application, but once you have entered any required information, WebMatrix Beta will take care of everything and open your website when the installation is complete. - -That's all it takes to install an application; no pain, no mess, no worries - WebMatrix Beta takes care of everything for you. - -Now you can easily run your website. Simply click on Run in the WebMatrix Beta toolbar and choose one of the browsers you may have installed on your machine. You can also use F12! You can move on to customize your application, test it, optimize it for SEO, and publish it to an Internet hosting provider. - -## Getting to Know WebMatrix Beta - -Now that you've installed a web application and created a website, let's take a quick tour of the WebMatrix Beta interface. In the lower-left part of the page you see that you can select one of four workspaces. When you open WebMatrix Beta and select a site, you start off in the Site workspace, which lets you perform tasks like specifying site settings (for example, designating a default web page) and monitoring HTTP requests. - -[![](create-a-website-from-a-gallery-application/_static/image16.png)](create-a-website-from-a-gallery-application/_static/image14.png) - -To review, create, delete, and update files such as web pages, select the **Files** workspace. The site's folder structure appears in the left pane, and when you select a file, you can edit it in the content pane on the right. To add a database to your site and then add tables and data to it, or simply to open a database, such as SQL Server Compact, SQL Express, or MySQL that you might have created when you selected a web application from the gallery, select the **Databases** workspace. You get a list of databases in the left pane, and the content pane changes depending on what you want to do with a selected database. - -Finally, to get information about how to help your site rank high in search engine results, select the **Reports** workspace. Once you've run some reports, you'll see them listed on the left, and when you select one, you'll see the report's contents on the right. - -You might have noticed that across the top of the page is a **Quick Access Toolbar** and a ribbon, like in Microsoft Office 2010. Some of the buttons on the ribbon's **Home** tab are different in each workspace, but the **Site** group remains the same. - -[![](create-a-website-from-a-gallery-application/_static/image20.png)](create-a-website-from-a-gallery-application/_static/image18.png) - -You use **My Sites** to choose a site to work on, **Publish** to make the site publicly available, **Run** to test the site in a browser, and **Start/Stop/Restart** to work with the web server that you'll use in WebMatrix Beta to test your website (IIS Express). You'll learn more about IIS Express in a minute. - -## Customizing an Application Using WebMatrix Beta - -Once you've installed an application and created a website, you may be wondering, "How do I customize it?" This is a logical question, and there's nothing to worry about when you're using WebMatrix Beta, because WebMatrix Beta makes it easy to modify your web content. - -By now you should have downloaded and installed a WordPress application. However, if you restart WebMatrix Beta, you can easily click **My Sites** in the **Home** tab to select a website from the list of sites that you have created. For example, if you used WebMatrix Beta to create a website that was based on WordPress, you would see that site listed in the WebMatrix Beta **Choose a Site** dialog box. - -[![](create-a-website-from-a-gallery-application/_static/image24.png)](create-a-website-from-a-gallery-application/_static/image22.png) - -Once your website opens in WebMatrix Beta, you can view the files in your site and open pages for editing. For example, you could modify the *Header.php* file in a WordPress theme to change how your page headers will appear when your website is published. Another common file that you might edit is the 404.php file that users will get if they navigate to a link that does not exist - you can edit it to give them a friendly message or a redirect to a page that does work. - -[![](create-a-website-from-a-gallery-application/_static/image28.png)](create-a-website-from-a-gallery-application/_static/image26.png) - -## Previewing Your Website from WebMatrix Beta - -One of the great features of WebMatrix Beta is IIS Express, which is a full-featured web server that lets you test your website on your local computer before you post it to an Internet hosting company. When you are editing a web page, you can preview your changes in any web browser that is installed on your computer by clicking **Run** on the WebMatrix Beta toolbar. Notice how all the browsers you have installed on your computer are displayed, you can even launch them, all at once. This will start the Web server (IIS Express) and will browse directly to the page that you are modifying so you can view how your changes will appear on the Internet. - -[![](create-a-website-from-a-gallery-application/_static/image32.png)](create-a-website-from-a-gallery-application/_static/image30.png) - -## Managing Your Data - -WebMatrix Beta comes with a handy database manager, so you can control your website's data using the same user interface that you are using to manage your site's web content. You can create a new database, add and edit tables (using Microsoft SQL Server Compact that comes with WebMatrix Beta), and you can additionally create tables, views, and stored procedures in SQL Server or MySQL (as easily as if you were using an application like Microsoft Access). To access your website's data, all you need to do is select the **Databases** workspace in WebMatrix Beta and connect to your data; all your tables, views, and stored procedures will be available for editing. - -[![](create-a-website-from-a-gallery-application/_static/image36.png)](create-a-website-from-a-gallery-application/_static/image34.png) - -## Testing Your Website - -WebMatrix Beta includes IIS Express, which works much like IIS, the commercial web server from Microsoft. However, IIS Express is integrated with WebMatrix Beta and runs on your local computer, which makes it easy to test your site without having to copy your files to a public server and test them there. - -Sometimes you need to do more than just see how pages look in a browser in order to test a site. You might want to know what's going on behind the scenes when a request comes in to your site. For example, are there broken links in your pages? The **Requests** tool in the **Site** workspace lets you know where there might be problems in your site, and it can take you directly to the file to make a fix. - -[![](create-a-website-from-a-gallery-application/_static/image40.png)](create-a-website-from-a-gallery-application/_static/image38.png) - -This example shows that a 404 error code was issued because your site does not have a Favorites icon. This is the icon that shows up in the browser's URL address bar, or in the Favorites list. It's not necessary to have one, but this gives you a good example of what you might see. To see details about the error, you can click the line with the 404. WebMatrix Beta then shows you details about the error, the name of the page that contains the broken link, and links to resources for more information. - -[![](create-a-website-from-a-gallery-application/_static/image44.png)](create-a-website-from-a-gallery-application/_static/image42.png) - -## Optimizing Your Website - -Once you've created your website, you may be wondering how your site will appear to search engines like Google, Bing, and Yahoo. WebMatrix Beta has your answer - a built-in Search Engine Optimization (SEO) feature. To analyze your website, all you need to do is click the **Reports** workspace in WebMatrix Beta, click **New**, and then click **OK**. - -[![](create-a-website-from-a-gallery-application/_static/image48.png)](create-a-website-from-a-gallery-application/_static/image46.png) - -Once WebMatrix Beta has analyzed your website, WebMatrix Beta will display a list of any SEO violations that it finds, along with individual details and recommendations about how to fix each violation. You can easily navigate to each issue and fix it - all from within WebMatrix Beta. - -[![](create-a-website-from-a-gallery-application/_static/image52.png)](create-a-website-from-a-gallery-application/_static/image50.png) - -## Publishing Your Website - -After you've finished creating and modifying your website, it's time to publish your site to an Internet hosting company. If you don't have an Internet hosting company, WebMatrix Beta conveniently provides a list for you to choose from. Simply click on the **Publish** button in the WebMatrix Beta toolbar, select **Find Web Hosting**, and you'll be able to select from a list of offers. - -And after you've selected a hosting company, WebMatrix Beta takes care of all the publishing details for you. - -[![](create-a-website-from-a-gallery-application/_static/image55.png)](create-a-website-from-a-gallery-application/_static/image54.png) - -To actually publish your site, WebMatrix Beta has built-in support for FTP, FTPS, and Microsoft Web Deploy, which is a one-click publishing solution. Once you've established an account with an Internet hosting company, enter your account settings into the WebMatrix Beta tool. Then all you have to do to publish your site directly from WebMatrix Beta is click **Publish**. It's as easy as that! - -Simply select **Publish** from the WebMatrix Beta toolbar, choose **Configure**, enter your account details and your method of publishing (**FTP**, **FTPS** or **Web Deploy**). With Web Deploy you can deploy your site's content, the database and any configuration changes you require, all in one click! - -[![](create-a-website-from-a-gallery-application/_static/image60.png)](create-a-website-from-a-gallery-application/_static/image58.png) - -Once you have entered all your publishing information, WebMatrix will show you a preview of all the actions that will occur when the site is published. - -[![](create-a-website-from-a-gallery-application/_static/image64.png)](create-a-website-from-a-gallery-application/_static/image62.png) - -After WebMatrix has finished publishing, you can browse to your website to verify that publishing was successful. - -[![](create-a-website-from-a-gallery-application/_static/image68.png)](create-a-website-from-a-gallery-application/_static/image66.png) - -## More Information - -To learn more about WebMatrix Beta and the Microsoft Web Platform, see the following website: -[https://www.microsoft.com/web/webmatrix/learn.aspx](https://www.microsoft.com/web/webmatrix/learn.aspx) - -Once you go to this **Learn** page, you'll find more resources about all aspects of WebMatrix Beta. You'll be able to find help in forums, or file bugs and suggestions directly to the WebMatrix Beta product team! diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image1.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image1.png deleted file mode 100644 index fe7d0e438..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image10.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image10.png deleted file mode 100644 index 9213424ce..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image10.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image11.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image11.png deleted file mode 100644 index 9213424ce..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image11.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image12.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image12.png deleted file mode 100644 index 9213424ce..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image12.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image13.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image13.png deleted file mode 100644 index 9213424ce..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image13.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image14.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image14.png deleted file mode 100644 index c1440d11b..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image14.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image15.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image15.png deleted file mode 100644 index c1440d11b..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image15.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image16.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image16.png deleted file mode 100644 index c1440d11b..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image16.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image17.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image17.png deleted file mode 100644 index c1440d11b..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image17.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image18.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image18.png deleted file mode 100644 index 8fba07557..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image18.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image19.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image19.png deleted file mode 100644 index 8fba07557..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image19.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image2.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image2.png deleted file mode 100644 index cae64aba4..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image20.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image20.png deleted file mode 100644 index 8fba07557..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image20.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image21.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image21.png deleted file mode 100644 index 8fba07557..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image21.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image22.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image22.png deleted file mode 100644 index 73d5070b3..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image22.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image23.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image23.png deleted file mode 100644 index 73d5070b3..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image23.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image24.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image24.png deleted file mode 100644 index 73d5070b3..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image24.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image25.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image25.png deleted file mode 100644 index 73d5070b3..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image25.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image26.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image26.png deleted file mode 100644 index 7bcc72100..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image26.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image27.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image27.png deleted file mode 100644 index 7bcc72100..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image27.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image28.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image28.png deleted file mode 100644 index 7bcc72100..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image28.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image29.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image29.png deleted file mode 100644 index 7bcc72100..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image29.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image3.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image3.png deleted file mode 100644 index cae64aba4..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image3.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image30.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image30.png deleted file mode 100644 index 1be95598f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image30.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image31.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image31.png deleted file mode 100644 index 1be95598f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image31.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image32.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image32.png deleted file mode 100644 index 1be95598f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image32.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image33.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image33.png deleted file mode 100644 index 1be95598f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image33.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image34.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image34.png deleted file mode 100644 index 030afa89f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image34.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image35.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image35.png deleted file mode 100644 index 030afa89f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image35.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image36.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image36.png deleted file mode 100644 index 030afa89f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image36.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image37.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image37.png deleted file mode 100644 index 030afa89f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image37.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image38.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image38.png deleted file mode 100644 index 5c791687d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image38.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image39.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image39.png deleted file mode 100644 index 5c791687d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image39.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image4.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image4.png deleted file mode 100644 index cae64aba4..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image4.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image40.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image40.png deleted file mode 100644 index 5c791687d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image40.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image41.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image41.png deleted file mode 100644 index 5c791687d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image41.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image42.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image42.png deleted file mode 100644 index 8a8825c2e..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image42.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image43.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image43.png deleted file mode 100644 index 8a8825c2e..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image43.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image44.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image44.png deleted file mode 100644 index 8a8825c2e..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image44.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image45.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image45.png deleted file mode 100644 index 8a8825c2e..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image45.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image46.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image46.png deleted file mode 100644 index b468a558f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image46.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image47.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image47.png deleted file mode 100644 index b468a558f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image47.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image48.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image48.png deleted file mode 100644 index b468a558f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image48.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image49.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image49.png deleted file mode 100644 index b468a558f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image49.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image5.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image5.png deleted file mode 100644 index cae64aba4..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image5.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image50.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image50.png deleted file mode 100644 index a207ff3ab..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image50.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image51.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image51.png deleted file mode 100644 index a207ff3ab..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image51.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image52.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image52.png deleted file mode 100644 index a207ff3ab..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image52.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image53.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image53.png deleted file mode 100644 index a207ff3ab..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image53.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image54.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image54.png deleted file mode 100644 index fe7d0e438..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image54.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image55.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image55.png deleted file mode 100644 index fe7d0e438..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image55.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image56.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image56.png deleted file mode 100644 index 9b283223d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image56.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image57.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image57.png deleted file mode 100644 index 9b283223d..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image57.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image58.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image58.png deleted file mode 100644 index 41877bf72..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image58.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image59.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image59.png deleted file mode 100644 index 41877bf72..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image59.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image6.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image6.png deleted file mode 100644 index d50c27b7f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image6.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image60.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image60.png deleted file mode 100644 index 41877bf72..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image60.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image61.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image61.png deleted file mode 100644 index 41877bf72..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image61.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image62.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image62.png deleted file mode 100644 index b51f6df96..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image62.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image63.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image63.png deleted file mode 100644 index b51f6df96..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image63.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image64.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image64.png deleted file mode 100644 index b51f6df96..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image64.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image65.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image65.png deleted file mode 100644 index b51f6df96..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image65.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image66.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image66.png deleted file mode 100644 index 143d2431a..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image66.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image67.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image67.png deleted file mode 100644 index 143d2431a..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image67.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image68.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image68.png deleted file mode 100644 index 143d2431a..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image68.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image69.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image69.png deleted file mode 100644 index 143d2431a..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image69.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image7.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image7.png deleted file mode 100644 index d50c27b7f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image7.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image8.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image8.png deleted file mode 100644 index d50c27b7f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image8.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image9.png b/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image9.png deleted file mode 100644 index d50c27b7f..000000000 Binary files a/iis/develop/using-webmatrix/create-a-website-from-a-gallery-application/_static/image9.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning.md b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning.md deleted file mode 100644 index 995054274..000000000 --- a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: "Creating a Content Feed for Learning" -author: simtan -description: "If you are a content/documentation provider that writes articles or creates video to help others learn web development, you can have your learning content sy..." -ms.date: 05/20/2011 -ms.assetid: e464de27-0e44-46f7-b928-6e07e0cf7a6c -msc.legacyurl: /learn/develop/using-webmatrix/creating-a-content-feed-for-learning -msc.type: authoredcontent ---- -# Creating a Content Feed for Learning - -by [Simon Tan](https://github.com/simtan) - -## Creating a Content Feed for Learning - -If you are a content/documentation provider that writes articles or creates video to help others learn web development, you can have your learning content syndicated inside the WebMatrix environment! Your content can be presented to users at opportune moments in the WebMatrix experience - for example, articles about databases can be shown right when WebMatrix users are working in the Databases workspace, or videos about JavaScript can be suggested as users are working in JavaScript files. - -In order to take advantage of this integration, you will need to create a specially formatted [Atom](http://tools.ietf.org/html/rfc4287 "Atom") feed which tells WebMatrix what content you want to make available, and at what times (conditions) you want to make it available. You can put this file online and WebMatrix will query it and cache it, much like how RSS clients handle RSS feeds. - -In this article, we will describe the integration experience through conditions in the app, how to create the feed in the right format, and how to add it to WebMatrix. - -### Learning Triggers - -WebMatrix has a selection of interesting states, or **triggers**, that it captures events for. When these occur, WebMatrix looks at the set of feeds it is currently indexing and opens a **learning panel** on the side of the application if there are any relevant entries in the feed for that event: - -[![Screenshot that shows the Web Matrix application. Utils dot j s tab is highlighted as well as the Java Script File.](creating-a-content-feed-for-learning/_static/image2.png)](creating-a-content-feed-for-learning/_static/image1.png) - -So when the user is performing some action in the IDE, relevant content can be presented to them at that opportune time - likely when they would find it most useful. A trigger fires by matching a defined "Condition" that is specific to that event - for example, a user entering the Database workspace might trigger the condition named "DatabaseWorkspace". - -The result is that any content marked with that condition name (i.e. "DatabaseWorkspace") in your feed will be shown at that time. - -Conditions may also have **parameters** - for example, an application ID from the Web Application Gallery or a NuGet package name might be necessary to narrow down the scope of what the user would need content for. The currently available conditions (and their respective identifiers and parameters if any) in WebMatrix include: - -| User Action | Condition Name | Parameters | -| --- | --- | --- | -| Being in the Site workspace with an Application Gallery app or template | KnownAppInSiteWorkSpace | appId (string identifier for the site/template from the WebPI feed) | -| Being in the Site workspace while working from scratch | UnknownAppInSiteWorkSpace | N/A | -| Focusing on a CSS File | CssFile | N/A | -| Focusing on a JScript File | JavaScriptFile | N/A | -| Focusing on a CSHTML File | CshtmlFile | N/A | -| Focusing on a VBHTML File | VbhtmlFile | N/A | -| Focusing on a PHP File | PhpFile | N/A | -| Focusing on an HTML File | HtmlFile | N/A | -| Entering Files workspace | EditorWorkspace | N/A | -| Entering Reports workspace (SEO) | ReportsWorkspace | N/A | -| Entering Databases workspace | DatabaseWorkspace | N/A | -| Opening Site Settings Page | SettingsPage | N/A | -| Opening Requests Page | RequestPage | N/A | -| Opening a database table | DatabaseTable | N/A | -| Opening a Report | Report | N/A | -| Installing a NuGet package | NuGet | packageID | - -(This list is subject to change after WebMatrix 2 Beta.) - -More triggers may be added in future versions of WebMatrix, or via WebMatrix extensions that users can install. - -### Feed Structure - -Your feed just needs to be in the Atom format with an additional custom namespace that adds a place for trigger definitions and [OPML style](http://www.opml.org/ "OPML") outlining capabilities: - -[!code-xml[Main](creating-a-content-feed-for-learning/samples/sample1.xml)] - -The custom namespace allows you to create two new kinds of tags in each Atom `` block - **ConditionRef** tags that are used to identify which trigger the content should launch on and **Outline** tags that are used to lay out a hierarchy of content (if necessary). - -Average entries in the feed will just be single links, so they will not need Outline nodes. They might look something like this: - -[!code-html[Main](creating-a-content-feed-for-learning/samples/sample2.html)] - -The `` and `<link>` elements are used to render the link in the sidebar. The `<d:DynamicHelp>` block contains one `<d:ConditionRef>` element that points to a specific trigger ("KnownAppInSiteWorkspace" above) and passes in the required parameter of "appId" so the content will only be shown with that application. - -The `<id>` element must be a unique identifier for this `<entry>` node - these are used to determine which articles are "new" to the user and notifications will be presented to them accordingly. One simple way to ensure they are unique is to use the URL for the content as the ID string. - -Things can be more complex when you'd like to lay out a detailed hierarchy (e.g. for courses or series) or include many links for one particular trigger - that is where the `<d:Outline>` nodes come in. - -Here is an example where there are three consecutive parts of a series, represented using the `<d:Outline>` nodes: - -[!code-html[Main](creating-a-content-feed-for-learning/samples/sample3.html)] - -Just like in OPML, each <d:Outline> node can have the following attributes in addition to the required ***text*** attribute: - -| Attribute | Details | -| --- | --- | -| type | *Required* for all nodes without children. Must be one of the following: - *article* - *video* - *series* Describes the kind of content this node represents. This in turn informs WebMatrix on how to label the node in the learning panel (with an icon). If this attribute is missing, the node **must** have children and this node will be interpreted as a header for those children. | -| uri | *Required* for all nodes without children. Must be a full URL, including a valid protocol. In the case of *article* or *video* types, this should be the URL to a web page containing the content. In the case of *series* types, this should be a URL to a page that describes the series more in-depth (like the website hosting the series). If this attribute is missing, the node **must** have children and this node will be interpreted as a header for those children. | - -### Sample Files - -This downloadable package includes: - -- An example of an full feed file that has multiple kinds of nodes and hierarchy, and exercises many kinds of triggers -- A trigger definitions file which specifies all the available "ConditionRef" identifiers -- An XSD schema file for the feed - this can be used for validation purposes - -Download the samples here: [DynamicHelpSamples.zip](creating-a-content-feed-for-learning/_static/creating-a-content-feed-for-learning-1032-dynamichelpsamples1.zip) - -### Adding a feed to WebMatrix - -Users can add additional feeds to WebMatrix wherever they find them on the web, just by adding URLs to valid feeds using the WebMatrix interface. So you can create separate feeds for different purposes and provide links to them for your visitors - they can then add the feeds to WebMatrix in order to stay aware of your latest content while working on their websites. - -### Questions? - -Please feel free to send questions to the author of this article, or post on the official [WebMatrix forums](https://forums.iis.net/1166.aspx). diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/creating-a-content-feed-for-learning-1032-dynamichelpsamples1.zip b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/creating-a-content-feed-for-learning-1032-dynamichelpsamples1.zip deleted file mode 100644 index db145b6c2..000000000 Binary files a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/creating-a-content-feed-for-learning-1032-dynamichelpsamples1.zip and /dev/null differ diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image1.png b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image1.png deleted file mode 100644 index 1e28e4990..000000000 Binary files a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image2.png b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image2.png deleted file mode 100644 index 1e28e4990..000000000 Binary files a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample1.xml b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample1.xml deleted file mode 100644 index 68304d2ea..000000000 --- a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample1.xml +++ /dev/null @@ -1 +0,0 @@ -<feed xmlns='http://www.w3.org/2005/Atom' xmlns:d='http://schemas.microsoft.com/2011/webmatrix/dynamichelp'> \ No newline at end of file diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample2.html b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample2.html deleted file mode 100644 index 81195c5ae..000000000 --- a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample2.html +++ /dev/null @@ -1,8 +0,0 @@ -<entry> - <title>Your First Website Using WebMatrix - - http://www.microsoft.com/web/post/your-first-website-using-webmatrix - - - - \ No newline at end of file diff --git a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample3.html b/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample3.html deleted file mode 100644 index 25a3033ef..000000000 --- a/iis/develop/using-webmatrix/creating-a-content-feed-for-learning/samples/sample3.html +++ /dev/null @@ -1,11 +0,0 @@ - - Introduction to JavaScript - - http://www.microsoft.com/web/post/introduction-to-javascript-part-1-of-3 - - - - - - - \ No newline at end of file diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application.md b/iis/develop/using-webmatrix/download-and-install-a-php-application.md deleted file mode 100644 index 234e81ef2..000000000 --- a/iis/develop/using-webmatrix/download-and-install-a-php-application.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: "Download and Install a PHP Application" -author: rmcmurray -description: "[This is preliminary documentation and is subject to change.] Overview This walkthrough shows the steps to download and install a PHP application using WebMa..." -ms.date: 07/06/2010 -ms.assetid: ef5fdfeb-875d-4989-bcc7-865718894540 -msc.legacyurl: /learn/develop/using-webmatrix/download-and-install-a-php-application -msc.type: authoredcontent ---- -# Download and Install a PHP Application - -by [Robert McMurray](https://github.com/rmcmurray) - -[This is preliminary documentation and is subject to change.] - -## Overview - -This walkthrough shows the steps to download and install a PHP application using WebMatrix Beta, and includes an example that uses the WordPress application. - -### Prerequisites - -The following items are required to complete the procedures in this walkthrough: - -- You must be using a computer with one of the following operating systems installed: - - - Windows 7, Windows Vista, or Windows XP SP2 or a later version of Windows XP. - - Windows Server 2008 or Windows Server 2008 R2. - - Windows Server 2003 SP1 or later. -- You must have WebMatrix Beta installed. For information about how to install WebMatrix Beta, see [Microsoft Web Platform Installer 3.0](https://go.microsoft.com/fwlink/?LinkID=145510). - -## Downloading and Installing WordPress - -To install WordPress using WebMatrix Beta, open WebMatrix. Then on the WebMatrix Beta **Quick Start** page, click **Site from Web Gallery**. - -![Screenshot of the WebMatrix Beta quick start page.](download-and-install-a-php-application/_static/image1.png) - -When the **Site from Web Gallery** wizard opens, you will see a wide selection of applications to choose from. Click **WordPress**, and then click **Next**. - -![Screenshot showing the Site from Web Gallery wizard page.](download-and-install-a-php-application/_static/image5.png) - -You need a MySQL database service to run WordPress. If MySQL is not installed on your local computer, you'll be prompted to install it. If you would like to use a local installation of MySQL on your computer, choose **Yes, install it on my machine** and then click **Next**. To use a remote instance of MySQL server, choose **No, use a remote server**. - -![Screenshot showing the database information page.](download-and-install-a-php-application/_static/image9.png) - -If you are prompted to enter the root password for the MySQL database engine, you will need to enter a password and then click **Next**. - -> [!NOTE] -> The root account is used for administering an instance of the MySQL database engine. - -![Screenshot of the page for entering the database administrator password.](download-and-install-a-php-application/_static/image13.png) - -On the **Accept EULA** page, read the terms, and if you accept them, click **I Accept**. - -![Screenshot of the Accept EULA page. I Accept is selected.](download-and-install-a-php-application/_static/image17.png) - -On the next page, WebMatrix will keep you informed of the download status. - -![Screenshot showing the installation status page.](download-and-install-a-php-application/_static/image21.png) - -When you are prompted, enter the following information: - -- Enter the name of your MySQL database server. You can use "localhost" if you are using your local computer, or you can enter the name of a remote MySQL server. -- Enter the name of the database for your WordPress application. You can choose any name for your database, but you might want to try something as simple as "wordpress" if you are creating your first WordPress site on your local computer. -- Enter a database user name and password for the database that you are creating. This is not the root password that you entered earlier when you installed MySQL; the WordPress application will use this account to access the information for the database that WebMatrix will create for your WordPress application. -- Enter the administrator name and password for your database server. If you install MySQL on your local computer, you'll need to specify the MySQL root user name and password that you entered. - -Once you have entered all of the required information, click **Next**. - -![Screenshot of the application parameters page. Create a new database is selected.](download-and-install-a-php-application/_static/image25.png) - -On the next page, WebMatrix keeps you informed of the installation status. - -![Screenshot showing the status of downloading and installing WordPress.](download-and-install-a-php-application/_static/image29.png) - -When the installation has completed, WebMatrix lists everything that was installed. Click **OK** to close the **Site from Web Gallery** wizard. - -![Screenshot showing a list of successfully installed products.](download-and-install-a-php-application/_static/image33.png) - -When the **Site from Web Gallery** wizard has closed, WebMatrix automatically opens the WordPress application. - -![Screenshot of the WordPress page showing that WordPress started successfully.](download-and-install-a-php-application/_static/image37.png) - -You can customize the WordPress application for your use, test your website locally using the IIS Express Web server that comes with WebMatrix, or publish it to a public website. diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image1.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image1.png deleted file mode 100644 index 174425708..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image10.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image10.png deleted file mode 100644 index 2f72ad29e..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image10.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image11.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image11.png deleted file mode 100644 index 2f72ad29e..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image11.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image12.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image12.png deleted file mode 100644 index 2f72ad29e..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image12.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image13.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image13.png deleted file mode 100644 index 0eec5347a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image13.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image14.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image14.png deleted file mode 100644 index 0eec5347a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image14.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image15.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image15.png deleted file mode 100644 index 0eec5347a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image15.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image16.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image16.png deleted file mode 100644 index 0eec5347a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image16.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image17.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image17.png deleted file mode 100644 index 5d8f37242..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image17.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image18.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image18.png deleted file mode 100644 index 5d8f37242..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image18.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image19.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image19.png deleted file mode 100644 index 5d8f37242..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image19.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image2.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image2.png deleted file mode 100644 index 174425708..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image20.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image20.png deleted file mode 100644 index 5d8f37242..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image20.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image21.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image21.png deleted file mode 100644 index c6be9cd94..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image21.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image22.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image22.png deleted file mode 100644 index c6be9cd94..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image22.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image23.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image23.png deleted file mode 100644 index c6be9cd94..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image23.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image24.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image24.png deleted file mode 100644 index c6be9cd94..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image24.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image25.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image25.png deleted file mode 100644 index 9213aa0ea..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image25.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image26.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image26.png deleted file mode 100644 index 9213aa0ea..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image26.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image27.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image27.png deleted file mode 100644 index 9213aa0ea..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image27.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image28.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image28.png deleted file mode 100644 index 9213aa0ea..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image28.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image29.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image29.png deleted file mode 100644 index 747dff6d7..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image29.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image3.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image3.png deleted file mode 100644 index 174425708..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image3.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image30.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image30.png deleted file mode 100644 index 747dff6d7..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image30.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image31.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image31.png deleted file mode 100644 index 747dff6d7..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image31.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image32.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image32.png deleted file mode 100644 index 747dff6d7..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image32.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image33.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image33.png deleted file mode 100644 index 0df809932..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image33.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image34.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image34.png deleted file mode 100644 index 0df809932..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image34.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image35.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image35.png deleted file mode 100644 index 0df809932..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image35.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image36.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image36.png deleted file mode 100644 index 0df809932..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image36.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image37.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image37.png deleted file mode 100644 index e0a196f3b..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image37.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image38.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image38.png deleted file mode 100644 index e0a196f3b..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image38.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image39.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image39.png deleted file mode 100644 index e0a196f3b..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image39.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image4.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image4.png deleted file mode 100644 index 174425708..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image4.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image40.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image40.png deleted file mode 100644 index e0a196f3b..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image40.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image5.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image5.png deleted file mode 100644 index 1b0f34689..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image5.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image6.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image6.png deleted file mode 100644 index 1b0f34689..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image6.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image7.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image7.png deleted file mode 100644 index 1b0f34689..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image7.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image8.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image8.png deleted file mode 100644 index 1b0f34689..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image8.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image9.png b/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image9.png deleted file mode 100644 index 2f72ad29e..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-a-php-application/_static/image9.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application.md b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application.md deleted file mode 100644 index decd59dad..000000000 --- a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: "Download and Install an ASP.NET Application" -author: rmcmurray -description: "[This is preliminary documentation and is subject to change.] Overview This walkthrough shows the steps to download and install an ASP.NET application using..." -ms.date: 07/06/2010 -ms.assetid: 75e1bb5f-1d98-430d-8462-757248c41b89 -msc.legacyurl: /learn/develop/using-webmatrix/download-and-install-an-aspnet-application -msc.type: authoredcontent ---- -# Download and Install an ASP.NET Application - -by [Robert McMurray](https://github.com/rmcmurray) - -[This is preliminary documentation and is subject to change.] - -## Overview - -This walkthrough shows the steps to download and install an ASP.NET application using WebMatrix Beta, and includes an example that uses the ScrewTurn Wiki application. - -### Prerequisites - -The following items are required to complete the procedures in this walkthrough: - -- You must be using a computer with one of the following operating systems installed: - - - Windows 7, Windows Vista, or Windows XP SP2 or a later version of Windows XP. - - Windows Server 2008 or Windows Server 2008 R2. - - Windows Server 2003 SP1 or later. -- You must have WebMatrix Beta installed. For information about how to install WebMatrix Beta, see [Microsoft Web Platform Installer 3.0](https://go.microsoft.com/fwlink/?LinkID=145510). - -## Downloading and Installing ScrewTurn Wiki - -To install ScrewTurn Wiki using WebMatrix Beta, first open WebMatrix. Then on the WebMatrix Beta **Quick Start** page, click **Site from Web Gallery**. - -![Screenshot of the navigation icons on the Web Matrix Quick Start page.](download-and-install-an-aspnet-application/_static/image2.png) - -When the **Site from Web Gallery** wizard opens, click **ScrewTurn Wiki**, and then click **Next**. - -![Screenshot of the Web Gallery Wizard with Screw Turn Wiki 3 dot 0 selected.](download-and-install-an-aspnet-application/_static/image6.png) - -WebMatrix uses a SQL Server database as part of ScrewTurn Wiki. If SQL Server is not installed on your local computer, you'll be prompted to install SQL Server Express. If you would like to use a local installation of SQL Server, choose **Yes, install it on my machine**, and then click **Next**. To use a remote installation of SQL Server, choose **No, use a remote server**. - -![Screenshot before installing S Q L Server on a local computer.](download-and-install-an-aspnet-application/_static/image10.png) - -If you are prompted to enter the SQL Server administrator password, enter a password and then click **Next**. - -> [!NOTE] -> The SQL Server administrator account is used for administering the SQL Server database. - -![Screenshot of setting the authentication mode to Mixed Mode and specifying the administrator password.](download-and-install-an-aspnet-application/_static/image14.png) - -On the **Accept EULA** page, click **I Accept**. - -![Screenshot before accepting the E U L A from each third-party application involved.](download-and-install-an-aspnet-application/_static/image18.png) - -On the next page, WebMatrix keeps you informed of the download and installation status. - -![Screenshot of the in-progress download and installation screen.](download-and-install-an-aspnet-application/_static/image22.png) - -When you are prompted, enter the following information: - -- Enter the instance name of your copy of SQL Server. For example, if you are using SQL Server Express on your local computer, you can use the name ".\SQLEXPRESS". -- Enter a database name for your ScrewTurn Wiki application. You can choose any name for your database, such as "ScrewTurnWiki" if you are creating your first ScrewTurn Wiki site on your local computer. -- Enter the database administrator name and password – the SQL Server administrator account and password for your instance of SQL - Server. -- Scroll down to enter a user name and password for the Wiki database that you are creating. This is not the administrator password - for SQL Server; it's the account for the database that WebMatrix will create for the ScrewTurn Wiki application. - -Once you have entered all of the required information, click **Next**. - -![Screenshot of the top of the form before creating a new database with the specified Application parameters.](download-and-install-an-aspnet-application/_static/image26.png) - -![Screenshot of the bottom of the form before creating a new database with the specified Application parameters.](download-and-install-an-aspnet-application/_static/image30.png) - -On the next page, WebMatrix will keep you informed of the installation status. - -![Screenshot of the in-progress download and installation for the new database.](download-and-install-an-aspnet-application/_static/image32.png) - -After the installation has completed, WebMatrix lists everything that was installed. Click **OK** to close the **Site from Web Gallery** wizard. - -![Screenshot of the confirmation page after successfully downloading Screw Turn Wiki and creating a new database.](download-and-install-an-aspnet-application/_static/image36.png) - -After the **Site from Web Gallery** wizard has closed, WebMatrix automatically opens your ScrewTurn Wiki application. - -![Screenshot of the new Screw Turn Wiki application page.](download-and-install-an-aspnet-application/_static/image40.png) - -You can customize the ScrewTurn Wiki application for your use, test your website locally using the IIS Express Web server that comes with WebMatrix Beta, or publish it to a public website. diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image1.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image1.png deleted file mode 100644 index 86b1df150..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image10.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image10.png deleted file mode 100644 index b538d1be5..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image10.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image11.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image11.png deleted file mode 100644 index b538d1be5..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image11.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image12.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image12.png deleted file mode 100644 index b538d1be5..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image12.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image13.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image13.png deleted file mode 100644 index b538d1be5..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image13.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image14.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image14.png deleted file mode 100644 index 9dc062388..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image14.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image15.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image15.png deleted file mode 100644 index 9dc062388..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image15.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image16.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image16.png deleted file mode 100644 index 9dc062388..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image16.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image17.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image17.png deleted file mode 100644 index 9dc062388..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image17.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image18.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image18.png deleted file mode 100644 index 1f7680dc4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image18.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image19.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image19.png deleted file mode 100644 index 1f7680dc4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image19.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image2.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image2.png deleted file mode 100644 index 241941c51..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image20.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image20.png deleted file mode 100644 index 1f7680dc4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image20.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image21.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image21.png deleted file mode 100644 index 1f7680dc4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image21.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image22.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image22.png deleted file mode 100644 index 2227ce99a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image22.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image23.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image23.png deleted file mode 100644 index 2227ce99a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image23.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image24.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image24.png deleted file mode 100644 index 2227ce99a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image24.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image25.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image25.png deleted file mode 100644 index 2227ce99a..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image25.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image26.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image26.png deleted file mode 100644 index 61d79b3f0..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image26.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image27.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image27.png deleted file mode 100644 index 61d79b3f0..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image27.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image28.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image28.png deleted file mode 100644 index 61d79b3f0..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image28.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image29.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image29.png deleted file mode 100644 index 61d79b3f0..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image29.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image3.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image3.png deleted file mode 100644 index 241941c51..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image3.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image30.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image30.png deleted file mode 100644 index 86b1df150..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image30.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image31.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image31.png deleted file mode 100644 index 86b1df150..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image31.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image32.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image32.png deleted file mode 100644 index cda993ec4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image32.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image33.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image33.png deleted file mode 100644 index cda993ec4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image33.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image34.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image34.png deleted file mode 100644 index cda993ec4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image34.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image35.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image35.png deleted file mode 100644 index cda993ec4..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image35.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image36.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image36.png deleted file mode 100644 index b8df6f5e6..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image36.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image37.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image37.png deleted file mode 100644 index b8df6f5e6..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image37.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image38.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image38.png deleted file mode 100644 index b8df6f5e6..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image38.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image39.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image39.png deleted file mode 100644 index b8df6f5e6..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image39.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image4.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image4.png deleted file mode 100644 index 241941c51..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image4.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image40.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image40.png deleted file mode 100644 index 3b86b490c..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image40.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image41.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image41.png deleted file mode 100644 index 3b86b490c..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image41.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image42.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image42.png deleted file mode 100644 index 3b86b490c..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image42.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image43.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image43.png deleted file mode 100644 index 3b86b490c..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image43.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image5.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image5.png deleted file mode 100644 index 241941c51..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image5.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image6.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image6.png deleted file mode 100644 index 60c0db87f..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image6.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image7.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image7.png deleted file mode 100644 index 60c0db87f..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image7.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image8.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image8.png deleted file mode 100644 index 60c0db87f..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image8.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image9.png b/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image9.png deleted file mode 100644 index 60c0db87f..000000000 Binary files a/iis/develop/using-webmatrix/download-and-install-an-aspnet-application/_static/image9.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly.md b/iis/develop/using-webmatrix/make-your-website-seo-friendly.md deleted file mode 100644 index d51e9279d..000000000 --- a/iis/develop/using-webmatrix/make-your-website-seo-friendly.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: "Make your Website SEO Friendly" -author: rick-anderson -description: "[This is preliminary documentation and is subject to change.] After you've created a website, you can use WebMatrix Beta to run an analysis to see how visibl..." -ms.date: 07/06/2010 -ms.assetid: 1c4ecbca-dba5-47c2-a3bd-c9f59e5c4f58 -msc.legacyurl: /learn/develop/using-webmatrix/make-your-website-seo-friendly -msc.type: authoredcontent ---- -# Make your Website SEO Friendly - -by Tim Ammann - -[This is preliminary documentation and is subject to change.] - -After you've created a website, you can use WebMatrix Beta to run an analysis to see how visible its pages will be to search engines like Bing, Google, and Yahoo. You can do this with the WebMatrix **Reports** feature, which can perform a Search Engine Optimization (SEO) analysis on your website and suggest how to fix the violations that it finds. WebMatrix Beta does this by crawling your locally hosted website just like a search engine would, and then reporting any issues it comes across. - -To get started, open an existing website in WebMatrix. Then click **Run a report** or **Reports**. - -[![Screenshot shows the WebMatrix window, displaying MyNewSite, with Reports selected and the Run a report link highlighted.](make-your-website-seo-friendly/_static/image3.png)](make-your-website-seo-friendly/_static/image1.png) - -Next, click **Run an SEO Report for your site**, or click **New** on the **Home** tab. - -[![Screenshot shows the WebMatrix page with the Run an S E O Report for your site link.](make-your-website-seo-friendly/_static/image7.png)](make-your-website-seo-friendly/_static/image5.png) - -This displays the **New Report** dialog box. - -[![Screenshot shows the New Report dialog box with a Name and Start U R L entered.](make-your-website-seo-friendly/_static/image11.png)](make-your-website-seo-friendly/_static/image9.png) - -Type a name that you want for the report, and the full URL of the website page that the analysis should start from. Alternatively, you can accept the default, which is the start page (default document) for your website as it is hosted locally by WebMatrix. - -Clicking **Advanced Settings** will show you more options you can set for the analysis, including the maximum number of URLs to crawl (the default is 20,000) and the maximum page size to download (100 KB). These options are important if you have a website with a large number of pages, or if your website has very large pages. Since the sample website in this how-to is small, you can just accept the defaults for now. - -Click **OK**, and WebMatrix Beta will begin the analysis, crawling your website just like a search engine would and recording the violations it finds. - -When the analysis is finished, SEO violations appear grouped by URL in the report. This sample website has only one page, so only one URL appears in the list. - -[![Screenshot shows the WebMatrix page with results for U R Ls displayed.](make-your-website-seo-friendly/_static/image15.png)](make-your-website-seo-friendly/_static/image13.png) - -Here you can see that the home page has three SEO violations, or errors. Click to expand the URL entry to find out what the violations are. - -[![Screenshot shows three U R L violations for the single page.](make-your-website-seo-friendly/_static/image19.png)](make-your-website-seo-friendly/_static/image17.png) - -Click a particular violation to see more information about it. In this example, all three will be checked to show both the details for each, and recommendations for how to fix each one. - -[![Screenshot shows three U R L violations for the single page with one violation selected and details about it displayed.](make-your-website-seo-friendly/_static/image23.png)](make-your-website-seo-friendly/_static/image21.png) - -This first violation says that the page has too many <h1> elements. The **Violation Details** section tells you that search engines prefer that there be only one <h1> tag per page. The **Recommendations** section tells you that you can correct this by changing the other headings to <h2> or <h3>. If you like, you can get more detailed information about each violation by clicking **View More Details**, which will bring up a **Details** dialog box for the URL. - -You can also click **Edit this page**, which will take you directly into the editor so that you can fix the violation. Because the website in this example has only one page and only a small number of violations, the editing step will be saved for last so that all of the violations can be fixed at once. - -On to the next violation. - -[![Screenshot shows the second of the violations selected with details about it displayed.](make-your-website-seo-friendly/_static/image27.png)](make-your-website-seo-friendly/_static/image25.png) - -The page has no information inside the <title> element. Search engines depend on the title to get information about web pages, so it should be filled in. Remember that search engines place more importance on the first words in a title, so you want to be sure to put the most important words in the title first. - -[![Screenshot shows the final violation selected with details about it displayed.](make-your-website-seo-friendly/_static/image31.png)](make-your-website-seo-friendly/_static/image29.png) - -This page lacks a description, which search engines use when they index a page and create a content summary for it. The **Recommendations** section lets you know that you need to add a <meta> tag to the page in the form of <meta name="description" content="description\_text">. - -To fix these violations, click **Edit this page** on the bottom right. This takes you directly to the right page in the editor so that you can fix the violation in your page's HTML: - -[![Screenshot shows a tab open for an h t m l page where you can edit to fix problems.](make-your-website-seo-friendly/_static/image35.png)](make-your-website-seo-friendly/_static/image33.png) - -After typing in a title, changing the headings, and adding a description, save your changes by clicking the **Save** icon in the quick access toolbar. Your violations should be resolved. - -[![Screenshot shows the h t m l for the page with issues addressed and the save icon highlighted.](make-your-website-seo-friendly/_static/image39.png)](make-your-website-seo-friendly/_static/image37.png) - -Click **Reports** again, select the latest report under the site, and click **Re-run** to confirm that the violations have been corrected. - -[![Screenshot shows the Re-run button where you can run the report again.](make-your-website-seo-friendly/_static/image43.png)](make-your-website-seo-friendly/_static/image41.png) - -The report now shows no violations, so the fixes were successful! - -[![Screenshot shows the new results now that the violations have been addressed.](make-your-website-seo-friendly/_static/image47.png)](make-your-website-seo-friendly/_static/image45.png) - -### Deleting Reports - -After you've fixed violations, you may no longer need or want the reports you used to find the violations. To delete a report, select the report in the navigation pane, and then click **Delete** on the **Home** tab. - -### Analyzing Other Web Pages - -If you want to run an analysis on a website other than the one that you currently have open, select **Other Sites** in the navigation pane, and then click **New** on the **Home** tab. This will reveal the **New Report** dialog box. - -Just like you did before, type a title for the report and the URL of the website page that the analysis should start from. If you choose to analyze a large commercial website, the analysis might take a few minutes to complete. - -### Using the Bing Webmaster Tools - -To improve your site's SEO, you can use the Bing webmaster tools. The Bing webmaster tools help you to submit your sites to Bing, find out which pages of your site have been indexed, and perform many other SEO-related tasks. - -For more information, see [http://www.bing.com/toolbox/webmasters/](http://www.bing.com/toolbox/webmasters/). diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image1.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image1.png deleted file mode 100644 index 6eb291b5e..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image10.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image10.png deleted file mode 100644 index 4bd981963..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image10.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image11.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image11.png deleted file mode 100644 index 4bd981963..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image11.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image12.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image12.png deleted file mode 100644 index 4bd981963..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image12.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image13.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image13.png deleted file mode 100644 index 027f9b237..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image13.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image14.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image14.png deleted file mode 100644 index 027f9b237..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image14.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image15.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image15.png deleted file mode 100644 index 027f9b237..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image15.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image16.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image16.png deleted file mode 100644 index 027f9b237..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image16.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image17.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image17.png deleted file mode 100644 index b29f68d9d..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image17.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image18.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image18.png deleted file mode 100644 index b29f68d9d..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image18.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image19.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image19.png deleted file mode 100644 index b29f68d9d..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image19.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image2.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image2.png deleted file mode 100644 index 6eb291b5e..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image20.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image20.png deleted file mode 100644 index b29f68d9d..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image20.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image21.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image21.png deleted file mode 100644 index 6c0c1722f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image21.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image22.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image22.png deleted file mode 100644 index 6c0c1722f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image22.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image23.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image23.png deleted file mode 100644 index 6c0c1722f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image23.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image24.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image24.png deleted file mode 100644 index 6c0c1722f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image24.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image25.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image25.png deleted file mode 100644 index b842d688f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image25.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image26.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image26.png deleted file mode 100644 index b842d688f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image26.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image27.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image27.png deleted file mode 100644 index b842d688f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image27.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image28.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image28.png deleted file mode 100644 index b842d688f..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image28.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image29.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image29.png deleted file mode 100644 index a0a9c9701..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image29.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image3.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image3.png deleted file mode 100644 index 6eb291b5e..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image3.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image30.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image30.png deleted file mode 100644 index a0a9c9701..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image30.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image31.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image31.png deleted file mode 100644 index a0a9c9701..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image31.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image32.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image32.png deleted file mode 100644 index a0a9c9701..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image32.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image33.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image33.png deleted file mode 100644 index f3f5a28c0..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image33.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image34.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image34.png deleted file mode 100644 index f3f5a28c0..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image34.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image35.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image35.png deleted file mode 100644 index f3f5a28c0..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image35.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image36.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image36.png deleted file mode 100644 index f3f5a28c0..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image36.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image37.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image37.png deleted file mode 100644 index a766f0e92..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image37.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image38.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image38.png deleted file mode 100644 index a766f0e92..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image38.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image39.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image39.png deleted file mode 100644 index a766f0e92..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image39.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image4.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image4.png deleted file mode 100644 index 6eb291b5e..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image4.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image40.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image40.png deleted file mode 100644 index a766f0e92..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image40.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image41.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image41.png deleted file mode 100644 index 2eae690bd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image41.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image42.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image42.png deleted file mode 100644 index 2eae690bd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image42.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image43.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image43.png deleted file mode 100644 index 2eae690bd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image43.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image44.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image44.png deleted file mode 100644 index 2eae690bd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image44.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image45.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image45.png deleted file mode 100644 index b08f6a2fd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image45.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image46.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image46.png deleted file mode 100644 index b08f6a2fd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image46.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image47.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image47.png deleted file mode 100644 index b08f6a2fd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image47.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image48.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image48.png deleted file mode 100644 index b08f6a2fd..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image48.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image5.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image5.png deleted file mode 100644 index 147ffe3a2..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image5.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image6.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image6.png deleted file mode 100644 index 147ffe3a2..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image6.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image7.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image7.png deleted file mode 100644 index 147ffe3a2..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image7.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image8.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image8.png deleted file mode 100644 index 147ffe3a2..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image8.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image9.png b/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image9.png deleted file mode 100644 index 4bd981963..000000000 Binary files a/iis/develop/using-webmatrix/make-your-website-seo-friendly/_static/image9.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website.md b/iis/develop/using-webmatrix/publish-your-website.md deleted file mode 100644 index bd6a53d66..000000000 --- a/iis/develop/using-webmatrix/publish-your-website.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: "Publish Your Website" -author: tdykstra -description: "[This is preliminary documentation and is subject to change.] Introduction After you create a website, you typically publish the site to a web hosting provid..." -ms.date: 07/06/2010 -ms.assetid: df929744-8274-406a-b8c7-7073c211369f -msc.legacyurl: /learn/develop/using-webmatrix/publish-your-website -msc.type: authoredcontent ---- -# Publish Your Website - -by [Tom Dykstra](https://github.com/tdykstra) - -[This is preliminary documentation and is subject to change.] - -## Introduction - -After you create a website, you typically publish the site to a web hosting provider where others can use it. Publishing a website involves the following tasks: - -- Setting up an account with a web hosting provider. -- Configuring WebMatrix Beta for publishing. This includes entering settings for your web hosting account and deciding how to publish the database (if your site has one). -- Clicking the **Publish** button. WebMatrix Beta shows you the changes it plans to make on the remote server, you approve the changes, and then it publishes the site. - -WebMatrix publishes the website by copying files to a remote server, and it can optionally deploy one or more databases to the hosting site. - -## Hosting Providers - -When you publish your website, you copy files from your computer to a web server that's maintained by a hosting company. There are dozens of hosting companies, each offering hosting plans that have different features and pricing. - -WebMatrix Beta lets you select a hosting provider right in the tool. These hosting providers all support the Web Deploy process that automates most of the publishing process. However, you don't have to use one of these hosting companies. If you select a different company, you can still publish from within WebMatrix, but you might need to transfer files using FTP, which is a slightly more manual process. FTP also lets you publish SQL Server Compact databases, but not databases that use SQL Server or SQL Server Express. - -Among the publishing options is SSL, which stands for *secure sockets layer*. (SSL is what you're using if you access a Web site using `https://` instead of `http://`.) SSL encrypts the information going between the browser and server, and is a good idea for pages that involve private information like passwords and credit-card numbers. Setting up SSL requires extra steps like purchasing and configuring a certificate that's used for encryption. We don't cover those steps here, so we also won't provide any information about how to configure SSL during publishing. - -## Databases - -If you're using SQL Server Compact as your database, the data is stored in an .sdf file. When you publish the database, WebMatrix copies not only the .sdf file but also the database program itself to the web server. This ensures that the published site will work even if SQL Server Compact isn't already installed on the web server. - -If you're using a SQL Server or MySQL database, WebMatrix publishes the database by creating scripts that run in a database that has been created for you by your hosting provider. These scripts create database tables and insert data into them in order to replicate the structure and data that you have in the database on your computer. - -If you're using a SQL Server Compact database and want to publish to a SQL Server database, you must migrate the data to SQL Server before publishing. For instructions, see [How to Migrate a Database to SQL Server](https://go.microsoft.com/fwlink/?LinkId=195270). You might want to do this to take advantage of SQL Server features such as stored procedures and its additional capabilities, such as handling more than 256 concurrent connections or creating databases larger than 4 gigabytes. - -## Setting Up a Web Hosting Account - -To set up web hosting, you must find a web hosting provider and set up an account. - -1. In the **Home** tab, click the arrow below **Publish**, and then click **Find Web Hosting**. - ![Screenshot showing the Find Web Hosting option selected.](publish-your-website/_static/image1.jpg) - The **Find Web Hosting** web page lists hosting providers. - ![Screenshot of a browser window showing the find web hosting page.](publish-your-website/_static/image1.png) -2. Select one of the hosting providers and click **Learn More**. -3. Follow the directions provided by the hosting provider's site to set up a new account. - - Support for a SQL Server database might be an option that costs extra. If you plan to publish a SQL Server Compact database (.sdf file), you don't need this option. - -After your account is set up, the hosting provider typically sends you an email message that contains information you'll need in order to publish your website. For example: - -- *Server*: webmatrix01.contoso.com -- *User Name*: user123 -- *Password*: *password* -- *Site Name*: user123.webmatrix01.contoso.com -- *Destination URL:* http://user123.webmatrix01.contoso.com - -If your hosting account includes a SQL Server database, you'll also get information that you will need to publish your database, which will typically look like this: - -> **Your database connection string is**: Password=*password*;User ID=*username*;Initial Catalog=username.hostingcompany;Data Source=sql1.hostingcompany.com - -At the hosting company, your site will be associated with an *application pool* (often just called an *app pool*). The application pool specifies which version of the .NET Framework your site will run under: version 2.0 or 4. Typically, the hosting provider tells you what the default value is and how to change it. (Some providers may provide separate sites for each .NET Framework version instead.) Most of the applications that you can download from the Web Gallery require that you publish to a .NET Framework 2.0 application pool. If you create a new ASP.NET Web pages application such as those built from the Site from Template option, you must publish to a .NET Framework 4 application pool. If you publish using Web Deploy to a site at the hosting provider that has an application pool setting inappropriate for the site you are publishing, the publishing process will fail. If so, correct the application pool setting and republish. If you publish using FTP and the application pool setting is inappropriate, publishing will succeed, but your site will not work correctly. In that case, correct the application pool setting; you do not have to republish. - -Configuring WebMatrix Beta for Publishing - -1. Open the website in WebMatrix. -2. On the **Home** tab, click the arrow below **Publish**, and then click **Configure**. - - ![Screenshot showing the Configure option selected.](publish-your-website/_static/image3.jpg) - - The **Publishing Settings** dialog box is displayed. - - ![Screenshot of the Publishing Settings dialog.](publish-your-website/_static/image5.jpg) -3. If you selected a hosting provider through WebMatrix Beta, you can leave **Protocol** set to **Web Deploy**. If you're using a hosting provider that doesn't support Web Deploy, or if you want to publish using FTP instead of Web Deploy, change the **Protocol** to **FTP**. -4. If you are using Web Deploy, enter the information you received from the hosting provider in the text boxes: - - | Option | What to enter | - | --- | --- | - | Server | Enter the "Service URL" or "Server Name" provided by the hosting company, like this: server1.lucernepublishing.com If the Service URL includes the prefix "https://" and the suffix ":8172/msdeploy.axd", you can leave out the prefix and suffix. | - | User Name/Password | Enter the credentials that the hosting provider provided for your account. (If you also signed up for a database for your account, the database might have a different username and password, so be sure that you use the right ones). | - | Site Name | Enter the "Site" or "Site/Application" value from the hosting company, like this: user123.server1.lucernepublishing.com | - | Destination URL | Enter the URL that people will use to browse your site over the internet, like this: contoso.com -or- contoso.com/blog | -5. If you want to use FTP instead of Web Deploy, select **FTP**. Some of the fields you have to enter are different: - ![Screenshot of Publishing Settings with the FTP Protocol selected.](publish-your-website/_static/image7.jpg) -6. If you are using FTP: - - 1. Enter the **Server**, **User name**, **Password**, and **Destination URL** as described above for Web Deploy. - 2. In the **Site path** box, enter the value identified by the hosting company as the "Site Root," such as /wwwroot. This field is optional. -7. If you want to upload only the files that have changed locally, select **Upload locally changed files**. -8. If you don't want to enter the password every time you publish, select the **Save password** check box. -9. Click **Validate Connection** to verify that WebMatrix Beta is able to connect to the hosting provider. WebMatrix Beta displays the results to the right of the button. - ![Screenshot of the Publishing Settings with Connected successfully selected.](publish-your-website/_static/image9.jpg) - If the connection test fails, double-check that you entered the information correctly. If you did but validation continues to display an error, contact the hosting provider for help. -10. If your website uses a full SQL Server or SQL Server Express database (that is, not a SQL Server Compact database), enter the connection string that was sent to you by the hosting provider. - If the SQL Server database doesn't appear in the dialog box, make sure it has a connection string in the Web.config file. For more information, see *About Connection Strings* later in this document. -11. If a SQL Server Compact database does not appear in this dialog box, make sure that the .sdf file is in the App\_Data folder. - -## Publishing - -You can now start the publishing process. Before WebMatrix Beta makes any changes at the hosting company's web server, it tells you what it plans to do. You can then review the plan and modify it if necessary. Then, when you're ready, you tell WebMatrix Beta to go ahead and publish. - -1. In the **Publishing Settings** dialog box, click **Publish**. The **Publish Preview** dialog box appears. - ![Screenshot showing the Publish Preview dialog.](publish-your-website/_static/image11.jpg) -2. Review the list of files and databases and make changes if necessary. For example, you might want to clear check boxes under **Changed Files** to exclude some files. Or, if this is the first time you're publishing the site, you might want to select check boxes under **Databases** to publish databases. (Check boxes are selected by default in the **Files** section and cleared by default in the **Databases** section.) - - > [!IMPORTANT] - > If you're publishing a database and the database already exists in at the hosting provider's site, whatever is in that database will be overwritten. -3. Click **Continue**. - - WebMatrix Beta publishes the website, showing status messages in the navigation bar at the bottom of the screen. The publishing process is done in the background, which means you can continue to work in WebMatrix Beta while it is publishing. - - ![Screenshot showing the Web Matrix demo screen. ](publish-your-website/_static/image13.jpg) - - You can click **More Details** in the notification bar to see a detailed log of the publishing activity. - - ![Screenshot showing the Deployment Details dialog.](publish-your-website/_static/image15.jpg) - - To verify that publishing was successful, browse to the site. - - If you published a database, make sure you try any pages that display data from the database. - - > [!NOTE] - > If your site has a Web.config file, the copy on the hosting provider's web server might look slightly different. For example, if you published a SQL Server database, it will have the hosting provider's connection string value so that the published site will use the database at the hosting provider. - -## About Connection Strings - -If you're using a SQL Server (not SQL Server Compact) database, your site has to have a Web.config file with a connection string that tells the site how to connect to the database. To set up publishing, you enter the connection string for the destination database in the **Publishing Settings** dialog box. When you publish to a hosting company, the company provides you this string. If you want to publish to another server on your own network, you have to create the string yourself. (And in that case you also have to know the site and application name as they appear in **IIS Manager**, and enter this as the **Site Name** in the **Publishing Settings** dialog box.) - -The following example shows a connection string in a Web.config file for a SQL Server Express database named CohoWinery.mdf. The .mdf file is located in the App\_Data folder. - -[!code-xml[Main](publish-your-website/samples/sample1.xml)] - -The following example shows a connection string for a full SQL Server database named CohoWinery that is on a server named "Server01", using integrated Windows authentication. The connection string for the database named SmallBakery shows how to use SQL Server authentication (that is, how to specify a user name and password). - -[!code-xml[Main](publish-your-website/samples/sample2.xml)] diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image1.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image1.jpg deleted file mode 100644 index e8425153a..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image1.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image1.png b/iis/develop/using-webmatrix/publish-your-website/_static/image1.png deleted file mode 100644 index fe7d0e438..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image1.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image10.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image10.jpg deleted file mode 100644 index 5a0b23003..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image10.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image11.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image11.jpg deleted file mode 100644 index b0628ec5b..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image11.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image12.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image12.jpg deleted file mode 100644 index b0628ec5b..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image12.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image13.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image13.jpg deleted file mode 100644 index 88c44c88a..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image13.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image14.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image14.jpg deleted file mode 100644 index 88c44c88a..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image14.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image15.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image15.jpg deleted file mode 100644 index 33fd4c63e..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image15.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image16.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image16.jpg deleted file mode 100644 index 33fd4c63e..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image16.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image2.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image2.jpg deleted file mode 100644 index f938a7609..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image2.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image2.png b/iis/develop/using-webmatrix/publish-your-website/_static/image2.png deleted file mode 100644 index fe7d0e438..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image2.png and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image3.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image3.jpg deleted file mode 100644 index 940511dad..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image3.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image4.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image4.jpg deleted file mode 100644 index 940511dad..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image4.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image5.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image5.jpg deleted file mode 100644 index 3bf7e53c7..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image5.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image6.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image6.jpg deleted file mode 100644 index 3bf7e53c7..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image6.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image7.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image7.jpg deleted file mode 100644 index 35e4d6e0b..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image7.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image8.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image8.jpg deleted file mode 100644 index 35e4d6e0b..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image8.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/_static/image9.jpg b/iis/develop/using-webmatrix/publish-your-website/_static/image9.jpg deleted file mode 100644 index 5a0b23003..000000000 Binary files a/iis/develop/using-webmatrix/publish-your-website/_static/image9.jpg and /dev/null differ diff --git a/iis/develop/using-webmatrix/publish-your-website/samples/sample1.xml b/iis/develop/using-webmatrix/publish-your-website/samples/sample1.xml deleted file mode 100644 index 3f0980b43..000000000 --- a/iis/develop/using-webmatrix/publish-your-website/samples/sample1.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/develop/using-webmatrix/publish-your-website/samples/sample2.xml b/iis/develop/using-webmatrix/publish-your-website/samples/sample2.xml deleted file mode 100644 index 6730f57c8..000000000 --- a/iis/develop/using-webmatrix/publish-your-website/samples/sample2.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/iis/develop/using-webmatrix/webmatrix-overview.md b/iis/develop/using-webmatrix/webmatrix-overview.md deleted file mode 100644 index d15b9b92e..000000000 --- a/iis/develop/using-webmatrix/webmatrix-overview.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: "WebMatrix Overview" -author: rick-anderson -description: "WebMatrix allows you to build websites using gorgeous, built-in templates or popular open source applications that run on many devices, and publish them to t..." -ms.date: 07/06/2010 -ms.assetid: 95204e87-ab20-4e4d-9072-3e9b3fd3d32c -msc.legacyurl: /learn/develop/using-webmatrix/webmatrix-overview -msc.type: authoredcontent ---- -# WebMatrix Overview - -by IIS Team - -WebMatrix allows you to build websites using gorgeous, built-in templates or popular open source applications that run on many devices, and publish them to the cloud in minutes. - -For information about getting started with WebMatrix, see the following topics: - -- [What is WebMatrix](https://go.microsoft.com/fwlink/?LinkID=195076) -- [Top 10 WebMatrix Features](https://go.microsoft.com/fwlink/?LinkID=195935) -- [Install WebMatrix with the Web Platform Installer](https://go.microsoft.com/fwlink/?LinkId=195938) -- [Start from scratch, or with a Web Application](https://go.microsoft.com/fwlink/?LinkID=196364) - -You can also refer to documentation for [getting started with WebMatrix and ASP.NET Web Pages](https://go.microsoft.com/fwlink/?LinkID=195072). - -For questions about specific gallery applications in WebMatrix, refer to the [Application Gallery FAQ](https://www.microsoft.com/web/webmatrix/). diff --git a/iis/develop/using-webmatrix/webmatrix-privacy-statement.md b/iis/develop/using-webmatrix/webmatrix-privacy-statement.md deleted file mode 100644 index 640a54aa8..000000000 --- a/iis/develop/using-webmatrix/webmatrix-privacy-statement.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: "WebMatrix Privacy Statement" -author: bilalaslam -description: "Microsoft is committed to protecting your privacy, while delivering software that brings you the performance, power, and convenience you desire in your perso..." -ms.date: 04/08/2011 -ms.assetid: 70f095ff-6766-4535-885a-0aca7f2a7fbb -msc.legacyurl: /learn/develop/using-webmatrix/webmatrix-privacy-statement -msc.type: authoredcontent ---- -# WebMatrix Privacy Statement - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Microsoft WebMatrix 2.0 Privacy Statement - -Last updated: April, 2011 Microsoft is committed to protecting your privacy, while delivering software that brings you the performance, power, and convenience you desire in your personal computing. This privacy statement explains many of the data collection and use practices of Microsoft WebMatrix 2.0 ("WebMatrix"). It focuses on features that communicate with the Internet. It does not apply to other online or offline Microsoft sites, products, or services. - -WebMatrix provides web development tooling functionality that includes everything you need for website development. Start from open source web applications, built-in web templates or just start writing code yourself. It's all-inclusive, simple and best of all free. Developing websites has never been easier. - -### Collection and Use of Your Information - -The information we collect from you will be used by Microsoft and its controlled subsidiaries and affiliates to enable the features you are using and provide the service(s) or carry out the transaction(s) you have requested or authorized. It may also be used to analyze and improve Microsoft products and services.In order to offer you a more consistent and personalized experience in your interactions with Microsoft, information collected through one Microsoft service may be combined with information obtained through other Microsoft services. We may also supplement the information we collect with information obtained from other companies. For example, we may use services from other companies that enable us to derive a general geographic area based on your IP address in order to customize certain services to your geographic area.Except as described in this statement, personal information you provide will not be transferred to third parties without your consent. We occasionally hire other companies to provide limited services on our behalf, such as packaging, sending and delivering purchases and other mailings, answering customer questions about products or services, processing event registration, or performing statistical analysis of our services. We will only provide those companies the personal information they need to deliver the service, and they are prohibited from using that information for any other purpose. Microsoft may access or disclose information about you, including the content of your communications, in order to: (a) comply with the law or respond to lawful requests or legal process; (b) protect the rights or property of Microsoft or our customers, including the enforcement of our agreements or policies governing your use of the services; or (c) act on a good faith belief that such access or disclosure is necessary to protect the personal safety of Microsoft employees, customers, or the public. We may also disclose personal information as part of a corporate transaction such as a merger or sale of assets.Information that is collected by or sent to Microsoft by WebMatrix may be stored and processed in the United States or any other country in which Microsoft or its affiliates, subsidiaries, or service providers maintain facilities. Microsoft abides by the safe harbor framework as set forth by the U.S. Department of Commerce regarding the collection, use, and retention of data from the European Union, the European Economic Area, and Switzerland. - -### Collection and Use of Information about Your Computer - -When you use software with Internet-enabled features, information about your computer ("standard computer information") is sent to the Web sites you visit and online services you use. Microsoft uses standard computer information to provide you Internet-enabled services, to help improve our products and services, and for statistical analysis. Standard computer information typically includes information such as your IP address, operating system version, browser version, and regional and language settings. In some cases, standard computer information may also include hardware ID, which indicates the device manufacturer, device name, and version. If a particular feature or service sends information to Microsoft, standard computer information will be sent as well. The privacy details for each WebMatrix feature, software or service listed in this privacy statement describe what additional information is collected and how it is used. - -### Security of your information - -Microsoft is committed to helping protect the security of your information. We use a variety of security technologies and procedures to help protect your information from unauthorized access, use, or disclosure. For example, we store the information you provide on computer systems with limited access, which are located in controlled facilities. - -### Changes to this privacy statement - -We will occasionally update this privacy statement to reflect changes in our products, services, and customer feedback. When we post changes, we will revise the "last updated" date at the top of this statement. If there are material changes to this statement or in how Microsoft will use your personal information, we will notify you either by posting a notice of such changes prior to implementing the change or by directly sending you a notification. We encourage you to periodically review this statement to be informed of how Microsoft is protecting your information. - -### For More Information - -Microsoft welcomes your comments regarding this privacy statement. If you have questions about this statement or believe that we have not adhered to it, please contact us at cypressp@microsoft.com. Bilal Aslam, Building 42, 1 Microsoft Way, Redmond, WA 98052 - -## Specific features - -The remainder of this document will address the following specific features: - -**Customer Experience Improvement Program** - -**What This Feature Does:** The Customer Experience Improvement Program ("CEIP") collects basic information about your hardware configuration and how you use our software and services in order to identify trends and usage patterns. CEIP also collects the type and number of errors you encounter, software and hardware performance, and the speed of services. We will not collect your name, address, or other contact information. - -**Information Collected, Processed, or Transmitted:** For more information about the information collected, processed, or transmitted by CEIP, see the CEIP privacy statement at [https://go.microsoft.com/fwlink/?LinkID=52097](https://go.microsoft.com/fwlink/?LinkID=52097). - -**Use of Information:** We use this information to improve the quality, reliability, and performance of Microsoft software and services. - -**Choice/Control:** You are offered the opportunity to participate in CEIP after installation. If you choose to participate and later change your mind, you can turn off CEIP at any time by: Start WebMatrix. Click Options. Click Customer Feedback. Choose the "I do not wish to participate…" radio button - -*Web Applications Feed* - -**What This Feature Does:** - -The "Site from Web Gallery" and "Site from Template" features of WebMatrix uses the Microsoft Web Platform Installer (WebPI), if it is on your computer, to download an XML feed of web applications which you can install on your computer. - -**Information Collected, Processed, or Transmitted:** - -Microsoft does not transmit or store any personally identifiable information through this feature. - -**Use of Information:** - -WebMatrix downloads the latest feed of web applications that you can install on your computer. diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq.yml b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq.yml deleted file mode 100644 index e60fd8e32..000000000 --- a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq.yml +++ /dev/null @@ -1,82 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Azure App Gallery FAQ" - author: SunBuild - description: "With just a few mouse clicks the Windows Web Application Gallery lets you select, download and install popular web applications like blogs, content managemen..." - ms.date: 06/14/2012 - ms.assetid: a4555019-dd6e-41b4-831c-1711760031f5 - msc.legacyurl: /learn/develop/windows-web-application-gallery/azure-app-gallery-faq - msc.type: authoredcontent - ms.topic: faq -title: Azure App Gallery FAQ -summary: | - by [Sunitha Muthukrishna](https://github.com/SunBuild) - - > [!NOTE] - > The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - - -sections: - - name: Ignored - questions: - - question: | - Introduction - answer: | - With just a few mouse clicks the Windows Web Application Gallery lets you select, download and install popular web applications like blogs, content management systems, wikis or media galleries onto Azure. The following FAQ describes additional information that you may need when you are configuring several popular applications on Azure. - - - question: | - DotNetNuke Community and Professional Editions: - answer: | - The database information must be re-entered to complete installation of DotNetNuke. You can view this information in the dashboard of your newly created site on the right side. - - [![image2](azure-app-gallery-faq/_static/image2.png)](azure-app-gallery-faq/_static/image1.png) - - Once you have the database information, in the Database configuration step of DotNetNuke install wizard enter this database information as seen below - - [![image4](azure-app-gallery-faq/_static/image4.png)](azure-app-gallery-faq/_static/image3.png) - - - question: | - Acquia Drupal and Drupal Commerce: - answer: | - Once either of these apps are deployed; the app runtime installer needs to run. Please click on the "Setup" icon to continue the installation. - - [![image6](azure-app-gallery-faq/_static/image6.png)](azure-app-gallery-faq/_static/image5.png) - - If "Setup" is not clicked and you browse the site you may see this error. This occurs since the app is not configured yet. To resolve this append install.php to the URL and run this script; for example [http://mysitename.azurewebsites.net/install.php](http://mysitename.azurewebsites.net/install.php) - - [![image8](azure-app-gallery-faq/_static/image8.png)](azure-app-gallery-faq/_static/image7.png) - - - question: | - Umbraco CMS - answer: | - Click on Setup in the notification bar once Umbraco is successfully deployed to configure your Umbraco site. - - [![image10](azure-app-gallery-faq/_static/image10.png)](azure-app-gallery-faq/_static/image9.png) - - Umbraco install wizard will request you to re-enter the database information. You can view this information in the dashboard of your newly created site on the right side - - [![image12](azure-app-gallery-faq/_static/image12.png)](azure-app-gallery-faq/_static/image11.png) - - Once you have the database information, re-enter this is the Umbraco install wizard - - [![image14](azure-app-gallery-faq/_static/image14.png)](azure-app-gallery-faq/_static/image13.png) - - - question: | - Kentico CMS - answer: | - The database information must be re-entered to complete installation of Kentico CMS. You can view this information in the dashboard of your newly created site on the right side. - - [![image16](azure-app-gallery-faq/_static/image16.png)](azure-app-gallery-faq/_static/image15.png) - - When you browse the app, Kentico CMS installation wizard request the database server name and database user information to be entered. Please refer to the connection string for this information. - - [![image18](azure-app-gallery-faq/_static/image18.png)](azure-app-gallery-faq/_static/image17.png) - - Now select "Existing database" and enter the database name from the connection string. - - [![image20](azure-app-gallery-faq/_static/image20.png)](azure-app-gallery-faq/_static/image19.png) - - Finally, a license needs to be created for the app as seen here. Continue with the wizard to complete the app installation. - - [![image22](azure-app-gallery-faq/_static/image22.png)](azure-app-gallery-faq/_static/image21.png) - diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image1.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image1.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image1.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image10.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image10.png deleted file mode 100644 index cfd1ae847..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image10.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image11.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image11.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image11.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image12.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image12.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image12.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image13.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image13.png deleted file mode 100644 index 5a42bba2d..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image13.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image14.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image14.png deleted file mode 100644 index 5a42bba2d..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image14.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image15.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image15.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image15.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image16.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image16.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image16.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image17.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image17.png deleted file mode 100644 index 28d50334d..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image17.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image18.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image18.png deleted file mode 100644 index 28d50334d..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image18.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image19.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image19.png deleted file mode 100644 index 9213859be..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image19.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image2.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image2.png deleted file mode 100644 index 426159737..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image2.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image20.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image20.png deleted file mode 100644 index 9213859be..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image20.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image21.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image21.png deleted file mode 100644 index c1bded035..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image21.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image22.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image22.png deleted file mode 100644 index c1bded035..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image22.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image3.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image3.png deleted file mode 100644 index d8fe829c7..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image3.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image4.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image4.png deleted file mode 100644 index d8fe829c7..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image4.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image5.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image5.png deleted file mode 100644 index cfd1ae847..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image5.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image6.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image6.png deleted file mode 100644 index cfd1ae847..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image6.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image7.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image7.png deleted file mode 100644 index dd96bbe26..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image7.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image8.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image8.png deleted file mode 100644 index dd96bbe26..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image8.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image9.png b/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image9.png deleted file mode 100644 index cfd1ae847..000000000 Binary files a/iis/develop/windows-web-application-gallery/azure-app-gallery-faq/_static/image9.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files.md b/iis/develop/windows-web-application-gallery/blogengine-net-sample-files.md deleted file mode 100644 index f8f95bdd1..000000000 --- a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "Blogengine .NET Sample files" -author: rick-anderson -description: "This is a set of sample files you could use with Blogengine .NET and the Web Deployment tool for deploying it on IIS. The manifest.xml and parameters.xml her..." -ms.date: 07/09/2009 -ms.assetid: 1f41da75-1fde-433e-af1e-d29f8b187478 -msc.legacyurl: /learn/develop/windows-web-application-gallery/blogengine-net-sample-files -msc.type: authoredcontent ---- -# Blogengine .NET Sample files - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with Blogengine .NET and the Web Deployment tool for deploying it on IIS. The `manifest.xml` and `parameters.xml` here are used to set the appropriate permissions and deploy the files to a web server . This application uses a file data store within App\_Data directory and hence requires that this directory have ReadAndExecute,Write,Delete permissions . - -The files are annotated with comments that explain specific lines in the files you'll need to customize for your configuration. - -## Sample manifest.xml file - -[!code-xml[Main](blogengine-net-sample-files/samples/sample1.xml)] - -## Sample parameters.xml - -[!code-xml[Main](blogengine-net-sample-files/samples/sample2.xml)] diff --git a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample1.xml deleted file mode 100644 index 5b876d239..000000000 --- a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample1.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample2.xml b/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample2.xml deleted file mode 100644 index 458ceb6df..000000000 --- a/iis/develop/windows-web-application-gallery/blogengine-net-sample-files/samples/sample2.xml +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md deleted file mode 100644 index 536159b48..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "Database Notes for packaging applications for the Web Application Gallery" -author: rick-anderson -description: "The database providers for the Web Deployment Tool (WebDeploy) give application developers a great deal of flexibility in setting up databases as part of the..." -ms.date: 06/02/2009 -ms.assetid: 9e5f2ff1-7a54-45f0-8197-7dd783154e41 -msc.legacyurl: /learn/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery -msc.type: authoredcontent ---- -# Database Notes for packaging applications for the Web Application Gallery - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -The database providers for the Web Deployment Tool (WebDeploy) give application developers a great deal of flexibility in setting up databases as part of their application installs. Outside of the Gallery, applications have a variety of methods for setting up databases, tables, users, and starting data: - -- Some applications can do everything necessary, as long as the user can provide administrative credentials during the application setup. These applications usually have the flexibility to work with any database components that have already been configured, and can work without administrative credentials in those cases. -- Some applications expect the database and the database user to be created before running the application for the first time. -- Some applications expect all of these steps to be done before running the application for the first time. -- Some applications will use any combination of the above. - -The WebDeploy database providers give the application developer the ability to perform whatever database functions are required prior to the application's first run. There are three WebDeploy components involved in specifying database installation directives. - -1. The provider directive in the manifest.xml file. This directive tells WebDeploy which database provider to use, and what file to use for the script. -2. The connection string in the parameters.xml file. This tells Web Deploy what credentials to use, and what database and server to connect to. -3. The SQL Script. This is a standalone file that can contain any valid database commands for the specific database engine you are using. We recommend using separate script files for different SQL transactions to isolate any SQL script errors. - -A minimal provider directive identifies the provider to use and the SQL file for the provide to use : - -[!code-xml[Main](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample1.xml)] - -This example tells WebDeploy to use the MS SQL (dbfullsql) provider and to run a file called "install.sql". - -The connection string is usually put together from other parameters in the parameters.xml file. The [App Packaging Guide](package-an-application-for-the-windows-web-application-gallery.md) contains a description of the requirements for these parameters, and examples of how to use them and put them together. - -When using one of the database providers, the user will need to provide credentials for WebDeploy to use to communicate with the database. Even though these credentials are used somewhat differently for the different databases, they are all present in some form for each. These credentials consist of: - -- **Database Server** - This can be the hostname or IP address of a server, or the service name for the database server. -- **Database Name** - The name of the database on the server that the application will use -- **Database User -** This is the user that is used specifically for WebDeploy to connect to the database and, if necessary, perform database operations. -- **Database Password** - The password for the Database User. - -In addition to these credentials, applications will usually need an ID and password specific to the application. Application developers can use the WebDeploy tool to prompt the user for these credentials as well. Then the credentials can be placed in configuration files or SQL scripts to be used by the application. - -The SQL Script can be any valid SQL or commands that the database engine will accept. The contents of this file can be parameterized the same way as any other file in the package. The SQL file can also be empty if you just want to use the provider to ensure that the database already exists. Most of the current applications in the Web Application Gallery use this SQL to create a database user for the application to use. Example syntax for each engine is covered in their respective sections. - -The providers will follow these steps in communicating with a database: - -1. Connect to the database server. -2. Authenticate as the database user. -3. Check to see if the database exists, and if the user has access to it. - - - If the database does not exist, WebDeploy will attempt to create it using the provided credentials. - - If the database creation fails, then WebDeploy will exit with a message telling the user that the user does not have sufficient privileges for the required tasks. -4. Execute the contents of all the database scripts in the package. - -**Common Scenarios** - -There are a few common scenarios that users of applications in the Gallery will face. The WebDeploy database providers have been designed with the flexibility to allow an application developer to create one set of configuration entries and scripts that will work for all of these scenarios. - -**Shared hosting** - -In a shared hosting scenario, the customer rarely has direct administrative access to the database. While in many cases, the user can create databases, the function is usually performed through a control panel where the user never sees the administrative credentials. The user that gets created as part of this process usually has full administrative privileges for the specific database that was created. Packages need to be able to execute the required SQL without needing full database administrative privileges. The database is usually remote in these scenarios. - -**Dedicated Hosting** - -Dedicated hosting users will usually have full privileges for their database engine. Many of these users may not have the skills, though, to be a full DBA. These users require the flexibility to be able to use either the administrative user for WebDeploy connections, or an application database user. The database may be local or remote. - -**Dev environment** - -In a dev environment, the user can be expected to have full control over the database and operating system. Any actions required by the application can be performed from outside the setup, if necessary. However, most devs still prefer an application installation that takes care of setting up the database. - -**Installation Methods** - -WebDeploy packages which are part of the Application Gallery can be installed by one of the methods below, each of which will provide a slightly different experience for users. As you design your package, you should keep each of these methods in mind such that your package will work with any of them. - -1. Using the [Web Platform Installer (WebPI)](https://www.microsoft.com/web/downloads/platform.aspx). When a package is installed with the WebPI, the WebPI's user interface adapts to the database requirements of the package. The WebPI will look at the tags on database oriented parameters, and the providers specified in the manifest.xml file. If more than one database engine is available for the application, the WebPI will ask the user to specify which database to use. The parameter setting screen will then only show the parameters that are relevant for that database. The WebPI will ask the user if the user wants to use an existing database, or create one. The user will only be asked for database administrative credentials if they are needed to create a new database. -2. Using WebDeploy locally. You may choose to make your WebDeploy package available to users outside of the WebPI. Users could then download the package and use the IIS Manager to install the application. The WebDeploy UI will ask the user to select from multiple databases if relevant. The user will be asked to provide all parameters specified for that database, including the administrative credentials. When designing your script, you should think about how the script would run if run by a regular user instead of an administrative user. -3. Using a third-party control panel. We have provided documentation on the way we use the parameter tags to all of our partners who are working on control panels to integrate with the Gallery. How they choose to implement their user interfaces is up to their discretion, and is dependent on their existing models. In some cases, the UI will behave like either of the examples above. Control panel vendors may choose to expose or hide any portion of the parameterization they want. It is important to make sure you use the specified tags, as these control panel vendors will be looking for them to help them build their UIs. - -**SQL Specifics** - -Applications that require access to MS SQL databases can work with either SQL Server (including SQL Express) and SQL Azure (with some additional requirements).When the Web Platform Installer installs one of these applications, it will check to see if any SQL is installed on the local machine. If there is none, the WebPI will select SQL Express as one of the components to be installed. Users that want to use a remote database have the option of unselecting the SQL Express option. - -**SQL Express / SQL Azure** - -The Web Platform Installer will install current version of SQL Express 2008 when the user requests a SQL Installation, or when an application needs SQL. The WebPI will offer the user a choice of authentication modes for SQL - either Windows Native or database based. The WebPI recommends that application users choose database based authentication, as most applications prefer that method. When the user selects database authentication, the user will need to enter a password for the ‘sa' or administrative user. This password needs to meet the requirements set out in [https://msdn.microsoft.com/library/ms143705.aspx](https://msdn.microsoft.com/library/ms143705.aspx). If you use the SQL script to set a password for a database user, the same password requirements will apply. The default installation sets up the SQL Express server with the service name of .\SQLEXPRESS. - -If you want to use a remote database (SQL Server on another machine, or SQL Azure) you don't need to install SQL Express. - -In all cases, two scripts are required to perform the initial setup of the database. This script will be complementary to the parameters example shown before in the packaging and their goal is: - -1. CreateLogin.sql: Create a login in the DB (newly created if the DB didn't exist). This script requires a connection string parameter with database administrative user credentials -2. CreateUser.sql: Create a user with appropriate db roles for the application's database. This script requires a connection string parameter with database user credentials. - -Refer to this [sample](umbraco-cms-sample-files.md "Umbraco Sample") to get you started with building a package for SQL Server or SQL Azure based application. The script is designed to set all of the required privileges for most application needs for both SQL Server and SQL Azure. - -Please note that in order to work in both SQL Server and SQL Azure, these two scripts need to be divided in two different files since the connection string are different (SQL Azure does not allow the " USE database" command). For more information about LOGIN and USER creation on SQL Azure, you can refer to [this page](https://msdn.microsoft.com/library/windowsazure/ee336235.aspx). For more information about SQL Azure limitations, you can refer to [this page](https://msdn.microsoft.com/library/windowsazure/ff394102.aspx). - -**Usage:** - -***Use a script for creating a login*** - -[!code-console[Main](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample2.cmd)] - -***Use a script to create a user and add database roles*** - -[!code-sql[Main](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample3.sql)] - -**MySQL Specifics** - -The Web PI will install MySQL on your users' systems. If your application requires MySQL, the WebPI will check for the existence of MySQL on the local system. If MySQL is not found, the WebPI will install it. - -WebDeploy can work with MySQL databases in much the same way as it does with SQL. SQL scripts can contain any valid MySQL syntax. The Install.sql script below works with the parameters example in the packaging guide to create a user and set a password for the application's database. The script is designed to set all of the required privileges for most application needs. - -In a shared hosting environment, the end user will probably not have the administrative privileges required for executing the GRANT statement in the script. If the user does not have permission to execute the GRANT statement, the MySQL provider will throw an error, and the installation process will fail. We have developed the add\_user script to ignore errors caused by the end user having insufficient privileges to execute the GRANT. This way, the installation can be completed successfully in an environment where both the user and the database are created before installing the application. - -In MySQL syntax, the normal command delimiter is a semi-colon (;). MySQL procedures require a different delimiter to be used for separating statements. This is explained in the [MySQL documentation](http://dev.mysql.com/doc/refman/5.1/en/stored-programs-defining.html). To specify the delimiter for WebDeploy, you should use attributes of the **dbMySQL** provider directive in the manifest.xml file: - -[!code-xml[Main](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample4.xml)] - -The create user script we use can be parameterized as well. We do recommend parameterizing the database server for the GRANT statement in the SQL Script below in the parameters.xml file and using a place-holder to represent the Database server, for example *‘PlaceHolderForServer'* . By doing so, the user will have the option to either install the application against a local MySQL server, usually ‘*localhost'* or install the application against a remote MySQL database . - -[!code-console[Main](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample5.cmd)] - -#### Related Articles - -- [MSDeploy SQL Database Provider (dbFullSql)](https://blogs.iis.net/msdeploy/archive/2008/11/10/the-msdeploy-sql-database-provider-dbfullsql.aspx) -- [MSDeploy MySql Database Provider(dbMySql)](https://blogs.iis.net/msdeploy/archive/2009/03/30/msdeploy-sample-custom-provider-to-sync-mysql-databases-dbfullmysql.aspx) -- [SQL Azure Limitations](https://msdn.microsoft.com/library/windowsazure/ff394102.aspx) -- [Migrating to SQL Azure](https://www.linkedin.com/pulse/sql-azure-glance-part-2migrating-database-using-ssdt-amit-kumar/?lipi=urn%3Ali%3Apage%3Ad_flagship3_profile_view_base_post_details%3Be6IQDj9BRri6Ld21rxcG8A%3D%3D) -- [MySQL documentation](http://dev.mysql.com/doc/refman/5.1/en/stored-programs-defining.html) diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample1.xml b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample1.xml deleted file mode 100644 index b678dd6e6..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample1.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample2.cmd b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample2.cmd deleted file mode 100644 index 7a32c0a4e..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample2.cmd +++ /dev/null @@ -1,11 +0,0 @@ -/**********************************************************************/ -/* CreateLogin.SQL */ -/* Creates a login */ -/* This scripts runs on master to create login and requires connection string with DB admin credentials */ -/* Supports SQL Server and SQL AZURE */ -**********************************************************************/ - --- Add here a test to be sure the login does not exist --- Create login - -CREATE LOGIN PlaceHolderForUser WITH PASSWORD = 'PlaceHolderForPassword' \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample3.sql b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample3.sql deleted file mode 100644 index d35026ddd..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample3.sql +++ /dev/null @@ -1,18 +0,0 @@ -/**********************************************************************/ -/* CreateUser.SQL */ -/* Creates a user and makes the user a member of db roles */ -/* This script runs against the User database and requires connection string */ -/* Supports SQL Server and SQL AZURE */ -/**********************************************************************/ - --- Create database user and map to login --- and add user to the datareader, datawriter, ddladmin and securityadmin roles --- - -CREATE USER PlaceHolderForUser FOR LOGIN PlaceHolderForUser; -GO -EXEC sp_addrolemember 'db_ddladmin', PlaceHolderForUser; -EXEC sp_addrolemember 'db_securityadmin', PlaceHolderForUser; -EXEC sp_addrolemember 'db_datareader', PlaceHolderForUser; -EXEC sp_addrolemember 'db_datawriter', PlaceHolderForUser; -GO \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample4.xml b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample4.xml deleted file mode 100644 index d6929e602..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample4.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample5.cmd b/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample5.cmd deleted file mode 100644 index f233f4c66..000000000 --- a/iis/develop/windows-web-application-gallery/database-notes-for-packaging-applications-for-use-with-the-web-application-gallery/samples/sample5.cmd +++ /dev/null @@ -1,16 +0,0 @@ -USE PlaceHolderForDb; - -DROP PROCEDURE IF EXISTS add_user ; - -CREATE PROCEDURE add_user() -BEGIN -DECLARE EXIT HANDLER FOR 1044 BEGIN END; -DECLARE EXIT HANDLER FOR 1410 BEGIN END; -GRANT ALL PRIVILEGES ON PlaceHolderForDb.* to 'PlaceHolderForUser'@'PlaceHolderForServer' IDENTIFIED BY 'PlaceHolderForPassword'; -FLUSH PRIVILEGES; -END -// - -CALL add_user() // - -DROP PROCEDURE IF EXISTS add_user // \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/frequently-asked-questions.yml b/iis/develop/windows-web-application-gallery/frequently-asked-questions.yml deleted file mode 100644 index 4ec42ee30..000000000 --- a/iis/develop/windows-web-application-gallery/frequently-asked-questions.yml +++ /dev/null @@ -1,120 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "Windows Web App Gallery FAQ" - author: SunBuild - description: "" - ms.date: 11/18/2012 - ms.assetid: 0fda743d-d99e-4172-8e4e-ec1d448281b8 - msc.legacyurl: /learn/develop/windows-web-application-gallery/frequently-asked-questions - msc.type: authoredcontent - ms.topic: faq -title: Windows Web App Gallery FAQ -summary: | - by [Sunitha Muthukrishna](https://github.com/SunBuild) - - > [!NOTE] - > The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - - ## Frequently Asked Questions - - Here is a list of frequently asked questions designed to provide a better understanding of the Windows Web App Gallery Submission and validation processes. - - -sections: - - name: Ignored - questions: - - question: | - How do I submit my Web Application to Windows Web Application Gallery? - answer: | - You can submit your application at the following URL: - - - *Windows Web App Gallery for Developers* - - - - question: | - Is my web application qualified to be part of Windows Web Application Gallery? - answer: | - Your web application must satisfy the following principles in order to be a part of Web Application Gallery. If you have more questions, please contact [appgal@microsoft.com](mailto:appgal@microsoft.com). - - - question: | - How long does it take for the Web Application Gallery Team to validate the application? - answer: | - Once the application is submitted, it will take 3-5 business days for us to validate the application and send you the status. You can review our process at the following URL: - - - *Windows Web Application Gallery Link Addition Process Walkthrough* - [https://www.iis.net/learn/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough](windows-web-application-gallery-link-addition-process-walkthrough.md) - - - question: | - How do I build a package for Web Application Gallery? - answer: | - Please refer to these articles to build a package for Web Application Gallery: - - - *Packaging Guidelines* - [https://www.iis.net/learn/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery](package-an-application-for-the-windows-web-application-gallery.md) - - *Reference for Web Application Gallery* - [https://www.iis.net/learn/develop/windows-web-application-gallery/reference-for-the-web-application-package](reference-for-the-web-application-package.md) - - - question: | - How can I verify my web application package? - answer: | - You can verify your application package with Sniffer Installer Reporter (SIR) for Application Gallery; you can find instructions for downloading and using the SIR tool at the following URL: - - - *Sniffer.Installer.Reporter (SIR) for Application Gallery* - [https://blogs.iis.net/kateroh/archive/2010/01/25/sniffer-installer-reporter-sir-for-application-gallery.aspx](https://blogs.iis.net/kateroh/archive/2010/01/25/sniffer-installer-reporter-sir-for-application-gallery.aspx) - - Please report any issues to [appgal@microsoft.com](mailto:appgal@microsoft.com). - - - question: | - How do I submit an application to Azure App Gallery? - answer: | - If you are already a part of Windows Web Application Gallery, then please contact [appgal@microsoft.com](mailto:appgal@microsoft.com) for more information on Azure App Gallery. If you are not part of the Windows Web Application Gallery, we request you to submit your application to Windows Web Application Gallery for review. Please do send an email to [appgal@microsoft.com](mailto:appgal@microsoft.com) notifying us about your interest in the Azure App Gallery. We shall respond within 3-5 business days. - - - question: | - How do I test my application for Windows App Gallery? - answer: | - To test your article, please refer the following article: - - - *Testing a Web Application Zip Package for Inclusion with the Web Application Gallery* - [https://www.iis.net/learn/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md) - - You can use also the [Web PI command line tool](https://blogs.iis.net/satishl/archive/2011/01/26/webpi-command-line.aspx) to test the application. We recommend that you test your application with Web PI and WebMatrix for the following : - - 1. The application must install successfully onto IIS - 2. The application must install successfully onto WebMatrix (IIS Express) - 3. If you application has a database, you should be able to view the database in WebMatrix - 4. Publish your application to a remote site using WebMatrix - 5. Download your application to the local site created on WebMatrix - - - question: | - How do I build a custom feed for Web Platform Installer? - answer: | - First, please make sure you are using the latest version of Web PI. You can find a sample custom feed as a part of the following article: - - - *Testing a Web Application Zip Package for Inclusion with the Web Application Gallery* - [https://www.iis.net/learn/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md) - - You can update the custom feed sample for your applications, and make sure that the following changes have been made so that you application is shown in Web PI: - - - Update <productId> (This must be unique) - - Update <Title> - - Update <Version> - - Update the <installerURL> - - Update <SHA1> hash - - Update <fileSize> - - If your application requires uses SQL or MySQL or both, add the appropriate Keywords in <keywords>: - - - <keywordId>SQL<keywordId> - - <keywordId>MySQL>keywordId> - - If you are still seeing issues with the custom feed from loading in Web PI or are facing any other issues please email us at [appgal@microsoft.com](mailto:appgal@microsoft.com). - - - question: | - My Application is already in the Windows Web App Gallery, how do I submit an update for my application? - answer: | - If your application version is the same then update the existing submission with the following as listed below and submit it to Web App Gallery through the [submission form](https://www.microsoft.com/web/gallery/submit.aspx): - - - Include any metadata changes such as Description, Brief Description, etc., if needed - - Update the package URL - - Update the SHA1 hash - - If you application version is different than the one that is live, you should create a new submission for the Application and submit it to Web App Gallery through the submission form. Please note the process from submission to live can take 3-5 business days. diff --git a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files.md b/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files.md deleted file mode 100644 index 95fcbe4ee..000000000 --- a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: "Gallery Server Pro sample files" -author: rick-anderson -description: "This is a set of sample files you could use with Gallery Server Pro and the Web Deployment tool for deploying Gallery Server Pro on IIS. You can include a cu..." -ms.date: 07/21/2009 -ms.assetid: a0991296-04e5-4a8a-8d67-8a79d6754405 -msc.legacyurl: /learn/develop/windows-web-application-gallery/gallery-server-pro-sample-files -msc.type: authoredcontent ---- -# Gallery Server Pro sample files - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with Gallery Server Pro and the Web Deployment tool for deploying Gallery Server Pro on IIS. You can include a custom `_SqlMembership.txt` file to parameterize the Application's admin username and password that can be used by the application to setup the application administrator credentials. - -The files are annotated with comments that explain specific lines in the files you'll need to customize for your configuration. - -## Sample manifest.xml file - -[!code-xml[Main](gallery-server-pro-sample-files/samples/sample1.xml)] - -## Sample parameters.xml file - -[!code-xml[Main](gallery-server-pro-sample-files/samples/sample2.xml)] - -## Sample App\_Data\\_SqlMembership.txt file - -[!code-console[Main](gallery-server-pro-sample-files/samples/sample3.cmd)] diff --git a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample1.xml deleted file mode 100644 index 1dc125813..000000000 --- a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample1.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample2.xml b/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample2.xml deleted file mode 100644 index 14988c35a..000000000 --- a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample2.xml +++ /dev/null @@ -1,87 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample3.cmd b/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample3.cmd deleted file mode 100644 index 84309ac38..000000000 --- a/iis/develop/windows-web-application-gallery/gallery-server-pro-sample-files/samples/sample3.cmd +++ /dev/null @@ -1,2 +0,0 @@ -PlaceholderForAdminName -PlaceholderForAdminPassword \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql.md b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql.md deleted file mode 100644 index 405e4a847..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "How to Create an App Package Supporting both SQL Server and MySQL" -author: SunBuild -description: "Applications that currently support MySQL as their main DBMS can also support Microsoft SQL Server. The SQL Server Driver for PHP is available to PHP develop..." -ms.date: 02/16/2012 -ms.assetid: 76946c02-3b19-43ad-b13d-3b914ab11c54 -msc.legacyurl: /learn/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql -msc.type: authoredcontent ---- -# How to Create an App Package Supporting both SQL Server and MySQL - -by [Sunitha Muthukrishna](https://github.com/SunBuild) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -Applications that currently support MySQL as their main DBMS can also support Microsoft SQL Server. [The SQL Server Driver for PHP](/previous-versions/sql/sql-server-2005/cc296172(v=sql.90)) is available to PHP developers, it is a cost-effective and efficient solution for supporting SQL Server from within PHP applications. This article provides the steps needed for creating a Web Deployment package to install an application that supports both SQL Server and MySQL. - -## Adding MySQL and SQL Server Databases - -Add both directives dbfullsql and dbmysql to add a SQL Server database and a MySQL database within the Manifest.xml file. - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample1.xml)] - -"path" attribute is used to set the path to the Sql scripts associated with the directive. You may add multiple dbfullsql/dbmysql directives within manifest file if you wish to use more than one Sql script for given database type. - -## Adding SQL Server and MySQL parameters in Parameters.xml file - -You need to create two sets of parameters one for SQL Server database and another for MySQL if they depend on the database type. - -> [!IMPORTANT] -> All the parameter names must be unique. - -Here is an example for Database Server parameter. - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample2.xml)] - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample3.xml)] - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample4.xml)] - -Similarly you would need to create MySQL and SQL parameters each for Database username, Database user password, Database administrator, Database administrator password. - -If user's choice is MySQL database during installation, the parameter "MSSQL Database Server" will be skipped and will not be visible to the user. - -This allows you to set different default values, descriptions based on database type which makes it user-friendly. This feature also allows you to hide/show custom parameters specific to the application. - -**For example:** - -If your application uses a Database type parameter in the application configuration file, say configuration.php; then we can parameter this in the parameters.xml as follows - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample5.xml)] - -**Connection Strings** - -Two connection string parameters must be included one for SQL server database parameters and one for MySQL database parameters. - -[!code-xml[Main](how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample6.xml)] diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample1.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample1.xml deleted file mode 100644 index 2bdc903b6..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample1.xml +++ /dev/null @@ -1,2 +0,0 @@ - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample2.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample2.xml deleted file mode 100644 index 8e7c6f200..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample2.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample3.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample3.xml deleted file mode 100644 index 62e1ed615..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample3.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample4.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample4.xml deleted file mode 100644 index 7877c31be..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample4.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample5.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample5.xml deleted file mode 100644 index 1d0b13728..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample5.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample6.xml b/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample6.xml deleted file mode 100644 index 8d4499dab..000000000 --- a/iis/develop/windows-web-application-gallery/how-to-create-an-app-package-supporting-both-sql-server-and-mysql/samples/sample6.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md deleted file mode 100644 index 2b31428a4..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md +++ /dev/null @@ -1,419 +0,0 @@ ---- -title: "Integrate the Windows Web Application Gallery into a Control Panel" -author: rick-anderson -description: "The Windows ® Web Application Gallery (WAG) lets application developers reach a wide audience of users and gives Web site builders an easy way to discover an..." -ms.date: 03/18/2009 -ms.assetid: 18743857-2074-4bed-84d6-2ffab07a5ab7 -msc.legacyurl: /learn/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel -msc.type: authoredcontent ---- -# Integrate the Windows Web Application Gallery into a Control Panel - -by IIS Team - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -## Introduction - -The Windows® Web Application Gallery (WAG) lets application developers reach a wide audience of users and gives Web site builders an easy way to discover and install freely available applications on Internet Information Services (IIS). Hosters and control panel vendors can use the guidance in this article to provide their users with access to the applications in the Web Application Gallery. - -The Gallery provides a dynamic feed that keeps your control panels up to date automatically. You can integrate the Web Application Gallery into your existing control panel solution, providing users with a simple installation path for the applications available in the Gallery. - -This article describes how to integrate the Windows Web Application Gallery applications in your application. Post any questions about the Gallery or about working with the Gallery feed or the Microsoft®Web Deployment Tool (MS Deploy) API to the [Web Application Gallery: Developers & Integrators Forum](https://forums.iis.net/1158.aspx "Web Application Gallery : Developers & Integrators"). - -## Before You Begin - -To integrate the WAG into your control panel solution, you need the following: - -- **Web Application Gallery Feed.** - This is an extended ATOM XML feed that contains all the information needed to download and install the applications available in the WAG. You can use the Microsoft® Web Platform Installer API to load and manipulate the content in the feed (recommended) or manually download and parse the feed XML content. This article provides information on the feed‘s location and XML content. -- **Web Platform Installer API (WebPI API).** The [Web Platform Installer tool](https://www.microsoft.com/web/downloads/platform.aspx) uses a new API to access the feed content. This is a public API available to developers: [Microsoft Web Platform Installer](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.aspx). We highly recommend you use this API to access the feed‘s content instead of manipulating the feed XML directly. It provides: - - - Abstraction from the details of the XML elements format and semantics. - - Intuitive classes and methods. - - Access to the list of applications and their tags to aid classification. - - Easy detection of missing application dependencies. -- **Web Deployment API.** The [Web Platform Installer tool](https://www.microsoft.com/web/downloads/platform.aspx) uses a new API to manage the application packages, you can find its documentation at: [Microsoft Web Deployment](https://msdn.microsoft.com/library/microsoft.web.deployment.aspx). It is a public API available to developers. It allows your application to read and set parameter values and deploy applications including their associated database to the target servers. -- **Sample Application.** - A sample application, [Sample App](integrate-the-windows-web-application-gallery-into-a-control-panel/_static/integrate-the-windows-web-application-gallery-into-a-control-panel-607-sample1.zip), is provided. It uses the WebPI API to access and manipulate the WAG XML feed, and it uses the Web Deployment API to manage the application package, its parameters, and deployment. - -This link downloads a compressed (Zip) file. Extract the contents of the compressed file, browse to the ControlPanelAppRtwAPI folder, and copy the content into your project or site. - -Note that the Zip file is formatted as a Web Deployment Tool package; this means that you can use the MS Deploy tool or the "Import Application" functionality in IIS Manager to deploy the application into the "Default Web Site." This Zip file package format is used by all applications in the Windows Application Gallery. - -Note also that you can manipulate the feed XML directly instead of using the WebPI API; however, this is discouraged since changes to the feed file may have unexpected results in your code. - -Post any feedback or questions about the sample application to the [Web Application Gallery: Developers & Integrators Forum](https://forums.iis.net/1158.aspx "Web Application Gallery : Developers & Integrators"). - -## Set Up the Environment - -The sample application illustrates some techniques that you may want to use with your own control panel application. Note, however, that the sample application should not be deployed in a production environment. - -The sample application includes instructions for configuring your environment for its use. Those instructions should be used as your general guide for setting up the users and privileges needed for running a control-panel style application with MS Deploy. - -## Set Up the Web Management Service (WMSVC) - -Install and configure WMSVC. This service is used both to host the deployment handler that installs applications and to authorize site owners to install in their Web sites. - -1. In the **Start** menu, click **Server Manager**. -2. In the tree view on the left, select the **Roles** node. -3. Scroll down to find and select the **Web Server (IIS)** role. -4. Click **Add Role Services**, and select the **Management Service** component. -5. Once the Management Service is installed, start **IIS Manager**. -6. Select the **Server** node. -7. Scroll down and locate the **Management Service** icon, and double-click on it. -8. Select the **Enable Remote Connections** check box. -9. In the **Task** pane, click **Start** to start the service. - -## Set Up the Web Deployment Handler - -Install and configure the deployment handler. - -1. Use the [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) to download and install Web Deployment Tool 1.0. under the **What's New** tab in the **New** **Web Platform Extensions** section. -2. During installation, select either **Custom** or **Complete**. -3. If you selected Custom, be sure that you select the **Web Management Service Integration** component. -4. The deployment handler uses rules to authorize users to perform actions during installation. For example, a common action is running a database script. This action should run as the low-privileged database account that the user already has. Some actions require higher privileges than the site owner has, such as marking a folder as an application. For this task, the handler can be configured to elevate to a higher privileged account. You should create an account that has access just to perform this action. -5. Allow a user to write to **ApplicationHost.config**, the IIS configuration file, to mark folders as applications. - - - Create a custom user to mark folders as applications. - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample1.cmd)] - - Grant the user read permission to - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample2.cmd)] - - Grant the user modify permission to - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample3.cmd)] - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample4.cmd)] -6. Add a set of rules to allow customers to deploy content, applications, and databases by opening the **Administration.config** file and navigating to this section: - - [!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample5.xml)] -7. To allow site owners to create applications, set access control lists (ACLs), and deploy database data, you must add the following rules to the **Administration.config** file within the `` section. Make sure to change the `` element to contain the user credentials you created in step 5 above. Notice that you can add these rules [programmatically using MWA](../../publish/using-web-deploy/configure-the-web-deployment-handler.md). - - [!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample6.xml)] -8. In the **Administration.config** file, find the element **"<sectionGroup name="management">"** inside **"<sectionGroup name="system.webServer">"**, verify that the following element is listed in it: **"<section name="delegation" overrideModeDefault="Deny" allowDefinition="MachineToWebRoot" />"**. If not, add it. -9. Restart **WMSVC**. -10. If you are using a remote Universal Naming Convention (UNC) share for content, follow the permission specified in [Configuring Share and NTFS Permissions](../../web-hosting/configuring-servers-in-the-windows-web-platform/configuring-share-and-ntfs-permissions.md), with the following exception: for the path \\server\share$ (share), set "Domain Users" to "Full Control" instead of "Change." If you are using shared configuration, apply the update (`https://support.microsoft.com/kb/969912`) to ensure that WMSVC allows connections when Shared Configuration is enabled in Windows Server® 2008. - -## Set Up the Sample Application - -Create a Web site, application pool, and custom identity to host the code for the sample application. - -## Set Up the Site - -1. Create a physical directory for the sample application Web site with the following command: - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample7.cmd)] -2. Create a new user account that will be used to run the sample application and install the applications. Run the following from an elevated command prompt: - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample8.cmd)] -3. Grant access to the user account: - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample9.cmd)] -4. Create a new Web site to host the sample application. -5. Start **IIS Manager**, and browse to the **Web Sites** node. -6. Right-click on the **Web Sites** node, and then select **Add Web Site**. -7. Create a new Web site called **ControlPanel**. This automatically creates an associated application pool called ControlPanel. -8. Open **IIS Manager**, and browse to the **Application Pools** node. -9. Right-click on the application pool **ControlPanel**, and then select **Advanced Settings**. -10. Under the **Process Model** header, click on the **Identity Network Service**. -11. Set the identity network service to a custom account, and then enter the *credentials* for the user created in step 2, ControlPanelAppId. - - For dependency checking in the sample application to work correctly, you must use an account that has administration privilege on the computer because dependency checking requires access to the registry and directories that is only available to administrators. Alternately, you can comment out the dependency checking code. -12. Copy the contents of the sample application into the physical path you selected when creating the Web site. -13. Make sure the application is running under [Full Trust](https://msdn.microsoft.com/library/tkscy493.aspx). [You can enable it in the App Web.config](https://msdn.microsoft.com/library/wyts434y.aspx) file or, if not allowed, the administrator can add it to the root Web.config file. - -## Use the Default SSL Certificate for WMSVC - -By default, the WMSVC service installs a self-signed Secure Sockets Layer (SSL) certificate. Ideally, a fully trusted certificate is installed for the WMSVC, but for testing purposes, use this default certificate with the sample application. - -1. In the sample application, open the file **Global.asax**. -2. Look for the **Application\_Start** function, and uncomment the line: - - [!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample10.cs)] - - to - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample11.cmd)] -3. Save the file. - -## Create a Customer Site and Authorize the Site Owner - -Create a Web site for a site owner and authorize the site owner to both connect using remote management in IIS Manager and install application packages using the sample application. - -1. Start **IIS Manager**. -2. Browse to the **Web Sites** node. -3. Create a new Web site called **MySite**, or use one that has already been provisioned. -4. Create a new site owner account called **MySiteUser**, or use one that has already been provisioned. - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample12.cmd)] -5. Select the Web site called **MySite**. -6. In the **Features View**, double-click **IIS Manager Permissions**. -7. On the **IIS Manager Permissions** page, in the **Actions** pane, click **Allow User**. -8. In the **Allow User** dialog box, add a Windows user. -9. Click **Select** to open the **Users** dialog box. -10. Type **mysiteuser**, and then click **OK**. -11. Click **OK** to close the **Allow User** dialog box. - - See [Allow an IIS Manager User Account to Connect to a Site or an Application (IIS 7)](https://technet.microsoft.com/library/cc770968.aspx) for additional information. - -## Test the Installation of an Application Package - -1. Start **IIS Manager**. -2. Browse to the **Web Sites** node. -3. Select the Web site **ControlPanel**. -4. In the **Task** pane, click **Browse**. -5. Click on the application package that you want to install. -6. Type **mysite** for the site name, type **mysiteuser** for the username, and type the *password* for this account. -7. Supply other information requested, and click **Install**. - -## Manipulate the Feeds - -The Gallery feed is provided as an extended ATOM feed. The [product list](https://www.microsoft.com/web/webpi/2.0/WebProductList.xml) contains the components of the Microsoft Web Platform and the [application list](https://www.microsoft.com/web/webpi/2.0/WebApplicationList.xml) contains many popular open-source applications. Feeds are used in the sample application to: - -- Generate the list of applications to install. -- Get the download information for a package. -- Get dependency information on any of the applications. - -## Download the Application List Feed - -Before you can parse the feed, you must download it locally. The sample application uses the [WebClient.DownloadFile](https://msdn.microsoft.com/library/ez801hhe(VS.80).aspx) method to download the feed (see the application list URL above) and save it in a temporary file obtained through [Path.GetTempFileName](https://msdn.microsoft.com/library/system.io.path.gettempfilename.aspx). These calls are made in **GetXmlLocationFromFeed** (see **Reload** method in the file "ControlPanelAppRtwAPI\App\_Code\Packges.cs"). - -## Use the WebPI API to Parse the Application Feed - -Also in **Reload**, you find calls to the [Microsoft.Web.PlatformInstaller.ProductManager](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.productmanager.aspx) class. This class provides the functionality for managing the data in the feeds (application and product lists). - -### Initialize the ProductManager Object - -The following code initatiates and intializes a ProductManager object: - -[!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample13.cmd)] - -### Extract the Installer Information for Each Application - -When building your user interface, you have the choice of which fields from the ATOM feed you want to display. A minimalist approach would be to just display the applications' names, taken from the title element. You can also create a much richer UI by taking advantage of the graphic elements, such as the icon and screenshot, and incorporating other metadata from the feed. - -To display the application information and to create the links to each installation package, the sample application uses the [Microsoft.Web.PlatformInstaller.Installer](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.installer.aspx) object for each of the applications. (See **Reload** method for reference.) - -1. Within a foreach loop, examine each [Microsoft.Web.PlatformInstaller.Product](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.product.aspx) object contained in the Microsoft.Web.PlatformInstaller.ProductManager.Products collection. Identify those that are marked as applications: - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample14.cmd)] -2. Still within the foreach loop, get the installer for the application and access the particular object properties needed for the user interface and installation process. The most important of them all is the [InstallerFile.InstallerUrl.AbsoluteUri](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.installerfile.installerurl.aspx), which contains the location for downloading the Web Deploy package for the application: - - [!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample15.cmd)] -3. You can then add each of the package objects to your own packages collections and display them in your UI. - -## The Application Entry XML - -Applications are listed as entries within the feed identified with the attribute **type="application"**. A sample application entry from the feed looks like: - -[!code-html[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample16.html)] - -## Reading the List of Applications Directly from the XML Feed - -You can access the XML from the feed directly, but this is not the recommended approach. The following example illustrates how you could access key application elements: - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample17.cs)] - -## Identifying Missing Dependencies Using the WebPI API - -An important step within the sample application is to identify all the missing dependencies in the target server where the application will be installed. The sample apllication collects this information and displays it as an error if the user tries to install an application package for which dependencies are missing. For this purpose, the Web.PlatformInstaller provides the [Microsoft.Web.PlatformInstaller.Product.GetMissingDependencies](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.product.getmissingdependencies.aspx) method, which returns a collection of missing products. - -Before this method is called, you must create an instance of ProductManager and initialize it with the Products List feed (not the Application feed). The following code snippet is an example on how to check for missing dependencies. You can find this code in the ControlPanelAppRtwAPI\App\_Code\Package.cs file of the sample application. - -Note that the call to GetMissingDependencies only works correctly if it is made within the context of a user with administrative rights to the computer because it needs access to the registry and directories only available to administrators. - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample18.cs)] - -Control panel applications should ensure that the corresponding dependencies for a particular package are available in the target server before proceeding with the installation process. If this functionality is not available, there is a risk of failure once the user tries to execute the application after a successful installation. In the absence of this dependency check, hosters would have to monitor the feed applications and their dependencies to ensure that target servers are properly set up. - -Note that the GetMissingDependencies method looks for dependencies within the scope of the bit size of the running process. If it is a 32-bit process, it looks for 32-bit dependencies, and for 64-bit process, it looks for 64-bit dependencies. This is important if you are running on a 64-bit computer under 32-bit mode application pools. - -## Tracking Application/Product Dependencies - -The best approach to identifying missing dependencies within your solution is to use WebPI API. However, you can use the following steps if you wish to review the feed XML and identify which dependencies are needed for each application. - -One of the most important elements within the **WebApplicationList.xml** feed file is the <dependency> element. This element describes the dependencies needed for a particular application package to work properly. - -The product list feed **WebProductList.xml** is the root feed. It not only contains references to the product information (Web Platform components) but also points to a child feed **WebApplicationList.xml**. The **WebApplicationList.xml** contains the references to the applications packages, and each application package entry contains a set of dependency references to product packages defined in **WebProductList.xml**. The following example shows how this relationship is implemented: - -1. The WebProductList.xml contains a link to the WebApplicationList.xml: - - [!code-html[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample19.html)] -2. The WebApplicationList.xml contains references to application packages contained within <entry> elements. Each package entry contains a list of dependencies. For example, the dependency element for a PHP application that also uses MySQL such as WordPress is: - - [!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample20.xml)] - - The <dependency> element means the beginning of the dependency list. The <and> element means that all the dependency elements listed inside are required by the application. -3. Note the idref="PHPApp" and idref="MySQLApp" properties. They refer to another <dependency> element with corresponding "id" value that defines the actual dependencies. For example, if you examine the WebApplicationList.xml file for the "PHPApp" dependency element, you find the set of PHPApp dependencies: - - [!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample21.xml)] -4. The `` element contains the reference to the corresponding product in the parent feed WebProductList.xml. For example: - - - ID = WDeployNoSMO, corresponds to Web Deploy without SMO - - ID= PHP, corresponds to the PHP engine (currently: 5.2.11) - - Notice that the <or> entry means that the dependency is for one or the other or both. -5. The product entries in the WebProductList.xml contain a <discoveryHint> element that shows what to look for to find out if the product already exist in the target machine or not. For example, in the case of product id "MySQLConnector": - - [!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample22.xml)] -6. The <or> element means that at least one of <discoveryHint> elements must be satisfied. - -## Filter the List of Applications Using the Web PI API - -You can provide your users with a UI that lets them sort the applications based on information provided in the Applications List feed. You can filter applications by using the keywords associated with each application under the element <keywords>. - -In the Application Entry example above, you can see: - -[!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample23.xml)] - -The following code snippet illustrates how you can filter applications by their keywords: - -[!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample24.cmd)] - -This example uses the Web.PlatformInstaller API to load the Application List feed and then list each application ordered by keyword. The [ProductManager.Keywords](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.productmanager.keywords.aspx) collection lists all the available keywords from the loaded feed. - -The following example lists all applications that have the "PHP" keyword followed by the applications that have the "ASPNET" keyword. - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample25.cs)] - -## Download a Web Deploy Package - -When the user selects an application, you need to download the Web Deploy package to a location on the server where the application will be installed. The package is available via HTTP. Its location is in the feed as the data within the <installer> element. For example: - -[!code-xml[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample26.xml)] - -The sample applications use the WebClient.DownloadFile method to download the package file; after downloading the sample applications, verify the hash and display the parameters required by the package. - -## Use the SHA1 Hash to Verify the Package - -The `` element in the example contains the SHA1 hash of the package to download and acts as a signature for the package. You can use this hash to verify that the downloaded package is indeed the one you expect. The sample application collects this value for every application in the feed XML file and uses the value to verify the hash of the downloaded package. - -The following code snippet from the sample application illustrates this verification: - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample27.cs)] - -## Handle Package Parameters - -Most packages contain parameters that are required to install them in a given environment. As part of the control panel design, you can choose what types of parameters you can compute and set and which ones require input from the user. - -## Collecting the Parameters Defined in the Package - -The Web Deployment API allows you to retrieve the parameters from a package by accessing a collection within the Web Deploy [**DeploymentObject**](https://msdn.microsoft.com/library/microsoft.web.deployment.deploymentobject.aspx). - -The code snippet below is taken from the sample applications and shows one method of generating the parameters as a collection called "\_parameters" to be used later. - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample28.cs)] - -The sample applications use a "ReadOnlyCollection" called "Parameters" to bind the "\_parameters" data list from the example above to the UI fields in a ListView control inside the Install.aspx file: - -[!code-console[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample29.cmd)] - -## Using the Parameter Names and Tags - -A typical package requests the following parameter names: - -- **Application Path**. This is the Web server path for the application in the form of "Web Site/Application" (for example, "Default Web Server/application\_name"). -- **Application Database Information**. This is the database information required for the application to communicate with the database, typically consisting of four parameters: - - - **Database Server**. The host name or IP address of the database server. - - **Database Name**. The name of the database. - - **Database Username**. The ID used by the application for communicating with the database. - - **Database Password**. The password for the database username. -- **Database Administrator information**. These are the credentials required for creating the database and user listed above. - -These parameter names are recommended, but not required. The control panel can tell which parameters are parts of the database connection by referring to the **tags** that are included with the parameters. - -The following tags can be used with parameters to tell the UI how to display and use the parameters: - -- **iisApp**. This identifies a parameter as the application path for installation. The defaultValue should be displayed unless you already know which site will be used for application installation. The defaultValue is usually set to a value such as "Default Web Site/application1" (this is not enforced). For example, if the user logs in and you determine they own "MySite.com," you can parse the defaultValue to get "/application1," and append this to the hosted site name. -- **Hidden**. This identifies a parameter that is set programmatically rather than through user input. For example, the "Connection String" has a default value that is computed from the values of other parameters. The portions of the entry within the {}s are replaced with the values of those parameters. -- **SQLConnectionString or MySQLConnectionString**. These parameters are used for constructing a connection string for connecting to the database. -- **SQL or MySQL**. These parameters are used in relation to a specific database. An application package can work with either SQL or MySQL as the database. Parameters can be tagged with one or both of these. The UI can let the user to choose which database to use. All parameters that have a ConnectionString tag also have the corresponding database tag. -- **Password**. This identifies a field that is used as a password that is already known. The UI obfuscates the value. -- **New**. When used along with the password tag, this identifies a field that is used to set a new password. The UI obfuscates the value, and asks the user to confirm it. For example, New, Password. -- **dbUsername, dbUserPassword, dbAdminUsername, dbAdminUserPassword**. Some UIs that install application packages handle the database creation themselves. If the user has already created a database, the UIs seamlessly hide and correctly fill in the administrative credentials to avoid making the user enter data twice. The tags identify the parameters to modify if the UI handles database creation. -- **dbServer**. This is used to identify a parameter that can be filled in with a database server name. -- **dbName.** This is used to identify a parameter that can be filled in with the name of a database. - -You can retrieve these tags through the **DeploymentSyncParameter.Tags** property; it is a comma-delimited string containing the tags associated to the parameter. - -Some parameters have default values that can be retrieved from the **syncParameters** collection. You have the choice of using those defaults, prompting the user for new values with the defaults in the forms, or ignoring them, as appropriate for your environment. - -## Using the Parameter Validation Data - -There is validation data you can use to help you build the appropriate UI. Each [DeploymentSyncParameter](https://msdn.microsoft.com/library/microsoft.web.deployment.deploymentsyncparameter.aspx) has a DeploymentSyncParameterValidation object that identifies the parameter as having one or more of the following types of data: - -- **AllowEmpty**. The parameter allows an empty value. -- **Boolean**. The parameter only allows "true" or "false." -- **Enumeration**. The parameter only allows values specified within the DeploymentSyncParameterValidation.ValidationString. This is a comma-delimited string. -- **RegularExpression**. The parameter only allows strings that match the specified regular expression within DeploymentSyncParameterValidation.ValidationString. - -The sample application uses this data to setup the UI input controls appropriately. For example, locate the following code snippet within either sample application and note the definitions of IsBooleam(), SplitValidationValues(), AllowEmpty(), and HasReg(): - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample30.cs)] - -## Deploy an Application - -Once you have gathered all of the data for the parameters, it is time to install the application. Working with your DeploymentObject, you can apply the set parameters and install the application. The API steps to do this are outlined below. - -## Initialize the DeploymentObject - -You must tell the DeploymentObject how to install the application. For example: - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample31.cs)] - -In the example, the ComputerName is the Universal Resource Identifier (URI) for the MS Deploy agent. The UserName and Password are the credentials for the ID that has the authority to use the agent. - -## Set the Parameters - -Each of the parameters in the original application package must have a value. If a parameter has a DefaultValue, you do not need to specify a new value at this point. All other parameters require values. - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample32.cs)] - -The Web site and application that MS Deploy uses to install the application is specified with the Application Path parameter. - -## Installing the Application - -The application is installed using the DeploymentObject.SyncTo() method. The sample application call to SyncTo follows: - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample33.cs)] - -In the code snippet: - -- **DeploymentWellKnownProvider.Auto** specifies that the MS Deploy auto provider be used to install the application. This provider examines the package manifest, contents, and parameter values to decide which resources need to be deployed. -- **destinationOptions** specifies the target computer, the credentials, and type of authentication to be used during the installation. - -## Change the Target Server - -The sample application assumes that the target server is the "localhost." Note that inside the Package.cs file, in the installation method, the code specifies localhost, the SiteName that you enter in the corresponding UI field: - -[!code-csharp[Main](integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample34.cs)] - -If you created a site called "MySite" (as in the example above), you must type **mysite** in the **Site Name** UI field. - -## Provide the User with the Application Location - -When the installation is complete, your control panel should provide a link to the application for the user. The base of this URL should be determined from the Web site setup. An application may have a StartPage element defined within its entry in the ATOM feed. If there is a StartPage element, its value should be appended to the link presented to the user. - -## Links for Further Information - -**Microsoft® Developer Network (MSDN®):** - -- [Microsoft Web Deployment namespace](https://msdn.microsoft.com/library/microsoft.web.deployment.aspx) - -**Forums:** - -- [Web Application Gallery: Users](https://forums.iis.net/1159.aspx) -- [Web Application Gallery: Developers & Integrators](https://forums.iis.net/1158.aspx) -- [Web Platform Installer](https://forums.iis.net/1155.aspx) - -**Articles:** - -- [Application Packaging Guide for the Windows Web Application Gallery](package-an-application-for-the-windows-web-application-gallery.md) -- [Web Application Gallery Overview](introducing-the-windows-web-application-gallery.md) -- [Web Application Gallery Principles](windows-web-application-gallery-principles.md) -- [Best Practices: Running PHP Applications on IIS](introducing-the-windows-web-application-gallery.md) -- [Best Practices: Running ASP.NET Applications on IIS](../../application-frameworks/building-and-running-aspnet-applications/index.md) diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/_static/integrate-the-windows-web-application-gallery-into-a-control-panel-607-sample1.zip b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/_static/integrate-the-windows-web-application-gallery-into-a-control-panel-607-sample1.zip deleted file mode 100644 index 215ab3a1a..000000000 Binary files a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/_static/integrate-the-windows-web-application-gallery-into-a-control-panel-607-sample1.zip and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample1.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample1.cmd deleted file mode 100644 index 1a5dd21b9..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -net user CustomAppUser PasswordHere /add \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample10.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample10.cs deleted file mode 100644 index 7ea89378c..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample10.cs +++ /dev/null @@ -1 +0,0 @@ -//ServicePointManager.ServerCertificateValidationCallback = delegate { return true; }; \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample11.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample11.cmd deleted file mode 100644 index 552a137ed..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample11.cmd +++ /dev/null @@ -1 +0,0 @@ -ServicePointManager.ServerCertificateValidationCallback = delegate { return true; }; \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample12.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample12.cmd deleted file mode 100644 index 3cdf0a22f..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample12.cmd +++ /dev/null @@ -1 +0,0 @@ -net user MySiteUser PasswordHere /add \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample13.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample13.cmd deleted file mode 100644 index df504777a..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample13.cmd +++ /dev/null @@ -1,3 +0,0 @@ -ProductManager pm = new ProductManager(); -string fileLocation = GetXmlLocationFromFeed(feedUrl); -pm.Load(new Uri(fileLocation)); \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample14.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample14.cmd deleted file mode 100644 index 2132b1258..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample14.cmd +++ /dev/null @@ -1,5 +0,0 @@ -foreach (Product p in pm.Products) { - if (!p.IsApplication) { - continue; - } -[...] \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample15.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample15.cmd deleted file mode 100644 index cae4958a6..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample15.cmd +++ /dev/null @@ -1,25 +0,0 @@ -[...] -Installer installer = p.GetInstaller(english); -if (installer == null) { - if (p.Installers.Count > 0) { - installer = p.Installers[0]; - } - else { - // some products are just for detection - continue; - } -} -// if there's no install location we'll skip as well -if (installer.InstallerFile == null) { - continue; -} -Package package = new Package { - ID = p.ProductId, - Description = p.Summary, - Title = p.Title, - Version = p.Version, - SartPage = installer.MSDeployPackage.StartPage ?? String.Empty, - DownloadUrl = installer.InstallerFile.InstallerUrl.AbsoluteUri, - DownloadHash = installer.InstallerFile.SHA1Hash -}; -[...] \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample16.html b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample16.html deleted file mode 100644 index 638cf609d..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample16.html +++ /dev/null @@ -1,49 +0,0 @@ - - - -[…] - - - BlogEngineNET - BlogEngine.NET - 1.5.0 - BlogEngine.NET is a fully featured, open source blogging platform written in ASP.NET. BlogEngine.NET is easily customizable with many downloadable themes, widgets, and extensions. - http://www.microsoft.com/web/webpi/2.0/blogengine - 2009-3-18T18:30:02Z - 2009-03-18T18:30:02Z - BlogEngine.NET is an open source ASP.NET blogging project that was born out of desire for a better blog platform. We focused on simplicity, ease of extendibility, and innovative features while taking advantage of the latest .NET features. BlogEngine.NET is easily customizable. We have many downloadable themes, widgets, and extensions or you could make your own with some basic .NET skills. With BlogEngine.NET, it is easy to make your blog look and function exactly how you’d like. - - - dotnetblogengine.net - http://www.dotnetblogengine.net/ - - - BlogEngine200x200.jpg - http://www.microsoft.com/web/media/gallery/apps-screenshots/BlogEngine200x200.jpg - - - Blogs - ASPNET - - - - - 1 - en - - - 1342 - http://blogengine.codeplex.com/Project/Download/FileDownload.aspx?DownloadId=66012 - https://go.microsoft.com/fwlink/?LinkId=146340 - C1EA7BF684D85A0CAD2EE6DE859011A61264CF2C - - http://forums.iis.net/1155.aspx - - - - - - 3-10-2009 - BlogEngine - -[…] \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample17.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample17.cs deleted file mode 100644 index 43bf5fb17..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample17.cs +++ /dev/null @@ -1,27 +0,0 @@ -public static void Reload() { - lock (_packagesLock) { - string feedUrl = ConfigurationManager.AppSettings["FeedXmlUrl"]; - if (String.IsNullOrEmpty(feedUrl)) { - throw new InvalidOperationException("Could not find FeedXmlUrl in application settings"); - } - // Parse the XML feed with the packages in them - XmlDocument doc = new XmlDocument(); - doc.LoadXml(GetXmlFromFeed(feedUrl)); - // Feed uses the Atom XML schema - XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable); - nsmgr.AddNamespace("atom", "http://www.w3.org/2005/Atom"); - _packages = new Dictionary(); - foreach (XmlNode app in doc.SelectNodes("//atom:entry[@type='application']", nsmgr)) { - Package package = new Package { - ID = GetXmlNodeText(app, nsmgr, "atom:productId"), - Description = GetXmlNodeText(app, nsmgr, "atom:summary"), - Title = GetXmlNodeText(app, nsmgr, "atom:title"), - Version = GetXmlNodeText(app, nsmgr, "atom:version"), - StartPage = GetXmlNodeText(app, nsmgr, "atom:pageName"), - DownloadUrl = GetXmlNodeText(app, nsmgr, "atom:installers/atom:installer/atom:installerFile/atom:installerURL"), - DownloadHash = GetXmlNodeText(app, nsmgr, "atom:installers/atom:installer/atom:installerFile/atom:sha1") - }; - _packages.Add(package.ID, package); - } - } -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample18.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample18.cs deleted file mode 100644 index dfc9ccf0c..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample18.cs +++ /dev/null @@ -1,22 +0,0 @@ -public string GetMissingRequirements() { - string displayString = String.Empty; - try { - ProductManager pm = new ProductManager(); - // we need to load the whole product list since app will depend on products in that file - // the "true" parameter says filter the installer set to only installers available on this - // architecture - pm.Load(new Uri(ConfigurationManager.AppSettings["PLFeedXmlUrl"]), true); - Product p = pm.GetProduct(ID); - ICollection missingProducts = p.GetMissingDependencies(null); - if (missingProducts.Count > 0) { - displayString = "The server is missing the following products that are required to run this app: "; - foreach (Product missing in missingProducts) { - displayString += " " + missing.Title + ","; - } - displayString = displayString.Trim(','); - } - } - catch { - } - return displayString; -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample19.html b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample19.html deleted file mode 100644 index 33d3b4cee..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample19.html +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample2.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample2.cmd deleted file mode 100644 index 68d175628..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample2.cmd +++ /dev/null @@ -1,2 +0,0 @@ -%windir%\system32\inetsrv\config. -icacls %windir%\system32\inetsrv\config /grant CustomAppUser:(R,RD,RA,REA) \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample20.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample20.xml deleted file mode 100644 index 05eda7a87..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample20.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample21.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample21.xml deleted file mode 100644 index 05f9c2d8c..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample21.xml +++ /dev/null @@ -1,21 +0,0 @@ - - - - - WDeployNoSMO - - - - - - PHP - - - LegacyPHP - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample22.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample22.xml deleted file mode 100644 index 8def1cf7c..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample22.xml +++ /dev/null @@ -1,18 +0,0 @@ - - - - - HKEY_LOCAL_MACHINE\SOFTWARE\MySQL AB\MySQL Connector/Net - Version - 5.2.5 - - - - - HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\MySQL AB\MySQL Connector/Net - Version - 5.2.5 - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample23.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample23.xml deleted file mode 100644 index e9de74677..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample23.xml +++ /dev/null @@ -1,4 +0,0 @@ - - Blogs - ASPNET - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample24.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample24.cmd deleted file mode 100644 index 34f5f5327..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample24.cmd +++ /dev/null @@ -1,8 +0,0 @@ -ProductManager pm = new ProductManager(); - pm.Load(new Uri(appXml), false, false); - foreach (Keyword k in pm.Keywords) { - tw.WriteLine("******** Keyword " + k.Text + " Products *********"); - foreach (Product p in k.Products) { - tw.WriteLine(p.Title + " (id = '" + p.ProductId + "')"); - } - } \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample25.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample25.cs deleted file mode 100644 index ed9299b43..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample25.cs +++ /dev/null @@ -1,13 +0,0 @@ -// get the php keyword -Keyword phpKeyword = pm.GetKeyword("PHP"); -tw.WriteLine("******** PHP apps ********"); -foreach (Product p in phpKeyword.Products) { - tw.WriteLine(p.Title + "(id = '" + p.ProductId + "')"); -} -tw.Write("\r\n"); -// get aspnet keyword -Keyword aspnetKeyword = pm.GetKeyword("ASPNET"); -tw.WriteLine("******** ASPNET apps ********"); -foreach (Product p in aspnetKeyword.Products) { - tw.WriteLine(p.Title + "(id = '" + p.ProductId + "')"); -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample26.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample26.xml deleted file mode 100644 index 7fe3856c5..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample26.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - 1 - en - - - 1342 - http://blogengine.codeplex.com/Project/Download/FileDownload.aspx?DownloadId=66012 - https://go.microsoft.com/fwlink/?LinkId=146340 - C1EA7BF684D85A0CAD2EE6DE859011A61264CF2C - - http://forums.iis.net/1155.aspx - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample27.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample27.cs deleted file mode 100644 index 1a38e70c3..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample27.cs +++ /dev/null @@ -1,9 +0,0 @@ -// Verify SHA1 Hash -SHA1 sha1 = SHA1.Create(); -byte[] hash = sha1.ComputeHash(File.ReadAllBytes(_downloadTempFile)); -string hashString = hash.Aggregate("", (acc, value) => acc + value.ToString("X2")); -if (DownloadHash.ToUpperInvariant() != hashString) { - File.Delete(_downloadTempFile); - _downloadTempFile = null; - throw new InvalidOperationException("The download file appears to be corrupt."); -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample28.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample28.cs deleted file mode 100644 index 8989c5b8d..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample28.cs +++ /dev/null @@ -1,11 +0,0 @@ -private void LoadParameters() { - string zipFile = GetDownload(); - if (!File.Exists(zipFile)) { - throw new InvalidOperationException("Could not download package for ID=" + ID + ", Title=" + Title); - } - using (DeploymentObject iisApplication = DeploymentManager.CreateObject(DeploymentWellKnownProvider.Package, zipFile)) { - _parameters = (from parameter in iisApplication.SyncParameters - where !IsHidden(parameter) - select parameter).ToList(); - } -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample29.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample29.cmd deleted file mode 100644 index aadbc9d93..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample29.cmd +++ /dev/null @@ -1,2 +0,0 @@ -ParameterList.DataSource = _package.Parameters; -ParameterList.DataBind(); \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample3.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample3.cmd deleted file mode 100644 index c64f8d9f1..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -windir%\system32\inetsrv\config\applicationHost.config. \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample30.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample30.cs deleted file mode 100644 index 2deb125f1..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample30.cs +++ /dev/null @@ -1,20 +0,0 @@ -/// -/// Gets the package's parameters. -/// -public ReadOnlyCollection Parameters { - get { - Initialize(); - return new ReadOnlyCollection( - (from syncParam in _parameters - select new PackageParameter { - Name = syncParam.Name, - Description = syncParam.Description, - Value = syncParam.DefaultValue, - IsPassword = IsPassword(syncParam), - IsBoolean = IsBoolean(syncParam), - ValidationValues = SplitValidationValues(syncParam), - AllowEmpty = AllowEmpty(syncParam), - RegEx = HasRegEx(syncParam) ? syncParam.Validation.ValidationString : null // if there is no RegEx, allow any value - }).ToArray()); - } -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample31.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample31.cs deleted file mode 100644 index bc8ce2148..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample31.cs +++ /dev/null @@ -1,9 +0,0 @@ -using (DeploymentObject iisApplication = - DeploymentManager.CreateObject(providerOptions, - sourceOptions)) { - DeploymentBaseOptions destinationOptions = new DeploymentBaseOptions { - ComputerName = agentUri, - UserName = userName, - Password = password, - AuthenticationType = "basic", - }; \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample32.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample32.cs deleted file mode 100644 index a6605fc31..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample32.cs +++ /dev/null @@ -1,13 +0,0 @@ -// for each parameter that was specified in the UI, set its value -foreach (PackageParameter updatedValue in updatedValues) { - DeploymentSyncParameter parameter; if (String.IsNullOrEmpty(updatedValue.Name)) { - throw new InvalidOperationException("A value without a name was passed to the installer"); - } - - // find the parameter to which a value should be set - if (! iisApplication.SyncParameters.TryGetValue(updatedValue.Name, out parameter)) { - throw new InvalidOperationException("Could not find a parameter with the name " + updatedValue.Name); - } - // Set the value - parameter.Value = updatedValue.Value; -} \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample33.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample33.cs deleted file mode 100644 index a5be4ab54..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample33.cs +++ /dev/null @@ -1,3 +0,0 @@ -// Install the application -DeploymentSyncOptions syncOptions = new DeploymentSyncOptions(); -iisApplication.SyncTo(DeploymentWellKnownProvider.Auto, String.Empty, destinationOptions, syncOptions); \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample34.cs b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample34.cs deleted file mode 100644 index 81965053b..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample34.cs +++ /dev/null @@ -1,2 +0,0 @@ -// change localhost to a computer name to do remote deployments -string agentUri = "https://localhost:8172/msdeploy.axd?Site=" + Uri.EscapeDataString(siteName); \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample4.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample4.cmd deleted file mode 100644 index 3624052af..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -icacls %windir%\system32\inetsrv\config\applicationhost.config /grant CustomAppUser:(W,WD,AD,RA,REA,RD,WA,WEA,R) \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample5.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample5.xml deleted file mode 100644 index adb8b45b3..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample5.xml +++ /dev/null @@ -1,2 +0,0 @@ - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample6.xml b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample6.xml deleted file mode 100644 index 71c24e8b4..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample6.xml +++ /dev/null @@ -1,26 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample7.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample7.cmd deleted file mode 100644 index 8b26206f5..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ -md %systemdrive%\inetpub\controlpanel \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample8.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample8.cmd deleted file mode 100644 index 63713c41d..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -net user ControlPanelAppId /add \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample9.cmd b/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample9.cmd deleted file mode 100644 index f099ef205..000000000 --- a/iis/develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel/samples/sample9.cmd +++ /dev/null @@ -1 +0,0 @@ -icacls %systemdrive%\inetpub\controlpanel /grant ControlPanelAppId:R \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md deleted file mode 100644 index da9024555..000000000 --- a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: "Introducing the Windows Web Application Gallery" -author: chrissfanos -description: "Users can browse the WWAG and running the installer." -ms.date: 03/18/2009 -ms.assetid: a6fef702-77c2-4c2c-963b-c8c361c37fe0 -msc.legacyurl: /learn/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery -msc.type: authoredcontent ---- -# Introducing the Windows Web Application Gallery - -by [Chris Sfanos](https://github.com/chrissfanos) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -The [Windows Web Application Gallery](https://www.microsoft.com/web/gallery) makes it easy to explore, discover and install popular community ASP.Net and PHP applications on Windows. Users can browse and view applications for different types of Web sites, ranging from photo galleries to blogs to ecommerce sites. - -The Web Application Gallery integrates with the [Web Platform Installer 3.0](https://www.microsoft.com/web/downloads/platform.aspx), so that when a user clicks "Install" for an application, the Web Platform Installer 3.0 launches with context set on the user's selection. This powerful combination of application discovery and simplified installation makes it easier than ever for community-based applications to run on Windows. - -The Web Application Gallery also provides a way for developers to reach millions of Windows users. When an application is accepted by the Web Application Gallery, the application is added to the Web Application Gallery ATOM feed. The ATOM feed is consumed by the Web Application Gallery itself, Web Platform Installer 3.0, WebMatrix, IIS Manager, and participating Hosting Control Panels. - -![Diagram showing how the A T O M feed is distributed.](introducing-the-windows-web-application-gallery/_static/image3.png) - -## Application Discovery and Installation by Users - -Users can browse the Web App Gallery by viewing by categories or groups like "Most Popular" or searching by keywords. Once the user clicks "Install", the Web App Gallery detects if the Microsoft Web Platform Installer is present on the computer. If not, the Web App Gallery redirects the user to install the Microsoft Web Platform Installer. When the Web Platform Installer is on the computer, the user can select "Install" and the Web Platform Installer will launch to install the selected application. - -The Web Platform Installer knows about the dependencies for each application in the Web Application Gallery. As a result, when the user installs an application, the Web Platform Installer also includes any required dependencies, such as PHP. - -Once the Web Platform Installer completes the installation of the application, the user can get started using or extending the application. Users can also rate applications after logging into the site. - -## Application Submissions to the Web Application Gallery by Developers - -The Windows Web Application Gallery provides a way for developers to more easily deploy applications to Windows users. The Web Application Gallery does not store code snapshots of applications. Instead, the App Gallery and Web PI retrieve the application package from the application developer's Web site. The application developer owns the originating distribution point, which Web Platform Installer uses to retrieve the package for deployment. The information displayed with the package, such the Publisher link, is all provided by the application developer during the application submission process. The Web Application Gallery will cache application screenshots and icon URLs to prevent inadvertent rerouting, but the application developer is free to provide new URLs at any time to the Microsoft Web Application for updates. - -The App Gallery contains both ASP.NET and PHP applications that follow the [Web Application Gallery Principles](windows-web-application-gallery-principles.md) and use [Microsoft Web Deploy for application packaging](package-an-application-for-the-windows-web-application-gallery.md) to streamline deployment on Windows. - -Developers follow four steps to submit an application to the Web Application Gallery. - -![Diagram showing an outline of the steps in the flow of submitting an application.](introducing-the-windows-web-application-gallery/_static/image6.png) - -### Step 1: Apply Web App Gallery Principles - -First, developers must review and apply the [Web Application Gallery Principles](windows-web-application-gallery-principles.md) to their applications. These Principles reflect the Web Application Gallery's goals to deliver a quality, safe user experience that is consistent across platforms supported by Windows Platform Installer. If developers have any questions about the Principles, the developer can ask questions or post comments to the [Web Application Gallery Developer forum](https://forums.iis.net/1158.aspx). - -### Step 2: Tune Application Based on Best Practices and Principles - -Next, developers can visit IIS.NET for best practices in running applications on IIS. For ASP.NET applications, developer can start with a snapshot of [ASP.NET Technical Resources](../../application-frameworks/building-and-running-aspnet-applications/aspnet-technical-resources.md) or check out the [Running ASP.NET Applications on IIS](../../application-frameworks/building-and-running-aspnet-applications/index.md) section. For PHP applications, developers can browse the [Running PHP Applications](../../application-frameworks/running-php-applications-on-iis/index.md) for articles on how to make PHP applications work well on Windows. Guidance for PHP developers includes [how to use web.config to set default document and static rewrite rules.](../../application-frameworks/install-and-configure-php-applications-on-iis/translate-htaccess-content-to-iis-webconfig.md) IIS.NET also hosts guidance for any application developer on Windows, such as [Securing Content on IIS Using File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md). You can also post questions about running PHP applications on Windows or the Principles in the [Web App Gallery Developer forum](https://forums.iis.net/1158.aspx). - -### Step 3: Package Using Web Deploy - -After tuning the application package with best practices, the developer adds Web Deploy support to the application package. Microsoft Web Deploy provides the framework for deploying and migrating Web applications and Web servers locally and remotely on IIS. With Web Deploy, a developer adds a couple of manifest files to the root directory of an existing ZIP package that tell IIS how to deploy the application. - -The manifest.XML file tells IIS what is in the package and allows the developer to set the name of the directory and Web site where the package is deployed. The parameters.xml file gives developers the ability to ask the user for information during the install process, such as Web site path. Learn more about how to define the Web Deploy manifest files in the [Application Packaging Guide](package-an-application-for-the-windows-web-application-gallery.md). - -### Step 4: Submit Application to Web Application Gallery - -Once the manifest files are added and tested in an application package, the Web developer is ready to submit the package to the Web Application Gallery. The Web Application Gallery Submission form in theWeb Application Gallery starts by collecting information about the application. See the [Submitting Links to the Web Application Gallery](windows-web-application-gallery-link-addition-process-walkthrough.md) walkthrough for a detailed description of how to submit an application. Each application is reviewed to make sure that the application follows the Web Application Gallery Principles. Microsoft may contact the application developer in the course of the review, and also to inform the application developer about the state of the submission. - -### Web Application Gallery Developers - -If an application developer is accepted into the Web Application Gallery, the lifecycle of the application continues at the developer's pace. With each package update, the application developer must contact the Microsoft Web Application Gallery to provide a new MD5 hash, which helps secure the distribution point. - -Some users will visit the Web Application Gallery user forum or Web Platform Installer forums where the Web Application Gallery team member will help diagnose the point of failure as Web PI, Web Deploy, the application package, or the application itself. If the failure occurs in the application package Web Deploy integration, the Web Application Gallery team will inform the application developer about the issue with the application package. - -Otherwise, for general application questions and issues, the Web Application Gallery team redirects the user to the application's free support forums. The application developer is also encouraged to use IIS.NET as a technical resource to answer any questions in forums that might stem from Web Application Gallery or Web Platform Installer, starting with the [Troubleshooting Web Platform Installer 3.0](../../troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md) article and [Known Issues with Web Application Gallery](windows-web-application-gallery-known-issues.md). - -Since the Web Platform Installer points to the application download URL, the application developer can collect download statistics on the app download server (which is owned by the application developer) by checking for the Web App Gallery user agent. diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image1.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image1.png deleted file mode 100644 index 6e89d94fa..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image1.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image2.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image2.png deleted file mode 100644 index 791f5c5ad..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image2.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image3.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image3.png deleted file mode 100644 index 6e89d94fa..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image3.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image4.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image4.png deleted file mode 100644 index 8030e6b26..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image4.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image5.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image5.png deleted file mode 100644 index 8030e6b26..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image5.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image6.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image6.png deleted file mode 100644 index 791f5c5ad..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image6.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image7.png b/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image7.png deleted file mode 100644 index 791f5c5ad..000000000 Binary files a/iis/develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery/_static/image7.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/joomla-sample-files.md b/iis/develop/windows-web-application-gallery/joomla-sample-files.md deleted file mode 100644 index 765e2ebee..000000000 --- a/iis/develop/windows-web-application-gallery/joomla-sample-files.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Joomla! Sample files" -author: rick-anderson -description: "This is a set of sample files you could use with Joomla! and the Web Deployment tool for deploying Joomla on IIS. The files are annotated with comments that..." -ms.date: 06/08/2009 -ms.assetid: d9957c2a-8f3d-4a3b-b9e9-d42eabf54b7a -msc.legacyurl: /learn/develop/windows-web-application-gallery/joomla-sample-files -msc.type: authoredcontent ---- -# Joomla! Sample files - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with Joomla! and the Web Deployment tool for deploying Joomla on IIS. The files are annotated with comments that explain specific lines in the files you'll need to customize for your configuration. - -## Sample manifest.xml file - -[!code-xml[Main](joomla-sample-files/samples/sample1.xml)] - -## Sample parameters.xml file - -[!code-vb[Main](joomla-sample-files/samples/sample2.vb)] - -## Sample install.sql file - -[!code-console[Main](joomla-sample-files/samples/sample3.cmd)] - -## Sample web.config file - -[!code-xml[Main](joomla-sample-files/samples/sample4.xml)] diff --git a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample1.xml deleted file mode 100644 index 7891e54e2..000000000 --- a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample1.xml +++ /dev/null @@ -1,102 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample2.vb b/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample2.vb deleted file mode 100644 index 9c8ddabe0..000000000 --- a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample2.vb +++ /dev/null @@ -1,338 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample3.cmd b/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample3.cmd deleted file mode 100644 index 5ffc1c3e0..000000000 --- a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample3.cmd +++ /dev/null @@ -1,15 +0,0 @@ -USE PlaceHolderForDb; - -DROP PROCEDURE IF EXISTS add_user ; - -CREATE PROCEDURE add_user() -BEGIN -DECLARE EXIT HANDLER FOR 1044 BEGIN END; -GRANT ALL PRIVILEGES ON PlaceHolderForDb.* to 'PlaceHolderForUser'@'localhost' IDENTIFIED BY 'PlaceHolderForPassword'; -FLUSH PRIVILEGES; -END -// - -CALL add_user() // - -DROP PROCEDURE IF EXISTS add_user // \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample4.xml b/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample4.xml deleted file mode 100644 index 2fc118b34..000000000 --- a/iis/develop/windows-web-application-gallery/joomla-sample-files/samples/sample4.xml +++ /dev/null @@ -1,37 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/mediawiki-sample-files.md b/iis/develop/windows-web-application-gallery/mediawiki-sample-files.md deleted file mode 100644 index dd29a973f..000000000 --- a/iis/develop/windows-web-application-gallery/mediawiki-sample-files.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "MediaWiki Sample Files" -author: rick-anderson -description: "This is a set of sample files you could use with MediaWiki and the Web Deployment tool for deploying MediaWiki on IIS. The files are annotated with comments..." -ms.date: 07/29/2009 -ms.assetid: 052e4fa7-82d5-41f8-8c22-a37428f6de27 -msc.legacyurl: /learn/develop/windows-web-application-gallery/mediawiki-sample-files -msc.type: authoredcontent ---- -# MediaWiki Sample Files - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with MediaWiki and the Web Deployment tool for deploying MediaWiki on IIS. The files are annotated with comments that explain specific lines in the files you'll need to customize for your configuration. - -MediaWiki has an installation routine that takes care of creating the database using database super user privileges, so there is no requirement for using the Web Deployment Tool for that. However, MediaWiki could be set up to create the database from the Web Deployment Tool if that was preferred. - -In addition, the MediaWiki installation routine creates the configuration file "LocalSettings.php" in the config sub directory. This requires the user to access the Operating System through either a command line, or the Explorer, to move the LocalSettings.php file to the application root. It might be worth investigating whether or not moving all of the steps for creating the database and LocalSettings.php file into the Web Deployment Tool would be worth the effort. The benfit would be that when the Web Deployment Tool (Or Web Platform Installer calling the WDT) was finished, the Wiki would be completely configured and ready for use. Or at least ready for the remaining system tests to be performed, and then to have the Wiki be used. The work invovled would be converting the PHP parameterization to WDT parameterization. The potential risk is that if the installation needed to change in any significant way, the change would have to be made in the MediaWiki installer, and in the WDT configuration files. - -## Sample manifest.xml file - -[!code-xml[Main](mediawiki-sample-files/samples/sample1.xml)] - -## Sample parameters.xml file - -[!code-xml[Main](mediawiki-sample-files/samples/sample2.xml)] - -## Sample web.config file - -[!code-xml[Main](mediawiki-sample-files/samples/sample3.xml)] diff --git a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample1.xml deleted file mode 100644 index 5137b8291..000000000 --- a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample1.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample2.xml b/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample2.xml deleted file mode 100644 index 5ddceac8f..000000000 --- a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample2.xml +++ /dev/null @@ -1,27 +0,0 @@ - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample3.xml b/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample3.xml deleted file mode 100644 index 5178a5ae6..000000000 --- a/iis/develop/windows-web-application-gallery/mediawiki-sample-files/samples/sample3.xml +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md deleted file mode 100644 index 40b698454..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md +++ /dev/null @@ -1,257 +0,0 @@ ---- -title: "Package an Application for the Windows Web Application Gallery" -author: rick-anderson -description: "Introduction The Windows ® Web Application Gallery gives Web site builders an easy way to discover, learn about, and install freely available and community a..." -ms.date: 03/18/2009 -ms.assetid: d88db0b1-a662-47a4-8978-ae8a4042ea2f -msc.legacyurl: /learn/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery -msc.type: authoredcontent ---- -# Package an Application for the Windows Web Application Gallery - -by IIS Team - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -## Introduction - -The Windows® Web Application Gallery gives Web site builders an easy way to discover, learn about, and install freely available and community applications on an Internet Information Services (IIS) Web server. To have your application included in the Gallery, you must add a couple of configuration files to your existing distribution package. - -This article provides everything you need to prepare your application for the Windows Web App Gallery. - -## Packaging Overview - -When users find an application in the Gallery, they want to be able to see that application running on their systems as simply and quickly as possible. Microsoft provides two products to assist users in setting up their environments and applications. - -[Microsoft® Web Platform Installer (Web PI)](https://www.microsoft.com/web/downloads/platform.aspx) is a free tool that makes it simple to download, install, and keep up to date with the latest components of the Microsoft® Web Platform. Web PI is the main interface for the users who are installing applications. It is responsible for ensuring that all of the prerequisite software is installed and configured on the system. Web PI installs and configures applications based on data supplied by the user. The Web Deployment Tool is used by Web PI to install these applications. - -[Web Deploy (Web Deployment Tool)](../../publish/deploying-application-packages/index.md) is a tool for deploying and installing Microsoft®ASP.NET and PHP applications, which are available from the Gallery. Web Deploy is responsible for setting up files and directories, working with the database, setting up file access control lists (ACLs), and substituting user- entered data (parameters) in appropriate places. Most of the information in this article is geared towards helping application developers configure their applications to work with Web Deploy. Web Deploy also has significant capabilities that go beyond the usage described here. - -### Packaging Process - -The following procedure is a summary of the most common process for preparing a working application for inclusion in the Windows Web App Gallery. The steps are described in more detail in the sections that follow. - -1. Review the [Web Application Gallery Principles](windows-web-application-gallery-principles.md). All applications in the Windows Web App Gallery must follow these principles. -2. Read and use this article to create and test a Web Deploy application package. -3. Refer to the article "[Best Practices for PHP on Windows](../../application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform.md)" for guidance in running your PHP application. -4. Submit the package to the Gallery for testing using the [submission form](https://www.microsoft.com/web/gallery/myapps.aspx "submission form"). -5. Resolve any issues with the Application Gallery team. -6. See your application on the [Windows Web Application Gallery](https://www.microsoft.com/web/gallery). - -## Create a Basic Package - -To create your application package, start with a simple Manifest.xml file that describes what is in the package. - -***Tip: A manifest is an XML file that says what your package contains and how to install it. [https://www.iis.net/learn/develop/windows-web-application-gallery/reference-for-the-web-application-package](reference-for-the-web-application-package.md) has more information about format of manifest.xml file.*** - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample1.xml)] - -This manifest will copy the contents of "application" and make it an application in IIS. Include this file in the root directory of your distribution package and your application can be installed by Web PI. In this example, the value of the *path* is used both as the name of the directory in the package where the application files are stored and as the name of the Web site where the application is installed. - -The next step would be to ask the user where they would like to install the application. For this, you use parameters. - -***Tip: The parameters.xml file has a list of parameters (or questions) to ask the user during installation.[https://www.iis.net/learn/develop/windows-web-application-gallery/reference-for-the-web-application-package](reference-for-the-web-application-package.md) has more information about format of parameters.xml file.*** - -By default, the application is installed in a Web site that has the same name as the path element of the iisapp directive in the Manifest.xml file. You must add a parameter similar to this one into your Parameters.xml file. The parameterEntry must have a type of "ProviderPath" and a scope of "iisapp." This parameter is used to ask the user to specify a Web site and application name. - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample2.xml)] - -The **scope** here identifies the type of directive in the Manifest.xml file being parameterized (for example, iisApp), and the **match** contains a regular expression to specify which directive is being modified. The regular expression is evaluated based on the "path" attribute of the "iisApp" provider. - -(Note that users installing applications on IIS 5.1 do not have a choice for the Web site portion of this path. IIS 5.1 only supports a single Web site, which is always "Default Web Site.") - -Here are some tips for creating parameters.xml: - -1. Use regular expressions for TextFile matches: - - Consider this entry in your application package's parameters.xml file: - - [!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample3.xml)] - - This parameter effectively treats config.php as a text file, looks for "putyourdbnamehere" inside the file and replaces it with what the user specifies on install time of the application. Hence in your app's config.php, it replaces the text in the following line:define('DB\_NAME', 'putyourdbnamehere');This prevents config.php from ever being updated again through parametrization, because the string ‘putyourdbnamehere' is no longer present, so the parameter match will no longer work. One downside is that the application will install correctly in Microsoft WebMatrix, but will not be parameterized correctly when the user tries to publish it to a remote location.Instead, you should use regular expressions so config.php can be updated at a future date: - - [!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample4.xml)] - - Notice that the parameter match will continue to work because of the regular expression. -2. Never use parameter type TextFilePosition: This is a deprecated parameter type. TextFilePosition allows you to specify matches at specific character positions. This is an inherently fragile approach, you should use TextFile parameter type with regular expression scope. -3. Constraint parameter scopes as much as possible: Consider this entry in your application package's parameters.xml file: - - [!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample5.xml)] - - The $ at the end of the scope regular expression is important - it indicates that we only want to match files names web.config and not, for example, files named web.config.bak. Constraining parameter scopes in this manner can help avoid unintentional changes to files which are difficult to diagnose. -4. If you store the local application URL in a file or database, parameterize it appropriately. Some applications store a base URL aka Local Application URL in a file or database. For example, a blog application may store `http://localhost:80` in the database and used this as a base URL to generate application-wide URLs. If your application does this, you need to create a parameter and tag it as "AppURL". - - [!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample6.xml)] - - The above parameter will let the user specify a value for Local Application URL for the destination so the application works correctly on the remote server. It works by matching two different regular expressions in database scripts generated by the dbFullSql and dbMySql providers. -5. Tag one-time parameters with "NoStore". Some parameters that are only required to be filled in once e.g. a salt value for generating strong passwords. Such parameters should be tagged as ‘noStore'. Parameters tagged in this manner are not stored in Web Deploy's application definition store and the user will be not be prompted for them when the application is published to a remote server. - - [!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample7.xml)] - - Note that it's okay to use a flat text replace with noStore parameters. - -**Add a Database** - -Most Web applications use a database to store information. Application packages installed through Web PI can support MS SQL or MySQL data stores and run a database script or create a database. To add a SQL database check to your Manifest.xml, add the dbfullsql directive. For MySQL, use dbmysql. - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample8.xml)] - -The Install.sql script would be in the root of the package, and it can contain any SQL script or be empty if all that you want to do is verify that the database is there. You may use as many scripts as your application needs for setup. If you use more than one SQL script, you must specify a database provider in the Manifest.xml file for each one. We require that you use a single set of database credentials for executing all of the scripts. - -The following example shows how to connect to a database that has commonly used parameters stored in the Parameters.xml file. Four of these parameters are used to build the Connection String used for connecting to the database. The Connection String and the four parameters used to build it are all required parameters. - -*NEW* Note that all of the parameters in the examples below have changes from the earlier versions. The most notable changes are: - -- All descriptions have been removed. All of these parameters have default descriptions that are associated with their tags. -- There are additional tags, and many of them are now mandatory. -- The concept of parameter validation is introduced. The comments are greatly expanded for many of the parameters. If you choose to bypass the defaults, some of the detail in the comments might be suitable for descriptions of these parameters - -For more information, see the [Reference for the Web Application Guide](reference-for-the-web-application-package.md). - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample9.xml)] - -For additional information about adding the database, see the article "[Database Notes for packaging applications for use with the Windows Web App Gallery](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md)." - -**Copy Files** - -If your application includes a configuration file that has to be copied to a new name or location before it is set up, you can do that with the **alias** directive in the Manifest.xml file. The paths are both relative to the locations of the files in the package. The destination file is specified as the location where the file would have come from if it was in the original package. - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample10.xml)] - -**Set File and Directory Permissions** - -By default, the WDT installs all files and directories without changing any of the existing permissions. In most cases, this means that the application only has read access to the installed files and directories. If your application needs to be able to write to any file or directory, you can specify which ones with a **setAcl** directive in the Manifest.xml file. The setAclResourceType element defines whether the path represents a file or a directory. - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample11.xml)] - -To ensure that the ACL gets applied to the proper directory, you should also provide a hidden parameter so that the ACL gets applied to the named directory relative to the AppPath where it is installed. - -[!code-xml[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample12.xml)] - -If no ACL is set on a file or directory, the ACL is most likely to be "Read." The ACLs are specific, so granting write access does not necessarily grant read access. If you must write to a file or directory, you should add "Read, Write". If you need to be able to enumerate the files in a directory, you should add "ListDirectory". Note that write access does not grant modify access. If you must change files once they are written to disk, you must explicitly set "Modify" access. There are some permissions that are combinations of other permissions. For example, "Modify" includes "Read," "Write," "Execute," and "Delete." - -Note that it is considered a risky security practice to grant "Write" or "Modify" access to the entire application tree by applying an ACL at the root of the application. ACLs need to be as limiting and granular as possible, while still allowing all required functionality of the application. - -*NEW* If you are familiar with UNIX or Linux style permissions, the privileges being set here are the equivalent of "Owner" permissions. While Group and World privileges can be set through various ACLs outside of the Web Deployment Tool, only "Owner" class permissions are set here. The table below shows the Windows® equivalents of various Linux bit-masked permissions: - -| Linux | Windows | Linux | Windows | -| --- | --- | --- | --- | -| 0 | No equivalent to None | 4 | Read | -| 1 | Execute | 5 | ReadAndExecute | -| 2 | Write | 6 | Read,Write | -| 3 | Write,Execute | 7 | Modify | - -For a full list of the various user rights and their descriptions, see [FileSystemRights Enumeration](https://msdn.microsoft.com/library/system.security.accesscontrol.filesystemrights.aspx). - -For IIS-specific ACL guidance, see the article "[Securing Content in IIS through File System ACLs](../../get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md)." - -The token "anonymousAuthenticationUser" is automatically compared to the ID that the Web Site has configured that is used for anonymous authentication. As this ID is configured by the Web site administrator, it is best to use anonymousAuthenticationUser for PHP applications and no setAclUser for ASP.NET applications, unless your application has a specific need for a user of its own for handling file ownership. - -PHP applications are typically run as the anonymous user because the FastCGI settings usually set the impersonation to be **True**(run as anonymous user). ASP.NET applications typically run as the worker process identity (application pool identity). If **setAclUser** is not specified, then the **setAcl** directive uses the application's Application Pool Identity as the ID for authorization. - -## Pack the Application - -Create a compressed file (Zip) package of the application if you don't already have one. You can create the Zip file with Windows® Explorer, WinZip, or the Linux zip command. The Manifest.xml, Parameters.xml, and Install.sql files all go in the root directory of the package. The rest of your application goes in a sub folder of the root as in the diagram below. - -[!code-console[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample13.cmd)] - -Note that the layout of the subdirectory tree is up to you. This example illustrates where the WDT XML files go for an application, and it is not prescriptive for how your sub tree should look. - -When you have a complete package, you should generate a SHA-1 hash signature of the file. This signature is used by the Web Platform Installer to ensure that the package that gets downloaded onto users' systems is the one you intended it to be. If you don't have a tool for generating a SHA-1 hash, you can get the [Microsoft® File Checksum Integrity Verifier](https://www.microsoft.com/downloads/details.aspx?FamilyID=B3C93558-31B7-47E2-A663-7365C1686C08&displaylang=en). - -*NEW* Note that all packages in the Gallery will be switched to use SHA-1 instead of MD5 hashes. - -## Test Your Package - -You can test your package by using the Web Deployment Tool. You can get the latest release of the Web Deployment Tool using the [Web Platform Installer](/windows/web/). The Web Deployment Tool runs on Windows® XP and later versions of the Windows operating system. Note that the Web Deployment Tool uses the MySQL Connector for .Net 5.2 to communicate with MySQL. You can download this from the [MySQL Web site](http://dev.mysql.com/downloads/connector/net/5.2.html). - -### Use Web Platform Installer - -You can test your package by using Web Platform Installer. You can refer to this guide : [Testing a Web Application Zip Package for Inclusion with the Web Application Gallery](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md) - -### Use the Web Deployment Tool UI - -If you are running on Windows Vista®, Windows® 7, Windows Server® 2008, or Windows Server® 2008 R2, you can use the Web Deployment Tool from within IIS Manager to test your package. For all other versions of Windows, you must use the command-line version for testing. - -1. Always make a backup prior to changing your system. Run the following command to backup an IIS server: - - [!code-console[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample14.cmd)] - - This creates a backup of the `%windir%\system32\inetsrv\config` directory, which contains the main IIS configuration files. If you are testing your package on a server that also has other applications or Web sites running, back up those applications and Web sites prior to starting your testing. -2. Open the IIS Manager by clicking **Start** > **Run**, and then typing: **inetmgr** -3. In **IIS Manager**, expand the **Server** node, expand the **Sites** node, and then select the **Default Web Site**. -4. In the **Actions** pane on the right, click the **Import Application** link to launch the packaging wizard. -5. Select the package that you created. -6. In the Install an Application Package dialog box, you see the application and the database. -7. On the **Parameters** page, review the parameters and their descriptions to make sure that they match your intent and provide enough information for a user to be able to fill them all in. -8. Click **Next** to install the package. -9. The Summarypage provides a high-level overview of some items that were installed from the package. The Detailstab provides details of exactly what was added. - -### Use the Web Deployment Tool Command Line - -You can also test your package by using the Web Deployment Tool at the command prompt. This is the only testing method available on Windows XP and Windows Server® 2003. The simplest way to test your application from the command prompt is by using a batch file that calls the Web Deployment Tool and sets values for the parameters. - -*NEW* Following is the shorthand syntax. - -[!code-console[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample15.cmd)] - -**Batch File Usage Notes** - -The parameter names used match the parameter names from the Parameters.xml file. - -- Ensure that all of the values match your environment. -- Parameters that have DefaultValues defined can be skipped if you want to use the default. -- Parameters that are tagged "Hidden" still must be set if they don't have DefaultValues defined. -- The Web site used in the Application Path must exist before you can run this batch file. -- The Command Prompt session from which you run the script must be run with administrator user rights. -- The '^' at the end of each line tells the batch file processor that the command continues on the next line. - -You can see full documentation of all of the Web Deployment Tool command-line arguments by running msdeploy.exe -help. - -## Submit the Application - -When your package is ready, submit a form to the Windows Web Application Gallery describing your application. - -### CodePlex Notes - -If your application is being hosted on CodePlex, you must have a special URL for your package. This URL looks similar to: - -[!code-console[Main](package-an-application-for-the-windows-web-application-gallery/samples/sample16.cmd)] - -You must substitute the name of your application at the beginning of the URL and the DownloadID for your package in place of the "nnnnn." - -## Next Steps - -If your application has been accepted in to the Gallery, you can provide a direct link on your Web site to your application's Gallery page. In addition, you can provide a link that starts the Web Platform Installer with your application and all of its prerequisites selected to be installed. - -You can learn more about these links and the graphics that are available to use with them in the article "[Using the Microsoft Web Platform Installer Badge](using-the-microsoft-web-platform-installer-badge.md)." - -## Update Your Application - -When you release an update to your application, please follow this procedure: - -1. Advise the Windows Web App Gallery in advance of the new package, if your schedule allows. -2. Do not remove the old version until you receive a confirmation that all links are pointing to the new version. -3. Create and test your new application package. -4. Ensure that the new package has a different name than the previous package. -5. Generate a SHA-1 hash for the new package. -6. Click [here](https://www.microsoft.com/web/gallery/myapps.aspx) to update your existing submission with the following information for the new package: - - - App Version - - URL - - SHA-1 hash - - A link to any Release Notes or Changelog for the update (optional) - - Note that it takes up to a week to test and roll out the new package. You will be informed when all testing has been completed and the new package is live; you may then remove the old package (optional). - -For more information, see the [Reference for the Web Application Guide](reference-for-the-web-application-package.md). - -## Links for Further Information - -- [Windows Web App Gallery](https://www.microsoft.com/web/gallery/). -- [Web App Gallery principles](windows-web-application-gallery-principles.md). -- [Web App Gallery submission form](https://login.iis.net/login/signin.aspx?ReturnUrl=TODO%20-%20get%20the%20URL%20for%20%20%20%20the%20new%20form). -- [Using the Microsoft Web Platform Installer Badge](using-the-microsoft-web-platform-installer-badge.md). -- [Web Platform Installer](/windows/web/). -- [CodePlex.](http://www.codeplex.com/) diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample1.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample1.xml deleted file mode 100644 index 84426a99f..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample1.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample10.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample10.xml deleted file mode 100644 index 1c76bda08..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample10.xml +++ /dev/null @@ -1,3 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample11.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample11.xml deleted file mode 100644 index ad4beaf70..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample11.xml +++ /dev/null @@ -1,5 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample12.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample12.xml deleted file mode 100644 index 87b4eb3d3..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample12.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample13.cmd b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample13.cmd deleted file mode 100644 index dc8d41f6d..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample13.cmd +++ /dev/null @@ -1,14 +0,0 @@ -MyApp.zip -\ - +--MyApp root folder - +--Manifest.xml (required) - +--Parameters.xml (required) - +--Install.sql (provisioning script for the database if you need it) - \ - +--MyApp-admin sub folder - |--MyApp-content sub folder - |--MyApp-includes sub folder - |--readme.txt - |--license.text - |--web.config - |--various other files \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample14.cmd b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample14.cmd deleted file mode 100644 index eda84b73e..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample14.cmd +++ /dev/null @@ -1 +0,0 @@ -%windir%\system32\inetsrv\appcmd add backup "PreMsDeploy" \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample15.cmd b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample15.cmd deleted file mode 100644 index 6d16e1300..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample15.cmd +++ /dev/null @@ -1,10 +0,0 @@ -"C:\Program Files\IIS\Microsoft Web Deploy\msdeploy.exe" ^ - -verb:sync -source:Package="application.zip" ^ - -dest:auto ^ - -setParam:dbAdminUsername="root" ^ - -setParam:dbAdminPassword="" ^ - -setParam:dbUsername="appuser" ^ - -setParam:dbUserPassword="" ^ - -setParam:dbServer="localhost" ^ - -setParam:dbName="application" ^ - -setParam:AppPath="Default Web Site/application" \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample16.cmd b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample16.cmd deleted file mode 100644 index 427a480b1..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample16.cmd +++ /dev/null @@ -1 +0,0 @@ -http://YourApplicationName.codeplex.com/Project/Download/FileDownload.aspx?DownloadId=nnnnn \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample2.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample2.xml deleted file mode 100644 index 7e0d7c9c0..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample2.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample3.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample3.xml deleted file mode 100644 index f9b2dbd93..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample3.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample4.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample4.xml deleted file mode 100644 index e34ecffb8..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample4.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample5.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample5.xml deleted file mode 100644 index 3e9b2dff2..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample5.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample6.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample6.xml deleted file mode 100644 index 1a0e45067..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample6.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample7.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample7.xml deleted file mode 100644 index 699d684c0..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample7.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample8.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample8.xml deleted file mode 100644 index 34087cd4c..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample8.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample9.xml b/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample9.xml deleted file mode 100644 index 02df5179f..000000000 --- a/iis/develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery/samples/sample9.xml +++ /dev/null @@ -1,127 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package.md b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package.md deleted file mode 100644 index b503dddf9..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package.md +++ /dev/null @@ -1,239 +0,0 @@ ---- -title: "Reference for the Web Application Package" -author: rick-anderson -description: "Every application in the Web Application Gallery has at least two XML files that enable the Web Platform Installer (Web PI) to use the Web Deployment Tool (W..." -ms.date: 11/15/2009 -ms.assetid: d0b0d1dc-ce47-409b-8dec-4153f08f483e -msc.legacyurl: /learn/develop/windows-web-application-gallery/reference-for-the-web-application-package -msc.type: authoredcontent ---- -# Reference for the Web Application Package - -by Tali Smith - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -Every application in the Web Application Gallery has at least two XML files that enable the Web Platform Installer (Web PI) to use the Web Deployment Tool (WDT) to deploy the application on Windows® operating systems. These files are the Manifest.xml and Parameters.xml files. In addition, many applications add a SQL script to be run by the WDT as part of the pre-setup installation. PHP applications also include a Web.config file. - -## Manifest.xml - -The Manifest.xml file (or the manifest) is the main file that tells the WDT what to do with an application. It is an XML file made up of "providers". Each of the providers can be modified by user input, which is described in the Parameters.xml file. There should generally be at least one parameter for each provider in the manifest. - -The available providers include: - -- **iisapp** - This is the only required provider in the manifest. The iisapp element has a single required attribute - "path". The path specifies the sub folder within the application package (compressed [Zip] file) that contains the files and directories required for running the application. When the application is installed, the contents of the specified folder are placed in the root of the Web site application folder. -- **dbfullsql** - This provider identifies a connection to a Microsoft® SQL Server® or Microsoft® SQL Server® Express database instance. The "path" attribute is required and identifies a SQL script to be executed against the database. The credentials and database information required to connect to the database are provided by the user through the parameters. The default behavior of this provider is to treat each SQL file as if it were a single database transaction which can be committed or rolled-back as needed. If the contents of your script maintain their own transactions, or have components which must run outside of a transaction, you can specify a "transacted" attribute and set its value to "false". -- **dbmysql** - This provider identifies a connection to a MySQL database engine. The "path" attribute is required and identifies a SQL script to be executed against the database. The credentials and database information required to connect to the database are provided by the user through the parameters. If your SQL scripts contain stored procedures which require you to define a different command delimiter from the MySQL default of a semicolon (;), you can specify the new delimiter with the optional "commandDelimiter" attribute. If you specify a commandDelimiter, you can have it removed from the SQL by specifying a "removeCommandDelimiter" attribute and setting its value to "true". Use removeCommandDelimiter if you are using a delimiter other than a semicolon (;). -- **setacl** - This provider is used to apply an access control list (ACL) to a file or directory. ACLs are used to define the access and permissions that a user or an application has on a file or directory. By default, everything installed by the WDT is installed without changing permissions. In most cases, this means that files will be readable by PHP (and Microsoft® ASP.NET), but not writable. If your application needs additional permissions, you can use this provider to set them. -- **alias** - Alias is used when you need to copy a file from the application package to another name or location. Typically this is used for applications that provide sample configuration files. Prior to the WDT, these applications often required the user to copy the sample file and edit it by hand. With the alias provider, you can have the WDT make the copy and use the parameters to fill in any necessary values. - -## Parameters.xml - -The Parameters.xml file defines the WDT and Web PI interactions with the user. Parameters.xml is an XML file made up of "parameters", presented to the user as a form that needs to be filled out to customize the application installation for the user's environment. Each parameter represents a data item that the WDT needs to collect to perform the installation. These parameters can be used to modify the attributes of a manifest provider or to replace targeted text in any file in the application distribution, or they can be used as components of the value of other parameters. - -The parameters have a number of attributes, including: - -- **name** - This is a required attribute which uniquely identifies the parameter within the scope of the Parameters.xml file. It is also used as the parameter's variable name. -- **friendlyName** - The friendlyName is used by most user interfaces (UIs) as the name above the form element that the parameter defines. If there is no friendlyName defined, the UIs will default to the parameter name. -- **description** - The description provides the caption for the form elements. These are most often used to provide instructions to the user about what is expected for the parameter and how it will be used. -- **defaultValue** - For parameters that are shown to the user, the defaultValue gets placed in the form as a suggestion for the value of the parameter. For parameters that are hidden from the user (see the description of the "hidden" tag below), the defaultValue is used to calculate the value for the parameter. -- **tags** - Tags are a comma-separated list of words or phrases that provide extra information for the WDT and Web PI to categorize a parameter. - -If your parameter is tagged with one of the ten well-known tags from the table below, the UI will automatically provide a friendlyName and description for the parameter. If you specify these elements, you override the defaults. Do not override the defaults unless there is a significant reason to do so. Common parameter tags include: - -- MySqlConnectionString -- SqlConnectionString -- DbAdminPassword -- DbAdminUsername -- DbName -- DbServer -- DbUsername -- DbUserPassword -- IisApp -- SetAcl - -In addition, each parameter can have sub elements that perform various functions. - -### ParameterEntry types - -There are four distinct ParameterEntry types available to specify parameter substitutions, each providing a different way of identifying the target. Three attributes are required for each instance: - -- **type**—specifies the mechanism for identifying the target of the parameter replacement. -- **scope**—identifies the file or component that will be searched for the target. -- **match**—specifies the search parameters for identifying the target - -Each ParameterEntry type has a specific format for defining the scope and the match attributes. The combination of all three elements should always identify at least one match within the application package. You may have as many ParameterEntrys as you need for your application; for more than one type of substitution or more than one target for the substitutions (for example, if two different files both need the substitution), you will need a distinct ParameterEntry element for each one. - -### TextFile ParameterEntry types - -With the TextFile type, the scope is a [regular expression](/dotnet/standard/base-types/regular-expression-language-quick-reference) used to identify a file or set of files to target. The match is a regular expression that represents the string to be replaced. The WDT applies the parameter substitution to all strings that are found by the match in all of the files identified by the scope. When defining regular expressions for TextFile ParameterEntry types, it is important to make sure that you limit both your match and your scope to the most precise expressions you can define. - -TextFile gives you the most reliable method for identifying targets within a file when you have complete control over the source and you are able to define the strings to be targeted. If you do not have complete control over the source, you can use the TextFilePosition parameterEntry type to uniquely identify the target. This most commonly happens with configuration files that have other aspects of the application that expect specific data in both modified and unmodified versions of the file. - -For example, you could specify that a database user name needs to be placed within a SQL script that was written for use with the WDT. The WDT would look for the string "PlaceholderForDbUsername" and substitute the user's parameter input for that string: - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample1.xml)] - -### XmlFile - -Many applications use XML files for data or configuration. All Microsoft® .NET applications, and many PHP applications, use a Web.config file for storing Web site and application configuration information. When identifying a target within a XML file, the most reliable mechanism to use is an XPath query. - -The scope for an XmlFile entry type is defined the same way as for TextFile, using a [regular expression](/dotnet/standard/base-types/regular-expression-language-quick-reference) to identify the target file(s). The match is specified as an [XPath query](/previous-versions/dotnet/netframework-4.0/ms256471(v=vs.100)). An XmlFile entry will replace every existence of a matching XPath in a file. This will frequently mean that you need a detailed XPath query to make sure you replace only the targeted match. - -For example, an application might have a SQL connectionString in a Web.config file. There may be more than one connectionString in the file to allow for different database types: - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample2.xml)] - -You could use the generated connection string parameter in the following example to replace the value in the configuration file with the values that the user entered. In this case, the XPath query searches from the root of the XML file following the element path in the query for the first "add" element under the "connectionStrings" element under the "configuration" element with an attribute of "name" that equals "SqlServerDbConnection". It then replaces the value of the "connectionString" attribute of that element with the parameterized value. - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample3.xml)] - -For more information, see the [XPath Syntax](/previous-versions/dotnet/netframework-4.0/ms256471(v=vs.100)) article. - -### ProviderPath - -The ProviderPath type is used for applying parameters to providers specified in the Manifest.xml file. When you are developing your application package, you cannot know all of the specifics about your users' system environments. So when you specify each of the providers, you associate defaults for each one that matches the expectations of the provider type. There will frequently be one ParameterEntry element in the Parameters.xml file for each directive in the Manifest.xml file. - -The scope of a ProviderPath entry refers to the type of provider being parameterized. The match specifies a regular expression that uniquely identifies the value of the "path" attribute for that provider element. The table below describes the substitutions for each of the providers that are allowed in the manifest. - -| Provider | Element that the parameter is applied to | Default Value | Replacement Value | -| --- | --- | --- | --- | -| iisApp | path | The specified path, which matches the name of the folder in the package that contains the application's files and folders | The path is replaced with the file system path to the directory where the application's files and folders will be installed. This is usually specified as the parameter named "Application Path" with a "iisApp" as one of the tags. | -| setAcl | path | The specified path, which matches the path to the file or folder in the package to which the ACL is applied | The path is replaced with the value for the parameter that identifies the setAcl provider. SetAcl parameters usually have "hidden" as one of their tags. The values are constructed by setting a defaultValue which uses the "Application Path" parameter with the rest of the path to the file or directory appended. | -| dbFullSql and dbMySql | connectionString - unspecified attribute | The specified path, which matches the path and name of the SQL file to execute as part of the installation | The connectionString is replaced with one constructed in the Parameters.xml file. This parameter is usually hidden and built from other parameters that identify the database and the credentials for connecting to it. The WebPI and the WDT will provide an intelligent UI for building connection strings when all of the relevant parameters are specified. If there is no matching parameter, the connectionString will remain blank, which will mean the database connection will be made to the system's defaults. | - -### TextFilePosition ParameterEntry type - -There may be times when using a regular expression to replace a text string in a file may not be precise enough. For example, there may be a string that you want to replace in one portion of the file but not in another. Or you may not be able to use a regular expression to uniquely identify the string to be changed. For those situations, you can use the TextFilePosition ParameterEntry type. - -The scope for a TextFilePositionEntry type is defined the same way as for TextFile, using a [regular expression](/dotnet/standard/base-types/regular-expression-language-quick-reference) to identify the target file(s). The match is specified as a series of three integers separated by semicolons (;). The first integer specifies the line number in the file. The second integer specifies the number of characters from the beginning of the line. The third integer specifies the number of characters to replace. You do need to be careful when specifying your target, as the parameter replacement will extend beyond the end of a line if the match numbers specify a target that would include end-of-line characters within the target length. - -For example, you could specify that the database user name from the TextFile example also needs to be included in a configuration file. The target in this file cannot be uniquely identified with a regular expression. Using TextFilePosition, we can target the specific string in the file based on its location instead of its content. - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample4.xml)] - -## Parameter Tags - -Parameter Tags are used to tell various UIs how to display and use parameters. Some of these tags are mandatory in certain situations. The descriptions that follow specify when specific tags are mandatory and how the tags should be used. - -- **iisapp**- This identities a parameter as the application path to install the application. The defaultValue will be displayed by most installers. The defaultValue should be set to something like "Default Web Site/application1", where "Default Web Site" is the default Web site for the server and "application1" is the subdirectory under that Web site. Web PI and other installers will use this data to suggest a Web site location for the installation when they don't already know where the user wants to install the application. This is a required tag. There must be at least one parameter that has this tag and that specifies the iisApp provider as its target. - - > [!NOTE] - > On IIS 5.1, the Web site portion of this will always be "Default Web Site". The user will be able to select a directory under the default for the Web site to keep applications separate. - -- **Hidden**- A Hidden parameter is not shown to the user as part of the installation UI. A Hidden parameter must have a defaultValue set. These parameters are used either to set a hard-coded default value or to set a computed default value. Hard-coded defaults are sometimes used when establishing a parameter for future use. Computed values are used to construct a parameter's value from other parameters. When constructing computed values, you can refer to other parameters by putting the other parameter name surrounded by {}s in the place you want the value. Please refer to the "Connection String" parameter in the example for a common usage of this tag. -- **SQL or MySQL**- These parameters are used in relation to a specific database. If the manifest contains parameters for both SQL and MySQL, the UI can choose which database to use and the user will only be presented with parameters relevant for that database. -- **Password**- This identifies a field that will be used as a password that is already known. The UI will hide the value of that password. -- **New**- When used together with the Password tag, this identifies a field that will be used to set a new password. The UI will hide the value of the password and ask the user to confirm it (for example, "New,Password"). -- **dbUsername, dbUserPassword, dbAdminUsername, dbAdminPassword, dbServer, dbName**- Some UIs that install application packages will handle the database creation themselves. In the case where the user already has a database created, the UIs will seamlessly hide and fill in the administrative credentials correctly to avoid requiring the user to enter data two times. These tags identify the parameters that must be modified if the UI will handle database creation. - - > [!NOTE] - > If there is a SQL or MySQL provider in the Manifest.xml, then there must be six parameters in the Parameters.xml file, and each parameter must have one of these tags. - -- **SQLConnectionString, MySQLConnectionString**- This identifies that a field (usually a Hidden one) is being used as a connection string to a database. Some UIs will use the connection string in conjunction with the dbXxxx tags above to display a specific dialog box. -- **Validate**- Validate is only allowed when specified with one of the connection string tags. Validate specifies a connection string that must be valid for the installation to succeed and for any SQL scripts to run as part of the installation. UIs will have a choice on how they want to implement this function. The Web PI will validate the database credentials before allowing the user to proceed through the rest of the installation. -- **VistaDB, SQLite, FlatFile** - These tags identify a parameter that is used with these flat file data types. There is no corresponding provider in the Manifest.xml file for these. The WebPI and other UIs will recognize these tags in the Parameters.xml file. If there is more than one type of database tag (for example, SQL, MySQL, SQLite, and VistaDB all in the same Parameters.xml file), the UI will present the user with a choice of database engines for the application. When the user selects the database engine, all parameters that are tagged for a different engine and not the selected one will be bypassed. - -## Parameter Validation - -There are several types of parameter validation that are available. If none of these are specified, the user is presented with a simple text box to enter the parameter's value: - -- **AllowEmpty** - Most UIs will require a value for all parameters that are not hidden. You can specify a validation type of "AllowEmpty" to instruct the UI that a blank or empty value is acceptable. AllowEmpty can be used in conjunction with any of the other parameter validation types, or on its own. The syntax for AllowEmpty is: - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample5.xml)] - -- **Boolean**- Boolean parameters are simple True / False questions. Depending on the UI, the user might be presented with a check box or two option buttons to select their choice. Booleans replace values in the same way as other parameters. For Booleans, the replacement value is either "True" or "False". If you need to have Boolean values other than "True" or "False", use an enumeration with only two values. The syntax for Booleans is: - - [!code-xml[Main](reference-for-the-web-application-package/samples/sample6.xml)] - -- **Enumeration**- Enumeration allows you to limit the user's input to a list of discrete possible values. Most UIs will implement this as a drop-down list box, where the user will have the ability to choose one value from the list. Any whitespace in the validationString will be included as part of the possible values. Therefore, there should be no whitespace on either side of a comma, unless you want that whitespace to be included in the parameter substitution. The syntax for Enumeration is: - - [!code-xml[Main](reference-for-the-web-application-package/samples/sample7.xml)] - - Currently, there is no way to escape a comma (,) so that it may be included as part of one of the values of an enumeration. - -- **Regular Expression**- With Regular Expression validation, the user is presented with a simple text box the way a non-validated parameter would be. Then, when the user goes to submit the form and move on to the next part of the installation, the entry in the text box will be compared to the validationString in the RegularExpression. For more information about specifying a regular expression, see [Regular Expression Language - Quick Reference](/dotnet/standard/base-types/regular-expression-language-quick-reference) or the [Regular Expressions Info Web site](http://www.regular-expressions.info/tutorial.html). The syntax for Regular Expression validation is: - - [!code-xml[Main](reference-for-the-web-application-package/samples/sample8.xml)] - - For Regular Expressions, even if you specify a RegEx that allows for empty values, most UIs will require a value anyway. To specify that a value can be blank, or empty, add 'allowEmpty' to the type of the 'parameterValidation', as in the example below: - - [!code-xml[Main](reference-for-the-web-application-package/samples/sample9.xml)] - -The regular expressions in the two previous examples are explained here: - -- `.+` - Specifies that the parameter entry *must* contain at least one of any type of character. Alternatively, use **".\*"** to specify that the parameter entry *may* contain at least one of any type of character, which means that it can be empty. -- `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}$` - This is a simple e-mail address validation expression. It does not catch every incorrect address, but it catches most. This regular expression does not allow blank or empty parameters. However, since "allowEmpty" was included in the "type" attribute, empty parameters will be accepted. - -## Database Credentials Validation - -If your application package contains a SQL Server or MySQL database provider, you can specify a set of database credentials to be validated by the UI prior to other steps in the installation process. Web PI will validate the tagged connection string when all of the parameters have been filled out for the application and the user presses the Next button. This validation consists of Web PI using the provided credentials to connect to the specified database and server. If the validation fails, the user will be informed and returned to the previous screen to update the database parameters as needed. Other UIs will provide some mechanism, such as a validate button or a validation dialog, to perform a similar function. The parameter to use for the validation is identified with the "Validate" tag. - -## Parameter Internationalization - -Web PI and the Web Deployment Tool are available in versions localized for ten languages, including English and the following: - -- Japanese -- Spanish -- German -- French -- Italian -- Korean -- Russian -- Chinese (China) -- Chinese (Taiwan) - -If Web PI detects that the user's system default location is something other than "en", the user will be presented with parameters using the user's system locale, for every parameter that has a translation available. - -The WDT has translations for the "friendlyName" for each parameter, which is used as the parameter's caption. The WDT also has translations for the "description" for each parameter, which is displayed below the caption to inform the user of the purpose of the parameter. - -Certain parameters are translated automatically into one of those languages based on the user's system language. The parameters that are automatically translated are ones that have one of the tags in the table below. Note that if there is a "description" or "friendlyName" attribute present in the parameter, the translation of that parameter will not occur. - -- MySqlConnectionString -- SqlConnectionString -- DbAdminPassword -- DbAdminUsername -- DbName -- DbServer -- DbUsername -- DbUserPassword -- IisApp -- SetAcl - -For the ten well-known parameters above, best practice is to use the parameter descriptions and friendly names that the WDT automatically generates. This leads to a more consistent experience for users and lets your application take advantage of additional languages as they are added. If necessary, specify your own translations for any of those parameters or for any parameters that do not have a default translation. This is done by providing alternate descriptions and friendlyNames in the parameter elements of the Parameters.xml file. The default description for a parameter is provided as one of the attributes of the parameter element, while the translations are provided as distinct elements. For example: - -[!code-xml[Main](reference-for-the-web-application-package/samples/sample10.xml)] - -In the example, note: - -- The UI displays the description where the "culture" attribute matches the system locale. If there is no specific match, the UI will display the default description. -- When only the language is specified (as in the case of "de" above), all cultures that include "de" as their language component will use that translation (for example, "de-DE" and "de-AT"). -- iisApp is one of the 10 automatically translated parameters; do not specify translations for this parameter unless the default translations were insufficient for your needs. -- Specify translations for both the "friendlyName" and the "description". If you do not specify a friendlyName, the UI will use the parameter name in all cases. - -For a table of common International Organization for Standardization (ISO) culture codes, see the [Table of Language Culture Names, Codes, and ISO Values Method [C++]](/previous-versions/commerce-server/ee825488(v=cs.20)). - -## xxxx.sql - -An application package can have any number of SQL scripts that will be executed as part of the installation package. These SQL scripts can contain any valid commands for the specified database engine, including all DDL, DML, and stored procedures. For details about the WDT interaction with the database, see the article "[Database Notes for packaging applications for use with the Web Application Gallery](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md)." - -## Web.config - -A Web.config file can be placed at any level in an application's directory tree. To learn more about the Web.config file, see the [IIS 7.0 Configuration Reference](../../configuration/index.md). - -## Integration Samples - -Samples of Web App Gallery integration are available for reference. - -> [!NOTE] -> *This article is based on information from "[Application Packaging Guide for the Windows Web Application Gallery](package-an-application-for-the-windows-web-application-gallery.md)" by the IIS team, published on September 24, 2009*. - -## See also - -- [Regular Expression Language - Quick Reference](/dotnet/standard/base-types/regular-expression-language-quick-reference) -- [XPath syntax](/previous-versions/dotnet/netframework-4.0/ms256471(v=vs.100)) -- [Table of Language Culture Names, Codes, and ISO Values Method [C++]](/previous-versions/commerce-server/ee825488(v=cs.20)) -- [Web App Gallery Integration Samples](http://www.iis.net/learn/develop/windows-web-application-gallery) -- [IIS 7.0 Configuration Reference](../../configuration/index.md) -- [Database Notes for packaging applications for use with the Web Application Gallery](database-notes-for-packaging-applications-for-use-with-the-web-application-gallery.md) diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample1.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample1.xml deleted file mode 100644 index dc7111c6b..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample1.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample10.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample10.xml deleted file mode 100644 index a13391173..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample10.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - Full site path where you want to install your application (for example, Default Web Site/Application). - Vollständiger Pfad, unter dem Sie Ihre Anwendung installieren möchten (z.B. Standardwebsite/Anwendung). - Application Path - Anwendungs Pfad - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample2.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample2.xml deleted file mode 100644 index a372f96a3..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample2.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample3.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample3.xml deleted file mode 100644 index ed7e5c7db..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample3.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample4.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample4.xml deleted file mode 100644 index 7d9df8ab3..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample4.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample5.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample5.xml deleted file mode 100644 index da817ed51..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample5.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample6.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample6.xml deleted file mode 100644 index b9e32119b..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample6.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample7.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample7.xml deleted file mode 100644 index 3a95c9292..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample7.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample8.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample8.xml deleted file mode 100644 index 0f3737d00..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample8.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample9.xml b/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample9.xml deleted file mode 100644 index c4c72868b..000000000 --- a/iis/develop/windows-web-application-gallery/reference-for-the-web-application-package/samples/sample9.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md deleted file mode 100644 index 08a474013..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery.md +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "TTesting a Zip Package for Inclusion with the Web Application Gallery" -author: rick-anderson -description: "The Web Application Gallery makes it easy for Windows users to find and deploy a free open source, community application onto a computer running Windows XP o..." -ms.date: 12/14/2009 -ms.assetid: 6f721a96-8210-4e2a-a110-09103f8f0b98 -msc.legacyurl: /learn/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery -msc.type: authoredcontent ---- -# Testing a Zip Package for Inclusion with the Web Application Gallery - -by [Mai-lan Tomsen Bukovec](https://twitter.com/mailant) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -The [Web Application Gallery](https://www.microsoft.com/web/gallery) makes it easy for Windows users to find and deploy a free open source, community application onto a computer running Windows XP or later. To learn more about how to build Web Deploy support for a zip package so that the application can be included in the Web Application Gallery, read the [Package An Application for the Web Application Gallery](package-an-application-for-the-windows-web-application-gallery.md) guide or view the [Adding Web Deployment Tool Support to Community Application ZIP Packages videocast](https://blogs.iis.net/mailant/archive/2009/05/04/real-world-iis-adding-web-deployment-tool.aspx). Once you have build Web Application Gallery integration for your zip package, you can test the Web Application Integration using [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx). - -Both the Web Application Gallery and the Web Platform Installer consume the same application and product feeds. The Web Platform Installer also orchestrates every deployment from the Web Application Gallery. As a result, you can test the deployment experience from the Web Application Gallery by using the Web Platform Installer and local feeds modified to contain the location of the application package that you want to test. Once you get done with the application testing, you can submit your application link to the Web Application Gallery team on the [Web Application Gallery developers site](https://www.microsoft.com/web/gallery/developers.aspx). - -You can take two different approaches to test your application package in your computer: - -1. Modify a local copy of the live xml feeds. You may want to use this approach if: - - - You have already published your application in the Web Application Gallery, and - - You only need to modify a few fields in the feed xml (installer url, version, and sha-1 hash), and - - You want to test a new updated package of your application following the end-to-end user experience that your users will see when using the Web Platform Installer. -2. Create a custom feed. You may want to use this approach if: - - - You want to build and maintain your own custom feed file. - - You want to avoid making changes to the feeds that will drive all of the Web Platform Installation. - -Details for each of the two approaches follow. - -## Test by modifying a local copy of the live XML feeds - -To test your application package locally by modifying a copy of the live XML feed files, follow these steps: - -#### Step 1. Download the Web Platform Installer - -The Web Platform Installer orchestrates the installation of applications from the Web Application Gallery, and is the tool you use to validate local feeds with your modified zip package. You can down the Web Platform Installer from: [https://www.iis.net/extensions/webpi](https://www.microsoft.com/web/downloads/platform.aspx).If you already have Web Platform Installer installed, please make sure it is the latest version of Web Platform Installer. - -#### Step 2. Download Web Application Gallery feeds locally. - -Download the two WebPI feeds to your computer: - -- WebProductList.xml: [https://www.microsoft.com/web/webpi/4.2/WebProductList.xml](https://www.microsoft.com/web/webpi/4.2/WebProductList.xml). This XML feed contains the products and application dependencies for Web Platform Installer. -- WebApplicationList.xml: [https://www.microsoft.com/web/webpi/4.2/WebApplicationList.xml](https://www.microsoft.com/web/webpi/4.2/WebApplicationList.xml). This XML feed contains the information for all applications in the Web App Gallery. - -#### Step 3. Make Sure the Local XML Feeds Can Talk to Each Other - -In the WebProductList.xml feed, look for the reference to WebApplicationList.xml. Change the location to point the location that you installed WebApplicationList.xml on your local computer. - -##### Example: - -[!code-html[Main](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample1.html)] - -Save the change. - -#### Step 4. Modify the Local WebApplicationList.XML Feed to Point to the New Application Package - -Next, you'll have to modify the WebApplicationList.xml to point to your new zip package xml file for testing. You will be eidting the XML entry for an application that would be similar to yours or, if your package is already included in the Web Application Gallery, the XML entry for your existing application. - -When you find "<productId>SimilarApp</productId>", you will see a child <entry type="application"> element. Within this element,look for the <installerURL> element. - -##### Example - -[!code-xml[Main](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample2.xml)] - -Change the location within that element to point to your local application zip package. - -##### Example - -[!code-xml[Main](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample3.xml)] - -You will also need to find the <sha1> element and change it to the new hash value or remove it. If you forget this step, your application testing will fail based on mismatched hash values. - Save the changes. - -#### Step 5. Set Up the Test Environment with Dependencies - -When a user installs an application from the Web Application Gallery, the Web Platform Installer will check the user's machine for application dependencies. If the user's machine is missing an application dependency, such as FastCGI for PHP applications, Web Platform Installer will take care of installing those dependencies. However, the Web Platform Installer test feed configuration does not support application dependency installations; the test feed configuration assumes all dependencies are present. - -As a result, when you are testing your application install in a clean machine, you will have to install application dependencies yourself. There are two ways to simplify the installation of application dependencies in your test feed environment: - -1. You can use the Web Platform Installer to install Internet Information Services (IIS), FastCGI 1.0, Web Deployment Tool 1.0, and other dependencies for your application like SQL Express. -2. You can install a similar application from Web Platform Installer or Web Application Gallery. For example, if you are testing a PHP application and want to set up a clean machine with the right dependencies, you can install another PHP application from the Web Application Gallery. That installation process will automatically install and configure the right dependencies on your computer for PHP application testing. - -Once you have the test environment configured, you are ready to run Web Platform Installer against your local modified feed. - -#### Step 6. Run Web Platform Installer Against Local Feed - -Follow these steps so that Web Platform Installer will point to the local feed when it loads: - -- Click on Start -> Run -- Type 'regedit' and Click OK -- Under HKEY\_LOCAL\_MACHINE\Software\Microsoft\Webplatforminstaller, add a string key "ProductXmlLocation" and let it point to the local copy of Webproductlist.xml -- Close any instances of Web Platform Installer -- Launch Web Platform Installer -- Click on 'Options' to select IIS or IIS Express (Web Matrix) and Click OK -- Look for the application you are testing and Click on Add -- Click on Install - - Web Platform Installer will now install the test application package onto IIS or Web Matrix. - -## Test by creating a custom feed - -To test your application package locally by modifying a copy of the live XML feed files, follow these steps (for more details see: [https://blogs.iis.net/kateroh/archive/2009/10/24/web-pi-extensibility-custom-feeds-installing-custom-products.aspx](https://blogs.iis.net/kateroh/archive/2009/10/24/web-pi-extensibility-custom-feeds-installing-custom-products.aspx)): - -#### Step 1. Create a new custom feed XML file - -Use the example below to create the custom feed XML file. This example illustrates: - -- How to add applications with ASP.NET/SQL and PHP/MySql dependencies, -- Create a new tab and subtabs based on keywords, -- Group products together and hint Web PI that your product is available in different languages. - -Notice that you have to define a new custom tab for your custom products, since they cannot to be added to Web PI core tabs. - -[!code-html[Main](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample4.html)] - -You can delete the <entry type="application"> element that do not correspond to the type of application you are interested in. Also, if you have already published your application in the Application gallery, you could copy your application's <entry type="application"> from the live feed: [https://www.microsoft.com/web/webpi/4.2/WebApplicationList.xml](https://www.microsoft.com/web/webpi/4.2/WebApplicationList.xml). - -Notice how applications are grouped based on keywords: xml element <keywords>. - -#### Step 2. Enter the Installer URL for your zip package - -In the custom feed file, locate the <installerURL> element and provide the path for your zip package, if it in located in the local file system use "file://" instead of "http://" - -##### Example - -[!code-xml[Main](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample5.xml)] - -#### Step 3. Enter the new SHA-1 hash - -In the custom feed file, locate <sha1> and substitute the value for the corresponding hash for your zip package. You can get a hash of your zip package, by using a free utility called [File Checksum Integrity Verifier (FCIV)](https://www.lifewire.com/how-to-download-and-install-file-checksum-integrity-verifier-fciv-2625185) and running fciv.exe -sha <path to your zip package> from the command prompt. - -#### Step 4. Test your custom feed file - -Now, you can try the custom feed file by saving it locally or storing it in a web server, and opening the Options dialog and adding a feed through either a physical path or URL. - -![Screenshot of the Change Options Window.](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image1.png) - -![Screenshot of Change Options Window under Display Additional Scenarios removes sample X M L.](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image3.png) - -You should be able to click in the new tab and see your application in it. - -![Screenshot of Web Platform Installer displaying Sample Applications tab.](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image5.png) - -![Screenshot of Sample Applications tab with chosen application highlighted.](testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image7.png) - -From here you can select your application and proceed with the installation. diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image1.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image1.png deleted file mode 100644 index 79849804d..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image1.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image2.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image2.png deleted file mode 100644 index 79849804d..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image2.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image3.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image3.png deleted file mode 100644 index 6c265a3a3..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image3.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image4.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image4.png deleted file mode 100644 index 6c265a3a3..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image4.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image5.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image5.png deleted file mode 100644 index bec533520..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image5.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image6.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image6.png deleted file mode 100644 index bec533520..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image6.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image7.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image7.png deleted file mode 100644 index 33da2e175..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image7.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image8.png b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image8.png deleted file mode 100644 index 33da2e175..000000000 Binary files a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/_static/image8.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample1.html b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample1.html deleted file mode 100644 index 6fa78c5d3..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample1.html +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample2.xml b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample2.xml deleted file mode 100644 index 4dafc5b00..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample2.xml +++ /dev/null @@ -1 +0,0 @@ -http://site.org/app1.0.zip \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample3.xml b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample3.xml deleted file mode 100644 index ab708ddcc..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample3.xml +++ /dev/null @@ -1 +0,0 @@ -file://C:/wag/app1.0.zip \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample4.html b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample4.html deleted file mode 100644 index 67ac577f1..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample4.html +++ /dev/null @@ -1,198 +0,0 @@ - - - - 1.0.0 - Sample Applications for WebPI v2 RTW Feed - - 2009-10-5T16:30:00Z - - Sample Application Builder - http://www.contoso.com/ - - http://www.contoso.com/SampleApplicationsFeed.xml - - - - Sample_ASPNET_SQL_App - Sample ASP.NET and SQL application - ASP.NET and SQL application sample - Sample ASP.NET and SQL to show how to add a feed with a custom ASP.NET application to WebPI and define all dependencies. - - - - ASPNETApps SQL - - - 1.0 - - c:\SampleASPNETAppIcon.jpg - - - 2009-10-5T18:30:02Z - 2009-10-5T18:30:02Z - - - Sample Application Builder - http://www.contoso.com - - - - - - SQLExpress - - - - - - - - SMO - - - WDeployNoSMO - - - UrlRewrite2 - - - - - - - - 1 - - en - ko - es - zh-tw - zh-cn - - - - 1024 - http://www.contoso.com/SampleASPNETApplication.zip - http://www.contoso.com/SampleASPNETApplication.aspx - - 1223334444555556666667777777888888889999 - - http://www.contoso.com/SampleASPNETApplicationForum.aspx - - - - Setup.aspx - - - - - - - - - Sample_PHP_MySQL_App - Sample PHP and MySQL application - PHP and MySQL application sample - Sample PHP and MySQL to show how to add a feed with a custom PHP application to WebPI and define all dependencies. - - - - PHPApps - MySQL - - - 1.0 - - c:\SamplePHPAppIcon.jpg - - - 2009-10-5T18:30:02Z - 2009-10-5T18:30:02Z - - - Sample Application Builder - http://www.contoso.com - - - - - - MySQL - - - - - - - - WDeployNoSMO - - - PHP53 - - - MySQLConnector - - - UrlRewrite2 - - - - - - - - 1 - - en - ru - fr - de - it - - - - 1024 - http://www.contoso.com/SamplePHPApplication.zip - http://www.contoso.com/SamplePHPApplication.aspx - - 1223334444555556666667777777888888889999 - - http://www.contoso.com/SamplePHPApplicationForum.aspx - - - - - - - - - - - - - SampleApplications - Sample Applications - Select from sample applications: - - - - ASPNETApps - PHPApps - - - - - - - - ASP.NET Apps - PHP Apps - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample5.xml b/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample5.xml deleted file mode 100644 index ab708ddcc..000000000 --- a/iis/develop/windows-web-application-gallery/testing-a-web-application-zip-package-for-inclusion-with-the-web-application-gallery/samples/sample5.xml +++ /dev/null @@ -1 +0,0 @@ -file://C:/wag/app1.0.zip \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files.md b/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files.md deleted file mode 100644 index 76e21fd28..000000000 --- a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Umbraco CMS Sample files" -author: SunBuild -description: "This is a set of sample files you could use with Umbraco CMS 5 and the Web Deployment tool for deploying Umbraco against a SQL Express/SQL Azure database or..." -ms.date: 02/08/2012 -ms.assetid: 1114e4dc-e2ea-4932-a616-745230baa1a8 -msc.legacyurl: /learn/develop/windows-web-application-gallery/umbraco-cms-sample-files -msc.type: authoredcontent ---- -# Umbraco CMS Sample files - -by [Sunitha Muthukrishna](https://github.com/SunBuild) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with Umbraco CMS 5 and the Web Deployment tool for deploying Umbraco against a SQL Express/SQL Azure database or SQL CE database. - -## Sample manifest.xml file - -[!code-xml[Main](umbraco-cms-sample-files/samples/sample1.xml)] - -## Sample parameters.xml file - -[!code-xml[Main](umbraco-cms-sample-files/samples/sample2.xml)] - -## Sample createlogin.sql Script - -[!code-console[Main](umbraco-cms-sample-files/samples/sample3.cmd)] - -## Sample createlogin.sql Script - -[!code-sql[Main](umbraco-cms-sample-files/samples/sample4.sql)] diff --git a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample1.xml deleted file mode 100644 index 75a087141..000000000 --- a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample1.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample2.xml b/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample2.xml deleted file mode 100644 index 0ea792569..000000000 --- a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample2.xml +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample3.cmd b/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample3.cmd deleted file mode 100644 index 1c1a41084..000000000 --- a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample3.cmd +++ /dev/null @@ -1,11 +0,0 @@ -/**********************************************************************/ -/* CreateLogin.SQL */ -/* Creates a login */ -/* This scripts runs on master to create login */ -/* Supports SQL Server and SQL AZURE */ -/**********************************************************************/ - --- Add here a test to be sure the login does not exist --- Create login - -CREATE LOGIN PlaceHolderForUser WITH PASSWORD = 'PlaceHolderForPassword' \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample4.sql b/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample4.sql deleted file mode 100644 index 128173e59..000000000 --- a/iis/develop/windows-web-application-gallery/umbraco-cms-sample-files/samples/sample4.sql +++ /dev/null @@ -1,19 +0,0 @@ -/**********************************************************************/ -/* CreateUser.SQL */ -/* Creates a user and makes the user a member of db roles */ -/* This script runs against the User database */ -/* Supports SQL Server and SQL AZURE */ -/**********************************************************************/ - --- Create database user and map to login --- and add user to the datareader, datawriter, ddladmin and -securityadmin roles --- - -CREATE USER PlaceHolderForUser FOR LOGIN PlaceHolderForUser; -GO -EXEC sp_addrolemember 'db_ddladmin', PlaceHolderForUser; -EXEC sp_addrolemember 'db_securityadmin', PlaceHolderForUser; -EXEC sp_addrolemember 'db_datareader', PlaceHolderForUser; -EXEC sp_addrolemember 'db_datawriter', PlaceHolderForUser; -GO \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/using-the-microsoft-web-platform-installer-badge.md b/iis/develop/windows-web-application-gallery/using-the-microsoft-web-platform-installer-badge.md deleted file mode 100644 index eda8d5efc..000000000 --- a/iis/develop/windows-web-application-gallery/using-the-microsoft-web-platform-installer-badge.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Using the Microsoft Web Platform Installer Badge" -author: rick-anderson -description: "Developers of applications have the ability to provide a link on their sites which will be able to launch the Web Platform Installer with their application a..." -ms.date: 05/26/2009 -ms.assetid: e4113e68-c5a0-4cea-b4f2-ecb0397e78fa -msc.legacyurl: /learn/develop/windows-web-application-gallery/using-the-microsoft-web-platform-installer-badge -msc.type: authoredcontent ---- -# Using the Microsoft Web Platform Installer Badge - -by Steve Jacobson - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -Developers of applications have the ability to provide a link on their sites which will be able to launch the Web Platform Installer with their application and all prerequisites ready to install. To take advantage of this feature, developers should link to the badge in this document. - -The link associated with the badge should be in the following format and will be available to use once the application is available in Web Platform Installer. Note the URL must include the Application ID that you entered when submitting the application to the Gallery - -Link: `https://www.microsoft.com/web/gallery/install.aspx?appid=` - -Image URL: `[https://www.microsoft.com/web/media/badge/install\_using\_webpi\_btn.png](https://www.microsoft.com/web/media/badge/install_using_webpi_btn.png)` - -Width: 195px - -Height: 43 px - -`![Install Using WebPI Badge](https://www.microsoft.com/web/media/badge/install_using_webpi_btn.png "Install Using WebPI Badge")` diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md deleted file mode 100644 index 2f57fa430..000000000 --- a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: "Windows Web Application Gallery: Known Issues" -author: rick-anderson -description: "Introduction With just a few mouse clicks the Windows Web Application Gallery lets you select, download and install popular web applications like blogs, cont..." -ms.date: 03/18/2009 -ms.assetid: 9ac68e1c-b377-4696-bde0-c44fe46750b5 -msc.legacyurl: /learn/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues -msc.type: authoredcontent ---- -# Windows Web Application Gallery: Known Issues - -by IIS Team - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -## Introduction - -With just a few mouse clicks the Windows Web Application Gallery lets you select, download and install popular web applications like blogs, content management systems, wikis or media galleries. This dramatically simplified installation process comes with a few gotchas that are called out in the following article. - -## Web Platform Installer Issues - -The following paragraphs describe problems you might run into when using the Web Platform Installer. - -### Empty Password Fields - -Web Platform Installer 2.0 doesn't allow empty passwords even if you don't want to use a password for your database or application. The following message is shown. - -![Screenshot showing the empty password dialog with OK selected.](windows-web-application-gallery-known-issues/_static/image27.png) - -The easiest way to work around this issue is to use a password for your database. - -### Creating New Web Sites - -If you want to create a new web site for your web application you need to create a physical directory for your new site. The Web Platform Installer doesn't create web site directories automatically. You have to specify an existing path if you select "New Web Site..." in the following dialog: - -![Screenshot of the Install Application window with physical path circled.](windows-web-application-gallery-known-issues/_static/image31.png) - -### Other Web Platform Installer Issues - -For other Web Platform Installer issues, for example if Web Platform Installer can't connect to the list of applications due to connectivity issues, read the following article for more details: - -[https://www.iis.net/learn/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer](../../troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md) - -## Issues with Databases - -### SQL Server Issues - -#### Strong Password - -Web Platform Installer prompts for a SQL Server sa password if SQL Server 2008 Express is installed by the Web Platform Installer as part of a web application. The SQL Server password needs to be a strong password and the SQL Server Express 2008 install can fail in certain cases if a weak password is used. Here is an article how to generate a strong password: - -`https://support.microsoft.com/kb/965823` - -#### Authentication Mode - -All Web Applications installed by the Web Platform Installer which have a SQL Server dependency require SQL Server to run in Mixed Mode Authentication also known as "SQL Server and Windows Authentication mode". Here is a link to an article how to change the SQL Server authentication mode: - -*[https://msdn.microsoft.com/library/ms188670.aspx](https://msdn.microsoft.com/library/ms188670.aspx)* - -#### SA login disabled - -Administrators often want to use the built-in SA account to administer SQL Server. This account is still disabled even if Mixed Mode authentication is enabled. The same article explains how to enable the SA account: - -[https://msdn.microsoft.com/library/ms188670.aspx](https://msdn.microsoft.com/library/ms188670.aspx) - -#### SA account doesn't work when "Existing Database" is selected. - -The SA account cannot be used when you choose "Existing Database" in a Web Platform Installer installation that has a SQL Server dependeny. The script that is run will try to add sa to the database and because the SA account already exists the script will fail. SA is a special account and the script will fail. - -![Screenshot of the Install Application window with Create new circled and an arrow pointing to the Database username example.](windows-web-application-gallery-known-issues/_static/image37.png) - -## Web Application Issues - -The following paragraphs describe known issues with web applications in the Windows Web Application Gallery. - -### Umbraco - -Umbraco can't be hosted in an application directory. It has to be hosted in the root of a web site. - -![Screenshot of the Install Application window with Umbraco application name circled.](windows-web-application-gallery-known-issues/_static/image39.png) - -When Web Platform Installer shows the following dialog during the Umbraco installatioin the 'Umbraco' application name has to stay empty or Umbraco will not work correctly. - -### SubText - -If you install SubText The SubText admin menu is not shown in Internet Explorer 6.0 (see below). This issue is likely to occur on Windows 2003 or other operating systems where the Internet Explorer wasn't upgraded to a higher version. Please upgrade to a later version of Internet Explorer to see the admin menu. - -![Screenshot showing a portion of the successful configuration screen.](windows-web-application-gallery-known-issues/_static/image44.png) - -### Gallery - -#### Database Server Name - -Gallery is a web application that works with Microsoft SQL Server as well as MySQL. For this reason the database field doesn't suggest the name of the database server. If you have SQL Server Express installed locally (which is the default if SQL Express is installed via Web Platform Installer) the database name has to look like this: **.\SQLExpress** - -![Screenshot of the Install Application window showing the example database server.](windows-web-application-gallery-known-issues/_static/image46.png) - -If MySQL is used locally the database server name can be **'localhost'**. - -#### Hiding the Data Directory - -When you open Gallery the first time it will ask you to secure the g2data folder. There are multiple ways to do this. In IIS you can add g2data to the hidden segements list. You can also turn off all authentication schemes (including anonymous authentication) for the g2data folder. Another way to do this is to remove all Access flags, i.e. AccessRead, AccessWrite and AccessExecute. - -### DasBlog - -DasBlog asks you to enter an application URL in the WebPI parameters UI. DasBlog content will not display correctly if the URL you enter doesn't match the URL that is used for the actual site. - -![Screenshot of the Install Application window with the U R L circled.](windows-web-application-gallery-known-issues/_static/image49.png) diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image1.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image1.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image1.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image10.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image10.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image10.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image11.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image11.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image11.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image12.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image12.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image12.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image13.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image13.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image13.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image14.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image14.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image14.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image15.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image15.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image15.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image16.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image16.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image16.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image17.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image17.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image17.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image18.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image18.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image18.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image19.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image19.png deleted file mode 100644 index 142f002e4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image19.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image2.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image2.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image2.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image20.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image20.png deleted file mode 100644 index fdabcde62..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image20.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image21.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image21.png deleted file mode 100644 index 82663de63..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image21.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image22.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image22.png deleted file mode 100644 index eb0f4dad9..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image22.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image23.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image23.png deleted file mode 100644 index eb0f4dad9..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image23.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image24.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image24.png deleted file mode 100644 index eb0f4dad9..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image24.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image25.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image25.png deleted file mode 100644 index cef4397b8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image25.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image26.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image26.png deleted file mode 100644 index 82663de63..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image26.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image27.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image27.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image27.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image28.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image28.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image28.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image29.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image29.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image29.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image3.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image3.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image3.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image30.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image30.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image30.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image31.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image31.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image31.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image32.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image32.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image32.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image33.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image33.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image33.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image34.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image34.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image34.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image35.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image35.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image35.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image36.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image36.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image36.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image37.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image37.png deleted file mode 100644 index fdabcde62..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image37.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image38.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image38.png deleted file mode 100644 index fdabcde62..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image38.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image39.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image39.png deleted file mode 100644 index 142f002e4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image39.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image4.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image4.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image4.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image40.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image40.png deleted file mode 100644 index 142f002e4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image40.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image41.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image41.png deleted file mode 100644 index 142f002e4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image41.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image42.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image42.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image42.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image43.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image43.png deleted file mode 100644 index 353720962..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image43.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image44.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image44.png deleted file mode 100644 index eb0f4dad9..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image44.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image45.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image45.png deleted file mode 100644 index eb0f4dad9..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image45.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image46.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image46.png deleted file mode 100644 index 82663de63..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image46.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image47.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image47.png deleted file mode 100644 index 82663de63..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image47.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image48.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image48.png deleted file mode 100644 index 142f002e4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image48.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image49.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image49.png deleted file mode 100644 index cef4397b8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image49.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image5.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image5.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image5.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image50.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image50.png deleted file mode 100644 index cef4397b8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image50.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image51.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image51.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image51.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image52.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image52.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image52.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image6.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image6.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image6.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image7.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image7.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image7.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image8.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image8.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image8.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image9.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image9.png deleted file mode 100644 index b1298d2a4..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-known-issues/_static/image9.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough.md b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough.md deleted file mode 100644 index 266b8d318..000000000 --- a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: "Windows Web Application Gallery Link Addition Process Walkthrough" -author: rick-anderson -description: "This walkthrough will guide you through the process of submitting an application to the Windows Web Application Gallery. Overview of the submission process T..." -ms.date: 03/18/2009 -ms.assetid: 218769b5-1bdf-49a2-97dc-a8e6c64bd724 -msc.legacyurl: /learn/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough -msc.type: authoredcontent ---- -# Windows Web Application Gallery Link Addition Process Walkthrough - -by IIS Team - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This walkthrough will guide you through the process of submitting an application to the Windows Web Application Gallery. - -## Overview of the submission process - -The steps from developing an application to seeing it live in the Web Application Gallery are shown below. This document concentrates on the step in Green, which can be exploded out into the process below it: - -![Diagram of the Web Application Gallery submission process within a Web application development process.](windows-web-application-gallery-link-addition-process-walkthrough/_static/image7.jpg) - -## Starting the Submission Process - -The Windows Web Application Gallery submission process begins on the [Web Application Gallery](https://www.microsoft.com/web/gallery/developer.aspx). This page contains links to all of the information you will need to understand and participate in the Windows Web Application Gallery. - -The following items are available on this landing page. - -- Application Packaging Guide. This document contains the overview of creating a package for the Gallery. -- Application Submission Agreement. This is the agreement you will need to accept as part of the submission process. -- Application Gallery Policies. These are the guiding policies for the Application Gallery - -## Submitting your application - -To submit your application, you will need to fill out the [submission form](https://www.microsoft.com/web/gallery/submit.aspx). This form is broken down into three sections, all of which must be completed. Each section is described below, with each field explained. - -- Application Information - - - App Name - This is the name that you want the application listed with. - - **Description** - The description can be up to 200 words. This is the description that is shown to the user when the user is looking at a page or screen dedicated to your application in either the Gallery or the WebPI. - - **Brief Description** - The Brief Description can be up to 40 words in length. This description will show up whenever your application is listed with other applications in the Gallery, and in the Web Platform Installer. - - **App ID** - An indentifier for your application. Use only letters and digits, no spaces or punctuation. This ID is used as the page name for your application in the application Gallery. - - Version - The version must be detailed enough to uniquely identify this release / build compared to future releases - - Submitting Entity - The Publisher is the entity that owns the rights for the application being submitted. It can be a company, an individual, a community, etc... - - Submitting Entity URL - Website for the application Publisher. - - App Web Site URL - Website for the Application. This may be the same as the Publisher URL. - - Support URL - The URL for whatever Support mechanism you provide. i.e. forums, help desk system, wiki, etc... - - Release Date - This is the date that the application at this version was released to the public. It may be different from the date that the application is available in the Gallery. - - Primary Category - This is the category in which your application will be displayed on microsoft.com/web/gallery. - - Secondary Category - This is the secondary category which may also be used by microsoft.com/web/gallery. - - Professional Services URL - Website where you may offer professional services to your application customers. - - Commercial Products URL - Website where you may offer other commercial products. - - Images - use this section of the form to specify product screen shots. - - Package Information - This portion of the form contains two tabs for specifying the details for your installation package. One tab for a 32-bit version, and a second for a 64-bit version, if needed. - - - Package Location URL - This specifies the location that the WebPI will use to download your application onto users' systems. If this changes for any reason, please return and update this form, or your application won't be usable. - - Application Start Page URL - This is any path or file name that you want the user to execute the first time the user visits his installation of your application. For example, if your application requires a setup routine to run after the WebPI is finished, you might put "/setup/index.php" here. Then, when the user installs the application via the WebPI, the link that the user sees to visit their installation will include this path. - - SHA-1 - The WebPI uses a SHA-1 hash to confirm that the version downloaded onto a user's computer is the same file that you want it to be. If the installation package changes at all, the hash will need to be updated so that the application can contnue to be installed correctly. - - File Size (in bytes) - the size of your application package. - - Language - This is a dropdown list for the primary language that the application supports. If the application supports multiple langagues, please select the one that is the default here. - - Dependencies - The Dependencies section gives you the opportunity to specify software and environmental prerequisites for your application. When the application is installed via the Web Platform Installer, the WebPI will ensure that the environment has these Dependencies. The WebPI will set up all of the specified dependencies so the application can function properly. The IIS components required to support the language will automatically be determined and installed by the WebPI. The IIS Components list allows you to select IIS extensions that your application depends on which go beyond the requirements for the framework. For example, if you specify PHP 5.2, the WebPI knows to install and configure FastCGI. However, if your application requires the URL Rewriter, you will need to select it in the Web Server Extensions column. - - There are three lists for specifying dependencies: - - - Framework - Specify one framework from the list of ASP.NET and PHP versions. This should be the version that your application depends on to function. - - Database - Select all of the databases that your application supports. - - IIS Components Select each of the IIS and other components that your application depends on to function. An example component is the IIS URL Rewriter. -- Terms and Conditions - You must agree to the Terms and Conditions of the Web Application Gallery before you can submit your application. - -When you have completed the form, submit the form. This data will be used to populate the Application Gallery with metadata for your application. At the application level of the Gallery, this data will be displayed as in the image below: - -![Screenshot of the Microsoft Web App Gallery displaying the submitted metadata.](windows-web-application-gallery-link-addition-process-walkthrough/_static/image9.jpg) - -## Testing - -After the application submission form has been sent, Microsoft will review the contents of the form and the application. Our process will be to: - -1. Download the application package zip. -2. Scan for Viruses and other materials that violate the Agreement -3. Ensure the application meets the [Web Application Gallery Principles](windows-web-application-gallery-principles.md). -4. Run some basic tests to make sure the application will install. - -We will be in contact with you throughout the process to keep you informed during the verification process. - -## Production - -When all of the testing is complete, we will push the metadata into the production version of the Web Application Gallery. At this point your application will be live, and available to all of the users that discover Web applications through the Gallery, and all of the programs that make use of its Atom feed. - -## What comes next? - -When the application is in production, there may be required updates, or new versions. For any new submissions (including application updates), you can edit the details of your submission using the [MyApps page](https://www.microsoft.com/web/gallery/myapps.aspx). If you have any questions about the process, please check out our Web Application Gallery: Developers & Integrators [forum](https://forums.iis.net/1158.aspx "Web APplication Gallery: Developers & Integrators"). diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.jpg deleted file mode 100644 index fa93c0c21..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.png deleted file mode 100644 index cafc48c1d..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image1.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image10.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image10.jpg deleted file mode 100644 index fa93c0c21..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image10.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.jpg deleted file mode 100644 index 56b362da8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.png deleted file mode 100644 index d0a81cca1..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image2.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.jpg deleted file mode 100644 index 56b362da8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.png deleted file mode 100644 index deb83e228..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image3.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.jpg deleted file mode 100644 index 3eb2f70ba..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.png b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.png deleted file mode 100644 index 791f5c5ad..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image4.png and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image5.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image5.jpg deleted file mode 100644 index 56b362da8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image5.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image6.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image6.jpg deleted file mode 100644 index 56b362da8..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image6.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image7.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image7.jpg deleted file mode 100644 index 132ef62ca..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image7.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image8.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image8.jpg deleted file mode 100644 index 132ef62ca..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image8.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image9.jpg b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image9.jpg deleted file mode 100644 index fa93c0c21..000000000 Binary files a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-link-addition-process-walkthrough/_static/image9.jpg and /dev/null differ diff --git a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-principles.md b/iis/develop/windows-web-application-gallery/windows-web-application-gallery-principles.md deleted file mode 100644 index c5747b8b8..000000000 --- a/iis/develop/windows-web-application-gallery/windows-web-application-gallery-principles.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "Windows Web Application Gallery Principles" -author: chrissfanos -description: "The Windows Web Application Gallery makes it easy to explore, discover and install popular community ASP.Net and PHP applications on Windows. Users can brows..." -ms.date: 03/18/2009 -ms.assetid: c11dcbc8-faae-4bab-89fb-998e409440d1 -msc.legacyurl: /learn/develop/windows-web-application-gallery/windows-web-application-gallery-principles -msc.type: authoredcontent ---- -# Windows Web Application Gallery Principles - -by [Chris Sfanos](https://github.com/chrissfanos) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -The [Windows Web Application Gallery](https://www.microsoft.com/web/gallery) makes it easy to explore, discover and install popular community ASP.Net and PHP applications on Windows. Users can browse and view applications for different types of Web sites, ranging from photo galleries to blogs to ecommerce sites. When an application is accepted by the Web Application Gallery, the application is added to the Web Application Gallery ATOM feed. The ATOM feed is consumed by the Web Application Gallery itself, Web Platform Installer, IIS Manager, and participating Hosting Control Panels. - -To be part of the Windows Web Application Gallery, developers should follow these principles, which establish a consistent, quality user experience: - -- **Be Current**: The application you provide a link to must be the latest, stable final release version available, hosted on a publicly available Web URL. -- **Be Free of Charge**: The application for which you submit a link to the Windows Web App Gallery must be provided free of charge and fully functional without time restrictions. You are welcome to charge for professional support or consulting services and/or provide an enhanced, enterprise version of the application for purchase on your site. We will be happy to provide a link to your commercial products and services from your page in the Windows Web Application Gallery. -- **Be Compatible**: The application to which you provide a link must run on Windows Server 2003, Windows Server 2008, Windows XP, Windows Vista & Windows 7 using [best practices on running ASP.NET applications and PHP applications on IIS](../../application-frameworks/index.md). -- **Be Deployable**: The application to which you provide a link must integrate with Microsoft Web Deploy as described in the [Microsoft Web Application Packaging Guide](package-an-application-for-the-windows-web-application-gallery.md), and run with the [Microsoft Web Platform Installer v3](../../install/web-platform-installer/using-the-microsoft-web-platform-installer.md). -- **Be Supported**: You must provide a publicly available Web site where end users can download your application, find documentation and/or get free on a best effort basis support through a forum. -- **Be Hostable**: The application to which you provide a link must run well in a shared hosted environment as well as when the user has administrative rights for the computer. -- **Be Platform Independent**: The application to which you provide a link must be able to run on all platforms: x86, Itanium, and x64. -- **Be Inclusive**: If your link is included in the Gallery, you should include a link on your application community's Web site to your application entry on the Windows Web Application Gallery. -- **Be Safe**: The application to which you provide a link must not harm customers or be malicious, dishonest, destructive, invasive, or act in any manner restricted by the Web Gallery Application Submission agreement. -- **Be a Web App**: The application to which you provide a link must be a Web application that can be used to generate a working, usable Web site after deployment *without* requiring code or customization. All submissions should adhere to the application categories currently available in the Windows Web Application Gallery. diff --git a/iis/develop/windows-web-application-gallery/wordpress-sample-files.md b/iis/develop/windows-web-application-gallery/wordpress-sample-files.md deleted file mode 100644 index 6efc0dd42..000000000 --- a/iis/develop/windows-web-application-gallery/wordpress-sample-files.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "WordPress Sample files" -author: SunBuild -description: "This is a set of sample files you could use with WordPress and the Web Deployment tool for deploying WordPress onto IIS. The files are annotated with comment..." -ms.date: 03/07/2012 -ms.assetid: 54c8b691-3b23-4af5-998e-93fc8484d262 -msc.legacyurl: /learn/develop/windows-web-application-gallery/wordpress-sample-files -msc.type: authoredcontent ---- -# WordPress Sample files - -by [Sunitha Muthukrishna](https://github.com/SunBuild) - -> [!NOTE] -> The Windows Web Application Gallery (WWAG) is being retired on July 1, 2021. We are no longer taking submissions via the Submission Portal. Please contact webpi@microsoft.com to make updates to your existing submission. - -This is a set of sample files you could use with WordPress and the Web Deployment tool for deploying WordPress onto IIS. The files are annotated with comments that explain specific lines in the files you'll need to customize for your configuration. - -## Sample manifest.xml file - -[!code-xml[Main](wordpress-sample-files/samples/sample1.xml)] - -## Sample parameters.xml file - -[!code-xml[Main](wordpress-sample-files/samples/sample2.xml)] - -## Sample install.sql file - -[!code-console[Main](wordpress-sample-files/samples/sample3.cmd)] diff --git a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample1.xml b/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample1.xml deleted file mode 100644 index 72dd580c0..000000000 --- a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample1.xml +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample2.xml b/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample2.xml deleted file mode 100644 index 0b29d937e..000000000 --- a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample2.xml +++ /dev/null @@ -1,149 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample3.cmd b/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample3.cmd deleted file mode 100644 index 8827b77db..000000000 --- a/iis/develop/windows-web-application-gallery/wordpress-sample-files/samples/sample3.cmd +++ /dev/null @@ -1,15 +0,0 @@ -USE PlaceHolderForDb; - -DROP PROCEDURE IF EXISTS add_user ; - -CREATE PROCEDURE add_user() -BEGIN -DECLARE EXIT HANDLER FOR 1044 BEGIN END; -GRANT ALL PRIVILEGES ON PlaceHolderForDb.* to 'PlaceHolderForUser'@'PlaceHolderForServer' IDENTIFIED BY 'PlaceHolderForPassword'; -FLUSH PRIVILEGES; -END -// - -CALL add_user() // - -DROP PROCEDURE IF EXISTS add_user // \ No newline at end of file diff --git a/iis/docfx.json b/iis/docfx.json index 9babe894e..05c1316ce 100644 --- a/iis/docfx.json +++ b/iis/docfx.json @@ -38,6 +38,7 @@ "overwrite": [], "externalReference": [], "globalMetadata": { + "ms.service": "iis", "feedback_system": "Standard", "feedback_help_link_type": "get-help-at-qna", "feedback_help_link_url": "https://learn.microsoft.com/answers/tags/85/windows-iis", @@ -48,22 +49,23 @@ "searchScope": [ "IIS" ], - "ms.prod": "iis", "ms.topic": "conceptual", "author": "John-Hart", "ms.author": "johnhart" }, "fileMetadata": { + "ms.subservice": { + "troubleshoot/**/*.md": "troubleshoot", + "web-hosting/**/*.md": "web-hosting", + "extensions/**/*.md": "extensions", + "application-frameworks/**/*.md": "appfx", + "publish/**/*.md": "publish", + "configuration/**/*.md": "config-reference", + "manage/**/*.md": "mgmt", + "develop/**/*.md": "develop" + }, "ms.technology": { - "application-frameworks/**/*.md": "iis-appfx", - "configuration/**/*.md": "iis-config", - "develop/**/*.md": "iis-develop", - "extensions/**/*.md": "iis-extensions", - "manage/**/*.md": "iis-manage", - "media/**/*.md": "iis-media", - "publish/**/*.md": "iis-publish", - "troubleshoot/**/*.md": "iis-troubleshoot", - "web-hosting/**/*.md": "iis-hosting" + "media/**/*.md": "iis-media" }, "ms.topic": { "configuration/**/*.md": "reference", diff --git a/iis/extensions/advanced-logging-module/advanced-logging-for-iis-custom-logging.md b/iis/extensions/advanced-logging-module/advanced-logging-for-iis-custom-logging.md index 4d4e6fbe1..4215aeafc 100644 --- a/iis/extensions/advanced-logging-module/advanced-logging-for-iis-custom-logging.md +++ b/iis/extensions/advanced-logging-module/advanced-logging-for-iis-custom-logging.md @@ -29,9 +29,8 @@ The following prerequisites must be fulfilled to install IIS Advanced Logging: - Windows 7 - To manage IIS Advanced Logging using the IIS Manager user interface, the IIS Management Console for IIS must be installed. -The following options are available for installing IIS Advanced Logging: +The following option is available for installing IIS Advanced Logging: -- Web Platform Installer - Windows Installer files (for 32-bit and 64-bit versions of the selected operating system) ## Concepts diff --git a/iis/extensions/advanced-logging-module/advanced-logging-readme.md b/iis/extensions/advanced-logging-module/advanced-logging-readme.md index d623a88e2..afb91a4e5 100644 --- a/iis/extensions/advanced-logging-module/advanced-logging-readme.md +++ b/iis/extensions/advanced-logging-module/advanced-logging-readme.md @@ -49,15 +49,6 @@ To uninstall the software, in **Control Panel** > **Programs** > **Program The IS Advanced Logging is an extension for Internet Information Services (IIS) 7 is no longer available. We recommend [Enhanced Logging for IIS 8.5](/iis/get-started/whats-new-in-iis-85/enhanced-logging-for-iis85). -**Install Using Web PI** - -1. Go to the [Microsoft Web Platform Installer Web Page](https://go.microsoft.com/?linkid=9656457) and click **Download It Now** to download and run Web PI. -2. At the bottom of the **Web Platform Installer** dialog box, click **Options**. -3. In the **Change Options** dialog box, in **Select your preferred language for software installations**, select the language that you want, and then click **OK**. -4. Back in the **Web Platform Installer** dialog box, at the top of the dialog box, click **Products** in the **Spotlight** - **Products** - **Applications** row of options. -5. In the Contents pane, click either **All** or **Server**. -6. In the list of products that is displayed, click the **Add** button for **Advanced Logging**, and then click **Install**. - **Install Using Windows Installer** The IS Advanced Logging is an extension for Internet Information Services (IIS) 7 is no longer available. We recommend [Enhanced Logging for IIS 8.5](/iis/get-started/whats-new-in-iis-85/enhanced-logging-for-iis85). diff --git a/iis/extensions/configuring-application-request-routing-arr/arr-as-generic-proxy-in-hotmail-and-skydrive.md b/iis/extensions/configuring-application-request-routing-arr/arr-as-generic-proxy-in-hotmail-and-skydrive.md index e4618e6f4..3d8c4b624 100644 --- a/iis/extensions/configuring-application-request-routing-arr/arr-as-generic-proxy-in-hotmail-and-skydrive.md +++ b/iis/extensions/configuring-application-request-routing-arr/arr-as-generic-proxy-in-hotmail-and-skydrive.md @@ -71,4 +71,4 @@ Listed below are a few of the issues Hotmail and SkyDrive encountered while onbo ## Conclusion -Hotmail and SkyDrive services span across [thousands of servers](http://windowsteamblog.com/windows_live/b/windowslive/archive/2010/04/07/hotmail-tips-the-scales.aspx), so each server uses ARR to proxy a large number of user requests during a rollout. Despite this large scale and the complexity of our applications, ARR integration was simple, effective, and performant. ARR has allowed us to simplify our service architecture and continue providing frequent [application updates](http://windowsteamblog.com/windows_live/b/windowslive/) with minimal to no impact to users of our services. +Hotmail and SkyDrive services span across thousands of servers, so each server uses ARR to proxy a large number of user requests during a rollout. Despite this large scale and the complexity of our applications, ARR integration was simple, effective, and performant. ARR has allowed us to simplify our service architecture and continue providing frequent application updates with minimal to no impact to users of our services. diff --git a/iis/extensions/configuring-application-request-routing-arr/configure-3-tier-deployment-architecture-using-application-request-routing.md b/iis/extensions/configuring-application-request-routing-arr/configure-3-tier-deployment-architecture-using-application-request-routing.md index 9027dd493..3587275ee 100644 --- a/iis/extensions/configuring-application-request-routing-arr/configure-3-tier-deployment-architecture-using-application-request-routing.md +++ b/iis/extensions/configuring-application-request-routing-arr/configure-3-tier-deployment-architecture-using-application-request-routing.md @@ -32,11 +32,6 @@ This walkthrough requires the following prerequisites: - Minimum of two content servers with working sites and applications - Static content available on the Application Request Routing server -If the Application Request Routing Version 1 has not been installed, download it at: - -- Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. As another prerequisite, you must have defined and configured a server farm using the steps outlined in **[Define and Configure an Application Request Routing (ARR) Server Group](define-and-configure-an-application-request-routing-server-farm.md)**. diff --git a/iis/extensions/configuring-application-request-routing-arr/configure-byte-range-request-segment-size-in-application-request-routing.md b/iis/extensions/configuring-application-request-routing-arr/configure-byte-range-request-segment-size-in-application-request-routing.md index f50d26552..dcc4c61e0 100644 --- a/iis/extensions/configuring-application-request-routing-arr/configure-byte-range-request-segment-size-in-application-request-routing.md +++ b/iis/extensions/configuring-application-request-routing-arr/configure-byte-range-request-segment-size-in-application-request-routing.md @@ -71,7 +71,7 @@ By default, the byte-range segment size is 256KB. The administrator may want to You will need a client tool that you can use to create the byte-range request. You will also want to trace and capture the HTTP requests to ensure that your client is receiving the expected responses based on the requests that it sends. 1. Send a byte-range request with a range of 0-500. In this example, a byte-range request has been sent to /pix/IMG\_1400.jpg. -2. If you have a way to monitor the network, for example using [Microsoft Network Monitor](https://www.microsoft.com/downloads/details.aspx?FamilyID=983b941d-06cb-4658-b7f6-3088333d062f&displaylang=en), verify that the client has received the range for 0-500. +2. If you have a way to monitor the network, for example using Microsoft Network Monitor, verify that the client has received the range for 0-500. 3. Locate the folder where IMG\_1400.jpg should be located on the cache drive location and list the contents by typing **dir /a**. [![Screenshot of the Administrator Command Prompt page.](configure-byte-range-request-segment-size-in-application-request-routing/_static/image6.jpg)](configure-byte-range-request-segment-size-in-application-request-routing/_static/image5.jpg) diff --git a/iis/extensions/configuring-application-request-routing-arr/define-and-configure-an-application-request-routing-server-farm.md b/iis/extensions/configuring-application-request-routing-arr/define-and-configure-an-application-request-routing-server-farm.md index fbae0d691..1f3eda73c 100644 --- a/iis/extensions/configuring-application-request-routing-arr/define-and-configure-an-application-request-routing-server-farm.md +++ b/iis/extensions/configuring-application-request-routing-arr/define-and-configure-an-application-request-routing-server-farm.md @@ -29,11 +29,6 @@ This walkthrough requires the following prerequisites: - Microsoft Application Request Routing Version 1 and dependent modules. - Minimum of two application servers with working sites and applications. -If Application Request Routing RC has not been installed, it is available for download at: - -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. ## Step 1 – Create a server farm in Application Request Routing diff --git a/iis/extensions/configuring-application-request-routing-arr/how-to-configure-wmi-service-on-application-servers-for-hostnamememory-affinity-provider.md b/iis/extensions/configuring-application-request-routing-arr/how-to-configure-wmi-service-on-application-servers-for-hostnamememory-affinity-provider.md index c91d1d89f..7e8c1ba43 100644 --- a/iis/extensions/configuring-application-request-routing-arr/how-to-configure-wmi-service-on-application-servers-for-hostnamememory-affinity-provider.md +++ b/iis/extensions/configuring-application-request-routing-arr/how-to-configure-wmi-service-on-application-servers-for-hostnamememory-affinity-provider.md @@ -39,11 +39,6 @@ This walkthrough requires the following prerequisites: - Microsoft Application Request Routing Version 1 and dependent modules. - ARR is configured for [shared hosting scenarios](shared-hosting-using-application-request-routing-arr.md). -If the Application Request Routing Version 1 has not been installed, download it at: - -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. ## Note diff --git a/iis/extensions/configuring-application-request-routing-arr/http-load-balancing-using-application-request-routing.md b/iis/extensions/configuring-application-request-routing-arr/http-load-balancing-using-application-request-routing.md index 08b9d2106..16351ac25 100644 --- a/iis/extensions/configuring-application-request-routing-arr/http-load-balancing-using-application-request-routing.md +++ b/iis/extensions/configuring-application-request-routing-arr/http-load-balancing-using-application-request-routing.md @@ -29,11 +29,6 @@ This walkthrough requires the following prerequisites: - Microsoft Application Request Routing Version 1 and dependent modules. - Minimum of two content servers with working sites and applications. -If Application Request Routing Version 1 has not been installed, it is available for download at: - -- Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. Another prerequisite is that the reader has defined and configured a server farm using the steps outlined in **[Define and Configure an Application Request Routing (ARR) Server Group](define-and-configure-an-application-request-routing-server-farm.md)**. diff --git a/iis/extensions/configuring-application-request-routing-arr/pilot-program-management-using-application-request-routing.md b/iis/extensions/configuring-application-request-routing-arr/pilot-program-management-using-application-request-routing.md index ab585657d..3da2bd986 100644 --- a/iis/extensions/configuring-application-request-routing-arr/pilot-program-management-using-application-request-routing.md +++ b/iis/extensions/configuring-application-request-routing-arr/pilot-program-management-using-application-request-routing.md @@ -28,11 +28,6 @@ This walkthrough requires the following prerequisites: - Minimum of four content servers with working sites and applications. Two servers will be used to simulate the production site, and the other two servers will simulate the pilot site. - Alternate browser to Microsoft Internet Explorer, such as Firefox, on a computer with .NET 3.5 installed. (This setup is used only for testing purposes.) -If Application Request Routing Version 1 has not been installed, it is available for download at: - -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. Another prerequisite is that the reader has defined and configured two server farms by following the steps outlined in **[Define and Configure an Application Request Routing (ARR) Server Group](define-and-configure-an-application-request-routing-server-farm.md)**. One server farm will represent the production environment, while the other will represent the pilot environment. diff --git a/iis/extensions/configuring-application-request-routing-arr/shared-hosting-using-application-request-routing-arr.md b/iis/extensions/configuring-application-request-routing-arr/shared-hosting-using-application-request-routing-arr.md index b1f074fe6..a6566fdeb 100644 --- a/iis/extensions/configuring-application-request-routing-arr/shared-hosting-using-application-request-routing-arr.md +++ b/iis/extensions/configuring-application-request-routing-arr/shared-hosting-using-application-request-routing-arr.md @@ -30,11 +30,6 @@ This walkthrough requires the following prerequisites: - The servers should be configured to use shared configuration and shared content. For more information about shared configuration, see the [Shared Configuration](../../manage/managing-your-configuration-settings/shared-configuration_264.md) article. - The sites on the servers should be using host name binding. -If the Application Request Routing RC has not been installed, download it at: - -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. As another prerequisite, you must define and configure a server farm by following the steps outlined in [**Define and Configure an Application Request Routing (ARR) Server Group**](define-and-configure-an-application-request-routing-server-farm.md). diff --git a/iis/extensions/configuring-application-request-routing-arr/using-multiple-instances-of-application-request-routing-arr-servers.md b/iis/extensions/configuring-application-request-routing-arr/using-multiple-instances-of-application-request-routing-arr-servers.md index c119855e2..ca23f95bc 100644 --- a/iis/extensions/configuring-application-request-routing-arr/using-multiple-instances-of-application-request-routing-arr-servers.md +++ b/iis/extensions/configuring-application-request-routing-arr/using-multiple-instances-of-application-request-routing-arr-servers.md @@ -39,9 +39,6 @@ This walkthrough requires the following prerequisites: If the Application Request Routing Version 1 has not been installed, download it at: -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Download Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - Follow the steps outlined in [this](../installing-application-request-routing-arr/install-application-request-routing.md) document to install Application Request Routing. You must have at least two ARR servers and two application servers. You can use a shared configuration to keep the ARR servers configured the same way, and use another shared configuration to keep the application servers in sync. For more information about shared configuration, refer to [this](../../manage/managing-your-configuration-settings/shared-configuration_264.md) article. diff --git a/iis/extensions/iis-search-engine-optimization-toolkit/getting-started-with-the-seo-toolkit.md b/iis/extensions/iis-search-engine-optimization-toolkit/getting-started-with-the-seo-toolkit.md index 5819ff35a..790015bd1 100644 --- a/iis/extensions/iis-search-engine-optimization-toolkit/getting-started-with-the-seo-toolkit.md +++ b/iis/extensions/iis-search-engine-optimization-toolkit/getting-started-with-the-seo-toolkit.md @@ -21,10 +21,6 @@ You can point the site analysis tool in the Toolkit at the top-level URL of your The SEO toolkit also makes it easy to optimize which content on your Web site gets indexed by search engines. You can manage robots.txt files, which search engine crawlers use to understand which URLs are excluded from the crawling process. You can also manage sitemaps, which provide URLs for crawling to search engine crawlers. You can also use the SEO Toolkit to provide additional metadata about the URL, such as last modified time, which search engines take into account when calculating relevancy in search results. -## Installs Quickly and Easily - -You can install the free IIS SEO Toolkit on Windows Vista, Windows 7, Windows Server 2008 or Windows Server 2008 R2 quickly and easily with the Web Platform Installer. When you click this link, the Web Platform Installer will check your computer for the required dependencies and install both the dependencies and the IIS SEO Toolkit. (You may be prompted to install the Web Platform Installer first if you do not have it already installed on your computer.) - ## Launching the IIS SEO Toolkit The IIS SEO Toolkit integrates into the IIS management console. To start using the Toolkit, launch the IIS Management Console first by clicking Run in the Start Menu and typing inetmgr in the Run command line. When the IIS Manager launches, you can scroll down to the Management section of the Features View and click the "Search Engine Optimization (SEO) Toolkit" icon. diff --git a/iis/extensions/iis-search-engine-optimization-toolkit/managing-robotstxt-and-sitemap-files.md b/iis/extensions/iis-search-engine-optimization-toolkit/managing-robotstxt-and-sitemap-files.md index 1649dcf19..2dca8116c 100644 --- a/iis/extensions/iis-search-engine-optimization-toolkit/managing-robotstxt-and-sitemap-files.md +++ b/iis/extensions/iis-search-engine-optimization-toolkit/managing-robotstxt-and-sitemap-files.md @@ -127,7 +127,7 @@ Your Robots.txt file will look similar to the following: In addition to adding the sitemap location to the Robots.txt file, it is recommended that you submit your sitemap location URL to the major search engines. This will allow you to obtain useful status and statistics about your Web site from the search engine's webmasters tools. -- To submit a sitemap to **bing.com,** use the [Bing Webmasters Tools](http://www.bing.com/webmaster) +- To submit a sitemap to **bing.com,** use the [Bing Webmasters Tools](https://www.bing.com/webmaster) - To submit a sitemap to **google.com,** use the [Google Webmasters Tools](https://www.google.com/webmasters/) ## Summary diff --git a/iis/extensions/installing-application-request-routing-arr/install-application-request-routing.md b/iis/extensions/installing-application-request-routing-arr/install-application-request-routing.md index 98718f8a0..5c807a6be 100644 --- a/iis/extensions/installing-application-request-routing-arr/install-application-request-routing.md +++ b/iis/extensions/installing-application-request-routing-arr/install-application-request-routing.md @@ -39,10 +39,7 @@ This walkthrough requires the following prerequisites: ## Step 1 – Download Microsoft Application Request Routing Version 1 -Download the Microsoft Application Request Routing release from the following locations: - -- Microsoft Application Request Routing Version 1 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -- Microsoft Application Request Routing Version 1 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). +Download the Microsoft Application Request Routing release. ## Step 2 – Install Microsoft Application Request Routing Version 1 diff --git a/iis/extensions/introduction-to-iis-express/iis-75-express-readme.md b/iis/extensions/introduction-to-iis-express/iis-75-express-readme.md index 75945c06a..dc16f7844 100644 --- a/iis/extensions/introduction-to-iis-express/iis-75-express-readme.md +++ b/iis/extensions/introduction-to-iis-express/iis-75-express-readme.md @@ -24,13 +24,13 @@ Internet Information Services (IIS) 7.5 Express is a free, simple and self-conta ## Installation -You can install IIS 7.5 Express using Web Platform Installer, or through the [Microsoft Download Center](https://www.microsoft.com/download/). +You can install IIS 7.5 Express through the [Microsoft Download Center](https://www.microsoft.com/download/). ## Using IIS 7.5 Express -You will most likely need an Integrated Development Environment to build web applications over IIS 7.5 Express. Microsoft WebMatrix provides a simple and integrated user experience for building both ASP.NET and PHP websites using IIS 7.5 Express. You can use IIS 7.5 Express with [Visual Studio 2010 SP1 Beta](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=11ea69cb-cf12-4842-a3d7-b32a1e5642e2&displaylang=en) to build and test web applications instead of the built-in ASP.NET Development Web Server (also known as Cassini). It is also possible to [run IIS 7.5 Express using the command line.](../using-iis-express/running-iis-express-from-the-command-line.md) +You will most likely need an Integrated Development Environment to build web applications over IIS 7.5 Express. Microsoft WebMatrix provides a simple and integrated user experience for building both ASP.NET and PHP websites using IIS 7.5 Express. You can use IIS 7.5 Express with Visual Studio 2010 SP1 Beta to build and test web applications instead of the built-in ASP.NET Development Web Server (also known as Cassini). It is also possible to [run IIS 7.5 Express using the command line.](../using-iis-express/running-iis-express-from-the-command-line.md) diff --git a/iis/extensions/introduction-to-iis-express/iis-express-faq.yml b/iis/extensions/introduction-to-iis-express/iis-express-faq.yml index 94153b0f7..9d732c93d 100644 --- a/iis/extensions/introduction-to-iis-express/iis-express-faq.yml +++ b/iis/extensions/introduction-to-iis-express/iis-express-faq.yml @@ -27,11 +27,6 @@ sections: answer: | The current release is IIS 7.5 Express. As the name suggests, this release is derived from the IIS 7.5 server codebase. - - question: | - How does it relate to Microsoft WebMatrix? - answer: | - Microsoft WebMatrix is a simple and integrated suite of tools that streamline ASP.NET and PHP development. IIS Express is the Web server that is included with WebMatrix. You can also install IIS Express all by itself using the following link. See [IIS Express Overview](iis-express-overview.md "IIS Express Overview") for information on the various ways to install the product. - - question: | Can I use IIS Express with Visual Studio? answer: | @@ -66,11 +61,6 @@ sections: answer: | Yes IIS Express supports SSL. The setup program will install a default, self-signed server certificate in the machine store and configure ports 44300-44399 for use with SSL. You can also set up and configure custom SSL certificates for your websites as an administrator. - - question: | - Does IIS Express support PHP? - answer: | - Yes, IIS Express includes the CGI and FastCGI modules for PHP. The best way to develop PHP applications using IIS Express is to install WebMatrix. This will automatically install and configure PHP and also allow you to download and customize popular gallery applications such as WordPress, Joomla etc. - - question: | Can IIS Express be redistributed or embedded in other applications? answer: | diff --git a/iis/extensions/planning-for-arr/using-the-application-request-routing-module.md b/iis/extensions/planning-for-arr/using-the-application-request-routing-module.md index b2d7bb728..01124a0dd 100644 --- a/iis/extensions/planning-for-arr/using-the-application-request-routing-module.md +++ b/iis/extensions/planning-for-arr/using-the-application-request-routing-module.md @@ -37,11 +37,6 @@ Microsoft Application Request Routing for IIS includes the following key feature - **Management and monitoring by using the UI** You can use IIS Manager to manage and view all configuration settings and aggregated runtime statistics for ARR. - **Failed request tracing rules** Specific traces have been added to quickly troubleshoot and diagnose ARR. -## Getting the Module - -Download Microsoft Application Request Routing Version 2 for IIS 7 (x86) [here](https://iis-umbraco.azurewebsites.net/downloads). -Download Microsoft Application Request Routing Version 2 for IIS 7 (x64) [here](https://iis-umbraco.azurewebsites.net/downloads). - ## Using the Module These articles explain how to configure and achieve the core scenarios by using ARR. It is recommended that you read the articles in the following order because the scenarios get richer with each article: diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md deleted file mode 100644 index 3f7fddc0f..000000000 --- a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "Enabling Pretty Permalinks in WordPress" -author: ruslany -description: "This walkthrough describes how to enable “ Pretty Permalinks ” for blog posts in the WordPress blog engine that is installed on IIS 7 and above. Typically, w..." -ms.date: 05/30/2008 -ms.assetid: 7d7afc06-8b24-4ee0-90a6-0a6ea9a2b89a -msc.legacyurl: /learn/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress -msc.type: authoredcontent ---- -# Enabling Pretty Permalinks in WordPress - -by [Ruslan Yakushev](https://github.com/ruslany) - -This walkthrough describes how to enable "[Pretty Permalinks](http://codex.wordpress.org/Using_Permalinks "Pretty Permalinks")" for blog posts in the [WordPress](http://www.wordpress.org/ "WordPress") blog engine that is installed on IIS 7 and above. Typically, without URL rewriting functionality on a Web server, WordPress users must use "Almost Pretty" URLs, for example, `http://contoso.com/index.php/yyyy/mm/dd/post-name/`. By using the URL Rewrite module, you can use "Pretty Permalinks," for example, `http://example.com/year/month/day/post-name/`, for WordPress blogs that are hosted on IIS. - -## Prerequisites - -This walkthrough requires the following prerequisites: - -1. IIS 7 or above with FastCGI and PHP installed. If you need to install PHP, follow the instructions in [this article](../../application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md "Install PHP"). -2. WordPress installed. If you need to install WordPress, follow the instructions in [this article](../../application-frameworks/install-and-configure-php-applications-on-iis/install-wordpress-on-iis.md "Install WordPress") or use the instructions from the official [WordPress site](https://wordpress.org/support/article/how-to-install-wordpress). -3. URL Rewrite installed. - -Note that for the purposes of this walkthrough it is assumed that WordPress is installed in a Web site root directory. If WordPress is installed in a subdirectory, then the rewrite rules that are used in this walkthrough should be included in the Web.config file that is located within the same subdirectory where the WordPress files are. - -## Enabling Pretty Permalinks in WordPress - -Use the following instructions to create pretty permalinks for your blog posts. - -**To enable pretty permalinks in Word Press:** - -1. Log on to WordPress with Administrator user rights. -2. In WordPress, click the **Options** tab. -3. On the **Options** page, click the **Permalinks** subtab. - This will take you to the page where you can customize how WordPress generates permalinks for blog posts. -4. On the **Permalinks** page, select **Custom, specify below** and enter "/%year%/%monthnum%/%day%/%postname%/" in the **Custom structure** text box. -5. Click **Update Permalink Structure**. - ![Screenshot of a browser window showing the Customize Permalink Structure in a tab.](enabling-pretty-permalinks-in-wordpress/_static/image1.png) - -All the blog post links will have URLs that follow the format that you have specified, but if you click any one of those links the Web server will return a 404 - File Not Found error. This is because WordPress relies on a URL rewriting capability within the server to rewrite requests that have "pretty permalinks" to an Index.php file. In the next section, you will create a rule that will provide this capability. - -## Creating a Rewrite Rule - -Open the Web.config file that is located in the same directory where the WordPress files are installed, and paste the following XML section into the system.webServer element: - -[!code-xml[Main](enabling-pretty-permalinks-in-wordpress/samples/sample1.xml)] - -This rule will try to match any requested URL. If the URL does not correspond to a file or a folder on the file system, it will rewrite the URL to the Index.php file. At that point, WordPress will determine which content to serve based on the REQUEST\_URI server variable that contains the original URL before it was modified by this rule. - -## Testing the Rewrite Rule - -After you save the rewrite rule to the Web.config file, open a Web browser and click any one of the permalinks in your WordPress blog. You should see the correct content returned by the Web server for each permalink. - -![Screenshot of a browser window showing the hello world example in a tab. ](enabling-pretty-permalinks-in-wordpress/_static/image5.png) - -## Summary - -In this walkthrough you learned how to use the URL Rewrite module to enable "pretty permalinks" in the WordPress blog engine. WordPress is just one example of the many popular PHP applications that can take advantage of the URL Rewrite module in IIS, a feature that enables user-friendly and search engine-friendly URLs. diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image1.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image1.png deleted file mode 100644 index fb263506f..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image1.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image2.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image2.png deleted file mode 100644 index fb263506f..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image2.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image3.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image3.png deleted file mode 100644 index fb263506f..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image3.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image4.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image4.png deleted file mode 100644 index fb263506f..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image4.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image5.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image5.png deleted file mode 100644 index 3d4f99280..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image5.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image6.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image6.png deleted file mode 100644 index 3d4f99280..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image6.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image7.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image7.png deleted file mode 100644 index 3d4f99280..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image7.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image8.png b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image8.png deleted file mode 100644 index 3d4f99280..000000000 Binary files a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/_static/image8.png and /dev/null differ diff --git a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/samples/sample1.xml b/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/samples/sample1.xml deleted file mode 100644 index 74d78fe4f..000000000 --- a/iis/extensions/url-rewrite-module/enabling-pretty-permalinks-in-wordpress/samples/sample1.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/extensions/url-rewrite-module/importing-apache-modrewrite-rules.md b/iis/extensions/url-rewrite-module/importing-apache-modrewrite-rules.md index 70fca99cd..2954dd114 100644 --- a/iis/extensions/url-rewrite-module/importing-apache-modrewrite-rules.md +++ b/iis/extensions/url-rewrite-module/importing-apache-modrewrite-rules.md @@ -96,7 +96,7 @@ Also, if you try either of these URLs: the Web browser gets redirected to `http://www_mysite_com:8088/iisstart.htm`. -Note that the rules that were imported from mod\_rewrite enabled the enforcement of canonical host names for a Web site. A Bing search will reveal other [examples of Apache mod\_rewrite rules](http://search.live.com/results.aspx?q=mod_rewrite+examples). +Note that the rules that were imported from mod\_rewrite enabled the enforcement of canonical host names for a Web site. A Bing search will reveal other examples of Apache mod\_rewrite rules. ## Disclaimer :::image type="icon" source="importing-apache-modrewrite-rules/_static/image1.gif"::: IMPORTANT - The URL Rewrite Module tries to convert Apache mod\_rewrite rules to functionally equivalent IIS URL rewrite rules. However, not all mod\_rewrite rules can be converted because of architectural differences between Apache and IIS. It is highly recommended that you study a mod\_rewrite rule set until you understand its functionality before you begin the conversion process. Then, after converting to IIS URL rewrite rules, review and test the result of the conversion to make sure that the corresponding IIS rewrite rule set provides the same URL rewriting logic. diff --git a/iis/extensions/url-rewrite-module/url-rewrite-module-20-configuration-reference.md b/iis/extensions/url-rewrite-module/url-rewrite-module-20-configuration-reference.md index 34298bf60..fa174e9da 100644 --- a/iis/extensions/url-rewrite-module/url-rewrite-module-20-configuration-reference.md +++ b/iis/extensions/url-rewrite-module/url-rewrite-module-20-configuration-reference.md @@ -198,7 +198,7 @@ When **filterByTags** attribute is not specified in the match element of the rul Rule pattern syntax can be specified by using the **patternSyntax** attribute of a rule. This attribute can be set to one of the following options: -**ECMAScript** – Perl compatible ([ECMAScript](http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf "ECMAScript Standard") standard compliant) regular expression syntax. This is a default option for any rule. This is an example of the pattern format: "^([\_0-9a-zA-Z-]+/)?(wp-.\*)" +**ECMAScript** – Perl compatible (ECMAScript standard compliant) regular expression syntax. This is a default option for any rule. This is an example of the pattern format: "^([\_0-9a-zA-Z-]+/)?(wp-.\*)" **Wildcard** – [Wildcard](https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/41c238b2-1188-488f-bf2d-464383b1bb08.mspx?mfr=true "Wildcard syntax") syntax used in IIS HTTP redirection module. This is an example of pattern in this format: "/Scripts/\*.js", where asterisk ("\*") means "match any number of any characters and capture them in a back-reference". Note that wildcard pattern type cannot be used when rule does not have any tag filters. @@ -230,6 +230,9 @@ A condition is defined by specifying the following properties: - **Input string**- Condition input specifies which item to use as an input for the condition evaluation. Condition input is an arbitrary string that can include server variables and back-references to prior condition patterns and/or to rule patterns. - **Pattern** – A pattern to look for in the condition input. A pattern can be specified by using either regular expression syntax or by using wildcard syntax. The type of pattern to use in a condition depends on the value of the **patternSyntax** flag defined for the rule to which this condition belongs. This condition type has two related attributes that control pattern matching: + - **pattern** – Use this attribute to specify the actual pattern. + - **ignoreCase** – Use this attribute to control whether pattern matching for the condition should be case sensitive or case insensitive. + ### Rule Action diff --git a/iis/extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md b/iis/extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md index bc6b86fbe..81ac55a07 100644 --- a/iis/extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md +++ b/iis/extensions/url-rewrite-module/url-rewrite-module-configuration-reference.md @@ -115,7 +115,7 @@ A pattern is specified within a <match> element of a rewrite rule. Rule pattern syntax can be specified by using the **patternSyntax** attribute of a rule. This attribute can be set to one of the following options: -**ECMAScript** – Perl compatible ([ECMAScript](http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf "ECMAScript Standard") standard compliant) regular expression syntax. This is a default option for any rule. This is an example of the pattern format: "^([\_0-9a-zA-Z-]+/)?(wp-.\*)" +**ECMAScript** – Perl compatible (ECMAScript standard compliant) regular expression syntax. This is a default option for any rule. This is an example of the pattern format: "^([\_0-9a-zA-Z-]+/)?(wp-.\*)" **Wildcard** – [Wildcard](https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/41c238b2-1188-488f-bf2d-464383b1bb08.mspx?mfr=true "Wildcard syntax") syntax used in IIS HTTP redirection module. The following is an example of a pattern in this format: "/Scripts/\*\_in.???", where asterisk ("\*") means "match any number of any characters and capture them in a back-reference" and "?" means match exactly one character (no back-reference is created). diff --git a/iis/extensions/url-rewrite-module/using-custom-rewrite-providers-with-url-rewrite-module.md b/iis/extensions/url-rewrite-module/using-custom-rewrite-providers-with-url-rewrite-module.md index 8da814b5f..5e5623ec2 100644 --- a/iis/extensions/url-rewrite-module/using-custom-rewrite-providers-with-url-rewrite-module.md +++ b/iis/extensions/url-rewrite-module/using-custom-rewrite-providers-with-url-rewrite-module.md @@ -160,7 +160,7 @@ The complete content of the web.config file should look similar to below: This rule aborts the HTTP connection if the user agent of the HTTP request matches any of the strings listed in disalloweduseragents.txt file. The FileContainsProvider instance named "FileContains" is invoked from the rule's condition and if the result returned from the provider is not empty then the HTTP connection is aborted. -To test the rule open [WFetch](https://www.microsoft.com/downloads/details.aspx?FamilyID=b134a806-d50e-4664-8348-da5c17129210&displaylang=en) and add a user-agent header to the request as below: +To test the rule open WFetch and add a user-agent header to the request as below: [!code-console[Main](using-custom-rewrite-providers-with-url-rewrite-module/samples/sample10.cmd)] diff --git a/iis/extensions/url-rewrite-module/using-the-url-rewrite-module.md b/iis/extensions/url-rewrite-module/using-the-url-rewrite-module.md index 77d8f6b22..f435b3d97 100644 --- a/iis/extensions/url-rewrite-module/using-the-url-rewrite-module.md +++ b/iis/extensions/url-rewrite-module/using-the-url-rewrite-module.md @@ -28,7 +28,7 @@ The URL Rewrite module is available both as a download that you can install on y The Microsoft URL Rewrite module 2.0 includes the following key features: - **Rules-based URL rewriting engine**. Rewrite rules define the logic used to analyze request URLs and map them to rewite URLs when the request URL matches a defined rule. Web server and site administrators can use rewrite rule sets to define URL rewriting logic. -- **Regular expression pattern matching**. Rewrite rules can use regular expression syntax for pattern matching as defined in [ECMA-262](http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf). +- **Regular expression pattern matching**. Rewrite rules can use regular expression syntax for pattern matching as defined in ECMA-262. - **Wildcard pattern matching.** Rewrite rules can use wildcard syntax for pattern matching. - **Global and distributed rewrite rules**. URL Rewrite uses global rules to define server-wide URL rewriting logic. These rules are defined within the applicationHost.config file, and they supercede rules configured at lower levels in the configuration hierarchy. The module also uses distributed rules to define URL rewrite logic specific to a particular configuration scope. This type of rule can be defined on any configuration level by using Web.config files. - **Access to server variables and HTTP headers**. Server variables and HTTP headers provide additional information about current HTTP requests. This information can be used to configure rewrite rules or to compose the output URL. @@ -72,7 +72,6 @@ These articles cover the functionality of the URL Rewrite Module and explain how - [Using global and distributed rules](using-global-and-distributed-rewrite-rules.md "Using global and distributed rewrite rules") - [Using Rewrite maps](using-rewrite-maps-in-url-rewrite-module.md "Using rewrite maps") - [Importing Apache mod\_rewrite rules](importing-apache-modrewrite-rules.md "Importing rewrite rules") -- [Enabling Pretty Permalinks in WordPress](enabling-pretty-permalinks-in-wordpress.md "Enabling Pretty Permalinks") - [Rule templates](rule-templates-overview.md) - [User Friendly URL](user-friendly-url-rule-template.md) diff --git a/iis/extensions/using-iis-express/handling-url-binding-failures-in-iis-express.md b/iis/extensions/using-iis-express/handling-url-binding-failures-in-iis-express.md index c7137a6a6..cb6054c58 100644 --- a/iis/extensions/using-iis-express/handling-url-binding-failures-in-iis-express.md +++ b/iis/extensions/using-iis-express/handling-url-binding-failures-in-iis-express.md @@ -28,7 +28,7 @@ HTTP.sys is an operating system component that handles HTTP and SSL traffic for - Serving external traffic - Using SSL -You can configure HTTP.sys to permit these operations for IIS Express. On Windows 7 and Windows Vista, you can configure HTTP.sys using the [netsh.exe](/windows/win32/http/netsh-commands-for-http) utility. On Windows XP, HTTP.sys can be configured using the [httpcfg.exe](/previous-versions/windows/it-pro/windows-server-2003/cc781601(v=ws.10)) command-line utility, which is included with [Windows XP Service Pack 2 Support Tools](https://www.microsoft.com/downloads/en/details.aspx?familyid=49AE8576-9BB9-4126-9761-BA8011FABF38&displaylang=en). +You can configure HTTP.sys to permit these operations for IIS Express. On Windows 7 and Windows Vista, you can configure HTTP.sys using the [netsh.exe](/windows/win32/http/netsh-commands-for-http) utility. On Windows XP, HTTP.sys can be configured using the [httpcfg.exe](/previous-versions/windows/it-pro/windows-server-2003/cc781601(v=ws.10)) command-line utility, which is included with Windows XP Service Pack 2 Support Tools. ## Using a Reserved Port diff --git a/iis/extensions/using-iis-express/using-the-windows-system-tray-to-manage-websites-and-applications.md b/iis/extensions/using-iis-express/using-the-windows-system-tray-to-manage-websites-and-applications.md index d1dfd4663..61f293cf4 100644 --- a/iis/extensions/using-iis-express/using-the-windows-system-tray-to-manage-websites-and-applications.md +++ b/iis/extensions/using-iis-express/using-the-windows-system-tray-to-manage-websites-and-applications.md @@ -13,7 +13,7 @@ by [Diana Nguyen](https://twitter.com/dianaaanguyen) ## Overview -This walkthrough discusses how to manage your websites and applications in WebMatrix Beta using the system tray. This feature lets you manage all running sites from the same system tray. +This walkthrough discusses how to manage your websites and applications using the system tray. This feature lets you manage all running sites from the same system tray. This walkthrough assumes that you have installed two or more websites and applications on your server. @@ -22,29 +22,10 @@ This walkthrough assumes that you have installed two or more websites and applic You must have the following installed to complete the procedures in this walkthrough: - Windows XP or newer -- WebMatrix Beta - -For information about how to install WebMatrix Beta, see [Microsoft Web Platform Installer 3.0](https://go.microsoft.com/fwlink/?LinkID=145510). ## Managing Sites and Applications with the System Tray -1. Click **Start** > **All Programs** > **Microsoft WebMatrix**. -2. On the WebMatrix Beta **Quick** **Start** page, click **My Sites**. - - ![Screenshot of the WebMatrix Beta Quick Start page.](using-the-windows-system-tray-to-manage-websites-and-applications/_static/image1.png) - -3. On the **Choose a Site** page, select the site that you want to open, and then click **OK**. - ![Screenshot of the WebMatrix Beta Quick Start Window displaying the Choose a Site page.](using-the-windows-system-tray-to-manage-websites-and-applications/_static/image5.png) -4. WebMatrix opens your site. - - ![Screenshot of the site opened by WebMatrix.](using-the-windows-system-tray-to-manage-websites-and-applications/_static/image7.png) - -5. Repeat steps 1 – 3 to open a second site. - - > [!NOTE] - > If you do not already have a second site, you can add a new one by choosing **Site from Web Gallery**, **Site From Template**, or **Site From Folder**. - -6. Right-click **WebMatrix** in the system tray. If you do not see the icon, click **Show hidden icons** to display the icon. +1. Right-click **IIS Express** in the system tray. If you do not see the icon, click **Show hidden icons** to display the icon. ![Screenshot of the the system tray with the Show hidden icons selection highlighted.](using-the-windows-system-tray-to-manage-websites-and-applications/_static/image11.png) @@ -71,4 +52,4 @@ Click the notification for more information, including a detailed error message ![Screenshot of the detailed error message dialog box.](using-the-windows-system-tray-to-manage-websites-and-applications/_static/image19.png) -For more information about IIS Express, see [Use the Command Line to Run a WebMatrix Site](https://go.microsoft.com/fwlink/?LinkId=195514). +For more information about IIS Express, see [Use the Command Line to Run a Site](https://go.microsoft.com/fwlink/?LinkId=195514). diff --git a/iis/extensions/web-platform-installer/microsoft-web-platform-installer.md b/iis/extensions/web-platform-installer/microsoft-web-platform-installer.md deleted file mode 100644 index b14112c4e..000000000 --- a/iis/extensions/web-platform-installer/microsoft-web-platform-installer.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Microsoft Web Platform Installer -description: The Microsoft Web Platform Installer (Web PI) is a free tool that makes it simple to download, install and keep up-to-date with the latest components of the Microsoft Web Platform, including Internet Information Services (IIS), IIS Media Platform technologies, SQL Server Express, .NET Framework, and Visual Web Developer. -TOCTitle: Microsoft Web Platform Installer -ms:assetid: 911e4cdf-e972-4b68-8962-83f042ea229d -ms:mtpsurl: https://msdn.microsoft.com/library/Hh943101(v=VS.90) -ms:contentKeyID: 46305596 -ms.date: 05/02/2012 -mtps_version: v=VS.90 ---- - -# Microsoft Web Platform Installer - -The Microsoft Web Platform Installer (Web PI) is a free tool that makes it simple to download, install and keep up-to-date with the latest components of the Microsoft Web Platform, including Internet Information Services (IIS), IIS Media Platform technologies, SQL Server Express, .NET Framework, and Visual Web Developer. - -## In This Section - -The Web Platform Installer includes a set of Application Programming Interfaces (APIs) that provide programmatic access to the Web Platform Installer user interface, packages, installers, and associated feeds, group, and other objects. - -|Namespace|Description| -|--- |--- | -|[Microsoft.Web.PlatformInstaller](https://msdn.microsoft.com/library/microsoft.web.platforminstaller)|Web Platform Installer APIs.| - -## See Also - -### Other Resources - -[Microsoft Web Platform Installer](https://go.microsoft.com/fwlink/?linkid=247915) diff --git a/iis/extensions/web-platform-installer/toc.yml b/iis/extensions/web-platform-installer/toc.yml deleted file mode 100644 index 5c0f9ed23..000000000 --- a/iis/extensions/web-platform-installer/toc.yml +++ /dev/null @@ -1,659 +0,0 @@ -- name: Microsoft Web Platform Installer - href: microsoft-web-platform-installer.md - items: - - name: Microsoft.Web.PlatformInstaller Namespace - href: /dotnet/api/microsoft.web.platforminstaller - items: - - name: Architecture Enumeration - href: /dotnet/api/microsoft.web.platforminstaller.architecture - - name: DatabaseProvider Enumeration - href: /dotnet/api/microsoft.web.platforminstaller.databaseprovider - - name: DeclaredParameter Class - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter - items: - - name: DeclaredParameter Members - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter - - name: DeclaredParameter Methods - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter#methods - - name: 'DeclaredParameter Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter#properties - items: - - name: 'DefaultValue Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.defaultvalue#microsoft_web_platforminstaller_declaredparameter_defaultvalue - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.description#microsoft_web_platforminstaller_declaredparameter_description - - name: 'FriendlyName Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.friendlyname#microsoft_web_platforminstaller_declaredparameter_friendlyname - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.name#microsoft_web_platforminstaller_declaredparameter_name - - name: 'RawTags Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.rawtags#microsoft_web_platforminstaller_declaredparameter_rawtags - - name: 'Tags Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.tags#microsoft_web_platforminstaller_declaredparameter_tags - - name: 'Validation Property ' - href: /dotnet/api/microsoft.web.platforminstaller.declaredparameter.validation#microsoft_web_platforminstaller_declaredparameter_validation - - name: Feed Class - href: /dotnet/api/microsoft.web.platforminstaller.feed - items: - - name: Feed Members - href: /dotnet/api/microsoft.web.platforminstaller.feed - - name: Feed Methods - href: /dotnet/api/microsoft.web.platforminstaller.feed#methods - - name: 'Feed Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.feed#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.feed.description#microsoft_web_platforminstaller_feed_description - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.feed.name#microsoft_web_platforminstaller_feed_name - - name: 'Url Property ' - href: /dotnet/api/microsoft.web.platforminstaller.feed.url#microsoft_web_platforminstaller_feed_url - - name: Group Class - href: /dotnet/api/microsoft.web.platforminstaller.group - items: - - name: Group Members - href: /dotnet/api/microsoft.web.platforminstaller.group - - name: Group Methods - href: /dotnet/api/microsoft.web.platforminstaller.group#methods - - name: 'Group Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.group#properties - items: - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.group.name#microsoft_web_platforminstaller_group_name - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.group.products#microsoft_web_platforminstaller_group_products - - name: GroupTab Class - href: /dotnet/api/microsoft.web.platforminstaller.grouptab - items: - - name: GroupTab Members - href: /dotnet/api/microsoft.web.platforminstaller.grouptab - - name: GroupTab Methods - href: /dotnet/api/microsoft.web.platforminstaller.grouptab#methods - - name: 'GroupTab Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.grouptab#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.grouptab.description#microsoft_web_platforminstaller_grouptab_description - - name: 'Groups Property ' - href: /dotnet/api/microsoft.web.platforminstaller.grouptab.groups#microsoft_web_platforminstaller_grouptab_groups - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.grouptab.name#microsoft_web_platforminstaller_grouptab_name - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.grouptab.products#microsoft_web_platforminstaller_grouptab_products - - name: InstallationState Enumeration - href: /dotnet/api/microsoft.web.platforminstaller.installationstate - - name: InstallCommand Class - href: /dotnet/api/microsoft.web.platforminstaller.installcommand - items: - - name: InstallCommand Members - href: /dotnet/api/microsoft.web.platforminstaller.installcommand - - name: 'InstallCommand Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.-ctor#microsoft_web_platforminstaller_installcommand__ctor_microsoft_web_platforminstaller_installer_ - - name: InstallCommand Methods - href: /dotnet/api/microsoft.web.platforminstaller.installcommand#methods - items: - - name: 'ReplaceEnvironmentVariables Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.replaceenvironmentvariables#microsoft_web_platforminstaller_installcommand_replaceenvironmentvariables_system_string_ - - name: 'InstallCommand Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand#properties - items: - - name: 'Done Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.done#microsoft_web_platforminstaller_installcommand_done - - name: 'EnvironmentVariables Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.environmentvariables#microsoft_web_platforminstaller_installcommand_environmentvariables - - name: 'Installer Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.installer#microsoft_web_platforminstaller_installcommand_installer - - name: 'InstallReturnCode Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installcommand.installreturncode#microsoft_web_platforminstaller_installcommand_installreturncode - - name: Installer Class - href: /dotnet/api/microsoft.web.platforminstaller.installer - items: - - name: Installer Members - href: /dotnet/api/microsoft.web.platforminstaller.installer - - name: Installer Methods - href: /dotnet/api/microsoft.web.platforminstaller.installer#methods - items: - - name: 'ClearPerInstallLogFiles Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.clearperinstalllogfiles#microsoft_web_platforminstaller_installer_clearperinstalllogfiles - - name: 'Installer Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installer#properties - items: - - name: 'EulaUrl Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.eulaurl#microsoft_web_platforminstaller_installer_eulaurl - - name: 'HelpLink Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.helplink#microsoft_web_platforminstaller_installer_helplink - - name: 'InstallCommands Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.installcommands#microsoft_web_platforminstaller_installer_installcommands - - name: 'InstallerFile Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.installerfile#microsoft_web_platforminstaller_installer_installerfile - - name: 'Language Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.language#microsoft_web_platforminstaller_installer_language - - name: 'LogFiles Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.logfiles#microsoft_web_platforminstaller_installer_logfiles - - name: 'MSDeployPackage Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.msdeploypackage#microsoft_web_platforminstaller_installer_msdeploypackage - - name: 'Product Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installer.product#microsoft_web_platforminstaller_installer_product - - name: InstallerContext Class - href: /dotnet/api/microsoft.web.platforminstaller.installercontext - items: - - name: InstallerContext Members - href: /dotnet/api/microsoft.web.platforminstaller.installercontext - - name: InstallerContext Methods - href: /dotnet/api/microsoft.web.platforminstaller.installercontext#methods - - name: 'InstallerContext Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext#properties - items: - - name: 'Id Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.id#microsoft_web_platforminstaller_installercontext_id - - name: 'InstallationState Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.installationstate#microsoft_web_platforminstaller_installercontext_installationstate - - name: 'Installer Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.installer#microsoft_web_platforminstaller_installercontext_installer - - name: 'InstallStateDetails Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.installstatedetails#microsoft_web_platforminstaller_installercontext_installstatedetails - - name: 'LogFileDirectory Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.logfiledirectory#microsoft_web_platforminstaller_installercontext_logfiledirectory - - name: 'ProductName Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.productname#microsoft_web_platforminstaller_installercontext_productname - - name: 'ReturnCode Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installercontext.returncode#microsoft_web_platforminstaller_installercontext_returncode - - name: InstallerFile Class - href: /dotnet/api/microsoft.web.platforminstaller.installerfile - items: - - name: InstallerFile Members - href: /dotnet/api/microsoft.web.platforminstaller.installerfile - - name: 'InstallerFile Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.-ctor#microsoft_web_platforminstaller_installerfile__ctor - - name: InstallerFile Methods - href: /dotnet/api/microsoft.web.platforminstaller.installerfile#methods - - name: 'InstallerFile Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile#properties - items: - - name: 'DownloadedLocation Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.downloadedlocation#microsoft_web_platforminstaller_installerfile_downloadedlocation - - name: 'FileSize Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.filesize#microsoft_web_platforminstaller_installerfile_filesize - - name: 'InstallerUrl Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.installerurl#microsoft_web_platforminstaller_installerfile_installerurl - - name: 'SHA1Hash Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.sha1hash#microsoft_web_platforminstaller_installerfile_sha1hash - - name: 'TrackingUrl Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.trackingurl#microsoft_web_platforminstaller_installerfile_trackingurl - - name: 'TrustVerified Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installerfile.trustverified#microsoft_web_platforminstaller_installerfile_trustverified - - name: InstallManager Class - href: /dotnet/api/microsoft.web.platforminstaller.installmanager - items: - - name: InstallManager Members - href: /dotnet/api/microsoft.web.platforminstaller.installmanager - - name: 'InstallManager Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.-ctor#microsoft_web_platforminstaller_installmanager__ctor - - name: InstallManager Methods - href: /dotnet/api/microsoft.web.platforminstaller.installmanager#methods - items: - - name: 'Cancel Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.cancel#microsoft_web_platforminstaller_installmanager_cancel - - name: 'DeleteInstallerFiles Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.deleteinstallerfiles#microsoft_web_platforminstaller_installmanager_deleteinstallerfiles - - name: 'Dispose Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.dispose#microsoft_web_platforminstaller_installmanager_dispose - - name: 'DownloadInstallerFile Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.downloadinstallerfile#microsoft_web_platforminstaller_installmanager_downloadinstallerfile_microsoft_web_platforminstaller_installercontext_system_string__ - - name: 'Load Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.load#overloads - items: - - name: Load Method () - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.load#microsoft_web_platforminstaller_installmanager_load_system_string_ - - name: Load Method ((Installer)) - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.load#microsoft_web_platforminstaller_installmanager_load_system_collections_generic_ienumerable_microsoft_web_platforminstaller_installer__ - - name: Load Method (, ) - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.load - - name: 'Save Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.save#overloads - items: - - name: Save Method () - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.save#microsoft_web_platforminstaller_installmanager_save_system_string_ - - name: Save Method (, ) - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.save - - name: 'StartApplicationInstallation Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.startapplicationinstallation#overloads - items: - - name: 'StartApplicationInstallation Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.startapplicationinstallation#microsoft_web_platforminstaller_installmanager_startapplicationinstallation - - name: StartApplicationInstallation Method (, ) - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.startapplicationinstallation#microsoft_web_platforminstaller_installmanager_startapplicationinstallation_system_string_system_string_ - - name: 'StartInstallation Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.startinstallation#microsoft_web_platforminstaller_installmanager_startinstallation - - name: 'StartSynchronousInstallation Method ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.startsynchronousinstallation#microsoft_web_platforminstaller_installmanager_startsynchronousinstallation - - name: 'InstallManager Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager#properties - items: - - name: 'InstallerContexts Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.installercontexts#microsoft_web_platforminstaller_installmanager_installercontexts - - name: 'RebootRequired Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.rebootrequired#microsoft_web_platforminstaller_installmanager_rebootrequired - - name: InstallManager Events - href: /dotnet/api/microsoft.web.platforminstaller.installmanager#events - items: - - name: InstallCompleted Event - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.installcompleted - - name: InstallerStatusUpdated Event - href: /dotnet/api/microsoft.web.platforminstaller.installmanager.installerstatusupdated - - name: InstallReturnCode Class - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode - items: - - name: InstallReturnCode Members - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode - - name: 'InstallReturnCode Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode.-ctor#microsoft_web_platforminstaller_installreturncode__ctor_microsoft_web_platforminstaller_installreturncodestatus_system_string_ - - name: InstallReturnCode Methods - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode#methods - - name: 'InstallReturnCode Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode#properties - items: - - name: 'DetailedInformation Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode.detailedinformation#microsoft_web_platforminstaller_installreturncode_detailedinformation - - name: 'Status Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installreturncode.status#microsoft_web_platforminstaller_installreturncode_status - - name: InstallReturnCodeStatus Enumeration - href: /dotnet/api/microsoft.web.platforminstaller.installreturncodestatus - - name: InstallStatusEventArgs Class - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs - items: - - name: InstallStatusEventArgs Members - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs - - name: InstallStatusEventArgs Methods - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs#methods - - name: 'InstallStatusEventArgs Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs#properties - items: - - name: 'DownloadRate Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs.downloadrate#microsoft_web_platforminstaller_installstatuseventargs_downloadrate - - name: 'InstallerContext Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs.installercontext#microsoft_web_platforminstaller_installstatuseventargs_installercontext - - name: 'ProgressValue Property ' - href: /dotnet/api/microsoft.web.platforminstaller.installstatuseventargs.progressvalue#microsoft_web_platforminstaller_installstatuseventargs_progressvalue - - name: Keyword Class - href: /dotnet/api/microsoft.web.platforminstaller.keyword - items: - - name: Keyword Members - href: /dotnet/api/microsoft.web.platforminstaller.keyword - - name: Keyword Methods - href: /dotnet/api/microsoft.web.platforminstaller.keyword#methods - - name: 'Keyword Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.keyword#properties - items: - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keyword.products#microsoft_web_platforminstaller_keyword_products - - name: 'Text Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keyword.text#microsoft_web_platforminstaller_keyword_text - - name: KeywordTab Class - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab - items: - - name: KeywordTab Members - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab - - name: KeywordTab Methods - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab#methods - - name: 'KeywordTab Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab.description#microsoft_web_platforminstaller_keywordtab_description - - name: 'Keywords Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab.keywords#microsoft_web_platforminstaller_keywordtab_keywords - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab.name#microsoft_web_platforminstaller_keywordtab_name - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.keywordtab.products#microsoft_web_platforminstaller_keywordtab_products - - name: Language Class - href: /dotnet/api/microsoft.web.platforminstaller.language - items: - - name: Language Members - href: /dotnet/api/microsoft.web.platforminstaller.language - - name: Language Methods - href: /dotnet/api/microsoft.web.platforminstaller.language#methods - - name: 'Language Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.language#properties - items: - - name: 'AvailableProducts Property ' - href: /dotnet/api/microsoft.web.platforminstaller.language.availableproducts#microsoft_web_platforminstaller_language_availableproducts - - name: 'Default Property ' - href: /dotnet/api/microsoft.web.platforminstaller.language.default#microsoft_web_platforminstaller_language_default - - name: 'Id Property ' - href: /dotnet/api/microsoft.web.platforminstaller.language.id#microsoft_web_platforminstaller_language_id - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.language.name#microsoft_web_platforminstaller_language_name - - name: Logging Class - href: /dotnet/api/microsoft.web.platforminstaller.logging - items: - - name: Logging Members - href: /dotnet/api/microsoft.web.platforminstaller.logging - - name: Logging Methods - href: /dotnet/api/microsoft.web.platforminstaller.logging#methods - items: - - name: 'LogMessage Method ' - href: /dotnet/api/microsoft.web.platforminstaller.logging.logmessage#overloads - items: - - name: LogMessage Method (, ) - href: /dotnet/api/microsoft.web.platforminstaller.logging.logmessage#microsoft_web_platforminstaller_logging_logmessage_system_diagnostics_traceeventtype_system_string_ - - name: LogMessage Method (, , []) - href: /dotnet/api/microsoft.web.platforminstaller.logging.logmessage#microsoft_web_platforminstaller_logging_logmessage_system_diagnostics_traceeventtype_system_string_system_object___ - - name: 'Logging Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.logging#properties - items: - - name: 'TraceSource Property ' - href: /dotnet/api/microsoft.web.platforminstaller.logging.tracesource#microsoft_web_platforminstaller_logging_tracesource - - name: MSDeployPackage Class - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage - items: - - name: MSDeployPackage Members - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage - - name: MSDeployPackage Methods - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage#methods - items: - - name: 'GetDBConnectionErrorString Method ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.getdbconnectionerrorstring#microsoft_web_platforminstaller_msdeploypackage_getdbconnectionerrorstring_microsoft_web_platforminstaller_databaseprovider_ - - name: 'SetConfigurationAndWebServerDirectories Method ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.setconfigurationandwebserverdirectories#microsoft_web_platforminstaller_msdeploypackage_setconfigurationandwebserverdirectories_system_string_system_string_ - - name: 'ShouldShowOverwriteWarning Method ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.shouldshowoverwritewarning#microsoft_web_platforminstaller_msdeploypackage_shouldshowoverwritewarning - - name: 'MSDeployPackage Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage#properties - items: - - name: 'AppPath Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.apppath#microsoft_web_platforminstaller_msdeploypackage_apppath - - name: 'DeclaredParameters Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.declaredparameters#microsoft_web_platforminstaller_msdeploypackage_declaredparameters - - name: 'IsAspNet2Application Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.isaspnet2application#microsoft_web_platforminstaller_msdeploypackage_isaspnet2application - - name: 'IsAspNet4Application Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.isaspnet4application#microsoft_web_platforminstaller_msdeploypackage_isaspnet4application - - name: 'IsPhpApplication Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.isphpapplication#microsoft_web_platforminstaller_msdeploypackage_isphpapplication - - name: 'PackageLocation Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.packagelocation#microsoft_web_platforminstaller_msdeploypackage_packagelocation - - name: 'RemoveParameters Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.removeparameters#microsoft_web_platforminstaller_msdeploypackage_removeparameters - - name: 'SetParameters Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.setparameters#microsoft_web_platforminstaller_msdeploypackage_setparameters - - name: 'Site Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.site#microsoft_web_platforminstaller_msdeploypackage_site - - name: 'SkipDirectives Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.skipdirectives#microsoft_web_platforminstaller_msdeploypackage_skipdirectives - - name: 'StartPage Property ' - href: /dotnet/api/microsoft.web.platforminstaller.msdeploypackage.startpage#microsoft_web_platforminstaller_msdeploypackage_startpage - - name: Pillar Class - href: /dotnet/api/microsoft.web.platforminstaller.pillar - items: - - name: Pillar Members - href: /dotnet/api/microsoft.web.platforminstaller.pillar - - name: Pillar Methods - href: /dotnet/api/microsoft.web.platforminstaller.pillar#methods - - name: 'Pillar Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar.description#microsoft_web_platforminstaller_pillar_description - - name: 'Groups Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar.groups#microsoft_web_platforminstaller_pillar_groups - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar.name#microsoft_web_platforminstaller_pillar_name - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar.products#microsoft_web_platforminstaller_pillar_products - - name: 'Recommended Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillar.recommended#microsoft_web_platforminstaller_pillar_recommended - - name: PillarTab Class - href: /dotnet/api/microsoft.web.platforminstaller.pillartab - items: - - name: PillarTab Members - href: /dotnet/api/microsoft.web.platforminstaller.pillartab - - name: PillarTab Methods - href: /dotnet/api/microsoft.web.platforminstaller.pillartab#methods - - name: 'PillarTab Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.pillartab#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillartab.description#microsoft_web_platforminstaller_pillartab_description - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillartab.name#microsoft_web_platforminstaller_pillartab_name - - name: 'Pillars Property ' - href: /dotnet/api/microsoft.web.platforminstaller.pillartab.pillars#microsoft_web_platforminstaller_pillartab_pillars - - name: PreferenceSettings Class - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings - items: - - name: PreferenceSettings Members - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings - - name: PreferenceSettings Methods - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings#methods - - name: 'PreferenceSettings Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings#properties - items: - - name: 'Feeds Property ' - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings.feeds#microsoft_web_platforminstaller_preferencesettings_feeds - - name: 'Text Property ' - href: /dotnet/api/microsoft.web.platforminstaller.preferencesettings.text#microsoft_web_platforminstaller_preferencesettings_text - - name: Product Class - href: /dotnet/api/microsoft.web.platforminstaller.product - items: - - name: Product Members - href: /dotnet/api/microsoft.web.platforminstaller.product - - name: Product Methods - href: /dotnet/api/microsoft.web.platforminstaller.product#methods - items: - - name: 'GetAttributeValue Method ' - href: /dotnet/api/microsoft.web.platforminstaller.product.getattributevalue#microsoft_web_platforminstaller_product_getattributevalue_system_string_ - - name: 'GetIncompatibleOrMissingExternalProduct Method ' - href: /dotnet/api/microsoft.web.platforminstaller.product.getincompatibleormissingexternalproduct#microsoft_web_platforminstaller_product_getincompatibleormissingexternalproduct_system_collections_generic_ienumerable_microsoft_web_platforminstaller_product__system_string__microsoft_web_platforminstaller_product__ - - name: 'GetInstaller Method ' - href: /dotnet/api/microsoft.web.platforminstaller.product.getinstaller#microsoft_web_platforminstaller_product_getinstaller_microsoft_web_platforminstaller_language_ - - name: 'GetMissingDependencies Method ' - href: /dotnet/api/microsoft.web.platforminstaller.product.getmissingdependencies#overloads - items: - - name: GetMissingDependencies Method ((Product)) - href: /dotnet/api/microsoft.web.platforminstaller.product.getmissingdependencies#microsoft_web_platforminstaller_product_getmissingdependencies_system_collections_generic_ienumerable_microsoft_web_platforminstaller_product__ - - name: GetMissingDependencies Method ((Product), Product) - href: /dotnet/api/microsoft.web.platforminstaller.product.getmissingdependencies#microsoft_web_platforminstaller_product_getmissingdependencies_system_collections_generic_ienumerable_microsoft_web_platforminstaller_product__microsoft_web_platforminstaller_product_ - - name: 'IsInstalled Method ' - href: /dotnet/api/microsoft.web.platforminstaller.product.isinstalled#microsoft_web_platforminstaller_product_isinstalled_system_boolean_ - - name: 'Product Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.product#properties - items: - - name: 'Author Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.author#microsoft_web_platforminstaller_product_author - - name: 'AuthorUri Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.authoruri#microsoft_web_platforminstaller_product_authoruri - - name: 'External Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.external#microsoft_web_platforminstaller_product_external - - name: 'ExternalWarningShown Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.externalwarningshown#microsoft_web_platforminstaller_product_externalwarningshown - - name: 'FeedLocation Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.feedlocation#microsoft_web_platforminstaller_product_feedlocation - - name: 'IconUrl Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.iconurl#microsoft_web_platforminstaller_product_iconurl - - name: 'Installers Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.installers#microsoft_web_platforminstaller_product_installers - - name: 'IsApplication Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.isapplication#microsoft_web_platforminstaller_product_isapplication - - name: 'IsIisComponent Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.isiiscomponent#microsoft_web_platforminstaller_product_isiiscomponent - - name: 'IsUpdate Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.isupdate#microsoft_web_platforminstaller_product_isupdate - - name: 'Keywords Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.keywords#microsoft_web_platforminstaller_product_keywords - - name: 'Link Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.link#microsoft_web_platforminstaller_product_link - - name: 'LongDescription Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.longdescription#microsoft_web_platforminstaller_product_longdescription - - name: 'ProductId Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.productid#microsoft_web_platforminstaller_product_productid - - name: 'Published Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.published#microsoft_web_platforminstaller_product_published - - name: 'RelatedProducts Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.relatedproducts#microsoft_web_platforminstaller_product_relatedproducts - - name: 'SelectedInstaller Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.selectedinstaller#microsoft_web_platforminstaller_product_selectedinstaller - - name: 'Summary Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.summary#microsoft_web_platforminstaller_product_summary - - name: 'Terms Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.terms#microsoft_web_platforminstaller_product_terms - - name: 'Title Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.title#microsoft_web_platforminstaller_product_title - - name: 'Updates Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.updates#microsoft_web_platforminstaller_product_updates - - name: 'Version Property ' - href: /dotnet/api/microsoft.web.platforminstaller.product.version#microsoft_web_platforminstaller_product_version - - name: ProductManager Class - href: /dotnet/api/microsoft.web.platforminstaller.productmanager - items: - - name: ProductManager Members - href: /dotnet/api/microsoft.web.platforminstaller.productmanager - - name: 'ProductManager Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.-ctor#microsoft_web_platforminstaller_productmanager__ctor - - name: ProductManager Methods - href: /dotnet/api/microsoft.web.platforminstaller.productmanager#methods - items: - - name: 'GetKeyword Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.getkeyword#microsoft_web_platforminstaller_productmanager_getkeyword_system_string_ - - name: 'GetLanguage Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.getlanguage#microsoft_web_platforminstaller_productmanager_getlanguage_system_string_ - - name: 'GetProduct Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.getproduct#microsoft_web_platforminstaller_productmanager_getproduct_system_string_ - - name: 'GetTab Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.gettab#microsoft_web_platforminstaller_productmanager_gettab_system_string_ - - name: 'Load Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#overloads - items: - - name: Load Method () - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#microsoft_web_platforminstaller_productmanager_load_system_uri_ - - name: Load Method (, ) - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#microsoft_web_platforminstaller_productmanager_load_system_uri_system_boolean_ - - name: Load Method (, , ) - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#microsoft_web_platforminstaller_productmanager_load_system_uri_system_boolean_system_boolean_ - - name: Load Method (, , , , ) - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#microsoft_web_platforminstaller_productmanager_load_system_uri_system_boolean_system_boolean_system_boolean_system_string_ - - name: Load Method (, , , , , Architecture, , , , , ) - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.load#microsoft_web_platforminstaller_productmanager_load_system_uri_system_boolean_system_boolean_system_boolean_system_string_microsoft_web_platforminstaller_architecture_system_int32_system_int32_system_int32_system_int32_system_int32_ - - name: 'LoadExternalFile Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.loadexternalfile#microsoft_web_platforminstaller_productmanager_loadexternalfile_system_uri_ - - name: 'SetResourceLanguage Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.setresourcelanguage#microsoft_web_platforminstaller_productmanager_setresourcelanguage_system_string_ - - name: 'UpdateWebPlatformBinary Method ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.updatewebplatformbinary#microsoft_web_platforminstaller_productmanager_updatewebplatformbinary - - name: 'ProductManager Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager#properties - items: - - name: 'Keywords Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.keywords#microsoft_web_platforminstaller_productmanager_keywords - - name: 'Languages Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.languages#microsoft_web_platforminstaller_productmanager_languages - - name: 'PreferenceSettings Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.preferencesettings#microsoft_web_platforminstaller_productmanager_preferencesettings - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.products#microsoft_web_platforminstaller_productmanager_products - - name: 'QuickStartGroups Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.quickstartgroups#microsoft_web_platforminstaller_productmanager_quickstartgroups - - name: 'ResourceLanguages Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.resourcelanguages#microsoft_web_platforminstaller_productmanager_resourcelanguages - - name: 'Tabs Property ' - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.tabs#microsoft_web_platforminstaller_productmanager_tabs - - name: ProductManager Events - href: /dotnet/api/microsoft.web.platforminstaller.productmanager#events - items: - - name: WebPlatformInstallerUpdateAvailable Event - href: /dotnet/api/microsoft.web.platforminstaller.productmanager.webplatforminstallerupdateavailable - - name: QuickStartGroup Class - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup - items: - - name: QuickStartGroup Members - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup - - name: QuickStartGroup Methods - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup#methods - - name: 'QuickStartGroup Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup#properties - items: - - name: 'BetaProducts Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.betaproducts#microsoft_web_platforminstaller_quickstartgroup_betaproducts - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.description#microsoft_web_platforminstaller_quickstartgroup_description - - name: 'DevelopmentProducts Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.developmentproducts#microsoft_web_platforminstaller_quickstartgroup_developmentproducts - - name: 'Id Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.id#microsoft_web_platforminstaller_quickstartgroup_id - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.name#microsoft_web_platforminstaller_quickstartgroup_name - - name: 'Products Property ' - href: /dotnet/api/microsoft.web.platforminstaller.quickstartgroup.products#microsoft_web_platforminstaller_quickstartgroup_products - - name: RelatedProduct Class - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct - items: - - name: RelatedProduct Members - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct - - name: RelatedProduct Methods - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct#methods - items: - - name: 'IsRelatedInstalled Method ' - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct.isrelatedinstalled#overloads - items: - - name: 'IsRelatedInstalled Method ' - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct.isrelatedinstalled#microsoft_web_platforminstaller_relatedproduct_isrelatedinstalled - - name: IsRelatedInstalled Method () - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct.isrelatedinstalled#microsoft_web_platforminstaller_relatedproduct_isrelatedinstalled_system_boolean_ - - name: 'RelatedProduct Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct#properties - items: - - name: 'Product Property ' - href: /dotnet/api/microsoft.web.platforminstaller.relatedproduct.product#microsoft_web_platforminstaller_relatedproduct_product - - name: Tab Class - href: /dotnet/api/microsoft.web.platforminstaller.tab - items: - - name: Tab Members - href: /dotnet/api/microsoft.web.platforminstaller.tab - - name: 'Tab Constructor ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.-ctor#microsoft_web_platforminstaller_tab__ctor_microsoft_web_platforminstaller_productmanager_ - - name: Tab Methods - href: /dotnet/api/microsoft.web.platforminstaller.tab#methods - - name: 'Tab Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.tab#properties - items: - - name: 'Description Property ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.description#microsoft_web_platforminstaller_tab_description - - name: 'FeedList Property ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.feedlist#microsoft_web_platforminstaller_tab_feedlist - - name: 'FromCustomFeed Property ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.fromcustomfeed#microsoft_web_platforminstaller_tab_fromcustomfeed - - name: 'Id Property ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.id#microsoft_web_platforminstaller_tab_id - - name: 'Name Property ' - href: /dotnet/api/microsoft.web.platforminstaller.tab.name#microsoft_web_platforminstaller_tab_name - - name: Terms Class - href: /dotnet/api/microsoft.web.platforminstaller.terms - items: - - name: Terms Members - href: /dotnet/api/microsoft.web.platforminstaller.terms - - name: Terms Methods - href: /dotnet/api/microsoft.web.platforminstaller.terms#methods - - name: 'Terms Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.terms#properties - items: - - name: 'TermsLink Property ' - href: /dotnet/api/microsoft.web.platforminstaller.terms.termslink#microsoft_web_platforminstaller_terms_termslink - - name: 'TermsLinkText Property ' - href: /dotnet/api/microsoft.web.platforminstaller.terms.termslinktext#microsoft_web_platforminstaller_terms_termslinktext - - name: 'TermsText Property ' - href: /dotnet/api/microsoft.web.platforminstaller.terms.termstext#microsoft_web_platforminstaller_terms_termstext - - name: UpdateAvailableEventArgs Class - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs - items: - - name: UpdateAvailableEventArgs Members - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs - - name: UpdateAvailableEventArgs Methods - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs#methods - - name: 'UpdateAvailableEventArgs Properties ' - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs#properties - items: - - name: 'Caption Property ' - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs.caption#microsoft_web_platforminstaller_updateavailableeventargs_caption - - name: 'Text Property ' - href: /dotnet/api/microsoft.web.platforminstaller.updateavailableeventargs.text#microsoft_web_platforminstaller_updateavailableeventargs_text diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios.md b/iis/extensions/working-with-urlscan/common-urlscan-scenarios.md deleted file mode 100644 index 8a3ff0e0e..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios.md +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: "Common UrlScan Scenarios" -author: naziml -description: "This article provides a list of common usage scenarios for UrlScan Version 3.1, and how to enable the scenarios using the UrlScan.ini configuration. Creating..." -ms.date: 06/24/2008 -ms.assetid: f159ad3c-db09-4c37-b563-746d824b4cb1 -msc.legacyurl: /learn/extensions/working-with-urlscan/common-urlscan-scenarios -msc.type: authoredcontent ---- -# Common UrlScan Scenarios - -by [Nazim Lala](https://github.com/naziml) - -This article provides a list of common usage scenarios for UrlScan Version 3.1, and how to enable the scenarios using the UrlScan.ini configuration. - -## Creating Rules to Disallow String Patterns in Parts of Requests - -A new feature added for UrlScan Version 3.1 is the ability to create a rule list that will let you specify rules to disallow requests based on patterns matched against certain portions of an HTTP request. The main configuration for this is the **RuleList** key under the **[Options]** section. The value of this key is a comma delimited list of section names that define the rules. Here's what defining a rule "Foo" would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample1.cmd)] - -**RuleList** under **[Options]** lists out all the rules to be run. In the case I have a rule "Foo" I need to evaluate. This could be multiple comma delimited rules as well. A section with the same name **[Foo]** will define the rule and if any item on the RuleList does not have a section declared the filter will log a configuration error to the log file. Under this section the **AppliesTo** key specifies which file extension this rule applies to. The **DenyDataSection** key specifies the section that contains the string patterns that are to be matched against for this rule. As you can see there is a **[Foo Strings]** section that has three patterns in it. This list is case insensitive and allows entering encoded values of the format %XX, where XX are hexadecimal digits. The other keys in the **[Foo]** section specify what parts of the request this rule applies to. Your choices include the Url (**ScanUrl**), the raw HTTP request (**ScanAllRaw**), the query string (**ScanQueryString**) or a list of particular headers (**ScanHeaders**). With the exception of **ScanHeaders**, all the other Scan keys expect a boolean value. **ScanHeaders** expects a list of comma delimited values of the actual headers including the colon. So in the case above we are only scanning the "Foo-Header" in a request for a particular string. The last setting in the rule before the data section called (**DenyUnescapedPercent**) is used to scan the specified parts of the request for a % character that is not used as an escape sequence and block requests where any such sequence is found. So setting **DenyUnescapedPercent** to 1 would trigger for a sequence %XX but not for %20 or %u0020, since the latter two represent an escaped [Space] character. This setting has been introduced in UrlScan Version 3.1 and is not present in UrlScan Version 3.0. - -The following request would fail this rule since it has a header called Foo-Header that contains the '--' pattern. - -[!code-console[Main](common-urlscan-scenarios/samples/sample2.cmd)] - -The following request below would fail this rule since Foo-Header contains the '%' character note used to denote an escape sequence. - -[!code-console[Main](common-urlscan-scenarios/samples/sample3.cmd)] - -## Rule to Block SQL injection Signatures - -Before we proceed any further it is important to note that this is not the recommended way to prevent SQL injection in your applications. This is only a stopgap for servers that are under a malicious attack. Such a rule would give you breathing room to go fix your application using [recommended best practices](/previous-versions/cc676512(v=msdn.10)). Also a rule similar to the one below is likely to encounter false positives and fail valid application requests. Another important point to note is that the rule below does nothing to block SQL injection attempts through the request entity body. - -Having said that, if we were to write a generic rule to block SQL injection we could write something like this: - -[!code-console[Main](common-urlscan-scenarios/samples/sample4.cmd)] - -Since we would only want non-static pages to run this rule, I can list out the file extensions we want this apply to using **AppliesTo**. In this case this rule will be run only for classic ASP and ASP.NET requests. The only part we are interested in is the query string and the Cookie Header and we can set the scan options as above to reflect this. The **[Sql Injection Strings]** section defines all the patterns we want to disallow. - -But the rule above is not checking any of the headers. If you wanted to check all headers you would need to trim the strings list to reduce false positives. The shorter sequences of characters and the semicolon could appear in the session cookie for instance and fail valid requests. Also, not all the headers are relevant and so we probably want to trim the headers to those that would actually be used for a SQL injection. The cookie header is a definite candidate for this. You could augment the rule above with something like what is shown below to deal with this. - -[!code-console[Main](common-urlscan-scenarios/samples/sample5.cmd)] - -## Creating Safe-List For URLs and Query Strings - -UrlScan Version 3.1 allows you to specify safe URLs and query strings that will bypass all checks and rules. In UrlScan Version 3.0 they only bypassed URL or query string checks respectively, but in UrlScan Version 3.1 they will bypass all checks and rules. This feature must be used with caution, since wrong configuration in this section could let malicious requests bypass your deny rules. If a user always wants to allow the URL '/my.login.page.asp' for instance even though it might trigger a deny rule defined, you can add configuration as below to allow this. - -[!code-console[Main](common-urlscan-scenarios/samples/sample6.cmd)] - -It is important to note that the leading '/' is required for the URL to be accepted as a valid URL. If a user wants to allow a query string 'session<1' which might otherwise trigger a deny rule defined, you can add configuration as below to allow this. - -[!code-console[Main](common-urlscan-scenarios/samples/sample7.cmd)] - -Note that you do not need to specify query strings leading with the '?' character. - -## Setting Limits on Parts of Requests - -### Limiting the Length of Header Values - -Under **[RequestLimits]** section add the value Max-<Header Name>=<N>, where "Header Name" is the name of the particular header whose value's length you want limited, and "N" is the maximum number of bytes a valid header can be. If "N" is 0, that particular header is effectively disallowed. - -For example, if you do not want the value of the Content-Type header to exceed 100 bytes the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample8.cmd)] - -### Limiting Maximum Content Length for a Request - -Under **[RequestLimits]** section add the value MaxAllowedContentLength=<N> where "N" is the maximum number of bytes allowed for the Content-Length header. If someone were to send more data than the value in the Content-Length header, the data after the length would be interpreted as a separate request. - -For example, if you want to disallow content lengths greater than 1000 bytes the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample9.cmd)] - -### Limiting Maximum Length of a URL - -Under **[RequestLimits]** section add the value MaxUrl=<N> where "N" is the maximum number of characters allowed in the URL of the request. - -For example, if you want to disallow URLs greater than 100 characters long the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample10.cmd)] - -### Limiting Maximum Length of a Query String - -Under **[RequestLimits]** section add the value MaxQueryString=<N> where "N" is the maximum number of characters allowed in the query string of the URL. - -For example, if you want to disallow query strings greater than 100 characters long the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample11.cmd)] - -## Disallowing Certain Types of Requests - -### Creating an allow or deny list of allowed HTTP verbs - -For an allow list create an **[AllowVerbs]** section and add the list of verbs you want to allow. The allow list is case sensitive and is evaluated before the deny list to remain conservative in the evaluation of rules. - -For example, if you want to only allow GET, HEAD and POST verbs the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample12.cmd)] - -For a deny list create a **[DenyVerbs]** section and add the list of verbs you want to disallow. The deny list is case insensitive. - -For example, if you want to disallow WebDAV verbs the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample13.cmd)] - -### Creating an allow or deny list of URI extensions - -For an allow list create an **[AllowExtension]** section and add the list of extensions you want to allow. The allow list is case insensitive and is evaluated before the deny list. - -For example, if you only want to allow .htm and .html files being served the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample14.cmd)] - -For a deny list create a **[DenyExtensions]** section and add the list of extensions you want to disallow. The deny list is case insensitive. - -For example, if you want to disallow executables in your requests the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample15.cmd)] - -### Creating a Deny List of Headers - -To deny a list of headers create a **[DenyHeaders]** section and add the list of headers that you want to disallow. The deny list is case insensitive. - -For example, if you wanted to reject requests with the Transfer-Encoding header the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample16.cmd)] - -### Creating a Deny List of URL Sequences - -To deny a list of URL sequences for all requests create a **[DenyUrlSequences]** section and add the list of strings you want to disallow in the URL of your requests. The deny list is case insensitive and allows encoded values of the format %XX, where XX are hexadecimal digits. - -For example, if you wanted to deny any URL with ".." or "./" or a carriage return and line feed (CRLF) sequence the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample17.cmd)] - -You probably noticed the %0D%0A at the end of this list. UrlScan Version 3.1 lets you specify encoded values in your sequences and 0x0D is the carriage return character and 0x0A is the line feed character. - -### Creating a Deny List of Query String Sequences - -To deny a list of query string sequences for all requests create a **[DenyQueryStringSequences]** section and add the list of strings you want to disallow in the query string of your request. The deny list is case insensitive and allows encoded values of the format %XX, where XX are hexadecimal digits. - -For example, if you wanted to deny <script> tags in your query string and want to allow for whitespaces in between the angle brackets, we can deny the angle bracket characters and the configuration would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample18.cmd)] - -It is possible that you want to scan for both escaped and un-escaped versions of this pattern. So if someone were to send a request like `http://www.foo.com/id=%3C%53%43%52%49%50%54%3E` where the <script> sequence has been escaped, we would like to check the un-escaped version of this query string as well. To do this set **UnescapeQueryString=1** in the **[Options]** section. This will perform 2 passes when it checks for patterns in query string, one for raw query string and one for the un-escaped query string. - -## Using UrlScan Logging - -UrlScan Version 3.1 uses W3C format for its log files so that users can write SQL like queries against their UrlScan logs. This is especially useful for analyzing false positives for UrlScan configuration. - -### Configuring UrlScan for Logging Only Mode - -On a production server it is useful to see how a particular UrlScan configuration would behave, without actually failing requests. For this purpose you can use UrlScan's logging only mode. To set this up make the following configuration change in UrlScan.ini: - -[!code-console[Main](common-urlscan-scenarios/samples/sample19.cmd)] - -The RejectResponseUrl is used to send a custom response to something blocked by UrlScan. However when set to the value above, it notifies UrlScan to go into logging only mode, where UrlScan will not block any requests, but will log requests that would have been blocked otherwise. - -### Using Log Parser with UrlScan Logs - -Since UrlScanv3.1 uses W3C formatted logs, users can use Log Parser to query the log files. Log Parser comes with a .chm documentation file that has information on how to use it. This section will provide a few examples specific to UrlScan and will not attempt to cover everything possible using Log Parser. - -> [!NOTE] -> For detailed information about querying UrlScan logs using LogParser, see the [Data Mining URLScan 3 Logs using LogParser 2.2](data-mining-urlscan-3-logs-using-logparser-22.md) topic. - -To see all the data fields available in the logs you can run the command: - -[!code-console[Main](common-urlscan-scenarios/samples/sample20.cmd)] - -This command specifies that the log file specified by <log filename> is in W3C input format and will list out the fields available for query. A sample output for this would look like: - -[!code-console[Main](common-urlscan-scenarios/samples/sample21.cmd)] - -### Analyzing UrlScan Failures By Site - -To issue a query to find out how many failures you have per site you could issue the command: - -[!code-console[Main](common-urlscan-scenarios/samples/sample22.cmd)] - -This query would yield results like those below and can be used to determine which site is getting more UrlScan failures. - -[!code-console[Main](common-urlscan-scenarios/samples/sample23.cmd)] - -### Analyzing UrlScan Failures By Reason - -To issue a query to get a distribution for the reason of failure you could issue the command: - -[!code-console[Main](common-urlscan-scenarios/samples/sample24.cmd)] - -This query would yield results like those below and can be used to analyze false positives because of a rule. - -[!code-console[Main](common-urlscan-scenarios/samples/sample25.cmd)] - -### Analyzing UrlScan Failures for Malicious Clients - -To issue a query to get a distribution of failures based on client IP addresses you could issue the command: - -[!code-console[Main](common-urlscan-scenarios/samples/sample26.cmd)] - -This query would yield results like those below and can be used to analyze malicious clients. You could then use IP restrictions list to block out these malicious clients. - -[!code-console[Main](common-urlscan-scenarios/samples/sample27.cmd)] diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample1.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample1.cmd deleted file mode 100644 index 8d4785921..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample1.cmd +++ /dev/null @@ -1,16 +0,0 @@ -[Options] -RuleList=Foo - -[Foo] -AppliesTo=.htm -DenyDataSection=Foo Strings -ScanUrl=0 -ScanAllRaw=0 -ScanQueryString=0 -ScanHeaders=Foo-Header: -DenyUnescapedPercent=1 - -[Foo Strings] --- -< -> \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample10.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample10.cmd deleted file mode 100644 index c80e09efd..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample10.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[RequestLimits] -MaxUrl=100 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample11.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample11.cmd deleted file mode 100644 index f8bcac8e2..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample11.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[RequestLimits] -MaxQueryString=100 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample12.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample12.cmd deleted file mode 100644 index 044f1b131..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample12.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[AllowVerbs] -GET -HEAD -POST \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample13.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample13.cmd deleted file mode 100644 index d2a41da66..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample13.cmd +++ /dev/null @@ -1,12 +0,0 @@ -[DenyVerbs] -PROPFIND -PROPPATCH -MKCOL -DELETE -PUT -COPY -MOVE -LOCK -UNLOCK -OPTIONS -SEARCH \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample14.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample14.cmd deleted file mode 100644 index 1a74cdb2a..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample14.cmd +++ /dev/null @@ -1,3 +0,0 @@ -[AllowExtensions] -.htm -.html \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample15.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample15.cmd deleted file mode 100644 index 50d17076b..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample15.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[DenyExtensions] -.exe -.com -.bat -.cmd \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample16.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample16.cmd deleted file mode 100644 index b0bcdf3a9..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample16.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[DenyHeaders] -Transfer-Encoding \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample17.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample17.cmd deleted file mode 100644 index fe007e216..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample17.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[DenyUrlSequences] -.. -./ -%0D%0A \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample18.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample18.cmd deleted file mode 100644 index 541456ff1..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample18.cmd +++ /dev/null @@ -1,3 +0,0 @@ -[DenyQueryStringSequences] -< -> \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample19.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample19.cmd deleted file mode 100644 index abdff069c..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample19.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[Options] -RejectResponseUrl=/~* \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample2.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample2.cmd deleted file mode 100644 index 10cc05e38..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -GET /iisstart.htm HTTP/1.1\r\n -Host: localhost\r\n -Accept: */*\r\n -Foo-Header: Test--value\r\n -\r\n \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample20.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample20.cmd deleted file mode 100644 index fb309c4c1..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample20.cmd +++ /dev/null @@ -1 +0,0 @@ -LogParser –h –i:W3C \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample21.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample21.cmd deleted file mode 100644 index a20e68ae5..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample21.cmd +++ /dev/null @@ -1,5 +0,0 @@ -Fields: - LogFilename (S) RowNumber (I) Date (T) Time (T) - c-ip (S) s-siteid (I) cs-method (S) cs-uri (S) - x-action (S) x-reason (S) x-context (S) cs-data (S) - x-control (S) \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample22.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample22.cmd deleted file mode 100644 index 2f259b39f..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample22.cmd +++ /dev/null @@ -1 +0,0 @@ -LogParser.exe -i:W3C "SELECT s-siteid, COUNT(*) FROM mylogfile.log GROUP BY s-siteid" \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample23.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample23.cmd deleted file mode 100644 index 93828af1a..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample23.cmd +++ /dev/null @@ -1,5 +0,0 @@ -s-siteid COUNT(ALL *) --------- ------------ -1 15 -2 2087 -- 2 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample24.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample24.cmd deleted file mode 100644 index 9c35ec60f..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample24.cmd +++ /dev/null @@ -1 +0,0 @@ -LogParser.exe -i:W3C "SELECT x-reason, COUNT(*) FROM mylogfile.log GROUP BY x-reason" \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample25.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample25.cmd deleted file mode 100644 index 198510ee4..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample25.cmd +++ /dev/null @@ -1,11 +0,0 @@ -x-reason COUNT(ALL *) ---------------------------------- ------------ -rule+'Rule1'+triggered 2090 -Invalid+config.+Error+0x8007000d. 2 -URL+too+long 1 -query+string+too+long 1 -verb+not+allowed 2 -disallowed+header 2 -extension+not+allowed 3 -disallowed+query+string+sequence 2 -URL+is+double+escaped 1 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample26.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample26.cmd deleted file mode 100644 index 780c6b6c8..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample26.cmd +++ /dev/null @@ -1 +0,0 @@ -LogParser.exe -i:W3C "SELECT c-ip, COUNT(*) FROM mylogfile.log GROUP BY c-ip" \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample27.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample27.cmd deleted file mode 100644 index a33e45970..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample27.cmd +++ /dev/null @@ -1,6 +0,0 @@ -c-ip COUNT(ALL *) ------------- ------------ -::1 15 -1.2.3.4 10 -80.80.80.80 2077 -- 2 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample3.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample3.cmd deleted file mode 100644 index 295ab27f2..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample3.cmd +++ /dev/null @@ -1,5 +0,0 @@ -GET /iisstart.htm HTTP/1.1\r\n -Host: localhost\r\n -Accept: */*\r\n -Foo-Header: E%XEC\r\n -\r\n \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample4.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample4.cmd deleted file mode 100644 index 1bd914530..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample4.cmd +++ /dev/null @@ -1,34 +0,0 @@ -[SQL Injection] -AppliesTo=.asp,.aspx -DenyDataSection=SQL Injection Strings -ScanUrl=0 -ScanAllRaw=0 -ScanQueryString=1 -ScanHeaders= -DenyUnescapedPercent=1 - -[SQL Injection Strings] --- -%3b ; a semicolon -/* -@ ; also catches @@ -char ; also catches nchar and varchar -alter -begin -cast -convert -create -cursor -declare -delete -drop -end -exec ; also catches execute -fetch -insert -kill -open -select -sys ; also catches sysobjects and syscolumns -table -update \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample5.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample5.cmd deleted file mode 100644 index d78f95152..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample5.cmd +++ /dev/null @@ -1,23 +0,0 @@ -[SQL Injection Headers] -AppliesTo=.asp,.aspx -DenyDataSection=SQL Injection Headers Strings -ScanUrl=0 -ScanAllRaw=0 -ScanQueryString=0 -ScanHeaders=Cookie: - -[SQL Injection Headers Strings] --- -@ ; also catches @@ -alter -cast -convert -create -declare -delete -drop -exec ; also catches execute -fetch -insert -kill -select \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample6.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample6.cmd deleted file mode 100644 index 0ed51f80b..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample6.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[AlwaysAllowedUrls] -/my.login.page.asp \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample7.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample7.cmd deleted file mode 100644 index 3bd5a8e33..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample7.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[AlwaysAllowedQueryStrings] -session<1 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample8.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample8.cmd deleted file mode 100644 index f9c371b5e..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample8.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[RequestLimits] -Max-Content-Type=100 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample9.cmd b/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample9.cmd deleted file mode 100644 index e234d3fa2..000000000 --- a/iis/extensions/working-with-urlscan/common-urlscan-scenarios/samples/sample9.cmd +++ /dev/null @@ -1,2 +0,0 @@ -[RequestLimits] -MaxAllowedContentLength=1000 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22.md b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22.md deleted file mode 100644 index 48a45cac5..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22.md +++ /dev/null @@ -1,251 +0,0 @@ ---- -title: "Data Mining UrlScan 3 Logs using LogParser 2.2" -author: rmcmurray -description: "Microsoft has released version 3.1 of UrlScan, and one of the great new features in this version is log files that conform to the W3C Extended Log File Form..." -ms.date: 10/22/2008 -ms.assetid: 92f717d4-cf5a-4ba9-9e49-6d0062849958 -msc.legacyurl: /learn/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22 -msc.type: authoredcontent ---- -# Data Mining UrlScan 3 Logs using LogParser 2.2 - -by [Robert McMurray](https://github.com/rmcmurray) - -Microsoft has released version 3.1 of [UrlScan](index.md), and one of the great new features in this version is log files that conform to the [W3C Extended Log File Format](http://www.w3.org/TR/WD-logfile). What this means to administrators is that they can now parse their UrlScan activity using almost any common log utilities, including Microsoft's [LogParser 2.2](https://www.microsoft.com/download/details.aspx?id=24659) utility, which is a freeware utility from Microsoft that allows you to write SQL-style queries to extract useful information. - - - -## Getting Started - - - -### Downloading and Installing UrlScan and LogParser - -The download locations for UrlScan are listed in the "Getting UrlScan" section of the following topic: - -[https://www.iis.net/learn/extensions/working-with-urlscan](index.md) - -> [!NOTE] -> There are separate downloads for 32-bit and 64-bit Windows. - -LogParser is available from the following URL: - -[https://www.iis.net/go/1287](https://www.microsoft.com/download/details.aspx?id=24659) - -> [!NOTE] -> LogParser is a 32-bit application, but you can use it on a 64-bit Windows system. - -While it's not essential, copying LogParser.exe to a folder in your PATH will allow you to run LogParser from any folder on your system. - - - -### UrlScan Log Files - -#### Locating your UrlScan Log Files - -By default UrlScan installs to `%WinDir%\System32\Inetsrv\UrlScan`, and this is where your UrlScan.ini file should be located. (If you installed to a different location, you would need to locate your installation by searching for your UrlScan.ini file.) In the **[Options]** section of the UrlScan.ini file you should see an entry for **LoggingDirectory** that is set "Logs" by default, which means that your default directory for UrlScan log files is `%WinDir%\System32\Inetsrv\UrlScan\Logs`. - -#### Log File Names - -UrlScan log files are named using the following syntax: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample1.cmd)] - -Where: - -| mm | = | Month | -| --- | --- | --- | -| dd | = | Day | -| yy | = | Year | - -#### Log File Fields - -The following table lists the fields that are available: - -| Field | Description | -| --- | --- | -| Date | Request date in YYYY-MM-DD format | -| Time | Request time in UTC time | -| c-ip | IP address of the client that made the request | -| s-siteid | ID of the web site that received the request | -| cs-method | HTTP method for the request | -| cs-uri | URL for the request | -| x-action | Action taken; for example: - Logged and allowed - Rejected | -| x-reason | Reason for action; for example: - a request header was too long - content length too long - disallowed header detected - disallowed query string sequence detected - disallowed url sequence detected - dot in path detected - extension not allowed - failed urlscan rules - high bit character detected - query string too long - second pass normalization failure - url too long - verb not allowed | -| x-context | Part of request that triggered the action; for example: - Content-Length - file extension - HTTP\_ALL\_RAW - HTTP method - query string - request headers - URL | -| cs-data | The request data that triggered the action. | -| x-control | Config control data that caused the trigger. For example, if a request was rejected because of a deny string from a UrlScan rule, the specific deny string will be listed. | - - - -## Querying Data - - - -### Simple Queries - -#### Selecting Everything - -The simplest (and least useful) query that you can issue is the following, which is listed here just to get us started: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample2.cmd)] - -Let's analyze what this query does: - -1. Selects all fields ("SELECT \*") from all records in all log files ("FROM UrlScan.\*.log") -2. Specifies the log file input type as "W3C Format" ("-i:w3c") - -> [!NOTE] -> Specifying the input file format as "W3C Format" is essential - without that step you would not be able to parse your UrlScan logs. - -#### Selecting Specific Fields to Query - -You can restrict the amount of data that you see by specifying which fields to return: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample3.cmd)] - -Here's what this query does: - -1. Selects only four specific fields ("SELECT date,time,c-ip,x-action") from all records in all log files ("FROM UrlScan.\*.log") -2. Specifies the log file input type as "W3C Format" ("-i:w3c") - -This allows you to greatly reduce the amount of information that you see in your results. - -#### Exporting Logs into a Different Format - -As mentioned earlier, selecting all of the records in all of your logs is probably not all that helpful, unless you were interested in parsing your UrlScan information using another application, like Microsoft Excel, Microsoft Access, SQL Server, etc. In which case, you might want to export all of your data into a comma-delimited file like the following example: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample4.cmd)] - -Here's what this query does: - -1. Selects all fields ("SELECT \*") from all records in all log files ("FROM UrlScan.\*.log") -2. Inserts from all records into a comma-delimited file ("INTO UrlScan.csv") -3. Specifies the input file type as "W3C Format" ("-i:w3c") -4. Specifies the output file type as "CSV Format" ("-o:csv") - -You could just as easily export into a tab-separated file using the following syntax: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample5.cmd)] - - - -### Filtering Queries - -One of the great things about LogParser and SQL queries in general is that you can filter the amount of data that you see by specifying criteria using a WHERE clause. The following - -#### Filtering based on IP Address - -For example, to see all of the requests from a specific client IP address, you could use the following syntax: - -[!code-sql[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample6.sql)] - -Here's what this query does: - -1. Selects all fields ("SELECT \*") from all records in all log files ("FROM UrlScan.\*.log") -2. Filters the results based on a specific client IP address ("WHERE c-ip='192.168.1.1'") -3. Specifies the input file type as "W3C Format" ("-i:w3c") - -#### Filtering based on UrlScan Action - -You can also filter based on UrlScan rejections using the following syntax: - -[!code-sql[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample7.sql)] - -Here's what this query does: - -1. Selects all fields ("SELECT \*") from all records in all log files ("FROM UrlScan.\*.log") -2. Filters the results where UrlScan rejected the request ("WHERE x-action='Rejected'") -3. Specifies the input file type as "W3C Format" ("-i:w3c") - -#### Filtering based on Uniqueness - -You can filter the amount of data that you see by specifying which fields to return and grouping the data based on uniqueness. This is done by adding the DISTINCT clause as seen in the following syntax: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample8.cmd)] - -Here's what this query does: - -1. Selects only the unique client IP addresses ("SELECT DISTINCT c-ip") from all records in all log files ("FROM UrlScan.\*.log") -2. Specifies the input file type as "W3C Format" ("-i:w3c") - - - -### Grouping, Tabulating, and Sorting Queries - -#### Counting Requests by Fields - -Another great feature of SQL-style queries is the ability to tabulate data. The following example shows how retrieve a count of requests based on the client IP address: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample9.cmd)] - -Here's what this query does: - -1. Selects only the client IP address and request count ("SELECT c-ip, COUNT(\*)") from all records in all log files ("FROM UrlScan.\*.log") -2. Groups the request count based on the client IP address ("GROUP BY c-ip") -3. Specifies the input file type as "W3C Format" ("-i:w3c") - -#### Sorting Data by Fields - -You can reorder your results into something more useful using the ORDER BY clause, as illustrated in the following example: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample10.cmd)] - -Here's what this query does: - -1. Selects four specific fields ("SELECT x-action,x-reason,c-ip,cs-uri") from all records in all log files ("FROM UrlScan.\*.log") -2. Sorts the data in ascending order based on the UrlScan action and reason for the action ("ORDER BY x-action,x-reason") -3. Specifies the input file type as "W3C Format" ("-i:w3c") - - - -## Putting it All Together - - - -#### Counting Requests by Client IP and Sorting Data by Request Count - -Starting with the request count query from a previous example, you can rename the request count field to something more useful using the AS clause, as illustrated in the following example: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample11.cmd)] - -This helps reorder the data based on the count, as shown in the following example: - -[!code-console[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample12.cmd)] - -Here's what this query does: - -1. Selects only the client IP address and request count ("SELECT c-ip, COUNT(\*)") from all records in all log files ("FROM UrlScan.\*.log") -2. Groups the request count based on the client IP address ("GROUP BY c-ip") -3. Sorts the data in descending order based on the request count ("ORDER BY c-request-count DESC") -4. Specifies the input file type as "W3C Format" ("-i:w3c") - - - -#### Counting Rejected Requests based on the Reason for Rejections - -While somewhat similar to the previous example, the following syntax will filter the results based on rejections and count the number of times that each reason occurs: - -[!code-sql[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample13.sql)] - -Here's what this query does: - -1. Selects only the reason and request count ("SELECT x-reason, COUNT(\*)") from all records in all log files ("FROM UrlScan.\*.log") -2. Filters the results based on rejections ("WHERE x-action='Rejected'") -3. Groups the request count based on the reason ("GROUP BY x-reason") -4. Sorts the data in descending order based on the request count ("ORDER BY c-request-count DESC") -5. Specifies the input file type as "W3C Format" ("-i:w3c") - - - -#### Splitting Requests into Separate Log Files based on Site ID - -UrlScan writes all log entries to a common log file, but you may want to see your data separated by site. The following example splits your UrlScan logs into separate files by site by creating unique log files that are named for each site ID. This example is a little more complex than previous examples, and is written as a batch file. - -[!code-sql[Main](data-mining-urlscan-3-logs-using-logparser-22/samples/sample14.sql)] - -Here's what this batch file does: - -1. Creates a tab-separated file that contains a list of unique site IDs -2. Creates a loop to step through the tab-separated file containing the site IDs -3. Selects all fields for the specific site ID and creates a new W3C format file for each site diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample1.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample1.cmd deleted file mode 100644 index 22177b11a..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -UrlScan.mmddyy.log \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample10.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample10.cmd deleted file mode 100644 index c337ab3e0..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample10.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT x-action,x-reason,c-ip,cs-uri FROM UrlScan.*.log ORDER BY x-action,x-reason" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample11.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample11.cmd deleted file mode 100644 index f4848d1fb..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample11.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT c-ip, COUNT(*) AS c-request-count FROM UrlScan.*.log GROUP BY c-ip" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample12.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample12.cmd deleted file mode 100644 index 1e552a131..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample12.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT c-ip, COUNT(*) AS c-request-count FROM UrlScan.*.log GROUP BY c-ip ORDER BY c-request-count DESC" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample13.sql b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample13.sql deleted file mode 100644 index c50713bba..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample13.sql +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT x-reason, COUNT(*) AS c-request-count FROM UrlScan.*.log WHERE x-action='Rejected' GROUP BY x-reason ORDER BY c-request-count DESC" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample14.sql b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample14.sql deleted file mode 100644 index 8535e63da..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample14.sql +++ /dev/null @@ -1,5 +0,0 @@ -logparser.exe "SELECT DISTINCT s-siteid INTO siteids.tsv FROM UrlScan.*.log" -i:W3C -o:tsv -headers:off - -for /f %%a in (siteids.tsv) do ( - logparser.exe "SELECT * INTO W3SVC%%a.log FROM UrlScan.*.log WHERE s-siteid='%%a' ORDER BY date,time" -i:W3C -o:w3c -) \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample2.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample2.cmd deleted file mode 100644 index dfa5fc205..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT * FROM UrlScan.*.log" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample3.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample3.cmd deleted file mode 100644 index b9bd62b67..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT date,time,c-ip,x-action FROM UrlScan.*.log" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample4.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample4.cmd deleted file mode 100644 index 968827674..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT * INTO UrlScan.csv FROM UrlScan.*.log" -i:w3c -o:csv \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample5.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample5.cmd deleted file mode 100644 index 04eeeaabf..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT * INTO UrlScan.tsv FROM UrlScan.*.log" -i:w3c -o:tsv \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample6.sql b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample6.sql deleted file mode 100644 index 713439510..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample6.sql +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT * FROM UrlScan.*.log WHERE c-ip='192.168.1.1'" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample7.sql b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample7.sql deleted file mode 100644 index 5f6b56d4f..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample7.sql +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT * FROM UrlScan.*.log WHERE x-action='Rejected'" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample8.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample8.cmd deleted file mode 100644 index aa6f7e3df..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser "SELECT DISTINCT c-ip FROM UrlScan.*.log" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample9.cmd b/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample9.cmd deleted file mode 100644 index 4649454f6..000000000 --- a/iis/extensions/working-with-urlscan/data-mining-urlscan-3-logs-using-logparser-22/samples/sample9.cmd +++ /dev/null @@ -1 +0,0 @@ -logparser.exe "SELECT c-ip, COUNT(*) FROM UrlScan.*.log GROUP BY c-ip" -i:w3c \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/overview-of-urlscan-versions.md b/iis/extensions/working-with-urlscan/overview-of-urlscan-versions.md deleted file mode 100644 index f2bd88936..000000000 --- a/iis/extensions/working-with-urlscan/overview-of-urlscan-versions.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Overview of UrlScan Versions" -author: rmcmurray -description: "UrlScan primarily consists of two parts: the UrlScan ISAPI filter named UrlScan.dll, and a configuration file named UrlScan.ini. (Note : Some of the earlier..." -ms.date: 07/15/2010 -ms.assetid: 09301b0d-9312-4ee2-b07b-1e01fa5dd8b5 -msc.legacyurl: /learn/extensions/working-with-urlscan/overview-of-urlscan-versions -msc.type: authoredcontent ---- -# Overview of UrlScan Versions - -by [Robert McMurray](https://github.com/rmcmurray) - -UrlScan primarily consists of two parts: the UrlScan ISAPI filter named UrlScan.dll, and a configuration file named UrlScan.ini. - -> [!NOTE] -> Some of the earlier versions of UrlScan contained an additional resource file named UrlScanr.dll. - -Each version of UrlScan added additional features, and each new version of the configuration file contained settings that controlled the functionality of those features. The configuration files are generally compatible across all versions of UrlScan, because older versions of UrlScan scan will ignore newer settings, and newer versions of UrlScan will use the default values if a setting is missing. - -### UrlScan Version 1 - -UrlScan 1.0 was the first version of UrlScan that Microsoft released as an ISAPI filter sample that helped reduce the attack surface for IIS versions 4.0 and 5.0. The design concept was to allow Web server administrations to define the list of HTTP verbs, headers, file name extensions, and character sequences that are allowed on their servers. - -> [!NOTE] -> UrlScan 1.0 has been replaced by the UrlScan Version 3.1 and should not be used. - -For more information about UrlScan Version 1, see the [UrlScan 1 Reference](urlscan-1-reference.md) topic. - -### UrlScan Version 2 - -Microsoft released UrlScan 2.1 and UrlScan 2.0 as part of the IIS Lockdown Tool, which was a more comprehensive approach to reducing the surface attack area for Web servers that used IIS versions 4.0, 5.0, and 5.1. The IIS Lockdown Tool was a wizard that server administrators would use to customize the content types, script mapping, system permissions, and virtual directories that their Web servers will use. The IIS Lockdown included the option to install UrlScan as an additional security measure, and included several configuration templates for UrlScan that addressed several installation environments for IIS, such as installing IIS with Exchange Server, BizTalk Server, SharePoint, etc. - -Microsoft later released UrlScan 2.5 as a separate download, which added request limits to the list of features. Request limits allow administrators to configure the maximum size for request elements, such as content length, URLs, and query strings. - -For more information about UrlScan Version 2, see the [UrlScan 2 Reference](urlscan-2-reference.md) topic. - -### UrlScan Version 3 - -Microsoft released UrlScan 3.1 and 3.0 as separate downloads, although administrators should make sure that they upgrade to UrlScan 3.1. - -The UrlScan Version 3 family added enhanced parsing of escape sequences in URLs and query strings, which added features to create filtering rules, to always allow specific URLs to bypass UrlScan filtering, and to allow or deny requests that contained user-defined query string elements. This feature helps prevent server attacks that use query strings, such as SQL injection attacks. - -For more information about UrlScan Version 3, see the [UrlScan 3 Reference](urlscan-3-reference.md) topic. diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference.md b/iis/extensions/working-with-urlscan/urlscan-1-reference.md deleted file mode 100644 index 100dc26be..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference.md +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: "UrlScan 1 Reference" -author: rmcmurray -description: "Note : UrlScan 1.0 has been replaced by UrlScan 3.1 and should not be used. If you are using UrlScan 1.0, you should download and install the latest version...." -ms.date: 07/15/2010 -ms.assetid: f0de02bb-1fed-45d5-a674-c398d6cdadc5 -msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-1-reference -msc.type: authoredcontent ---- -# UrlScan 1 Reference - -by [Robert McMurray](https://github.com/rmcmurray) - -> [!NOTE] -> UrlScan 1.0 has been replaced by [UrlScan 3.1](urlscan-3-reference.md) and should not be used. If you are using UrlScan 1.0, you should download and install the latest version. The information on this page is included only as a reference. - -UrlScan 1.0 was the first version of UrlScan that Microsoft released as an ISAPI filter sample that helped reduce the attack surface for IIS versions 4.0 and 5.0. UrlScan 1.0 allows Web server administrations to define the list of HTTP verbs, headers, file name extensions, and character sequences that are allowed or denied on their servers. UrlScan 1.0 consists of the UrlScan ISAPI filter named UrlScan.dll and a configuration file named UrlScan.ini. - -#### On This Page - -- [Installing UrlScan 1.0](urlscan-1-reference.md#InstallingUrlScan) -- [Using UrlScan 1.0](urlscan-1-reference.md#UsingUrlScan) -- [UrlScan.ini Sections](urlscan-1-reference.md#UrlScanIniSections) - - - [[Options] Section](urlscan-1-reference.md#OptionsSection) - - [[AllowVerbs] Section](urlscan-1-reference.md#AllowVerbsSection) - - [[DenyVerbs] Section](urlscan-1-reference.md#DenyVerbsSection) - - [[DenyHeaders] Section](urlscan-1-reference.md#DenyHeadersSection) - - [[AllowExtensions] Section](urlscan-1-reference.md#AllowExtensionsSection) - - [[DenyExtensions] Section](urlscan-1-reference.md#DenyExtensionsSection) - - [[DenyUrlSequences] Section](urlscan-1-reference.md#DenyUrlSequencesSection) - - - -## Installing UrlScan 1.0 - -UrlScan 1.0 required manual installation for IIS. The following steps will lead you through the steps to install UrlScan as a global ISAPI filter. - -> [!NOTE] -> UrlScan may be installed as a site filter, but Microsoft recommends that UrlScan is installed as a global filter so that its functionality applies to the entire server. - -1. Copy UrlScan.dll and UrlScan.ini into a local directory on the server. While it is not required, the suggested directory is: - `%SystemRoot%\System32\Inetsrv\UrlScan` -2. Open the Internet Information Services (IIS) - - Open the Windows Control Panel. - - Double-click **Administrative Tools**. - - Double-click **Internet Information Services**. -3. Open the global-level properties for your version of IIS: - - - For IIS 4.0 or IIS 5.0: - - - Right-click the server name and select **Properties**. - - Ensure that **WWW Service** is displayed in the **Master Properties** drop down list, and click **Edit**. - - For IIS 5.1 or IIS 6.0: - - - Right-click the **Web Sites** node and select **Properties**. -4. Choose the **ISAPI Filters** tab. -5. Click **Add**. -6. When the ISAPI filter properties dialog is displayed, enter the following information: - - - Enter "UrlScan" in the **Filter Name** box. - - Enter the full path to the UrlScan.dll file in the **Executable** box. -7. Click **OK** to close each dialog that is open. -8. Restart the web service. - - - -## Using UrlScan 1.0 - -You configure UrlScan's operation by setting options in the UrlScan.ini file. This file should reside in the same directory as UrlScan.dll, and it contains the sections and options that are listed below. - -> [!NOTE] -> For performance reasons, UrlScan only reads the UrlScan.ini file when IIS first loads the ISAPI filter. If you make changes to the UrlScan.ini file, you will need to stop and start the World-Wide-Web Publishing Service before your changes will be effective. - -**Warning**: The default options built into UrlScan.dll will result in a configuration that will reject all requests to the server, therefore it is necessary to provide a UrlScan.ini file for IIS to serve HTTP requests when you are using UrlScan. A sample UrlScan.ini file is provided that contains several recommended settings to defend against known attacks on IIS servers. - - - -## UrlScan.ini Sections - - - -### [Options] Section - -The [Options] section of a UrlScan.ini file contains a list of name/value pairs that define the general behavior for UrlScan. A few of the settings enable or disable other sections in the UrlScan.ini file. - -#### Enabling or Disabling other UrlScan.ini Sections - -| UseAllowVerbs | Allowed values are 0 or 1. The default value for UseAllowVerbs is 1. If set to 1, UrlScan will read the [AllowVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb that is not explicitly listed. If set to 0, UrlScan will read the [DenyVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb listed. **Note:** The [AllowVerbs] section is case sensitive, but the [DenyVerbs] section is not case sensitive. | -| --- | --- | -| UseAllowExtensions | Allowed values are 0 or 1. The default value for UseAllowExtensions is 1. If set to 1, UrlScan will read the [AllowExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the URL is not explicitly listed. If set to 0, UrlScan will read the [DenyExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the request is listed. **Note:** The [AllowExtensions] and [DenyExtensions] sections are both case insensitive. | - -#### URL Scanning Options - -| NormalizeUrlBeforeScan | Allowed values are 0 or 1. The default value for NormalizeUrlBeforeScan is 1. If set to 1, UrlScan will do all of its analysis on the request URLs after IIS decodes and normalizes them. If set to 0, UrlScan will do all of its analysis on the raw URLs as sent by the client. **Note:** Only advanced administrators who are very knowledgeable about URL parsing should set this option to 0, as doing so will likely expose the IIS server to canonicalization attacks that bypass proper analysis of the URL extensions. | -| --- | --- | -| VerifyNormalization | Allowed values are 0 or 1. The Default value for VerifyNormalization is 1. If set to 1, UrlScan verifies normalization of the URL. This action will defend against canonicalization attacks, where a URL contains a double encoded string in the URL. For example, the string "%252e" is a double encoded dot '.' character because "%25" decodes to a '%' character, the first pass decoding of "%252e" results in "%2e", which can be decoded a second time into a single dot '.' string. If set to 0, UrlScan will not verify normalization of the URL. **Note:** This option is dependent on the NormalizeUrlBeforeScan option. | -| AllowHighBitCharacters | Allowed values are 0 or 1. The default value for AllowHighBitCharacters is 1. If set to 1, then UrlScan will allow any byte to exist in the URL. If set to 0, then UrlScan will reject any request where the URL contains a character outside of the ASCII character set. **Note:** This feature can defend against UNICODE or UTF-8 based attacks, but will also reject legitimate requests on IIS servers that use a non-ASCII code page. | -| AllowDotInPath | Allowed values are 0 or 1. The default value for AllowDotInPath is 1. If set to 1, UrlScan will allow requests that contain multiple instances of the dot (.) character in the URL. If set to 0, UrlScan will reject requests that contain multiple instances of the dot (.) character in the URL. **Note:** Because UrlScan operates at a level where IIS has not yet parsed the URL, it is not possible to determine in all cases whether a dot character denotes the extension or whether it is a part of the directory path or filename of the URL. For the purposes of extension analysis, UrlScan will always assume that an extension is the part of the URL beginning after the last dot in the string and ending at the first question mark or slash character after the dot or the end of the string. Setting AllowDotInPath to 0 defends against the case where an attacker uses path info to hide the true extension of the request; for example, "/path/TruePart.asp/FalsePart.htm". Setting AllowDotInPath to 0 also causes UrlScan to deny any request that contains a dot in a directory or file name. | - -#### Logging Options - -| EnableLogging | Allowed values are 0 or 1. The default value for EnableLogging is 1. If set to 1, UrlScan will log its actions in a file called UrlScan.log that will be created in the same directory that contains UrlScan.dll. If set to 0, UrlScan will not log any activity. | -| --- | --- | -| PerProcessLogging | Allowed values are 0 or 1. The default value of PerProcessLogging is 0. If set to 1, UrlScan will append the process ID of the IIS process that is hosting UrlScan.dll to the log file name; for example, UrlScan.1234.log. This feature is helpful for IIS versions that can host filters in more than 1 process concurrently, such as IIS 6.0 and later. If set to 0, UrlScan will log all activity in UrlScan.log. | - -#### HTTP Server Header Manipulation - -| RemoveServerHeader | Allowed values are 0 or 1. The default value for RemoveServerHeader is 1. If set to 1, UrlScan will remove the server header on all responses, and the value of AlternateServerName will be ignored. If set to 0, IIS will return the default server header on all responses. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | -| --- | --- | -| AlternateServerName | Allowed value is a string. The default value for AlternateServerName is an empty string. If you specify a value for AlternateServerName and RemoveServerHeader is set to 0, then IIS will replace its default "Server:" header in all responses with the AlternateServerName value. If RemoveServerHeader is set to 1, the value of AlternateServerName will be ignored. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | - -##### Example [Options] Section - -The following example [Options] section configures several recommended settings for UrlScan: - -[!code-console[Main](urlscan-1-reference/samples/sample1.cmd)] - - - -### [AllowVerbs] Section - -The [AllowVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 1 in the [Options] section, UrlScan will reject any request that contains an HTTP verb that is not explicitly listed in this section. The entries in this section are case sensitive. - -##### Example [AllowVerbs] Section - -The following example [AllowVerbs] section configures UrlScan to allow basic HTTP functionality: - -[!code-console[Main](urlscan-1-reference/samples/sample2.cmd)] - -To use this example, you would need to set UseAllowVerbs to 1 in the [Options] section. - - - -### [DenyVerbs] Section - -The [DenyVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 0 in the [Options] section, UrlScan will reject any request that contains a verb that is listed in this section. The entries in this section are not case sensitive. - -##### Example [DenyVerbs] Section - -The following example [DenyVerbs] section configures UrlScan to deny several of the HTTP methods that are not required for basic HTTP functionality, such as WebDAV methods: - -[!code-console[Main](urlscan-1-reference/samples/sample3.cmd)] - -To use this example, you would need to set UseAllowVerbs to 0 in the [Options] section. - - - -### [DenyHeaders] Section - -The [DenyHeaders] section contains a list of request headers in the form "header-name:". Any request containing a request header listed in this section will be rejected. The entries in this section are not case sensitive. - -##### Example [DenyHeaders] Section - -The following example [DenyHeaders] section configures UrlScan to deny several HTTP headers that are used with WebDAV requests: - -[!code-console[Main](urlscan-1-reference/samples/sample4.cmd)] - - - -### [AllowExtensions] Section - -The [AllowExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=1 is set in the [Options] section, then any request containing a URL with an extension not explicitly listed here is rejected. The entries in this section are not case sensitive. - -##### Example [AllowExtensions] Section - -The following example [AllowExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-1-reference/samples/sample5.cmd)] - -To use this example, you would need to set UseAllowExtensions to 1 in the [Options] section. - - - -### [DenyExtensions] Section - -The [DenyExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=0 is set in the [Options] section, then any request containing a URL with an extension listed here is rejected. The entries in this section are not case sensitive. - -##### Example [DenyExtensions] Section - -The following example [DenyExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-1-reference/samples/sample6.cmd)] - -To use this example, you would need to set UseAllowExtensions to 0 in the [Options] section. - - - -### [DenyUrlSequences] Section - -The [DenyUrlSequences] section contains a list of character sequences that UrlScan will deny if they appear in a URL. For example, two dots ".." indicate a parent path, which a hacker might try to use to gain access to files outside of a Web site's content area. - -##### Example [DenyUrlSequences] Section - -The following example [DenyUrlSequences] section configures UrlScan to deny several URL sequences that could be used to attack your server: - -[!code-console[Main](urlscan-1-reference/samples/sample7.cmd)] diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample1.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample1.cmd deleted file mode 100644 index 404cfcb3e..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample1.cmd +++ /dev/null @@ -1,10 +0,0 @@ -[Options] -UseAllowVerbs=1 ; Use the [AllowVerbs] section. -UseAllowExtensions=0 ; Use the [DenyExtensions] section. -NormalizeUrlBeforeScan=1 ; Normalize a URL before processing. -VerifyNormalization=1 ; Normalize a URL twice and reject request if a change occurs. -AllowHighBitCharacters=0 ; Deny high bit characters in URL. -AllowDotInPath=0 ; Deny dots that are not file name extensions. -RemoveServerHeader=0 ; Do not remove the "Server" header from response. -EnableLogging=1 ; Log UrlScan activity. -PerProcessLogging=0 ; Do not create log files for each process. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample2.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample2.cmd deleted file mode 100644 index 83874a880..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[AllowVerbs] -HEAD ; Allow HTTP feature discovery. -GET ; Allow most HTTP requests. -POST ; Allow posting data to applications. -OPTIONS ; Allow HTTP feature discovery. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample3.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample3.cmd deleted file mode 100644 index 1319dface..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample3.cmd +++ /dev/null @@ -1,12 +0,0 @@ -[DenyVerbs] -TRACE ; Deny HTTP tracing. -PUT ; Deny uploading files. -DELETE ; Deny deleting files. -MKCOL ; Deny creating folders/collections. -COPY ; Deny copying files. -MOVE ; Deny moving files. -LOCK ; Deny locking resources. -UNLOCK ; Deny unlocking resources. -PROPFIND ; Deny property queries. -PROPPATCH ; Deny setting properties. -SEARCH ; Deny protocol-based searches. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample4.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample4.cmd deleted file mode 100644 index a7ea1bbd6..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample4.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[DenyHeaders] -Translate: ; Allow HTTP feature discovery. -If: ; Allow most HTTP requests. -Lock-Token: ; Allow posting data to applications. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample5.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample5.cmd deleted file mode 100644 index 7c3b359b2..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample5.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[AllowExtensions] -.htm ; Allow HTML files. -.html ; Allow HTML files. -.txt ; Allow text files. -.jpg ; Allow JPEG graphics. -.jpeg ; Allow JPEG graphics. -.gif ; Allow GIF graphics. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample6.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample6.cmd deleted file mode 100644 index a19964c7d..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample6.cmd +++ /dev/null @@ -1,28 +0,0 @@ -[DenyExtensions] -.asp ; Deny ASP requests. -.asa ; Deny ASA requests. -.inc ; Deny include files. -.cdx ; Deny certificate requests. -.cer ; Deny certificate requests. -.config ; Deny configuration files. -.exe ; Deny executable files. -.bat ; Deny batch files. -.cmd ; Deny batch files. -.com ; Deny executable files. -.htw ; Deny Index Server hit highlighting. -.ida ; Deny HTTP-based Index Server administration. -.idq ; Deny Index Server queries. -.htr ; Deny legacy IIS password changing requests. -.idc ; Deny legacy database access requests. -.shtm ; Deny Server Side Includes. -.shtml ; Deny Server Side Includes. -.stm ; Deny Server Side Includes. -.printer ; Deny Internet-based printing. -.ini ; Deny configuration files. -.log ; Deny log files. -.pol ; Deny policy files. -.dat ; Deny configuration files. -.mdb ; Deny Microsoft Access databases. -.ldb ; Deny Microsoft Access lock files. -.mdf ; Deny Microsoft SQL databases. -.ldf ; Deny Microsoft SQL log files. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample7.cmd b/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample7.cmd deleted file mode 100644 index bd5bb478a..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-1-reference/samples/sample7.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[DenyUrlSequences] -.. ; Deny directory traversals. -./ ; Deny trailing dot on a directory name. -\ ; Deny backslashes in URL. -: ; Deny access to alternate streams. -% ; Deny escaping after normalization. -& ; Deny running multiple CGI processes on a single request. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference.md b/iis/extensions/working-with-urlscan/urlscan-2-reference.md deleted file mode 100644 index ca84db03e..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference.md +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: "UrlScan 2 Reference" -author: rmcmurray -description: "Note : UrlScan 2.x has been replaced by UrlScan 3.1. If you are using UrlScan 2.x, you should download and install the latest version. The information on th..." -ms.date: 07/15/2010 -ms.assetid: c3019760-a9f1-45a4-88d4-4a9d4459d033 -msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-2-reference -msc.type: authoredcontent ---- -# UrlScan 2 Reference - -by [Robert McMurray](https://github.com/rmcmurray) - -> [!NOTE] -> UrlScan 2.x has been replaced by [UrlScan 3.1](urlscan-3-reference.md). If you are using UrlScan 2.x, you should download and install the latest version. The information on this page is presented for reference purposes. - -Microsoft released UrlScan 2.0 and UrlScan 2.1 as part of the IIS Lockdown Tool, which was a more comprehensive approach to reducing the surface attack area for Web servers that used IIS versions 4.0, 5.0, and 5.1. The IIS Lockdown Tool was a wizard that server administrators would use to customize the content types, script mapping, system permissions, and virtual directories that their Web servers will use. The IIS Lockdown included the option to install UrlScan as an additional security measure, and included several configuration templates for UrlScan that addressed several installation environments for IIS, such as installing IIS with Exchange Server, BizTalk Server, and SharePoint. - -Microsoft later released UrlScan 2.5 as a separate download, which added request limits to the list of features. Request limits allow administrators to configure the maximum size for request elements, such as content length, URLs, and query strings. - -#### On This Page - -- [Installing UrlScan 2.x](urlscan-2-reference.md#InstallingUrlScan) - - - [Installing UrlScan 2.0 or UrlScan 2.1](urlscan-2-reference.md#Installing_UrlScan_2.0_or_UrlScan_2.1) - - [Installing UrlScan 2.5](urlscan-2-reference.md#Installing_UrlScan_2.5) -- [Using UrlScan 2.x](urlscan-2-reference.md#UsingUrlScan) -- [UrlScan.ini Sections](urlscan-2-reference.md#UrlScanIniSections) - - - [[Options] Section](urlscan-2-reference.md#OptionsSection) - - [[AllowVerbs] Section](urlscan-2-reference.md#AllowVerbsSection) - - [[DenyVerbs] Section](urlscan-2-reference.md#DenyVerbsSection) - - [[DenyHeaders] Section](urlscan-2-reference.md#DenyHeadersSection) - - [[AllowExtensions] Section](urlscan-2-reference.md#AllowExtensionsSection) - - [[DenyExtensions] Section](urlscan-2-reference.md#DenyExtensionsSection) - - [[DenyUrlSequences] Section](urlscan-2-reference.md#DenyUrlSequencesSection) - - [[RequestLimits] Section](urlscan-2-reference.md#RequestLimitsSection) - - - -## Installing UrlScan 2.x - - - -### Installing UrlScan 2.0 or UrlScan 2.1 - -UrlScan 2.0 and UrlScan 2.1 are installed as part of the IIS Lockdown Tool. - -For more information about installing the IIS Lockdown Tool, see the IIS Lockdown Tool download pages at the following URL: - -> [https://www.microsoft.com/downloads/details.aspx?FamilyID=dde9efc0-bb30-47eb-9a61-fd755d23cdec](https://www.microsoft.com/downloads/details.aspx?FamilyID=dde9efc0-bb30-47eb-9a61-fd755d23cdec) - - - -### Installing UrlScan 2.5 - -UrlScan 2.5 installs as a clean install on a computer running IIS 5.1 or later. Upgrade scenarios are also supported. - -**To Install UrlScan 2.5** - -1. Download the Setup.exe file for UrlScan 2.5 from the following URL to your computer: - [https://www.microsoft.com/downloads/details.aspx?familyid=23d18937-dd7e-4613-9928-7f94ef1c902a](https://www.microsoft.com/downloads/details.aspx?familyid=23d18937-dd7e-4613-9928-7f94ef1c902a) -2. Double-click the Setup.exe icon to begin the installation process. -3. Review the agreement in the UrlScan Installer Package End User Agreement and then click **Yes** to accept the agreement and continue. If you click **No**, the installer will close. -4. When the installer completes, the following message is displayed: "UrlScan has been successfully installed." Click **OK** to close the installer. - -**To Uninstall UrlScan** - -1. In Control Panel, double-click **Add or Remove Programs**. -2. Select UrlScan 2.5 and then click the **Change/Remove** button. -3. When UrlScan 2.5 has been removed from your server, the following message is displayed: "UrlScan has been successfully uninstalled." -4. Click **OK** to complete the uninstall process. - -**Understanding the UrlScan 2.5 Installer** - -When installing UrlScan 2.5, the UrlScan 2.5 installer does the following: - -- Installs the UrlScan.dll and UrlScan.ini files in the `%windir%\system32\inetsrv\UrlScan` directory. If UrlScan is already installed on the computer, the UrlScan.ini file is updated with any new settings that are not present in the current configuration file. -- Adds UrlScan as a global filter to IIS. -- Creates a `%windir%\system32\inetsrv\UrlScan\Logs` directory. - -When installing UrlScan on a server running IIS 6.0, the UrlScan 2.5 installer makes some additional changes that enable UrlScan 2.5 to work with the new IIS 6.0 process model. These changes are as follows: - -- **PerProcessLogging** is set to 1 in the UrlScan.ini file. This ensures that two UrlScan processes do not write to the log file at the same time. -- UrlScan is marked as cache-aware in the metabase. This ensures that two or more worker processes that are running UrlScan do not write to the log file at the same time. -- The new log directory, which is a subdirectory located under the ..\inetsrv\UrlScan directory, ensures that the UrlScan directory does not get cluttered with all of the log files that the **PerProcessLogging** option will create. - -When installing UrlScan 2.5 on IIS, the installer sets permissions for UrlScan.dll, UrlScan.ini, and the log file. When installing UrlScan 2.5 on IIS 6.0, the installer sets additional permissions on the same files to allow UrlScan 2.5 to work with IIS 6.0 worker process isolation mode. Table 2 lists the IIS permissions that are set when UrlScan 2.5 is installed. - -**Table 2: UrlScan 2.5 IIS 6.0 Permissions** - -| **File/Directory** | **Permissions** | -| --- | --- | -| ..\inetsrv\UrlScan\UrlScan.dll | Read and Execute (set on IIS 6.0 only): LocalService, IIS\_WPG, and NetworkService Full: Administrators, and LocalSystem | -| ..\inetsrv\UrlScan\UrlScan.ini | Read (set on IIS 6.0 only): IIS\_WPG, LocalService, and NetworkService Full: Administrators, and LocalSystem | -| ..\inetsrv\UrlScan\logs | Read and Write (set on IIS 6.0 only): IIS\_WPG, LocalService, and NetworkService Full: Administrators, and LocalSystem | - -If a version of UrlScan is detected on the computer, the installation will be considered an upgrade. In the upgrade scenario, the changes that the installer makes will be the same as for a clean installation unless you have configured a custom log directory. If you have defined a different location for the UrlScan logs, then the new logs directory will not be created. - - - -## Using UrlScan 2.x - -You configure UrlScan's operation by setting options in the UrlScan.ini file. This file should reside in the same directory as UrlScan.dll, and it contains the sections and options that are listed below. - -> [!NOTE] -> For performance reasons, UrlScan only reads the UrlScan.ini file when IIS first loads the ISAPI filter. If you make changes to the UrlScan.ini file, you will need to stop and start the World-Wide-Web Publishing Service before your changes will be effective. - -**Warning**: The default options built into UrlScan.dll will result in a configuration that will reject all requests to the server, therefore it is necessary to provide a UrlScan.ini file for IIS to serve HTTP requests when you are using UrlScan. A sample UrlScan.ini file is provided that contains the recommended settings to defend against known attacks against IIS servers at the time of writing. - - - -## UrlScan.ini Sections - - - -### [Options] Section - -The [Options] section of a UrlScan.ini file contains a list of name/value pairs that define the general behavior for UrlScan. A few of the settings enable or disable other sections in the UrlScan.ini file. - -#### Enabling or Disabling other UrlScan.ini Sections - -| UseAllowVerbs | Allowed values are 0 or 1. The default value for UseAllowVerbs is 1. If set to 1, UrlScan will read the [AllowVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb that is not explicitly listed. If set to 0, UrlScan will read the [DenyVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb listed. **Note:** The [AllowVerbs] section is case sensitive, but the [DenyVerbs] section is not case sensitive. | -| --- | --- | -| UseAllowExtensions | Allowed values are 0 or 1. The default value for UseAllowExtensions is 1. If set to 1, UrlScan will read the [AllowExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the URL is not explicitly listed. If set to 0, UrlScan will read the [DenyExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the request is listed. **Note:** The [AllowExtensions] and [DenyExtensions] sections are both case insensitive. | - -#### URL Scanning Options - -| NormalizeUrlBeforeScan | Allowed values are 0 or 1. The default value for NormalizeUrlBeforeScan is 1. If set to 1, UrlScan will do all of its analysis on the request URLs after IIS decodes and normalizes them. If set to 0, UrlScan will do all of its analysis on the raw URLs as sent by the client. **Note:** Only advanced administrators who are very knowledgeable about URL parsing should set this option to 0, as doing so will likely expose the IIS server to canonicalization attacks that bypass proper analysis of the URL extensions. | -| --- | --- | -| VerifyNormalization | Allowed values are 0 or 1. The Default value for VerifyNormalization is 1. If set to 1, UrlScan verifies normalization of the URL. This action will defend against canonicalization attacks, where a URL contains a double encoded string in the URL. For example, the string "%252e" is a double encoded dot '.' character because "%25" decodes to a '%' character, the first pass decoding of "%252e" results in "%2e", which can be decoded a second time into a single dot '.' string. If set to 0, then UrlScan will not verify normalization of the URL. **Note:** This option is dependent on the NormalizeUrlBeforeScan option. | -| AllowHighBitCharacters | Allowed values are 0 or 1. The default value for AllowHighBitCharacters is 1. If set to 1, then UrlScan will allow any byte to exist in the URL. If set to 0, UrlScan will reject any request where the URL contains a character outside of the ASCII character set. **Note:** This feature can defend against UNICODE or UTF-8 based attacks, but will also reject legitimate requests on IIS servers that use a non-ASCII code page. | -| AllowDotInPath | Allowed values are 0 or 1. The default value for AllowDotInPath is 1. If set to 1, UrlScan will allow requests that contain multiple instances of the dot (.) character in the URL. If set to 0, UrlScan will reject requests that contain multiple instances of the dot (.) character in the URL. **Note:** Because UrlScan operates at a level where IIS has not yet parsed the URL, it is not possible to determine in all cases whether a dot character denotes the extension or whether it is a part of the directory path or filename of the URL. For the purposes of extension analysis, UrlScan will always assume that an extension is the part of the URL beginning after the last dot in the string and ending at the first question mark or slash character after the dot or the end of the string. Setting AllowDotInPath to 0 defends against the case where an attacker uses path info to hide the true extension of the request (for example, something like "/path/TruePart.asp/FalsePart.htm"). Setting AllowDotInPath to 0 also causes UrlScan to deny any request that contains a dot in a directory or file name. | -| AllowLateScanning | Allowed values are 0 or 1. The default value for AllowLateScanning is 0. If set to 1, UrlScan will register itself as a low priority filter. This will allow other ISAPI filters to modify the URL before UrlScan performs any analysis. If set to 0, UrlScan runs as a high priority filter. **Note:** In addition to the value of AllowLateScanning, it may be necessary to ensure that UrlScan is listed lower on the list of ISAPI filters for the server. For example, the FrontPage Server Extensions require that AllowLateScanning is set to 1 and that UrlScan is lower on the filter load order list than the Fpexedll.dll ISAPI filter. **Note:** This feature was introduced in UrlScan 2.0. | -| UseFastPathReject | Allowed values are 0 or 1. The default value for UseFastPathReject is 0. If set to 1, UrlScan will return a short 404 response to the client in cases where it rejects a request. **Note:** Using UseFastPathReject is faster than using the RejectResponseUrl option, but IIS cannot return a custom 404 response or log many parts of the request into the IIS log, even though the UrlScan log file will contain complete information about the rejected request. **Note:** This feature was introduced in UrlScan 2.0. | -| RejectResponseUrl | Allowed value is a string. The default value for RejectResponseUrl is /<Rejected-By-UrlScan>. The value for RejectResponseUrl is a URL in the form "/path/filename.ext". When UrlScan rejects a request, it will process the specified URL, which needs to be local to the Web site for the request that is being analyzed by UrlScan. The specified URL can have the same extension as the rejected URL; for example, ".asp". **Note:** UrlScan creates the following server variables that can be used by the specified URL in determining the nature of the rejected request and to allow flexibility in returning the actual response to the client: - HTTP\_UrlScan\_STATUS\_HEADER - Contains the reason the request is being rejected. - HTTP\_UrlScan\_ORIGINAL\_VERB - Contains the original verb from the request that is being rejected. - HTTP\_UrlScan\_ORIGINAL\_URL - Contains the original URL from the request that is being rejected. UrlScan appends the URL of the request that is being rejected as a query string to the location specified by RejectResponseUrl. If IIS is configured to log request query strings, the URL of the rejected request can be found in the IIS log in addition to the UrlScan log. There is a special value for RejectResponseUrl that can be used to put UrlScan into "Logging Only Mode." If you set the value of RejectResponseUrl to /~\*, UrlScan performs all of the configured scanning and logs the results, however, it will allow IIS to serve the page even if it would normally be rejected. This mode is useful if you would like to test UrlScan.ini settings without actually rejecting any requests, and the log entries in the UrlScan log file will indicate that requests are not being rejected. **Note:** This feature was introduced in UrlScan 2.0. | - -#### Logging Options - -| EnableLogging | Allowed values are 0 or 1. The default value for EnableLogging is 1. If set to 1, UrlScan will log its actions in a file called UrlScan.log that will be created in the same directory that contains UrlScan.dll. If set to 0, UrlScan will not log any activity. | -| --- | --- | -| PerProcessLogging | Allowed values are 0 or 1. The default value of PerProcessLogging is 0. If set to 1, UrlScan will append the process ID of the IIS process that is hosting UrlScan.dll to the log file name; for example, UrlScan.1234.log. This feature is helpful for IIS versions that can host filters in more than 1 process concurrently, such as IIS 6.0 and later. If set to 0, UrlScan will log all activity in UrlScan.log. | -| PerDayLogging | Allowed values are 0 or 1. The default value of PerDayLogging is 1. If set to 1, UrlScan creates a new log file each day and appends a date to the log file name; for example, UrlScan.101501.log. If set to 0, UrlScan opens a single file called UrlScan.log, or UrlScan.nnnn.log, where nnnn is the process ID when PerProcessLogging is set to 1. **Note:** When PerDayLogging is set to 1, a log file is created for the current day when the first log entry is written for that day. If no UrlScan activity occurs, a log file will not be created for that day. If both PerDayLogging and PerProcessLogging are set to 1, the log file name contains the date and a process ID in the name; for example, UrlScan.101501.123.log. **Note:** This feature was introduced in UrlScan 2.0. | -| LogLongUrls | Allowed values are 0 or 1. The default value of LogLongUrls is 0. If set to 1, then URLs up to 128 KB per request can be logged. If set to 0, then only URLs up to 1 KB is allowed per request. **Note:** This feature was introduced in UrlScan 2.5. | -| LoggingDirectory | Allowed value is a string. The default value for LoggingDirectory is `C:\WINDOWS\system32\inetsrv\UrlScan\logs`. Use LoggingDirectory to specify the absolute path to the directory where the UrlScan log files will be created. If you do not specify a path, UrlScan will create log files in the same directory where the UrlScan.dll file is located. **Note:** This feature was introduced in UrlScan 2.5. | - -#### HTTP Server Header Manipulation - -| RemoveServerHeader | Allowed values are 0 or 1. The default value for RemoveServerHeader is 1. If set to 1, UrlScan will remove the server header on all responses, and the value of AlternateServerName will be ignored. If set to 0, IIS will return the default server header on all responses. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | -| --- | --- | -| AlternateServerName | Allowed value is a string. The default value for AlternateServerName is an empty string. If you specify a value for AlternateServerName and RemoveServerHeader is set to 0, then IIS will replace its default "Server:" header in all responses with the AlternateServerName value. If RemoveServerHeader is set to 1, the value of AlternateServerName will be ignored. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | - -##### Example [Options] Section - -The following example [Options] section configures several recommended settings for UrlScan: - -[!code-console[Main](urlscan-2-reference/samples/sample1.cmd)] - - - -### [AllowVerbs] Section - -The [AllowVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 1 in the [Options] section, UrlScan will reject any request that contains an HTTP verb that is not explicitly listed in this section. The entries in this section are case sensitive. - -##### Example [AllowVerbs] Section - -The following example [AllowVerbs] section configures UrlScan to allow basic HTTP functionality: - -[!code-console[Main](urlscan-2-reference/samples/sample2.cmd)] - -To use this example, you would need to set UseAllowVerbs to 1 in the [Options] section. - - - -### [DenyVerbs] Section - -The [DenyVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 0 in the [Options] section, UrlScan will reject any request that contains a verb that is listed in this section. The entries in this section are not case sensitive. - -##### Example [DenyVerbs] Section - -The following example [DenyVerbs] section configures UrlScan to deny several of the HTTP methods that are not required for basic HTTP functionality, such as WebDAV methods: - -[!code-console[Main](urlscan-2-reference/samples/sample3.cmd)] - -To use this example, you would need to set UseAllowVerbs to 0 in the [Options] section. - - - -### [DenyHeaders] Section - -The [DenyHeaders] section contains a list of request headers in the form "header-name:". Any request containing a request header listed in this section will be rejected. The entries in this section are not case sensitive. - -##### Example [DenyHeaders] Section - -The following example [DenyHeaders] section configures UrlScan to deny several HTTP headers that are used with WebDAV requests: - -[!code-console[Main](urlscan-2-reference/samples/sample4.cmd)] - - - -### [AllowExtensions] Section - -The [AllowExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=1 is set in the [Options] section, then any request containing a URL with an extension not explicitly listed here is rejected. The entries in this section are not case sensitive. - -##### Example [AllowExtensions] Section - -The following example [AllowExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-2-reference/samples/sample5.cmd)] - -To use this example, you would need to set UseAllowExtensions to 1 in the [Options] section. - - - -### [DenyExtensions] Section - -The [DenyExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=0 is set in the [Options] section, then any request containing a URL with an extension listed here is rejected. The entries in this section are not case sensitive. - -##### Example [DenyExtensions] Section - -The following example [DenyExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-2-reference/samples/sample6.cmd)] - -To use this example, you would need to set UseAllowExtensions to 0 in the [Options] section. - - - -### [DenyUrlSequences] Section - -The [DenyUrlSequences] section contains a list of character sequences that UrlScan will deny if they appear in a URL. For example, two dots ".." indicate a parent path, which a hacker might try to use to gain access to files outside of a Web site's content area. - -##### Example [DenyUrlSequences] Section - -The following example [DenyUrlSequences] section configures UrlScan to deny several URL sequences that could be used to attack your server: - -[!code-console[Main](urlscan-2-reference/samples/sample7.cmd)] - - - -### [RequestLimits] Section - -The [RequestLimits] section impose limits on the length of user-defined parts of HTTP requests, such as the maximum content length or maximum URL length for HTTP requests. - -> [!NOTE] -> This feature was introduced in UrlScan 2.5. - -You can specify the maximum length of the value for a specific request header by adding "Max-" to the name of the header. For example, the following entry would impose a limit of 100 bytes to the value of the 'Content-Type' header: - -> Max-Content-Type=100 - -To list a header and not specify a maximum value, use 0. For example, "Max-User-Agent=0". Note: Any HTTP request headers that are not listed in this section will not be checked for length limits. - -The [RequestLimits] section can contain the following three special-case limits: - -| MaxAllowedContentLength | Specifies the maximum allowed numeric value, in bytes, of the Content-Length request header. For example, setting this to 1000 would cause any request with a content length that exceeds 1000 to be rejected. The default value for MaxAllowedContentLength is 30000000. | -| --- | --- | -| MaxUrl | Specifies the maximum length, in bytes, of the request URL, not including the query string. The default value for MaxUrl is 260, which is equivalent to the MAX\_PATH constant. | -| MaxQueryString | Specifies the maximum length, in bytes, of the query string. The default value for MaxQueryString is 4096. | - -##### Example [RequestLimits] Section - -The following example [RequestLimits] section configures UrlScan to specify the maximum lengths for several HTTP headers and the maximum content length for a request: - -[!code-console[Main](urlscan-2-reference/samples/sample8.cmd)] diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample1.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample1.cmd deleted file mode 100644 index 0c9270773..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample1.cmd +++ /dev/null @@ -1,15 +0,0 @@ -[Options] -UseAllowVerbs=1 ; Use the [AllowVerbs] section. -UseAllowExtensions=0 ; Use the [DenyExtensions] section. -NormalizeUrlBeforeScan=1 ; Normalize a URL before processing. -VerifyNormalization=1 ; Normalize a URL twice and reject request if a change occurs. -AllowHighBitCharacters=0 ; Deny high bit characters in URL. -AllowDotInPath=0 ; Deny dots that are not file name extensions. -RemoveServerHeader=0 ; Do not remove the "Server" header from response. -EnableLogging=1 ; Log UrlScan activity. -PerProcessLogging=0 ; Do not create log files for each process. -AllowLateScanning=0 ; Load UrlScan as a high priority filter. -PerDayLogging=1 ; UrlScan will create a new log file each day. -RejectResponseUrl= ; Default is / -UseFastPathReject=0 ; Use the RejectResponseUrl or allow IIS to log the request. -LogLongUrls=1 ; Log URLs up to 128 KB per request. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample2.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample2.cmd deleted file mode 100644 index 83874a880..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[AllowVerbs] -HEAD ; Allow HTTP feature discovery. -GET ; Allow most HTTP requests. -POST ; Allow posting data to applications. -OPTIONS ; Allow HTTP feature discovery. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample3.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample3.cmd deleted file mode 100644 index 1319dface..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample3.cmd +++ /dev/null @@ -1,12 +0,0 @@ -[DenyVerbs] -TRACE ; Deny HTTP tracing. -PUT ; Deny uploading files. -DELETE ; Deny deleting files. -MKCOL ; Deny creating folders/collections. -COPY ; Deny copying files. -MOVE ; Deny moving files. -LOCK ; Deny locking resources. -UNLOCK ; Deny unlocking resources. -PROPFIND ; Deny property queries. -PROPPATCH ; Deny setting properties. -SEARCH ; Deny protocol-based searches. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample4.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample4.cmd deleted file mode 100644 index a7ea1bbd6..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample4.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[DenyHeaders] -Translate: ; Allow HTTP feature discovery. -If: ; Allow most HTTP requests. -Lock-Token: ; Allow posting data to applications. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample5.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample5.cmd deleted file mode 100644 index 7c3b359b2..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample5.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[AllowExtensions] -.htm ; Allow HTML files. -.html ; Allow HTML files. -.txt ; Allow text files. -.jpg ; Allow JPEG graphics. -.jpeg ; Allow JPEG graphics. -.gif ; Allow GIF graphics. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample6.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample6.cmd deleted file mode 100644 index a19964c7d..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample6.cmd +++ /dev/null @@ -1,28 +0,0 @@ -[DenyExtensions] -.asp ; Deny ASP requests. -.asa ; Deny ASA requests. -.inc ; Deny include files. -.cdx ; Deny certificate requests. -.cer ; Deny certificate requests. -.config ; Deny configuration files. -.exe ; Deny executable files. -.bat ; Deny batch files. -.cmd ; Deny batch files. -.com ; Deny executable files. -.htw ; Deny Index Server hit highlighting. -.ida ; Deny HTTP-based Index Server administration. -.idq ; Deny Index Server queries. -.htr ; Deny legacy IIS password changing requests. -.idc ; Deny legacy database access requests. -.shtm ; Deny Server Side Includes. -.shtml ; Deny Server Side Includes. -.stm ; Deny Server Side Includes. -.printer ; Deny Internet-based printing. -.ini ; Deny configuration files. -.log ; Deny log files. -.pol ; Deny policy files. -.dat ; Deny configuration files. -.mdb ; Deny Microsoft Access databases. -.ldb ; Deny Microsoft Access lock files. -.mdf ; Deny Microsoft SQL databases. -.ldf ; Deny Microsoft SQL log files. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample7.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample7.cmd deleted file mode 100644 index bd5bb478a..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample7.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[DenyUrlSequences] -.. ; Deny directory traversals. -./ ; Deny trailing dot on a directory name. -\ ; Deny backslashes in URL. -: ; Deny access to alternate streams. -% ; Deny escaping after normalization. -& ; Deny running multiple CGI processes on a single request. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample8.cmd b/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample8.cmd deleted file mode 100644 index 454cc3e18..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-2-reference/samples/sample8.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[RequestLimits] -MaxAllowedContentLength=30000000 -MaxUrl=1024 -MaxQueryString=2048 -Max-User-Agent=1024 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference.md b/iis/extensions/working-with-urlscan/urlscan-3-reference.md deleted file mode 100644 index 9f7acb4f4..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference.md +++ /dev/null @@ -1,293 +0,0 @@ ---- -title: "UrlScan 3 Reference" -author: rmcmurray -description: "Note : UrlScan 3.0 has been replaced by UrlScan 3.1. If you are using UrlScan 3.0, you should download and install the latest version. Microsoft released Url..." -ms.date: 07/15/2010 -ms.assetid: 919552f3-f3ec-4fde-aa55-85e5ee3b5164 -msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-3-reference -msc.type: authoredcontent ---- -# UrlScan 3 Reference - -by [Robert McMurray](https://github.com/rmcmurray) - -> [!NOTE] -> UrlScan 3.0 has been replaced by UrlScan 3.1. If you are using UrlScan 3.0, you should download and install the latest version. - -Microsoft released UrlScan 3.0 as a separate download, which added features to create filtering rules, to always allow specific URLs to bypass UrlScan filtering, and to allow or deny requests that contained user-defined query string elements. This feature helps prevent server attacks that use query strings, such as SQL injection attacks. UrlScan 3.0 added change notifications for the UrlScan.ini file, so it is no longer necessary to restart IIS after updating your UrlScan.ini file. - -Microsoft later released UrlScan 3.1 as a separate download, which added enhanced parsing of escape sequences in URLs and query strings. - - - -## Installing UrlScan 3.1 - -UrlScan 3.1 installs as a clean install on a computer running IIS 5.1 or later. Upgrade scenarios are also supported. - -**To Install UrlScan 3.1** - -1. Download the setup MSI file for UrlScan 3.1 from one of the following URLs to your computer: - - - x86: [https://www.microsoft.com/downloads/details.aspx?FamilyID=ee41818f-3363-4e24-9940-321603531989](https://www.microsoft.com/downloads/details.aspx?FamilyID=ee41818f-3363-4e24-9940-321603531989) - - x64: [https://www.microsoft.com/downloads/details.aspx?FamilyID=361e5598-c1bd-46b8-b3e7-3980e8bdf0de](https://www.microsoft.com/downloads/details.aspx?FamilyID=361e5598-c1bd-46b8-b3e7-3980e8bdf0de) -2. Double-click the MSI file to begin the installation process. -3. Review the agreement in the UrlScan Installer Package End User Agreement and then click **Yes** to accept the agreement and continue. If you click **No**, the installer will close. -4. When the installer completes, a dialog box stating that UrlScan has been successfully installed will be displayed. Click **Finish** to close the installer. - -**To Uninstall UrlScan** - -1. In Control Panel, double-click **Add or Remove Programs**. -2. Select **Microsoft UrlScan Filter v3.1** and then click the **Remove** button. -3. Click **Yes** when prompted to remove UrlScan 3.1 from your computer. -4. When UrlScan 3.1 has been removed from your server, a dialog box stating that UrlScan has been successfully uninstalled may be displayed. If so, click **Finish** to close the installer. - -**Understanding the UrlScan 3.1 Installer** - -When installing UrlScan 3.1, the UrlScan 3.1 installer does the following: - -- Installs the UrlScan.dll and UrlScan.ini files in the `%windir%\system32\inetsrv\UrlScan` directory. If UrlScan is already installed on the computer, the UrlScan.ini file is updated with any new settings that are not present in the current configuration file. -- Adds UrlScan as a global filter to IIS. -- Creates a `%windir%\system32\inetsrv\UrlScan\Logs` directory. - -When installing UrlScan on a server running IIS 6.0, the UrlScan 3.1 installer makes some additional changes that enable UrlScan 3.1 to work with the new IIS 6.0 process model. These changes are as follows: - -- **PerProcessLogging** is set to 1 in the UrlScan.ini file. This ensures that two UrlScan processes do not write to the log file at the same time. -- UrlScan is marked as cache-aware in the metabase. This ensures that two or more worker processes that are running UrlScan do not write to the log file at the same time. -- The new log directory, which is a subdirectory located under the ..\inetsrv\UrlScan directory, ensures that the UrlScan directory does not get cluttered with all of the log files that the **PerProcessLogging** option will create. - -When installing UrlScan 3.1 on IIS, the installer sets permissions for UrlScan.dll, UrlScan.ini, and the log file. When installing UrlScan 3.1 on IIS 6.0, the installer sets additional permissions on the same files to allow UrlScan 3.1 to work with IIS 6.0 worker process isolation mode. Table 2 lists the IIS permissions that are set when UrlScan 3.1 is installed. - -**Table 2: UrlScan 3.1 IIS 6.0 Permissions** - -| **File/Directory** | **Permissions** | -| --- | --- | -| ..\inetsrv\UrlScan\UrlScan.dll | Read and Execute (set on IIS 6.0 only): LocalService, IIS\_WPG, and NetworkService Full: Administrators, and LocalSystem | -| ..\inetsrv\UrlScan\UrlScan.ini | Read (set on IIS 6.0 only): IIS\_WPG, LocalService, and NetworkService Full: Administrators, and LocalSystem | -| ..\inetsrv\UrlScan\logs | Read and Write (set on IIS 6.0 only): IIS\_WPG, LocalService, and NetworkService Full: Administrators, and LocalSystem | - -If a version of UrlScan is detected on the computer, the installation will be considered an upgrade. In the upgrade scenario, the changes that the installer makes will be the same as for a clean installation unless you have configured a custom log directory. If you have defined a different location for the UrlScan logs, then the new logs directory will not be created. - - - -## Using UrlScan 3.1 - -You configure UrlScan's operation by setting options in the UrlScan.ini file. This file should reside in the same directory as UrlScan.dll, and it contains the sections and options that are listed below. - -> [!NOTE] -> UrlScan 3.0 added change notifications for the UrlScan.ini file, so it is no longer necessary to restart IIS after updating your UrlScan.ini file. - -**Warning**: The default options built into UrlScan.dll will result in a configuration that will reject all requests to the server, therefore it is necessary to provide a UrlScan.ini file for IIS to serve HTTP requests when you are using UrlScan. A sample UrlScan.ini file is provided that contains the recommended settings to defend against known attacks against IIS servers at the time of writing. - - - -## UrlScan.ini Sections - - - -### [Options] Section - -The [Options] section of a UrlScan.ini file contains a list of name/value pairs that define the general behavior for UrlScan. A few of the settings enable or disable other sections in the UrlScan.ini file. - -#### Enabling or Disabling other UrlScan.ini Sections - -| UseAllowVerbs | Allowed values are 0 or 1. The default value for UseAllowVerbs is 1. If set to 1, UrlScan will read the [AllowVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb that is not explicitly listed. If set to 0, UrlScan will read the [DenyVerbs] section of the UrlScan.ini file and reject any request containing an HTTP verb listed. **Note:** The [AllowVerbs] section is case sensitive, but the [DenyVerbs] section is not case sensitive. | -| --- | --- | -| UseAllowExtensions | Allowed values are 0 or 1. The default value for UseAllowExtensions is 1. If set to 1, UrlScan will read the [AllowExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the URL is not explicitly listed. If set to 0, UrlScan will read the [DenyExtensions] section of the UrlScan.ini file and reject any request where the file name extension associated with the request is listed. **Note:** The [AllowExtensions] and [DenyExtensions] sections are both case insensitive. | - -#### URL Scanning Options - -| NormalizeUrlBeforeScan | Allowed values are 0 or 1. The default value for NormalizeUrlBeforeScan is 1. If set to 1, UrlScan will do all of its analysis on the request URLs after IIS decodes and normalizes them. If set to 0, UrlScan will do all of its analysis on the raw URLs as sent by the client. **Note:** Only advanced administrators who are very knowledgeable about URL parsing should set this option to 0, as doing so will likely expose the IIS server to canonicalization attacks that bypass proper analysis of the URL extensions. | -| --- | --- | -| VerifyNormalization | Allowed values are 0 or 1. The Default value for VerifyNormalization is 1. If set to 1, UrlScan verifies normalization of the URL. This action will defend against canonicalization attacks, where a URL contains a double encoded string in the URL. For example, the string "%252e" is a double encoded dot '.' character because "%25" decodes to a '%' character, the first pass decoding of "%252e" results in "%2e", which can be decoded a second time into a single dot '.' string. If set to 0, then UrlScan will not verify normalization of the URL. **Note:** This option is dependent on the NormalizeUrlBeforeScan option. | -| AllowHighBitCharacters | Allowed values are 0 or 1. The default value for AllowHighBitCharacters is 1. If set to 1, then UrlScan will allow any byte to exist in the URL. If set to 0, UrlScan will reject any request where the URL contains a character outside of the ASCII character set. **Note:** This feature can defend against UNICODE or UTF-8 based attacks, but will also reject legitimate requests on IIS servers that use a non-ASCII code page. | -| AllowDotInPath | Allowed values are 0 or 1. The default value for AllowDotInPath is 1. If set to 1, UrlScan will allow requests that contain multiple instances of the dot (.) character in the URL. If set to 0, UrlScan will reject requests that contain multiple instances of the dot (.) character in the URL. **Note:** Because UrlScan operates at a level where IIS has not yet parsed the URL, it is not possible to determine in all cases whether a dot character denotes the extension or whether it is a part of the directory path or filename of the URL. For the purposes of extension analysis, UrlScan will always assume that an extension is the part of the URL beginning after the last dot in the string and ending at the first question mark or slash character after the dot or the end of the string. Setting AllowDotInPath to 0 defends against the case where an attacker uses path info to hide the true extension of the request (for example, something like "/path/TruePart.asp/FalsePart.htm"). Setting AllowDotInPath to 0 also causes UrlScan to deny any request that contains a dot in a directory or file name. | -| AllowLateScanning | Allowed values are 0 or 1. The default value for AllowLateScanning is 0. If set to 1, UrlScan will register itself as a low priority filter. This will allow other ISAPI filters to modify the URL before UrlScan performs any analysis. If set to 0, UrlScan runs as a high priority filter. **Note:** In addition to the value of AllowLateScanning, it may be necessary to ensure that UrlScan is listed lower on the list of ISAPI filters for the server. For example, the FrontPage Server Extensions require that AllowLateScanning is set to 1 and that UrlScan is lower on the filter load order list than the Fpexedll.dll ISAPI filter. **Note:** This feature was introduced in UrlScan 2.0. | -| UseFastPathReject | Allowed values are 0 or 1. The default value for UseFastPathReject is 0. If set to 1, UrlScan will return a short 404 response to the client in cases where it rejects a request. **Note:** Using UseFastPathReject is faster than using the RejectResponseUrl option, but IIS cannot return a custom 404 response or log many parts of the request into the IIS log, even though the UrlScan log file will contain complete information about the rejected request. **Note:** This feature was introduced in UrlScan 2.0. | -| RejectResponseUrl | Allowed value is a string. The default value for RejectResponseUrl is /<Rejected-By-UrlScan>. The value for RejectResponseUrl is a URL in the form "/path/filename.ext". When UrlScan rejects a request, it will process the specified URL, which needs to be local to the Web site for the request that is being analyzed by UrlScan. The specified URL can have the same extension as the rejected URL; for example, ".asp". **Note:** UrlScan creates the following server variables that can be used by the specified URL in determining the nature of the rejected request and to allow flexibility in returning the actual response to the client: - HTTP\_UrlScan\_STATUS\_HEADER - Contains the reason the request is being rejected. - HTTP\_UrlScan\_ORIGINAL\_VERB - Contains the original verb from the request that is being rejected. - HTTP\_UrlScan\_ORIGINAL\_URL - Contains the original URL from the request that is being rejected. UrlScan appends the URL of the request that is being rejected as a query string to the location specified by RejectResponseUrl. If IIS is configured to log request query strings, the URL of the rejected request can be found in the IIS log in addition to the UrlScan log. There is a special value for RejectResponseUrl that can be used to put UrlScan into "Logging Only Mode." If you set the value of RejectResponseUrl to /~\*, UrlScan performs all of the configured scanning and logs the results, however, it will allow IIS to serve the page even if it would normally be rejected. This mode is useful if you would like to test UrlScan.ini settings without actually rejecting any requests, and the log entries in the UrlScan log file will indicate that requests are not being rejected. **Note:** This feature was introduced in UrlScan 2.0. | -| UnescapeQueryString | Allowed values are 0 or 1. The default value for UnescapeQueryString is 1. If set to 1, UrlScan will perform two passes on each query string scan. The first pass will scan the raw query string, and the second pass will scan the query string after IIS has decoded any escape sequences. If set to 0, UrlScan will only look at the raw query string as sent by the client. **Note:** If this property is set to 0, then checks based on the query string will be unreliable. **Note:** This feature was introduced in UrlScan 3.0. | -| RuleList | Allowed value is a string. The default value is a blank string. RuleList specifies a comma-separated list of custom rules that UrlScan will apply in addition to the other checks and options that are specified in the UrlScan.ini file. Each rule in the list corresponds to two sections in this configuration file, one containing the options for the rule, and one containing deny strings for the rule. **Note:** This feature was introduced in UrlScan 3.0. | - -#### Logging Options - -| EnableLogging | Allowed values are 0 or 1. The default value for EnableLogging is 1. If set to 1, UrlScan will log its actions in a file called UrlScan.log that will be created in the same directory that contains UrlScan.dll. If set to 0, UrlScan will not log any activity. | -| --- | --- | -| PerProcessLogging | Allowed values are 0 or 1. The default value of PerProcessLogging is 0. If set to 1, UrlScan will append the process ID of the IIS process that is hosting UrlScan.dll to the log file name; for example, UrlScan.1234.log. This feature is helpful for IIS versions that can host filters in more than 1 process concurrently, such as IIS 6.0 and later. If set to 0, UrlScan will log all activity in UrlScan.log. | -| PerDayLogging | Allowed values are 0 or 1. The default value of PerDayLogging is 1. If set to 1, UrlScan creates a new log file each day and appends a date to the log file name; for example, UrlScan.101501.log. If set to 0, UrlScan opens a single file called UrlScan.log, or UrlScan.nnnn.log, where nnnn is the process ID when PerProcessLogging is set to 1. **Note:** When PerDayLogging is set to 1, a log file is created for the current day when the first log entry is written for that day. If no UrlScan activity occurs, a log file will not be created for that day. If both PerDayLogging and PerProcessLogging are set to 1, the log file name contains the date and a process ID in the name; for example, UrlScan.101501.123.log. **Note:** This feature was introduced in UrlScan 2.0. | -| LogLongUrls | **Note:** This feature was deprecated in UrlScan 3.0; UrlScan 3.x will always include the complete URL in its log file. | -| LoggingDirectory | Allowed value is a string. The default value for LoggingDirectory is `C:\WINDOWS\system32\inetsrv\UrlScan\logs`. Use LoggingDirectory to specify the absolute path to the directory where the UrlScan log files will be created. If you do not specify a path, UrlScan will create log files in the same directory where the UrlScan.dll file is located. **Note:** This feature was introduced in UrlScan 3.1. | - -#### HTTP Server Header Manipulation - -| RemoveServerHeader | Allowed values are 0 or 1. The default value for RemoveServerHeader is 1. If set to 1, UrlScan will remove the server header on all responses, and the value of AlternateServerName will be ignored. If set to 0, IIS will return the default server header on all responses. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | -| --- | --- | -| AlternateServerName | Allowed value is a string. The default value for AlternateServerName is an empty string. If you specify a value for AlternateServerName and RemoveServerHeader is set to 0, then IIS will replace its default "Server:" header in all responses with the AlternateServerName value. If RemoveServerHeader is set to 1, the value of AlternateServerName will be ignored. **Note:** This feature is only available if UrlScan is installed on IIS 4.0 or later. | - -##### Example [Options] Section - -The following example [Options] section configures several recommended settings for UrlScan: - -[!code-console[Main](urlscan-3-reference/samples/sample1.cmd)] - - - -### [AllowVerbs] Section - -The [AllowVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 1 in the [Options] section, UrlScan will reject any request that contains an HTTP verb that is not explicitly listed in this section. The entries in this section are case sensitive. - -##### Example [AllowVerbs] Section - -The following example [AllowVerbs] section configures UrlScan to allow basic HTTP functionality: - -[!code-console[Main](urlscan-3-reference/samples/sample2.cmd)] - -To use this example, you would need to set UseAllowVerbs to 1 in the [Options] section. - - - -### [DenyVerbs] Section - -The [DenyVerbs] section contains a list of HTTP verbs or methods. If UseAllowVerbs is set to 0 in the [Options] section, UrlScan will reject any request that contains a verb that is listed in this section. The entries in this section are not case sensitive. - -##### Example [DenyVerbs] Section - -The following example [DenyVerbs] section configures UrlScan to deny several of the HTTP methods that are not required for basic HTTP functionality, such as WebDAV methods: - -[!code-console[Main](urlscan-3-reference/samples/sample3.cmd)] - -To use this example, you would need to set UseAllowVerbs to 0 in the [Options] section. - - - -### [DenyHeaders] Section - -The [DenyHeaders] section contains a list of request headers in the form "header-name:". Any request containing a request header listed in this section will be rejected. The entries in this section are not case sensitive. - -##### Example [DenyHeaders] Section - -The following example [DenyHeaders] section configures UrlScan to deny several HTTP headers that are used with WebDAV requests: - -[!code-console[Main](urlscan-3-reference/samples/sample4.cmd)] - - - -### [AllowExtensions] Section - -The [AllowExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=1 is set in the [Options] section, then any request containing a URL with an extension not explicitly listed here is rejected. The entries in this section are not case sensitive. - -##### Example [AllowExtensions] Section - -The following example [AllowExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-3-reference/samples/sample5.cmd)] - -To use this example, you would need to set UseAllowExtensions to 1 in the [Options] section. - - - -### [DenyExtensions] Section - -The [DenyExtensions] section contains a list of file name extensions in the form of ".ext". If UseAllowExtensions=0 is set in the [Options] section, then any request containing a URL with an extension listed here is rejected. The entries in this section are not case sensitive. - -##### Example [DenyExtensions] Section - -The following example [DenyExtensions] section configures UrlScan to allow several static content types: - -[!code-console[Main](urlscan-3-reference/samples/sample6.cmd)] - -To use this example, you would need to set UseAllowExtensions to 0 in the [Options] section. - - - -### [DenyUrlSequences] Section - -The [DenyUrlSequences] section contains a list of character sequences that UrlScan will deny if they appear in a URL. For example, two dots ".." indicate a parent path, which a hacker might try to use to gain access to files outside of a Web site's content area. - -##### Example [DenyUrlSequences] Section - -The following example [DenyUrlSequences] section configures UrlScan to deny several URL sequences that could be used to attack your server: - -[!code-console[Main](urlscan-3-reference/samples/sample7.cmd)] - - - -### [RequestLimits] Section - -The [RequestLimits] section impose limits on the length of user-defined parts of HTTP requests, such as the maximum content length or maximum URL length for HTTP requests. - -> [!NOTE] -> This feature was introduced in UrlScan 3.1. - -You can specify the maximum length of the value for a specific request header by adding "Max-" to the name of the header. For example, the following entry would impose a limit of 100 bytes to the value of the 'Content-Type' header: - -> Max-Content-Type=100 - -To list a header and not specify a maximum value, use 0. For example, "Max-User-Agent=0". Note: Any HTTP request headers that are not listed in this section will not be checked for length limits. - -The [RequestLimits] section can contain the following three special-case limits: - -| MaxAllowedContentLength | Specifies the maximum allowed numeric value, in bytes, of the Content-Length request header. For example, setting this to 1000 would cause any request with a content length that exceeds 1000 to be rejected. The default value for MaxAllowedContentLength is 30000000. | -| --- | --- | -| MaxUrl | Specifies the maximum length, in bytes, of the request URL, not including the query string. The default value for MaxUrl is 260, which is equivalent to the MAX\_PATH constant. | -| MaxQueryString | Specifies the maximum length, in bytes, of the query string. The default value for MaxQueryString is 4096. | - -##### Example [RequestLimits] Section - -The following example [RequestLimits] section configures UrlScan to specify the maximum lengths for several HTTP headers and the maximum content length for a request: - -[!code-console[Main](urlscan-3-reference/samples/sample8.cmd)] - - - -### [AlwaysAllowedUrls] Section - -The [AlwaysAllowedUrls] section contains a list of URLs that UrlScan will always allow. - -> [!NOTE] -> These URLs will bypass all URL-based checks, and URLs must be listed with a leading '/' character. - -##### Example [AlwaysAllowedUrls] Section - -The following example [AlwaysAllowedUrls] section configures UrlScan to deny several URL sequences that could be used to attack your server: - -[!code-console[Main](urlscan-3-reference/samples/sample9.cmd)] - - - -### [AlwaysAllowedQueryStrings] Section - -The [AlwaysAllowedQueryStrings] section contains a list of query strings that will always be explicitly allowed by UrlScan and bypass all checks. - - - -### [DenyQueryStringSequences] Section - -The [DenyQueryStringSequences] section contains a list of character sequences that UrlScan will deny if they appear in a query string. - -##### Example [DenyQueryStringSequences] Section - -The following example [DenyQueryStringSequences] section configures UrlScan to deny several query string sequences that could be used to attack your server: - -[!code-console[Main](urlscan-3-reference/samples/sample10.cmd)] - - - -### Rule Sections - -Individual rule sections contain the settings for rules that are specified in the RuleList setting in the [Options] section, and each rule section can specify an additional rule data section that contains a list of strings to deny. - -Each rule section can contain the following settings: - -| AppliesTo | Allowed value is a string. The default value is blank. The AppliesTo setting may contain comma separated list of file extensions to which the rule applies. For example, .asp, .aspx., .php, etc. **Note:** If no AppliesTo setting is specified, the rule will be applied to all requests. **Note:** This feature was introduced in UrlScan 3.0. | -| --- | --- | -| DenyDataSection | Allowed value is a string. The default value is blank. The DenyDataSection setting may contain the name of a section that contains the strings to deny for this rule. **Note:** This feature was introduced in UrlScan 3.0. | -| ScanURL | Allowed values are 0 or 1. The default value of ScanURL is 0. If set to 1, the URL will be scanned for deny strings. **Note:** This feature was introduced in UrlScan 3.0. | -| ScanAllRaw | Allowed values are 0 or 1. The default value of ScanAllRaw is 0. If set to 1, then the raw request header data will be scanned for deny strings. **Note:** This feature was introduced in UrlScan 3.0. | -| ScanQueryString | Allowed values are 0 or 1. The default value of ScanQueryString is 0. If set to 1, the query string will be scanned for deny strings. **Note:** If UnescapeQueryString is set to 1 in the [Options] section, then two scans will be made of the query string, one with the raw query string and one with the query string unescaped. **Note:** This feature was introduced in UrlScan 3.0. | -| ScanHeaders | Allowed value is a string. The default value is no headers. A comma separated list of request headers to be scanned for deny strings. **Note:** This feature was introduced in UrlScan 3.0. | -| DenyUnescapedPercent | Allowed values are 0 or 1. The default value of DenyUnescapedPercent is 0. If set to 1, UrlScan will scan the specified part of the raw request for a % character that is not used as an escape sequence. If found, the request will be rejected. This check can be used with ScanQueryString=1, ScanAllRaw=1, or the list of ScanHeaders. **Note:** If you want to deny non-escaped % characters in the URL, you can set VerifyNormalization=0 in the [Options] section and then add % as a [DenyUrlSequences] entry. **Note:** This feature was introduced in UrlScan 3.1. | - -##### Example Rule Section - -The following example rule section configures UrlScan with two custom rules that will configure custom settings for \*.asp/\*.aspx and \*.php files. In this example, the two rules share a common data section for the DenyDataSection, but you can configure your rules to use separate data sections as well. - -[!code-console[Main](urlscan-3-reference/samples/sample11.cmd)] diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample1.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample1.cmd deleted file mode 100644 index cc71f0f14..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample1.cmd +++ /dev/null @@ -1,16 +0,0 @@ -[Options] -UseAllowVerbs=1 ; Use the [AllowVerbs] section. -UseAllowExtensions=0 ; Use the [DenyExtensions] section. -NormalizeUrlBeforeScan=1 ; Normalize a URL before processing. -VerifyNormalization=1 ; Normalize a URL twice and reject request if a change occurs. -AllowHighBitCharacters=0 ; Deny high bit characters in URL. -AllowDotInPath=0 ; Deny dots that are not file name extensions. -RemoveServerHeader=0 ; Do not remove the "Server" header from response. -EnableLogging=1 ; Log UrlScan activity. -PerProcessLogging=0 ; Do not create log files for each process. -AllowLateScanning=0 ; Load UrlScan as a high priority filter. -PerDayLogging=1 ; UrlScan will create a new log file each day. -RejectResponseUrl= ; Default is / -UseFastPathReject=0 ; Use the RejectResponseUrl or allow IIS to log the request. -LogLongUrls=1 ; Log URLs up to 128 KB per request. -UnescapeQueryString=1 ; Perform two passes on the query string. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample10.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample10.cmd deleted file mode 100644 index 82c77c9c3..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample10.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[DenyQueryStringSequences] -< ; Used by script injection attacks. -> ; Used by script injection attacks. -@ ; Used by script injection attacks. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample11.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample11.cmd deleted file mode 100644 index e09d681d3..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample11.cmd +++ /dev/null @@ -1,25 +0,0 @@ -[Options] -RuleList=MyAspRule,MyPhpRule - -[MyAspRule] -AppliesTo=.asp, .aspx -DenyDataSection=MyRuleData -ScanURL=0 -ScanAllRaw=1 -ScanQueryString=1 -ScanHeaders= -DenyUnescapedPercent=1 - -[MyPhpRule] -AppliesTo=.php -DenyDataSection=MyRuleData -ScanURL=1 -ScanAllRaw=0 -ScanQueryString=1 -ScanHeaders= -DenyUnescapedPercent=1 - -[MyRuleData] -< ; Used by script injection attacks. -> ; Used by script injection attacks. -@ ; Used by script injection attacks. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample2.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample2.cmd deleted file mode 100644 index 83874a880..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample2.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[AllowVerbs] -HEAD ; Allow HTTP feature discovery. -GET ; Allow most HTTP requests. -POST ; Allow posting data to applications. -OPTIONS ; Allow HTTP feature discovery. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample3.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample3.cmd deleted file mode 100644 index 1319dface..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample3.cmd +++ /dev/null @@ -1,12 +0,0 @@ -[DenyVerbs] -TRACE ; Deny HTTP tracing. -PUT ; Deny uploading files. -DELETE ; Deny deleting files. -MKCOL ; Deny creating folders/collections. -COPY ; Deny copying files. -MOVE ; Deny moving files. -LOCK ; Deny locking resources. -UNLOCK ; Deny unlocking resources. -PROPFIND ; Deny property queries. -PROPPATCH ; Deny setting properties. -SEARCH ; Deny protocol-based searches. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample4.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample4.cmd deleted file mode 100644 index a7ea1bbd6..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample4.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[DenyHeaders] -Translate: ; Allow HTTP feature discovery. -If: ; Allow most HTTP requests. -Lock-Token: ; Allow posting data to applications. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample5.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample5.cmd deleted file mode 100644 index 7c3b359b2..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample5.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[AllowExtensions] -.htm ; Allow HTML files. -.html ; Allow HTML files. -.txt ; Allow text files. -.jpg ; Allow JPEG graphics. -.jpeg ; Allow JPEG graphics. -.gif ; Allow GIF graphics. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample6.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample6.cmd deleted file mode 100644 index 949517b82..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample6.cmd +++ /dev/null @@ -1,27 +0,0 @@ -[DenyExtensions] -.asp ; Deny ASP requests. -.asa ; Deny ASA requests. -.inc ; Deny include files. -.cer ; Deny certificate requests. -.cdx ; Deny certificate requests. -.exe ; Deny executable files. -.bat ; Deny batch files. -.cmd ; Deny batch files. -.com ; Deny executable files. -.htw ; Deny Index Server hit highlighting. -.ida ; Deny HTTP-based Index Server administration. -.idq ; Deny Index Server queries. -.htr ; Deny legacy IIS password changing requests. -.idc ; Deny legacy database access requests. -.shtm ; Deny Server Side Includes. -.shtml ; Deny Server Side Includes. -.stm ; Deny Server Side Includes. -.printer ; Deny Internet-based printing. -.ini ; Deny configuration files. -.log ; Deny log files. -.pol ; Deny policy files. -.dat ; Deny configuration files. -.mdb ; Deny Microsoft Access databases. -.ldb ; Deny Microsoft Access lock files. -.mdf ; Deny Microsoft SQL databases. -.ldf ; Deny Microsoft SQL log files. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample7.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample7.cmd deleted file mode 100644 index bd5bb478a..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample7.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[DenyUrlSequences] -.. ; Deny directory traversals. -./ ; Deny trailing dot on a directory name. -\ ; Deny backslashes in URL. -: ; Deny access to alternate streams. -% ; Deny escaping after normalization. -& ; Deny running multiple CGI processes on a single request. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample8.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample8.cmd deleted file mode 100644 index 454cc3e18..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample8.cmd +++ /dev/null @@ -1,5 +0,0 @@ -[RequestLimits] -MaxAllowedContentLength=30000000 -MaxUrl=1024 -MaxQueryString=2048 -Max-User-Agent=1024 \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample9.cmd b/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample9.cmd deleted file mode 100644 index 774e52b8b..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-3-reference/samples/sample9.cmd +++ /dev/null @@ -1,3 +0,0 @@ -[AlwaysAllowedUrls] -/robots.txt ; Always allow access to the list of rules for web spiders. -/sitemap.xml ; Always allow access to an XML-based list of site URLs. \ No newline at end of file diff --git a/iis/extensions/working-with-urlscan/urlscan-faq.yml b/iis/extensions/working-with-urlscan/urlscan-faq.yml deleted file mode 100644 index 0d8b22930..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-faq.yml +++ /dev/null @@ -1,88 +0,0 @@ -### YamlMime:FAQ -metadata: - title: "UrlScan FAQ" - author: naziml - description: "The following section provides answers to frequently asked questions about UrlScan. Question: What is UrlScan? Answer: UrlScan is a security tool that screen..." - ms.date: 06/24/2008 - ms.assetid: eba182f0-0428-474e-a87c-d478a631ce95 - msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-faq - msc.type: authoredcontent - ms.topic: faq -title: UrlScan FAQ -summary: | - by [Nazim Lala](https://github.com/naziml) - - The following section provides answers to frequently asked questions about UrlScan. - - -sections: - - name: Ignored - questions: - - question: | - What is UrlScan? - answer: | - UrlScan is a security tool that screens all incoming requests to the server by filtering the requests based on rules that are set by the administrator. Filtering requests helps secure the server by ensuring that only valid requests are processed. UrlScan helps protect Web servers because most malicious attacks share a common characteristic - they involve the use of a request that is unusual in some way. For instance, the request might be extremely long, request an unusual action, be encoded using an alternate character set, or include character sequences that are rarely seen in legitimate requests. By filtering unusual requests, UrlScan helps prevent such requests from reaching the server and potentially causing damage. - - - question: | - Will UrlScan work with my version of IIS? - answer: | - That depends on your version of IIS and the version of UrlScan that you are attempting to install: - - - UrlScan 1.0 is no longer supported. - - UrlScan 2.1 and UrlScan 2.0 are supported on IIS 5.0, IIS 5.1 and IIS 6.0. - - UrlScan 2.5 is supported on IIS 5.0, IIS 5.1 and IIS 6.0, and IIS 7.0 and above. - - UrlScan 3.1 and UrlScan 3.0 are supported on IIS 5.1, IIS 6.0, and IIS 7.0 and above. - - - question: | - I'm already using UrlScan. Why should I download an updated version? - answer: | - Microsoft always recommends installing the latest version of UrlScan because later versions of UrlScan include new features that have been added to help improve the security of servers running IIS. A short list of these new features are as follows: - - - Changing the log file directory (introduced in UrlScan 2.5) - - Logging long URLs (introduced in UrlScan 2.5) - - Restricting the size of requests (introduced in UrlScan 2.5) - - Restricting the size of HTTP headers (introduced in UrlScan 2.5) - - Configuring URLs that will bypass UrlScan filtering (introduced in UrlScan 3.0) - - Creating custom filtering rules (introduced in UrlScan 3.0) - - Specifying query strings that are always allowed or denied (introduced in UrlScan 3.0) - - Denying requests that contain unescaped percent signs (introduced in UrlScan 3.1) - - - question: | - Where are my UrlScan log files? - answer: | - By default the log files are in `%windir%\System32\Inetsrv\UrlScan\Logs` for both x86 and x64 installations. Your UrlScan.ini file contains the **LoggingDirectory** key under the **[Options]** section that would point to an absolute location to your log file directory or a relative path based on the location of your UrlScan.ini file. If you have a custom folder and are not seeing any logs, it is likely that your IIS worker process does not have write access to the logs folder. For IIS 6.0 grant IIS\_WPG group write access to this folder, and for IIS 7.0 and above grant the IIS\_IUSRS group write access to this folder. If this is a pre existing folder make sure this directory does not have any sensitive information that can be tampered. Also if you are on x64, file system redirection may affect the custom path you are writing your logs to. - - - question: | - I have UrlScan v3.0 Beta or RTM right now. What will happen if I install v3.1? - answer: | - The UrlScan v3.1 MSI will upgrade the UrlScan v3.0 Beta or RTM filters in the inetsrv directory. It will leave your .ini configuration and log files intact and the RTW version will work against your previous configuration. Since new sections have been added to the UrlScan v3.1, you can download the new default .ini file from [here](https://www.iis.net/community/files/UrlScan/UrlScan-ini_v3.zipdownloads/files/UrlScan/UrlScan-ini_v31.zip) to see what more it has to offer and add those to your existing configuration. - - - question: | - I have UrlScan v2.5 right now. What will happen if I install v3.1? - answer: | - UrlScan v3.1 will overwrite the pre-existing UrlScan v2.5 filter in the inetsrv directory. It will leave your old UrlScan.ini file intact though and no changes will be needed for this .ini file to make it work with UrlScan v3.1. If you need to restore UrlScan v2.5 you will need to re-install it from [Microsoft Download Center](https://www.microsoft.com/downloads/details.aspx?familyid=23D18937-DD7E-4613-9928-7F94EF1C902A&displaylang=en). - - - question: | - Has the log format for UrlScan changed? - answer: | - UrlScan 3.1 and 3.0 have W3C formatted logs; you can use tools like Log Parser to query information in these log files. - - - question: | - How come I don't see any 500 errors in my W3SVC logs from UrlScan blocking requests? - answer: | - UrlScan v3.1 failures result in 404 errors and not 500 errors. Searching for 404 errors in your W3SVC log will include failures due to UrlScan blocking. - - - question: | - How is this version different from the request filtering module in IIS 7.0 and above? - answer: | - The request filtering module that shipped with Windows Server 2008 RTM does not have the ability to filter based on query strings like UrlScan v3.1 does. Request Filtering module also does not allow you to specify rules that apply to multiple parts of an HTTP request in one entity. However all the changes in UrlScan v3.x will be incorporated into the request filtering module for an update release in the near future. - - - question: | - I've already configured UrlScan for my site. What will happen to my current configuration settings? - answer: | - The installation packages for UrlScan Version 2.5 and later will only add new entries to your existing configuration file. UrlScan supports all of the configuration settings from earlier versions of UrlScan. - - - question: | - If UrlScan helps protect my server against certain vulnerabilities, is it still necessary to apply security updates? - answer: | - Yes. To help protect your server from any new or existing security vulnerabilities, Microsoft strongly recommends that you evaluate and apply the latest security updates as soon as they are available. diff --git a/iis/extensions/working-with-urlscan/urlscan-overview.md b/iis/extensions/working-with-urlscan/urlscan-overview.md deleted file mode 100644 index 88ce2d06c..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-overview.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: "UrlScan Overview" -author: naziml -description: "UrlScan is a security tool that restricts the types of HTTP requests that Microsoft Internet Information Services (IIS) will process. By blocking specific HT..." -ms.date: 11/04/2009 -ms.assetid: 87825b78-26cc-4b36-8297-a3ac0b4e8c5d -msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-overview -msc.type: authoredcontent ---- -# UrlScan Overview - -by [Nazim Lala](https://github.com/naziml) - -## Introduction - -UrlScan is a security tool that restricts the types of HTTP requests that Microsoft Internet Information Services (IIS) will process. By blocking specific HTTP requests, the UrlScan security tool helps prevent potentially harmful requests from reaching the server. UrlScan is implemented as an ISAPI filter that screens and analyzes HTTP requests as IIS receives them. When properly configured, UrlScan is effective at reducing the exposure of IIS to potential Internet attacks. - -> [!NOTE] -> Microsoft has now released [UrlScan 3.1](urlscan-3-reference.md). This version updates earlier versions of UrlScan with additional features, including the ability to filter requests based on query strings - which can help mitigate SQL injection and other attacks that use a query string payload, and the ability to created custom rules that scan parts of your HTTP requests. - -Administrators may configure UrlScan to reject HTTP requests based on the following criteria: - -- The HTTP request method or verb -- The file name extension of the requested resource -- Suspicious URL encoding -- Presence of non-ASCII characters in the URL -- Presence of specified character sequences in the URL -- Presence of specified headers in the request - -When UrlScan denies a request it will log the action and the reason for the denial, along with additional information about the request – typically, the complete URL and IP address of the source of the request. When a denial occurs, IIS sends a "404 Object not found" response to the client. This simple response reduces the possibility of inadvertently disclosing information about the server to a possible attacker. - -## Getting UrlScan - -To download and install UrlScan 3.1, click on the appropriate download link for your environment: - -- Download the x86 version from [Microsoft Download Center](https://www.iis.net/downloads/microsoft/urlscan). -- Download the x64 version from [Microsoft Download Center](https://www.iis.net/downloads/microsoft/urlscan). - -UrlScan 3.1 works with the following IIS versions: - -- IIS 5.1 on Windows XP -- IIS 6.0 on Windows Server 2003 -- IIS 7.0 and above on Windows Server 2008 and Windows Vista - -> [!NOTE] -> While UrlScan 3.1 might work with IIS 4.0 on Windows NT 4.0 and IIS 5.0 on Windows 2000, these products are no longer supported by Microsoft. For more information about Microsoft's list of supported products, see Microsoft's [Support Lifecycle Policy](https://support.microsoft.com/lifecycle/). - -## UrlScan 3.1 Overview - -This section provides a quick look at how to use UrlScan Version 3.1. If you have used UrlScan Version 2.5, be sure to check out the **New Features** section. Please refer to the [Frequently Asked Questions](index.md) if you have any questions or concerns. If you do not find the information you are looking for, please post to the [IIS 7 security forums](https://forums.iis.net/1043.aspx) on IIS.net. - -UrlScan Version 3.1 is an upgrade to UrlScan Version 2.5 which was originally released as part of the IIS Lockdown Tool. UrlScan Version 3.1 maintains compatibility with its predecessor, so if you have a configuration file for the older version, you can use your existing configuration file with UrlScan Version 3.1 and the behavior will be identical. Like its predecessor, UrlScan Version 3.1 is an ISAPI filter that reads configuration from a UrlScan.ini file and restricts certain types of requests (enumerated in UrlScan.ini) from being executed by IIS. An IIS web server administrator can add, modify and extend UrlScan configuration to further restrict the types of HTTP requests that will be served by IIS. By filtering unusual requests, UrlScan will help prevent such requests from reaching application code, where they may potentially cause damage to the application or server. UrlScan Version 3.1 will install for IIS 5.1 and later, including IIS 7.0 and above for Windows Server 2008. - -### UrlScan Version 3.1 Features - -UrlScan Version 3.1 maintains feature and functionality parity with its predecessor (UrlScan Version 2.5). The configuration format is the same, but includes a few additional sections that can be used for the new features. If you are currently using UrlScan Version 2.5, you can use the same UrlScan.ini configuration file with UrlScan Version 3.1. - -#### New Features - -- Deny rules can now be independently applied to query string, all headers, a particular header, URL or a combination of these. -- A global DenyQueryString section in configuration lest you add deny rules for query strings with the option of checking the un-escaped version of the query string as well. -- A global AlwaysAllowedUrls section in configuration lets you specify safe URLs that will bypass all URL based checks. This feature has been added post UrlScan Version 3.0 Beta. -- A global AlwaysAllowedQueryStrings section in configuration lets you specify safe query strings that will bypass all query string checks. This feature has been added post UrlScan Version 3.0 Beta. -- Using escape sequences (like %0A%0D) can now be used in deny rules so it is possible to deny CRLF and other sequences involving non-printable characters. -- Multiple UrlScan instances can now be installed as site filters, each with its own configuration and rules (UrlScan.ini). -- Configuration (UrlScan.ini) change notifications will be propagated to IIS worker processes so you won't have to recycle your worker processes after making a configuration change. Logging settings are the only exception to this. -- Enhanced W3C formatted logging that will give descriptive configuration errors in the Remarks header. This feature has been added post UrlScan Version 3.0 Beta, which did not have W3C formatted logs. - -#### Features Ported from UrlScan Version 2.5 - -Here is a quick summary of the features in UrlScan Version 2.5. - -- Block requests from being executed by IIS based on HTTP Verbs, HTML Encoding, URI Extension, URL sequences and size of request. -- Ability to change log file directory. -- Ability to log long URLs (>1024 bytes) up to 128 Kb. - -Please check the [UrlScan Version 2 Reference](urlscan-2-reference.md) for more information. - -## More Information - -For additional information about using UrlScan: - -- Post queries about the tool on the IIS security forums: - - - [IIS 5.x and IIS 6.0](https://forums.iis.net/1031.aspx) - - [IIS 7.0 and IIS 7.5](https://forums.iis.net/1043.aspx) -- See blogs about UrlScan Version 3.1 from [Wade Hilmo](https://blogs.iis.net/wadeh/archive/2008/10/31/UrlScan-3-1.aspx). diff --git a/iis/extensions/working-with-urlscan/urlscan-setup.md b/iis/extensions/working-with-urlscan/urlscan-setup.md deleted file mode 100644 index 19ec9b60c..000000000 --- a/iis/extensions/working-with-urlscan/urlscan-setup.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "UrlScan Setup" -author: naziml -description: "Windows XP, Windows Server 2003, Windows Vista or Windows Server 2008. IIS version 5.1, 6.0 or 7.0 or above (depending on the platform). Installation Steps R..." -ms.date: 06/24/2008 -ms.assetid: a1093a4e-de67-4206-b7c0-34d8c6373966 -msc.legacyurl: /learn/extensions/working-with-urlscan/urlscan-setup -msc.type: authoredcontent ---- -# UrlScan Setup - -by [Nazim Lala](https://github.com/naziml) - -## Prerequisites - -- Windows XP, Windows Server 2003, Windows Vista or Windows Server 2008. -- IIS version 5.1, 6.0 or 7.0 or above (depending on the platform). - -## Installation Steps - -- Run UrlScan v3.1 MSI installer for either x86 or x64 version depending on your platform. -- On successful installation you should have a "UrlScan" folder with UrlScan.dll under `%windir%\system32\inetsrv` and additionally under `%windir%\syswow64\inetsrv` as well for x64 installations. -- Folder above will also contain the configuration file, UrlScan.ini. In the x64 case, only the system32 directory will have the UrlScan.ini file since the filter will turn off redirection when attempting to access UrlScan.ini, so both versions of the filter will access the same configuration under system32 directory -- Upgrading from UrlScan v2.5 or UrlScan v3.0 will leave your old UrlScan.ini file intact. -- The default installation will install UrlScan as a global filter only. Please refer to the Setting Up UrlScan v3.1 section for details. -- UrlScan is required to be the highest priority filter for it to function properly. The MSI installer will do so for the global filter case, but if you are installing UrlScan as a site filter you will need to set UrlScan as the highest order filter. - -## Setting up UrlScan v3.1 - -UrlScan v3.1 can be set up as either a global filter or site level filter. A global filter is invoked for every HTTP request to the IIS server on which it is set up. A site level filter is invoked only for requests to a particular site on the IIS server. UrlScan v3.1 supports using the filter as both a global and site filter in conjunction, with the goal of having global rules in the global filter and application specific rules in the site filter. - -In every case, the filter will read the UrlScan.ini configuration file from the same location that it loads UrlScan.dll. If you install UrlScan.dll filter from `c:\foo` and your IIS worker process loads the filter from this location, the configuration that will be applied to that instance of UrlScan is loaded from `c:\foo\UrlScan.ini`. - -### Global Filter - -The default installation of UrlScan v3.1 installs the filter as a global filter. See the Site Filter section on how to setup your filter as a site filter - -If you are upgrading from UrlScan v2.5 or from UrlScan v3.0 your old UrlScan.ini file will be persisted and all your old settings will apply. If you want to check out the new defaults for the UrlScan.ini file, download the new UrlScan.ini file [here](https://www.iis.net/community/files/UrlScan/UrlScan-ini_v3.zipdownloads/files/UrlScan/UrlScan-ini_v31.zip). - -The default logging directory is the "logs" directory underneath the "UrlScan" directory where your global filter is installed. Change this to point to wherever you want your log files to be located. Make sure that IIS worker processes have write permissions to this folder. For IIS 6.0 make sure you give IIS\_WPG write permissions to this folder, and for IIS 7.0 and above make sure you give IIS\_IUSRS write permission to this folder. - -The default UrlScan.ini file has detailed descriptions of what all the configuration options do. Read through it and update the values for them according to your needs. Check out the "Common Scenarios" section for some common configurations. - -### Site Filter - -Upon installation of UrlScan v3.1 as a site filter requests for that particular site will run through both the site and the global filter if the global filter is not un-mapped. There would be two instances of the filter running in this case. - -If you have a site called "Site1" setup on the server under `c:\site1` folder and you want to use UrlScan v3.1 as a site filter for this site, here is how you would set it up. - -1. Copy UrlScan.dll and UrlScan.ini from the default installation location to `c:\site1`. -2. Modify `c:\site1\UrlScan.ini` with all the options that you want for your site filter. The default UrlScan.ini file that you can [download here](https://www.iis.net/community/files/UrlScan/UrlScan-ini_v3.zipdownloads/files/UrlScan/UrlScan-ini_v31.zip) has the options listed with comments on what they do. -3. Register `c:\site1\UrlScan.dll` as a site filter. Run "inetmgr" and drill down to "Site1" in your left hand pane. For IIS 5.1 and 6.0, right-click on "Site1" and select "Properties" then go to the "ISAPI Filters" tab and add a new filter and point the executable to `c:\site1\UrlScan.dll`. For IIS 7.0 and above, you should see an ISAPI Filters icon under the IIS category and double-clicking this will bring up an "Add…" action which you can then point the executable to `c:\site1\UrlScan.dll` -4. Using the up arrow key, move the UrlScan filter to the top to make it the highest priority filter. This step is essential for the filter to function correctly. diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-api-reference.md b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-api-reference.md index f34c705cc..2322dd05a 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-api-reference.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-api-reference.md @@ -1,19 +1,23 @@ --- title: "FTP Native-Code Extensibility API Reference" -description: Learn about the native-code APIs that developers use to extend the functionality of the FTP 7.5 service for IIS 7.5. +description: Learn about the native-code APIs that developers use to extend the functionality of the FTP service for IIS 7.5 and later. ms.date: "09/20/2017" ms.assetid: 50b67888-09fc-4aab-bf51-86b2365461ba ms.author: "robmcm" --- + # FTP Native-Code Extensibility API Reference -This section describes the native-code APIs that developers use to extend the functionality of the FTP 7.5 service for IIS 7.5. - -## In This Section - [FTP Native-Code Extensibility Interfaces](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md) - Describes the native-code interfaces for the FTP service. - - [FTP Native-Code Extensibility Structures](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md) - Describes the native-code structures for the FTP service. - -## See Also - [FTP Managed-Code Extensibility API Reference](https://msdn.microsoft.com/library/e7b57c2a-e14c-4f14-9707-df95ab8b3660) + +This section describes the native-code APIs that developers use to extend the functionality of the FTP service for IIS 7.5 and later. + +## In This Section + +[FTP Native-Code Extensibility Interfaces](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md) +Describes the native-code interfaces for the FTP service. + +[FTP Native-Code Extensibility Structures](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md) +Describes the native-code structures for the FTP service. + +## See Also + +[FTP Managed-Code Extensibility API Reference](https://msdn.microsoft.com/library/e7b57c2a-e14c-4f14-9707-df95ab8b3660) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md index f6defcc61..1aab6e152 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md @@ -5,19 +5,23 @@ ms.date: "09/06/2017" ms.assetid: afa33f3c-e758-4cb2-873c-4b902276707c ms.author: "robmcm" --- + # FTP Native-Code Extensibility Interfaces -Describes the native-code interfaces that developers use to extend the functionality of the FTP 7.5 service for IIS 7.5. - -## In This Section - The following table lists the native-code interfaces that are exposed by the FTP service. - -|Interface|Definition| -|---|---| -|[IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md)|Provides an interface for authenticating an FTP user.| -|[IFtpHomeDirectoryProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md)|Provides an interface for retrieving the path to a user's FTP home directory.| -|[IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md)|Provides an interface for logging FTP activity.| -|[IFtpProviderConstruct Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md)|Provides an interface for passing configuration settings to a provider.| -|[IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md)|Provides an interface for FTP authorization and role checks.| - -## See Also - [FTP Native-Code Extensibility Structures](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md) + +Describes the native-code interfaces that developers use to extend the functionality of the FTP 7.5 service for IIS 7.5. + +## In This Section + +The following table lists the native-code interfaces that are exposed by the FTP service. + +|Interface|Definition| +|---|---| +|[IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md)|Provides an interface for authenticating an FTP user.| +|[IFtpHomeDirectoryProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md)|Provides an interface for retrieving the path to a user's FTP home directory.| +|[IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md)|Provides an interface for logging FTP activity.| +|[IFtpProviderConstruct Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md)|Provides an interface for passing configuration settings to a provider.| +|[IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md)|Provides an interface for FTP authorization and role checks.| + +## See Also + +[FTP Native-Code Extensibility Structures](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md index ccdb6577e..21d599e24 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-structures.md @@ -5,15 +5,19 @@ ms.date: "09/06/2017" ms.assetid: bc442670-15a7-4cc2-a601-0e217173f828 ms.author: "robmcm" --- + # FTP Native-Code Extensibility Structures -Describes the native-code structures for FTP 7.5 in IIS 7.5. - -## In This Section - The following table lists the native-code structures that are exposed by the FTP service. - + +Describes the native-code structures for FTP 7.5 in IIS 7.5. + +## In This Section + +The following table lists the native-code structures that are exposed by the FTP service. + |Structure|Definition| -|---|---| -|[LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md)|Contains logging information for use with the `IFtpLogProvider` interface.| - -## See Also - [FTP Native-Code Extensibility Interfaces](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md) +|---|---| +|[LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md)|Contains logging information for use with the `IFtpLogProvider` interface.| + +## See Also + +[FTP Native-Code Extensibility Interfaces](../../ftp-extensibility-reference/native-code-api-reference/ftp-native-code-extensibility-interfaces.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md index de12d1cdc..85fee7d1e 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md @@ -5,87 +5,93 @@ ms.date: 09/06/2017 ms.assetid: ab84c942-f9e5-4dc9-9c51-cb25906deb15 ms.author: robmcm --- + # IFtpAuthenticationProvider::AuthenticateUser Method -Checks to see whether a user name and password are valid. - -## Syntax - -```cpp# -AuthenticateUser( - LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszPassword, - LPWSTR * ppszCanonicalUserName, - long * pfAuthenticated -) -``` - -### Parameters - + +Checks to see whether a user name and password are valid. + +## Syntax + +```cpp +AuthenticateUser( + LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszPassword, + LPWSTR * ppszCanonicalUserName, + long * pfAuthenticated +) +``` + +### Parameters + |Term|Definition| |---|---| -|`pszSessionId`|A pointer to a string that contains the session ID.| -|`pszSiteName`|A pointer to a string that contains the site name.| -|`pszUserName`|A pointer to a string that contains the user name.| -|`pszPassword`|A pointer to a string that contains the password.| -|`ppszCanonicalUserName`|A pointer to a string that will contain the canonical name of the user.| -|`pfAuthenticated`|A pointer to a long integer that will contain `true` if the user is authenticated; otherwise, `false`.| - -## Return Value - An `HRESULT`. Possible values include, but are not limited to, those in the following table. - +|`pszSessionId`|A pointer to a string that contains the session ID.| +|`pszSiteName`|A pointer to a string that contains the site name.| +|`pszUserName`|A pointer to a string that contains the user name.| +|`pszPassword`|A pointer to a string that contains the password.| +|`ppszCanonicalUserName`|A pointer to a string that will contain the canonical name of the user.| +|`pfAuthenticated`|A pointer to a long integer that will contain `true` if the user is authenticated; otherwise, `false`.| + +## Return Value + +An `HRESULT`. Possible values include, but are not limited to, those in the following table. + |Value|Description| |---|---| -|S_OK|Indicates that the operation was successful.| - -## Remarks - The `ppszCanonicalUserName` parameter can be used to canonicalize user names; the suggested canonical form is domain\user because previous versions of IIS FTP servers required the user name to be in the domain\user form. - - A Windows authentication-based provider cannot be implemented with this method because that form of authentication does not allow user tokens to be returned. - -## Example - The following code example illustrates how to use the `IFtpAuthenticationProvider` interface to create a custom authentication module for the FTP service that implements user name checks. - -``` -public: - STDMETHOD(AuthenticateUser)(LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszPassword, - LPWSTR * ppszCanonicalUserName, - long * pfAuthenticated) - { - // Note: You would add your own custom logic here. - *ppszCanonicalUserName = pszUserName; - - CString strUserName = L"MyUser"; - CString strPassword = L"MyPassword"; - - // Verify that the user name and password are valid. - // In this example, the user name is case-insensitive - // and the password is case-sensitive. - if ((strUserName.CompareNoCase(pszUserName)==0) && - (strPassword.Compare(pszPassword)==0)) - { - *pfAuthenticated = TRUE; - } - else - { - *pfAuthenticated = FALSE; - } - return S_OK; - } -``` - -## Requirements - -|Type|Description| +|S_OK|Indicates that the operation was successful.| + +## Remarks + +The `ppszCanonicalUserName` parameter can be used to canonicalize user names; the suggested canonical form is domain\user because previous versions of IIS FTP servers required the user name to be in the domain\user form. + +A Windows authentication-based provider cannot be implemented with this method because that form of authentication does not allow user tokens to be returned. + +## Example + +The following code example illustrates how to use the `IFtpAuthenticationProvider` interface to create a custom authentication module for the FTP service that implements user name checks. + +```cpp +public: + STDMETHOD(AuthenticateUser)(LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszPassword, + LPWSTR * ppszCanonicalUserName, + long * pfAuthenticated) + { + // Note: You would add your own custom logic here. + *ppszCanonicalUserName = pszUserName; + + CString strUserName = L"MyUser"; + CString strPassword = L"MyPassword"; + + // Verify that the user name and password are valid. + // In this example, the user name is case-insensitive + // and the password is case-sensitive. + if ((strUserName.CompareNoCase(pszUserName)==0) && + (strPassword.Compare(pszPassword)==0)) + { + *pfAuthenticated = TRUE; + } + else + { + *pfAuthenticated = FALSE; + } + return S_OK; + } +``` + +## Requirements + +|Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md index 79312fecc..881678967 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md @@ -5,64 +5,69 @@ ms.date: "09/06/2017" ms.assetid: 843eaeff-6349-465d-958f-12d940763122 ms.author: "robmcm" --- + # IFtpAuthenticationProvider Interface (Native) -Provides an interface for authentication checks. - -## Syntax - -```cpp# -interface IFtpAuthenticationProvider : IUknown -``` - -## Methods - The following table lists the methods exposed by the `IFtpAuthenticationProvider` interface. - + +Provides an interface for authentication checks. + +## Syntax + +```cpp +interface IFtpAuthenticationProvider : IUknown +``` + +## Methods + +The following table lists the methods exposed by the `IFtpAuthenticationProvider` interface. + |Name|Definition| |---|---| -|[IFtpAuthenticationProvider::AuthenticateUser Method](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md)|Checks to see whether a user name and password are valid.| - -## Example - The following code example illustrates how to use the `IFtpAuthenticationProvider` interface to create a custom authentication module that implements user name checks for the FTP service. - -``` -public: - STDMETHOD(AuthenticateUser)(LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszPassword, - LPWSTR * ppszCanonicalUserName, - long * pfAuthenticated) - { - // Note: You would add your own custom logic here. - *ppszCanonicalUserName = pszUserName; - - CString strUserName = L"MyUser"; - CString strPassword = L"MyPassword"; - - // Verify that the user name and password are valid. - // In this example, the user name is case-insensitive - // and the password is case-sensitive. - if ((strUserName.CompareNoCase(pszUserName)==0) && - (strPassword.Compare(pszPassword)==0)) - { - *pfAuthenticated = TRUE; - } - else - { - *pfAuthenticated = FALSE; - } - return S_OK; - } -``` - -## Requirements - +|[IFtpAuthenticationProvider::AuthenticateUser Method](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-authenticateuser-method.md)|Checks to see whether a user name and password are valid.| + +## Example + +The following code example illustrates how to use the `IFtpAuthenticationProvider` interface to create a custom authentication module that implements user name checks for the FTP service. + +```cpp +public: + STDMETHOD(AuthenticateUser)(LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszPassword, + LPWSTR * ppszCanonicalUserName, + long * pfAuthenticated) + { + // Note: You would add your own custom logic here. + *ppszCanonicalUserName = pszUserName; + + CString strUserName = L"MyUser"; + CString strPassword = L"MyPassword"; + + // Verify that the user name and password are valid. + // In this example, the user name is case-insensitive + // and the password is case-sensitive. + if ((strUserName.CompareNoCase(pszUserName)==0) && + (strPassword.Compare(pszPassword)==0)) + { + *pfAuthenticated = TRUE; + } + else + { + *pfAuthenticated = FALSE; + } + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md index a6422fe5c..03c32e943 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md @@ -5,92 +5,97 @@ ms.date: "09/06/2017" ms.assetid: 36671ffa-4c66-40dc-a1c5-6ecd5309e191 ms.author: "robmcm" --- + # IFtpHomeDirectoryProvider::GetUserHomeDirectoryData Method -Returns the physical path of the home directory for a user. - -## Syntax - -```cpp# -HRESULT GetUserHomeDirectoryData( - LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR * ppszHomeDirectoryData -) -``` - -### Parameters - + +Returns the physical path of the home directory for a user. + +## Syntax + +```cpp +HRESULT GetUserHomeDirectoryData( + LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR * ppszHomeDirectoryData +) +``` + +### Parameters + |Term|Definition| |---|---| -|`pszSessionId`|[IN] A pointer to a string that contains the session ID.| -|`pszSiteName`|[IN] A pointer to a string that contains the site name.| -|`pszUserName`|[IN] A pointer to a string that contains the user name.| -|`ppszHomeDirectoryData`|[OUT] A pointer to a string that will contain the physical path for the user.| - -## Return Value - An `HRESULT`. Possible values include, but are not limited to, those in the following table. - +|`pszSessionId`|[IN] A pointer to a string that contains the session ID.| +|`pszSiteName`|[IN] A pointer to a string that contains the site name.| +|`pszUserName`|[IN] A pointer to a string that contains the user name.| +|`ppszHomeDirectoryData`|[OUT] A pointer to a string that will contain the physical path for the user.| + +## Return Value + +An `HRESULT`. Possible values include, but are not limited to, those in the following table. + |Value|Description| |---|---| -|S_OK|Indicates that the operation was successful.| - -## Example - The following code example illustrates how to use the `IFtpHomeDirectoryProvider` interface to create a custom home directory module for the FTP service that returns a specific home directory. - -``` -public: - STDMETHOD(GetUserHomeDirectoryData)( - LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR * ppszHomeDirectoryData) - { - // Note: You would add your own custom logic here. - HRESULT hr = S_OK; - WCHAR wszPath[MAX_PATH] = L""; - - // Calculate the user's home directory based on their user name. - hr = StringCchPrintf(wszPath,_countof(wszPath), - L"\\\\?\\C:\\ftpusers\\%s",pszUserName); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Allocate a block of memory for the user's home directory. - LPWSTR wszHomeDirectoryData = - (LPWSTR)CoTaskMemAlloc(_countof(wszPath) * sizeof(WCHAR)); - // Return an error if a failure occurs. - if (wszHomeDirectoryData == NULL) - { - return E_OUTOFMEMORY; - } - - // Copy the user's home directory into the memory block. - hr = StringCchCopy(wszHomeDirectoryData, - _countof(wszPath), wszPath); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Return the user's home directory. - (*ppszHomeDirectoryData) = wszHomeDirectoryData; - return S_OK; - } -``` - -## Requirements - +|S_OK|Indicates that the operation was successful.| + +## Example + +The following code example illustrates how to use the `IFtpHomeDirectoryProvider` interface to create a custom home directory module for the FTP service that returns a specific home directory. + +```cpp +public: + STDMETHOD(GetUserHomeDirectoryData)( + LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR * ppszHomeDirectoryData) + { + // Note: You would add your own custom logic here. + HRESULT hr = S_OK; + WCHAR wszPath[MAX_PATH] = L""; + + // Calculate the user's home directory based on their user name. + hr = StringCchPrintf(wszPath,_countof(wszPath), + L"\\\\?\\C:\\ftpusers\\%s",pszUserName); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Allocate a block of memory for the user's home directory. + LPWSTR wszHomeDirectoryData = + (LPWSTR)CoTaskMemAlloc(_countof(wszPath) * sizeof(WCHAR)); + // Return an error if a failure occurs. + if (wszHomeDirectoryData == NULL) + { + return E_OUTOFMEMORY; + } + + // Copy the user's home directory into the memory block. + hr = StringCchCopy(wszHomeDirectoryData, + _countof(wszPath), wszPath); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Return the user's home directory. + (*ppszHomeDirectoryData) = wszHomeDirectoryData; + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpHomeDirectoryProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpHomeDirectoryProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md index ee290bf50..789301bd3 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-interface-native.md @@ -5,75 +5,79 @@ ms.date: 09/06/2017 ms.assetid: b7bc3cf4-96eb-4cb2-ad39-1323d581da3f ms.author: "robmcm" --- + # IFtpHomeDirectoryProvider Interface (Native) -Provides an interface to implement returning the physical path for a user's home directory. - -## Syntax - -```cpp# -interface IFtpHomeDirectoryProvider : IUknown -``` - -## Methods - The following table lists the methods exposed by the `IFtpHomeDirectoryProvider` interface. - + +Provides an interface to implement returning the physical path for a user's home directory. + +## Syntax + +```cpp +interface IFtpHomeDirectoryProvider : IUknown +``` + +## Methods + +The following table lists the methods exposed by the `IFtpHomeDirectoryProvider` interface. + |Name|Definition| |---|---| -|[IFtpHomeDirectoryProvider::GetUserHomeDirectoryData Method](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md)|Returns the physical path of the home directory for a user.| - -## Example - The following code example illustrates using the `IFtpHomeDirectoryProvider` interface to create a custom home directory module for the FTP service that returns a specific home directory. - -``` -public: - STDMETHOD(GetUserHomeDirectoryData)( - LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR * ppszHomeDirectoryData) - { - // Note: You would add your own custom logic here. - HRESULT hr = S_OK; - WCHAR wszPath[MAX_PATH] = L""; - - // Calculate the user's home directory based on their user name. - hr = StringCchPrintf(wszPath,_countof(wszPath), - L"\\\\?\\C:\\ftpusers\\%s",pszUserName); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Allocate a block of memory for the user's home directory. - LPWSTR wszHomeDirectoryData = - (LPWSTR)CoTaskMemAlloc(_countof(wszPath) * sizeof(WCHAR)); - // Return an error if a failure occurs. - if (wszHomeDirectoryData == NULL) - { - return E_OUTOFMEMORY; - } - - // Copy the user's home directory into the memory block. - hr = StringCchCopy(wszHomeDirectoryData, - _countof(wszPath), wszPath); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Return the user's home directory. - (*ppszHomeDirectoryData) = wszHomeDirectoryData; - return S_OK; - } -``` - -## Requirements - +|[IFtpHomeDirectoryProvider::GetUserHomeDirectoryData Method](../../ftp-extensibility-reference/native-code-api-reference/iftphomedirectoryprovider-getuserhomedirectorydata-method.md)|Returns the physical path of the home directory for a user.| + +## Example + +The following code example illustrates using the `IFtpHomeDirectoryProvider` interface to create a custom home directory module for the FTP service that returns a specific home directory. + +```cpp +public: + STDMETHOD(GetUserHomeDirectoryData)( + LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR * ppszHomeDirectoryData) + { + // Note: You would add your own custom logic here. + HRESULT hr = S_OK; + WCHAR wszPath[MAX_PATH] = L""; + + // Calculate the user's home directory based on their user name. + hr = StringCchPrintf(wszPath,_countof(wszPath), + L"\\\\?\\C:\\ftpusers\\%s",pszUserName); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Allocate a block of memory for the user's home directory. + LPWSTR wszHomeDirectoryData = + (LPWSTR)CoTaskMemAlloc(_countof(wszPath) * sizeof(WCHAR)); + // Return an error if a failure occurs. + if (wszHomeDirectoryData == NULL) + { + return E_OUTOFMEMORY; + } + + // Copy the user's home directory into the memory block. + hr = StringCchCopy(wszHomeDirectoryData, + _countof(wszPath), wszPath); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Return the user's home directory. + (*ppszHomeDirectoryData) = wszHomeDirectoryData; + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| |Reference|ftpext.tlb| diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md index b53cd9ca6..f2cd548db 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md @@ -5,106 +5,111 @@ ms.date: 09/06/2017 ms.assetid: 164e8ebe-cae0-4e23-af04-34ef3f43954b ms.author: robmcm --- + # IFtpLogProvider Interface (Native) -Provides an interface for logging FTP activity. - -## Syntax - -```cpp# -interface IFtpLogProvider : IUknown -``` - -## Methods - The following table lists the methods exposed by the `IFtpLogProvider` interface. - + +Provides an interface for logging FTP activity. + +## Syntax + +```cpp +interface IFtpLogProvider : IUknown +``` + +## Methods + +The following table lists the methods exposed by the `IFtpLogProvider` interface. + |Name|Definition| -|-|-| -|[IFtpLogProvider::Log Method](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md)|Performs logging activity for the `IFtpLogProvider` interface.| - -## Example - The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. - -``` -public: - STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) - { - // Note: You would add your own custom logic here. - HRESULT hr = S_OK; - DWORD dwResult; - HANDLE hFile; - char szLogEntry[256]=""; - const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; - - OVERLAPPED Overlapped = { 0 }; - Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; - Overlapped.OffsetHigh = -1; - - // Retrieve the current date and time for the log entry. - SYSTEMTIME CurrentTime; - GetSystemTime(&CurrentTime); - - // Open the log file for output. - hFile = CreateFile( - L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", - GENERIC_WRITE, - FILE_SHARE_READ, - NULL, - OPEN_ALWAYS, - FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, - NULL); - - // Return an error if a failure occurs. - if (hFile == INVALID_HANDLE_VALUE) - { - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Format the log entry. - hr = StringCchPrintfA( - szLogEntry,256, - "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", - CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, - CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, - pLoggingParameters->pszCommand, - pLoggingParameters->FtpStatus); - - // Test for error. - if (FAILED(hr)) - { - // Return the error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Write the log entry to the log file. - if(!WriteFile(hFile, szLogEntry, - strlen(szLogEntry), &dwResult, &Overlapped)) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - -EXIT: - // Close the log file if it is open. - if(CloseHandle(hFile)==0) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - } - return hr; - } -``` - -## Requirements - +|---|---| +|[IFtpLogProvider::Log Method](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md)|Performs logging activity for the `IFtpLogProvider` interface.| + +## Example + +The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. + +```cpp +public: + STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) + { + // Note: You would add your own custom logic here. + HRESULT hr = S_OK; + DWORD dwResult; + HANDLE hFile; + char szLogEntry[256]=""; + const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; + + OVERLAPPED Overlapped = { 0 }; + Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; + Overlapped.OffsetHigh = -1; + + // Retrieve the current date and time for the log entry. + SYSTEMTIME CurrentTime; + GetSystemTime(&CurrentTime); + + // Open the log file for output. + hFile = CreateFile( + L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", + GENERIC_WRITE, + FILE_SHARE_READ, + NULL, + OPEN_ALWAYS, + FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, + NULL); + + // Return an error if a failure occurs. + if (hFile == INVALID_HANDLE_VALUE) + { + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Format the log entry. + hr = StringCchPrintfA( + szLogEntry,256, + "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", + CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, + CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, + pLoggingParameters->pszCommand, + pLoggingParameters->FtpStatus); + + // Test for error. + if (FAILED(hr)) + { + // Return the error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Write the log entry to the log file. + if(!WriteFile(hFile, szLogEntry, + strlen(szLogEntry), &dwResult, &Overlapped)) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + +EXIT: + // Close the log file if it is open. + if(CloseHandle(hFile)==0) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + } + return hr; + } +``` + +## Requirements + |Type|Description| -|-|-| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md) +|---|---| +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md index d7f8f3eb8..2eb2d70a3 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftplogprovider-log-method.md @@ -5,114 +5,119 @@ ms.date: "09/06/2017" ms.assetid: 0978c707-4bba-46be-8457-abdcfb930f5b ms.author: "robmcm" --- + # IFtpLogProvider::Log Method -Performs custom logging of FTP activity for the IFtpLogProvider interface. - -## Syntax - -```cpp# -HRESULT Log( - LOGGING_PARAMETERS * pLoggingParameters -) -``` - -### Parameters - + +Performs custom logging of FTP activity for the IFtpLogProvider interface. + +## Syntax + +```cpp +HRESULT Log( + LOGGING_PARAMETERS * pLoggingParameters +) +``` + +### Parameters + Term|Definition| |---|---| -|`pLoggingParameters`|[IN] A pointer to an [LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md) that contains FTP log information.| - -## Return Value - An `HRESULT`. Possible values include, but are not limited to, those in the following table. - -|Value|Description| +|`pLoggingParameters`|[IN] A pointer to an [LOGGING_PARAMETERS Structure](../../ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md) that contains FTP log information.| + +## Return Value + +An `HRESULT`. Possible values include, but are not limited to, those in the following table. + +|Value|Description| |---|---| -|S_OK|Indicates that the operation was successful.| - -## Example - The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. - -``` -public: - STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) - { - // Note: You would add your own custom logic here. - HRESULT hr = S_OK; - DWORD dwResult; - HANDLE hFile; - char szLogEntry[256]=""; - const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; - - OVERLAPPED Overlapped = { 0 }; - Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; - Overlapped.OffsetHigh = -1; - - // Retrieve the current date and time for the log entry. - SYSTEMTIME CurrentTime; - GetSystemTime(&CurrentTime); - - // Open the log file for output. - hFile = CreateFile( - L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", - GENERIC_WRITE, - FILE_SHARE_READ, - NULL, - OPEN_ALWAYS, - FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, - NULL); - - // Return an error if a failure occurs. - if (hFile == INVALID_HANDLE_VALUE) - { - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Format the log entry. - hr = StringCchPrintfA( - szLogEntry,256, - "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", - CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, - CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, - pLoggingParameters->pszCommand, - pLoggingParameters->FtpStatus); - - // Test for error. - if (FAILED(hr)) - { - // Return the error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Write the log entry to the log file. - if(!WriteFile(hFile, szLogEntry, - strlen(szLogEntry), &dwResult, &Overlapped)) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - -EXIT: - // Close the log file if it is open. - if(CloseHandle(hFile)==0) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - } - return hr; - } -``` - -## Requirements - +|S_OK|Indicates that the operation was successful.| + +## Example + +The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. + +```cpp +public: + STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) + { + // Note: You would add your own custom logic here. + HRESULT hr = S_OK; + DWORD dwResult; + HANDLE hFile; + char szLogEntry[256]=""; + const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; + + OVERLAPPED Overlapped = { 0 }; + Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; + Overlapped.OffsetHigh = -1; + + // Retrieve the current date and time for the log entry. + SYSTEMTIME CurrentTime; + GetSystemTime(&CurrentTime); + + // Open the log file for output. + hFile = CreateFile( + L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", + GENERIC_WRITE, + FILE_SHARE_READ, + NULL, + OPEN_ALWAYS, + FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, + NULL); + + // Return an error if a failure occurs. + if (hFile == INVALID_HANDLE_VALUE) + { + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Format the log entry. + hr = StringCchPrintfA( + szLogEntry,256, + "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", + CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, + CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, + pLoggingParameters->pszCommand, + pLoggingParameters->FtpStatus); + + // Test for error. + if (FAILED(hr)) + { + // Return the error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Write the log entry to the log file. + if(!WriteFile(hFile, szLogEntry, + strlen(szLogEntry), &dwResult, &Overlapped)) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + +EXIT: + // Close the log file if it is open. + if(CloseHandle(hFile)==0) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + } + return hr; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md index cabbfd155..ea358c3b8 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md @@ -5,104 +5,110 @@ ms.date: "09/06/2017" ms.assetid: 897bde2f-6b40-46eb-b290-d0f92e454f09 ms.author: "robmcm" --- + # IFtpProviderConstruct::Construct Method -Retrieves an array of key/value pairs from an FTP provider's configuration settings in the IIS ApplicationHost.config file. - -## Syntax - -```cpp# -HRESULT Construct( - SAFEARRAY * configurationEntries -) -``` - -### Parameters - + +Retrieves an array of key/value pairs from an FTP provider's configuration settings in the IIS ApplicationHost.config file. + +## Syntax + +```cpp +HRESULT Construct( + SAFEARRAY * configurationEntries +) +``` + +### Parameters + |Term|Definition| |---|---| -|`configurationEntries`|[IN] A pointer to a SAFEARRAY that contains key/value pairs from the IIS configuration settings.| - -## Return Value - An `HRESULT`. Possible values include, but are not limited to, those in the following table. - +|`configurationEntries`|[IN] A pointer to a SAFEARRAY that contains key/value pairs from the IIS configuration settings.| + +## Return Value + +An `HRESULT`. Possible values include, but are not limited to, those in the following table. + |Value|Description| |---|---| -|S_OK|Indicates that the operation was successful.| - -## Remarks - You can specify parameters for an FTP provider in the IIS ApplicationHost.config file by adding an <`activation`> collection, which may contain a series of <`providerData`> elements that list additional settings for custom FTP providers. Each <`providerData`> element is paired with an entry in the <`providerDefinitions`> collection, and contains a series of key/value pairs that contain information that is specific to each provider. - - The following configuration excerpt illustrates a custom FTP provider entry in the ApplicationHost.config file and its related information. - -``` - - - - - - - - - - - -``` - -## Example - The following code example iterates through the array of configuration settings and sends the key/value pairs to the debug stream. - -``` -public: - STDMETHOD(Construct)(SAFEARRAY * configurationEntries) - { - CONFIGURATION_ENTRY * pArray; - HRESULT hr = S_OK; - LONG lLbound = 0; - LONG lUbound = 0; - - OutputDebugString(L"IFtpProviderConstruct::Construct\n"); - - // Retrieve the upper and lower bounds for the configuration array. - SafeArrayGetLBound( configurationEntries, 1, &lLbound ); - SafeArrayGetUBound( configurationEntries, 1, &lUbound ); - - // Retrieve a pointer to the array of configuration settings. - hr = SafeArrayAccessData(configurationEntries, (void**)&pArray); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Loop through the array of configuration setttings and - // output the key/value pairs to the debug channel. - for(LONG Index = lLbound; Index <= lUbound; Index ++) - { - OutputDebugString(pArray[Index].bstrKey); - OutputDebugString(pArray[Index].bstrValue); - } - - // Release the pointer to the array of configuration settings. - hr = SafeArrayUnaccessData(configurationEntries); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - return S_OK; - } -``` - -## Requirements - +|S_OK|Indicates that the operation was successful.| + +## Remarks + +You can specify parameters for an FTP provider in the IIS ApplicationHost.config file by adding an <`activation`> collection, which may contain a series of <`providerData`> elements that list additional settings for custom FTP providers. Each <`providerData`> element is paired with an entry in the <`providerDefinitions`> collection, and contains a series of key/value pairs that contain information that is specific to each provider. + +The following configuration excerpt illustrates a custom FTP provider entry in the ApplicationHost.config file and its related information. + +```xml + + + + + + + + + + + +``` + +## Example + +The following code example iterates through the array of configuration settings and sends the key/value pairs to the debug stream. + +```cpp +public: + STDMETHOD(Construct)(SAFEARRAY * configurationEntries) + { + CONFIGURATION_ENTRY * pArray; + HRESULT hr = S_OK; + LONG lLbound = 0; + LONG lUbound = 0; + + OutputDebugString(L"IFtpProviderConstruct::Construct\n"); + + // Retrieve the upper and lower bounds for the configuration array. + SafeArrayGetLBound( configurationEntries, 1, &lLbound ); + SafeArrayGetUBound( configurationEntries, 1, &lUbound ); + + // Retrieve a pointer to the array of configuration settings. + hr = SafeArrayAccessData(configurationEntries, (void**)&pArray); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Loop through the array of configuration setttings and + // output the key/value pairs to the debug channel. + for(LONG Index = lLbound; Index <= lUbound; Index ++) + { + OutputDebugString(pArray[Index].bstrKey); + OutputDebugString(pArray[Index].bstrValue); + } + + // Release the pointer to the array of configuration settings. + hr = SafeArrayUnaccessData(configurationEntries); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpProviderConstruct Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpProviderConstruct Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md index 50c52bbb9..3097f6a49 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-interface.md @@ -5,93 +5,98 @@ description: IFtpProviderConstruct Interface provides an interface for passing c ms.assetid: f4c8f1c8-f28e-4907-832d-05cccef42c0a ms.author: "robmcm" --- + # IFtpProviderConstruct Interface -Provides an interface for passing configuration settings to a provider. - -## Syntax - -```cpp# -interface IFtpProviderConstruct : IUknown -``` - -## Methods - The following table lists the methods exposed by the `IFtpRoleProvider` interface. - + +Provides an interface for passing configuration settings to a provider. + +## Syntax + +```cpp +interface IFtpProviderConstruct : IUknown +``` + +## Methods + +The following table lists the methods exposed by the `IFtpRoleProvider` interface. + Name|Definition| |---|---| -|[IFtpProviderConstruct::Construct Method](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md)|Retrieves an array of key/value pairs from an FTP provider's configuration settings in the IIS ApplicationHost.config file.| - -## Remarks - You can specify parameters for an FTP provider in the IIS ApplicationHost.config file by adding an <`activation`> collection, which may contain a series of <`providerData`> elements that list additional settings for custom FTP providers. Each <`providerData`> element is paired with an entry in the <`providerDefinitions`> collection, and contains a series of key/value pairs that contain information that is specific to each provider. - - The following configuration excerpt illustrates a custom FTP provider entry in the ApplicationHost.config file and its related information. - -``` - - - - - - - - - - - -``` - -## Example - The following code example iterates through the array of configuration settings and sends the key/value pairs to the debug stream. - -``` -public: - STDMETHOD(Construct)(SAFEARRAY * configurationEntries) - { - CONFIGURATION_ENTRY * pArray; - HRESULT hr = S_OK; - LONG lLbound = 0; - LONG lUbound = 0; - - OutputDebugString(L"IFtpProviderConstruct::Construct\n"); - - // Retrieve the upper and lower bounds for the configuration array. - SafeArrayGetLBound( configurationEntries, 1, &lLbound ); - SafeArrayGetUBound( configurationEntries, 1, &lUbound ); - - // Retrieve a pointer to the array of configuration settings. - hr = SafeArrayAccessData(configurationEntries, (void**)&pArray); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - // Loop through the array of configuration setttings and - // output the key/value pairs to the debug channel. - for(LONG Index = lLbound; Index <= lUbound; Index ++) - { - OutputDebugString(pArray[Index].bstrKey); - OutputDebugString(pArray[Index].bstrValue); - } - - // Release the pointer to the array of configuration settings. - hr = SafeArrayUnaccessData(configurationEntries); - // Return an error if a failure occurs. - if (FAILED(hr)) - { - return hr; - } - - return S_OK; - } -``` - -## Requirements - +|[IFtpProviderConstruct::Construct Method](../../ftp-extensibility-reference/native-code-api-reference/iftpproviderconstruct-construct-method.md)|Retrieves an array of key/value pairs from an FTP provider's configuration settings in the IIS ApplicationHost.config file.| + +## Remarks + +You can specify parameters for an FTP provider in the IIS ApplicationHost.config file by adding an <`activation`> collection, which may contain a series of <`providerData`> elements that list additional settings for custom FTP providers. Each <`providerData`> element is paired with an entry in the <`providerDefinitions`> collection, and contains a series of key/value pairs that contain information that is specific to each provider. + +The following configuration excerpt illustrates a custom FTP provider entry in the ApplicationHost.config file and its related information. + +```xml + + + + + + + + + + + +``` + +## Example + +The following code example iterates through the array of configuration settings and sends the key/value pairs to the debug stream. + +```cpp +public: + STDMETHOD(Construct)(SAFEARRAY * configurationEntries) + { + CONFIGURATION_ENTRY * pArray; + HRESULT hr = S_OK; + LONG lLbound = 0; + LONG lUbound = 0; + + OutputDebugString(L"IFtpProviderConstruct::Construct\n"); + + // Retrieve the upper and lower bounds for the configuration array. + SafeArrayGetLBound( configurationEntries, 1, &lLbound ); + SafeArrayGetUBound( configurationEntries, 1, &lUbound ); + + // Retrieve a pointer to the array of configuration settings. + hr = SafeArrayAccessData(configurationEntries, (void**)&pArray); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + // Loop through the array of configuration setttings and + // output the key/value pairs to the debug channel. + for(LONG Index = lLbound; Index <= lUbound; Index ++) + { + OutputDebugString(pArray[Index].bstrKey); + OutputDebugString(pArray[Index].bstrValue); + } + + // Release the pointer to the array of configuration settings. + hr = SafeArrayUnaccessData(configurationEntries); + // Return an error if a failure occurs. + if (FAILED(hr)) + { + return hr; + } + + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| |Reference|ftpext.tlb| diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md index 4118b1901..d8de56a04 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md @@ -5,62 +5,67 @@ ms.date: "09/06/2017" ms.assetid: 58e05545-9a67-4504-a897-f97b054765ab ms.author: "robmcm" --- + # IFtpRoleProvider Interface (Native) -Provides an interface for authorization and role checks. - -## Syntax - -```cpp# -interface IFtpRoleProvider : IUknown -``` - -## Methods - The following table lists the methods exposed by the `IFtpRoleProvider` interface. - + +Provides an interface for authorization and role checks. + +## Syntax + +```cpp +interface IFtpRoleProvider : IUknown +``` + +## Methods + +The following table lists the methods exposed by the `IFtpRoleProvider` interface. + |Name|Definition| |---|---| -|[IFtpRoleProvider::IsUserInRole Method](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md)|Checks to see whether a user is a member of a specific role.| - -## Example - The following code example illustrates how to use the `IFtpRoleProvider` interface to create a custom authentication module for the FTP service that implements role checks. - -``` -public: - STDMETHOD(IsUserInRole)(LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszRole, - long * pfIsInRole) - { - // Note: You would add your own custom logic here. - CString strUserName = L"MyUser"; - CString strRoleName = L"MyRole"; - - // Verify that the user name and role name are valid. - // In this example, both the user name and - // the role name are case-insensitive. - if ((strUserName.CompareNoCase(pszUserName)==0) && - (strRoleName.CompareNoCase(pszRole)==0)) - { - *pfIsInRole = TRUE; - } - else - { - *pfIsInRole = FALSE; - } - - return S_OK; - } -``` - -## Requirements - +|[IFtpRoleProvider::IsUserInRole Method](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md)|Checks to see whether a user is a member of a specific role.| + +## Example + +The following code example illustrates how to use the `IFtpRoleProvider` interface to create a custom authentication module for the FTP service that implements role checks. + +```cpp +public: + STDMETHOD(IsUserInRole)(LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszRole, + long * pfIsInRole) + { + // Note: You would add your own custom logic here. + CString strUserName = L"MyUser"; + CString strRoleName = L"MyRole"; + + // Verify that the user name and role name are valid. + // In this example, both the user name and + // the role name are case-insensitive. + if ((strUserName.CompareNoCase(pszUserName)==0) && + (strRoleName.CompareNoCase(pszRole)==0)) + { + *pfIsInRole = TRUE; + } + else + { + *pfIsInRole = FALSE; + } + + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpAuthenticationProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftpauthenticationprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md b/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md index 789ed6f95..7f8ea4106 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/iftproleprovider-isuserinrole-method.md @@ -5,78 +5,83 @@ ms.date: "09/06/2017" ms.assetid: edb0aed7-253f-40ae-85f5-09f37fce2504 ms.author: "robmcm" --- + # IFtpRoleProvider::IsUserInRole Method -Checks to see whether a user is a member of a specific role. - -## Syntax - -```cpp# -HRESULT IsUserInRole( - LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszRole, - long * pfIsInRole -) -``` - -### Parameters - + +Checks to see whether a user is a member of a specific role. + +## Syntax + +```cpp +HRESULT IsUserInRole( + LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszRole, + long * pfIsInRole +) +``` + +### Parameters + |Term|Definition| |---|---| -|`pszSessionId`|[IN] A pointer to a string that contains the session ID.| -|`pszSiteName`|[IN] A pointer to a string that contains the site name.| -|`pszUserName`|[IN] A pointer to a string that contains the user name.| -|`pszRole`|[IN] A pointer to a string that contains the role name.| -|`pfIsInRole`|[OUT] A pointer to a long integer that is set to `true` if the user is in the role; otherwise, `false`.| - -## Return Value - An `HRESULT`. Possible values include, but are not limited to, those in the following table. - +|`pszSessionId`|[IN] A pointer to a string that contains the session ID.| +|`pszSiteName`|[IN] A pointer to a string that contains the site name.| +|`pszUserName`|[IN] A pointer to a string that contains the user name.| +|`pszRole`|[IN] A pointer to a string that contains the role name.| +|`pfIsInRole`|[OUT] A pointer to a long integer that is set to `true` if the user is in the role; otherwise, `false`.| + +## Return Value + +An `HRESULT`. Possible values include, but are not limited to, those in the following table. + |Value|Description| |---|---| -|S_OK|Indicates that the operation was successful.| - -## Example - The following code example illustrates how to use the `IFtpRoleProvider` interface to create a custom authentication module for the FTP service that implements role checks. - -``` -public: - STDMETHOD(IsUserInRole)(LPWSTR pszSessionId, - LPWSTR pszSiteName, - LPWSTR pszUserName, - LPWSTR pszRole, - long * pfIsInRole) - { - // Note: You would add your own custom logic here. - CString strUserName = L"MyUser"; - CString strRoleName = L"MyRole"; - - // Verify that the user name and role name are valid. - // In this example, both the user name and - // the role name are case-insensitive. - if ((strUserName.CompareNoCase(pszUserName)==0) && - (strRoleName.CompareNoCase(pszRole)==0)) - { - *pfIsInRole = TRUE; - } - else - { - *pfIsInRole = FALSE; - } - - return S_OK; - } -``` - -## Requirements - +|S_OK|Indicates that the operation was successful.| + +## Example + +The following code example illustrates how to use the `IFtpRoleProvider` interface to create a custom authentication module for the FTP service that implements role checks. + +```cpp +public: + STDMETHOD(IsUserInRole)(LPWSTR pszSessionId, + LPWSTR pszSiteName, + LPWSTR pszUserName, + LPWSTR pszRole, + long * pfIsInRole) + { + // Note: You would add your own custom logic here. + CString strUserName = L"MyUser"; + CString strRoleName = L"MyRole"; + + // Verify that the user name and role name are valid. + // In this example, both the user name and + // the role name are case-insensitive. + if ((strUserName.CompareNoCase(pszUserName)==0) && + (strRoleName.CompareNoCase(pszRole)==0)) + { + *pfIsInRole = TRUE; + } + else + { + *pfIsInRole = FALSE; + } + + return S_OK; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpRoleProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftproleprovider-interface-native.md) diff --git a/iis/ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md b/iis/ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md index fc34c84b8..437e5c45f 100644 --- a/iis/ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md +++ b/iis/ftp-extensibility-reference/native-code-api-reference/logging-parameters-structure.md @@ -5,142 +5,146 @@ ms.date: "09/06/2017" ms.assetid: e8a0342f-2636-492f-9fbf-f72dd1133f03 ms.author: "robmcm" --- + # LOGGING_PARAMETERS Structure -Defines the information for FTP activity, such as user name, session ID, IP addresses for the client and server. Developers can select which logging information to use when they implement the IFtpLogProvider interface. - -## Syntax - -```cpp# -struct LOGGING_PARAMETERS -{ - LPWSTR pszSessionId; - LPWSTR pszSiteName; - LPWSTR pszUserName; - LPWSTR pszHostName; - LPWSTR pszRemoteIpAddress; - unsigned long dwRemoteIpPort; - LPWSTR pszLocalIpAddress; - unsigned long dwLocalIpPort; - unsigned __int64 BytesSent; - unsigned __int64 BytesReceived; - LPWSTR pszCommand; - LPWSTR pszCommandParameters; - LPWSTR pszFullPath; - unsigned long dwElapsedMilliseconds; - unsigned long FtpStatus; - unsigned long FtpSubStatus; - HRESULT hrStatus; - LPWSTR pszInformation; -}; -``` - -## Members - + +Defines the information for FTP activity, such as user name, session ID, IP addresses for the client and server. Developers can select which logging information to use when they implement the IFtpLogProvider interface. + +## Syntax + +```cpp +struct LOGGING_PARAMETERS +{ + LPWSTR pszSessionId; + LPWSTR pszSiteName; + LPWSTR pszUserName; + LPWSTR pszHostName; + LPWSTR pszRemoteIpAddress; + unsigned long dwRemoteIpPort; + LPWSTR pszLocalIpAddress; + unsigned long dwLocalIpPort; + unsigned __int64 BytesSent; + unsigned __int64 BytesReceived; + LPWSTR pszCommand; + LPWSTR pszCommandParameters; + LPWSTR pszFullPath; + unsigned long dwElapsedMilliseconds; + unsigned long FtpStatus; + unsigned long FtpSubStatus; + HRESULT hrStatus; + LPWSTR pszInformation; +}; +``` + +## Members + |Member Name|Definition| |---|---| -|BytesReceived|The number of bytes received from the client.| -|BytesSent|The number of bytes sent to the client.| -|pszCommand|The FTP command.| -|pszCommandParameters|The parameters related to the FTP command.| -|dwElapsedMilliseconds|The number of milliseconds it took for the operation to complete.| -|FtpStatus|The FTP status of the current command.| -|FtpSubStatus|The FTP substatus of the current command.| -|pszFullPath|The full path of the operation for the FTP command.| -|pszHostName|The FTP virtual host name.| -|hrStatus|The Windows error code for the operation.| -|pszInformation|Additional troubleshooting information for the command.| -|pszLocalIpAddress|The local IP address to which the client is connected.| -|dwLocalIpPort|The TCP/IP port of the server.| -|pszRemoteIpAddress|The IP address of the client.| -|dwRemoteIpPort|The TCP/IP port of the client.| -|pszSessionId|The session ID.| -|pszSiteName|The name of the server instance that is being logged.| -|pszUserName|The name of the user.| - -## Example - The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. - -``` -public: - STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) - { - // Note: You would add your own custom logic here. - HRESULT hr = S_OK; - DWORD dwResult; - HANDLE hFile; - char szLogEntry[256]=""; - const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; - - OVERLAPPED Overlapped = { 0 }; - Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; - Overlapped.OffsetHigh = -1; - - // Retrieve the current date and time for the log entry. - SYSTEMTIME CurrentTime; - GetSystemTime(&CurrentTime); - - // Open the log file for output. - hFile = CreateFile( - L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", - GENERIC_WRITE, - FILE_SHARE_READ, - NULL, - OPEN_ALWAYS, - FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, - NULL); - - // Return an error if a failure occurs. - if (hFile == INVALID_HANDLE_VALUE) - { - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Format the log entry. - hr = StringCchPrintfA( - szLogEntry,256, - "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", - CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, - CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, - pLoggingParameters->pszCommand, - pLoggingParameters->FtpStatus); - - // Test for error. - if (FAILED(hr)) - { - // Return the error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - - // Write the log entry to the log file. - if(!WriteFile(hFile, szLogEntry, - strlen(szLogEntry), &dwResult, &Overlapped)) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - goto EXIT; - } - -EXIT: - // Close the log file if it is open. - if(CloseHandle(hFile)==0) - { - // Return an error if a failure occurs. - hr = HRESULT_FROM_WIN32(GetLastError()); - } - return hr; - } -``` - -## Requirements - +|BytesReceived|The number of bytes received from the client.| +|BytesSent|The number of bytes sent to the client.| +|pszCommand|The FTP command.| +|pszCommandParameters|The parameters related to the FTP command.| +|dwElapsedMilliseconds|The number of milliseconds it took for the operation to complete.| +|FtpStatus|The FTP status of the current command.| +|FtpSubStatus|The FTP substatus of the current command.| +|pszFullPath|The full path of the operation for the FTP command.| +|pszHostName|The FTP virtual host name.| +|hrStatus|The Windows error code for the operation.| +|pszInformation|Additional troubleshooting information for the command.| +|pszLocalIpAddress|The local IP address to which the client is connected.| +|dwLocalIpPort|The TCP/IP port of the server.| +|pszRemoteIpAddress|The IP address of the client.| +|dwRemoteIpPort|The TCP/IP port of the client.| +|pszSessionId|The session ID.| +|pszSiteName|The name of the server instance that is being logged.| +|pszUserName|The name of the user.| + +## Example + +The following code example illustrates how to use the `IFtpLogProvider` interface to create a custom logging module for the FTP service. + +```cpp +public: + STDMETHOD(Log)(LOGGING_PARAMETERS * pLoggingParameters) + { + // Note: You would add your own custom logic here. + HRESULT hr = S_OK; + DWORD dwResult; + HANDLE hFile; + char szLogEntry[256]=""; + const DWORD FILE_WRITE_TO_END_OF_FILE = 0xffffffff; + + OVERLAPPED Overlapped = { 0 }; + Overlapped.Offset = FILE_WRITE_TO_END_OF_FILE; + Overlapped.OffsetHigh = -1; + + // Retrieve the current date and time for the log entry. + SYSTEMTIME CurrentTime; + GetSystemTime(&CurrentTime); + + // Open the log file for output. + hFile = CreateFile( + L"\\\\?\\C:\\logfiles\\myftpsite\\myftplog.log", + GENERIC_WRITE, + FILE_SHARE_READ, + NULL, + OPEN_ALWAYS, + FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH, + NULL); + + // Return an error if a failure occurs. + if (hFile == INVALID_HANDLE_VALUE) + { + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Format the log entry. + hr = StringCchPrintfA( + szLogEntry,256, + "%04d-%02d-%02d\t%02d:%02d:%02d\t%S\t%d\r\n", + CurrentTime.wYear,CurrentTime.wMonth,CurrentTime.wDay, + CurrentTime.wHour,CurrentTime.wMinute,CurrentTime.wSecond, + pLoggingParameters->pszCommand, + pLoggingParameters->FtpStatus); + + // Test for error. + if (FAILED(hr)) + { + // Return the error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + + // Write the log entry to the log file. + if(!WriteFile(hFile, szLogEntry, + strlen(szLogEntry), &dwResult, &Overlapped)) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + goto EXIT; + } + +EXIT: + // Close the log file if it is open. + if(CloseHandle(hFile)==0) + { + // Return an error if a failure occurs. + hr = HRESULT_FROM_WIN32(GetLastError()); + } + return hr; + } +``` + +## Requirements + |Type|Description| |---|---| -|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| -|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| -|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| -|Reference|ftpext.tlb| - -## See Also - [IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md) +|Client|- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10| +|Server|- IIS 7.5 on Windows Server 2008 R2
- IIS 8.0 on Windows Server 2012
- IIS 8.5 on Windows Server 2012 R2
- IIS 10.0 on Windows Server 2016| +|Product|- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0| +|Reference|ftpext.tlb| + +## See Also + +[IFtpLogProvider Interface](../../ftp-extensibility-reference/native-code-api-reference/iftplogprovider-interface-native.md) diff --git a/iis/get-started/getting-started-with-iis/getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md b/iis/get-started/getting-started-with-iis/getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md index 116d7988f..0a058e8dd 100644 --- a/iis/get-started/getting-started-with-iis/getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md +++ b/iis/get-started/getting-started-with-iis/getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md @@ -25,7 +25,7 @@ IIS 7.0 and later have a new user interface from previous versions of IIS: the I **Why did it have to change?** Here are a few top reasons: - **IIS and ASP.NET work together**: IIS 6.0 users right-click on a web site, select "All Properties", and get a dialog with a number of tabs for different settings. With IIS 7.0 and above, IIS Manager needed to show configuration for new features like Output Caching, [Failed Request Tracing](../../troubleshoot/using-failed-request-tracing/troubleshooting-failed-requests-using-tracing-in-iis.md), and [Request Filtering](../../manage/configuring-security/use-request-filtering.md), as well as configuration for ASP.NET and relevant portions of the .NET Framework. The new functionality would have required many more of new tabs, an unacceptable option. -- **Delegated Administration**: Moving our configuration from the metabase to the .NET configuration system means that users can, if permitted, set IIS configuration in web.config files. For example, configuration for an application [http://www.contoso.com/sales](http://www.contoso.com/sales) can be written to the root config file applicationHost.config, to the site [http://www.contoso.com/](http://www.contoso.com/) web.config file, or directly to the application's web.config file. The new IIS Manager has to: 1) allow an administrator to control the configuration permitted in web.config files, 2) show the administrator/user where configuration is being written. The older IIS Manager was not up to these challenges. +- **Delegated Administration**: Moving our configuration from the metabase to the .NET configuration system means that users can, if permitted, set IIS configuration in web.config files. For example, configuration for an application ```http://www.contoso.com/sales``` can be written to the root config file applicationHost.config, to the site ```http://www.contoso.com/``` web.config file, or directly to the application's web.config file. The new IIS Manager has to: 1) allow an administrator to control the configuration permitted in web.config files, 2) show the administrator/user where configuration is being written. The older IIS Manager was not up to these challenges. - **Engineering Reasons**: Software has a shelf life. Time brings new technologies, new requirements, new conventions, and there comes a point where updating existing software becomes more labour intensive and costly that rebuilding the software. IIS Manager was approaching the end of its shelf life. **Anything else to know?** Once we decided to rewrite IIS Manager, we took the opportunity to improve in a number of key ways: diff --git a/iis/get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md b/iis/get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md index 534151c3f..cb2a9d44a 100644 --- a/iis/get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md +++ b/iis/get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md @@ -33,7 +33,6 @@ Each scenario is self-contained. You can read them in any order and concentrate | [Build a Static Website on IIS](../../manage/creating-websites/scenario-build-a-static-website-on-iis.md) | Shows how to install IIS with the minimum module configuration to server static websites. Describes how to add a website, configure anonymous authentication, set up a default document, set up static content compression, use IIS logging, and filter requests. | | [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) | Shows how to install IIS with the modules required to server classic ASP websites. Explains how to add a websites and edit ASP application settings. | | [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) | Guides you through planning, installing, and configuring an ASP.NET website on IIS. Describes what IIS modules to install. Shows how to configure ASP.NET settings, such as session state, pages and controls, application settings, .NET compilation and globalization settings. Explains how to configure data source settings. And shows how to improve security with application isolation, .NET trust levels, .NET authentication, machine key settings, and SSL communication. | -| [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) | Guides you through planning, installing, and configuring a PHP website on IIS. Describes what IIS modules to install. Describes how to configure essential PHP settings. Explains how to configure WinCache and other PHP extensions. Describes how to improve security of a PHP application on IIS. | | [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) | Shows how to install FTP on an existing IIS web server. Describes how to add an FTP site, configure FTP site defaults, fire wall support, user isolation, and directory browsing options. Shows how to configure logon attempt restrictions, request filtering, FTP logging, and FTP messages. | | [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) | Guides you through planning, installing, and configuring a simple server farm with IIS servers. Helps you plan and configure the farm infrastructure. Shows how set up load balancing by using Application Request Routing (ARR). Describes how to set up shared content and shared configuration. Shows how to set up a central certificate store for SSL certificates. Explains how to set up FTP and Web Deploy on the server farm. | diff --git a/iis/get-started/introduction-to-iis/iis-modules-overview.md b/iis/get-started/introduction-to-iis/iis-modules-overview.md index de7ef7871..1cce9ee9d 100644 --- a/iis/get-started/introduction-to-iis/iis-modules-overview.md +++ b/iis/get-started/introduction-to-iis/iis-modules-overview.md @@ -35,10 +35,6 @@ To follow the steps in this document it is best to do a full install of IIS. > [!NOTE] > Not all editions of Windows support all available IIS features. To see which features of IIS are supported on your operating system, you will need to consult the documentation which shipped with your version of Windows. -### To install IIS Using the Web Platform Installer - -You can use the Web Platform Installer (Web PI) to easily install IIS, and applications that run on IIS. The Web PI is a free, lightweight tool that lets you install IIS and related technologies such as ASP.NET, SQL Server Express, Visual Web Developer, other popular Web applications, and more. Because the Web PI installs the latest versions of available Web Platform offerings, with just a few simple clicks you can download and install any new tools or updates. To learn more about the Web PI, see [Learn more and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). - ### To Perform a Full Installation of IIS on Windows Vista, Windows 7, Windows 8, Windows 10 or Windows 11 1. Click **Start** and then click **Control Panel**. diff --git a/iis/get-started/localized-content/iis-localized-japanese-learn-articles-and-more.md b/iis/get-started/localized-content/iis-localized-japanese-learn-articles-and-more.md index 119fa5ca3..810dac8cb 100644 --- a/iis/get-started/localized-content/iis-localized-japanese-learn-articles-and-more.md +++ b/iis/get-started/localized-content/iis-localized-japanese-learn-articles-and-more.md @@ -19,7 +19,7 @@ by IIS Team ### IIS TechCenter メニュー: -| [![](iis-localized-japanese-learn-articles-and-more/_static/image1.png)](https://technet.microsoft.com/iis/default.aspx "IIS TechCenter (日本語版)") | [![](iis-localized-japanese-learn-articles-and-more/_static/image2.png)](https://technet.microsoft.com/iis/ee794964.aspx "PHP on IIS (日本語版)") | [![](iis-localized-japanese-learn-articles-and-more/_static/image3.png)](https://technet.microsoft.com/iis/dd936209.aspx "IIS の資格と学習教材 (日本語版)") | [![](iis-localized-japanese-learn-articles-and-more/_static/image4.png)](https://technet.microsoft.com/iis/dd742256.aspx "IIS 7 拡張機能のダウンロード") | +| [![](iis-localized-japanese-learn-articles-and-more/_static/image1.png)](https://technet.microsoft.com/iis/default.aspx "IIS TechCenter (日本語版)") | [![](iis-localized-japanese-learn-articles-and-more/_static/image3.png)](https://technet.microsoft.com/iis/dd936209.aspx "IIS の資格と学習教材 (日本語版)") | [![](iis-localized-japanese-learn-articles-and-more/_static/image4.png)](https://technet.microsoft.com/iis/dd742256.aspx "IIS 7 拡張機能のダウンロード") | | --- | --- | --- | --- | | - IIS 構築の近道 | - [PHP 環境の設定](https://technet.microsoft.com/iis/ee794964.aspx#lerning "PHP 環境の設定") - [セミナー資料](https://technet.microsoft.com/iis/ee794964.aspx#doc "PHP セミナー資料") | - [バーチャル ラボ](https://technet.microsoft.com/iis/dd936209.aspx#touch "バーチャル ラボ") - [Web キャスト (デモ)](https://technet.microsoft.com/iis/dd936209.aspx#watch "Web キャスト") | - 拡張機能の日本語解説 - ダウンロード | diff --git a/iis/get-started/planning-for-security/build-a-custom-iis-server.md b/iis/get-started/planning-for-security/build-a-custom-iis-server.md index e618591dc..dae511763 100644 --- a/iis/get-started/planning-for-security/build-a-custom-iis-server.md +++ b/iis/get-started/planning-for-security/build-a-custom-iis-server.md @@ -84,7 +84,7 @@ Navigate to the <system.webServer>/<modules> section. This section, Navigate to the <system.webServer>/<handlers> section. This section, which can be configured at the server, application, or URL-level, specifies how requests are handled. Modules typically participate in each and every request, whereas handlers only get requests for a particular URL. -A good example of a module is the compression module. The compression module looks at each response and compresses it if required. The ASP.NET page handler is a good example. It receives only requests that are mapped to it, for example requests that have the extension .aspx. The `` list defines the mappings between a request based on the URL and verb, and a handling module that will be used to process this request. There is also some extra information that is used to configure each mapping, which is not the focus in this topic. +A good example of a module is the compression module. The compression module looks at each response and compresses it if required. The ASP.NET page handler is a good example of a handler. It receives only requests that are mapped to it, for example requests that have the extension .aspx. The `` list defines the mappings between a request based on the URL and verb, and a handling module that will be used to process this request. There is also some extra information that is used to configure each mapping, which is not the focus in this topic. [!code-xml[Main](build-a-custom-iis-server/samples/sample7.xml)] diff --git a/iis/get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md b/iis/get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md index 197a79f34..bf245c35f 100644 --- a/iis/get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md +++ b/iis/get-started/planning-for-security/secure-content-in-iis-through-file-system-acls.md @@ -66,7 +66,7 @@ Figuring out the right accounts to grant permissions depends on the profile and ## How to Set ACLs -There are several ways to set your ACLs through the shell, including command-line tools such as Icacls.exe. This article focuses on the Web Deployment Tool manifest (XML) mechanism that can be used to set ACLs. This is used when installing an application through the Web Deployment Tool or the Web Platform Installer. +There are several ways to set your ACLs through the shell, including command-line tools such as Icacls.exe. This article focuses on the Web Deployment Tool manifest (XML) mechanism that can be used to set ACLs. This is used when installing an application through the Web Deployment Tool. To give Read, Execute, and Write permissions to *MyApp* file system directory for user *Foo*, add the following line to the Manifest.xml file: diff --git a/iis/get-started/planning-for-security/set-acls-through-the-manifestxml-file.md b/iis/get-started/planning-for-security/set-acls-through-the-manifestxml-file.md index 3262bda61..86ac99099 100644 --- a/iis/get-started/planning-for-security/set-acls-through-the-manifestxml-file.md +++ b/iis/get-started/planning-for-security/set-acls-through-the-manifestxml-file.md @@ -13,7 +13,7 @@ by Tali Smith ## Introduction -There are several ways to set access control lists (ACLs), including command-line tools such as Icacls.exe. PHP hosters generally use the command line. It is also possible, however, to set ACLs in the Manifest.xml file; these are the mechanisms that are applied when you install an application through the Web Deployment Tool (WDT) or the Microsoft® Web Platform Installer (Web PI). +There are several ways to set access control lists (ACLs), including command-line tools such as Icacls.exe. PHP hosters generally use the command line. It is also possible, however, to set ACLs in the Manifest.xml file; these are the mechanisms that are applied when you install an application through the Web Deployment Tool (WDT). By default, the WDT installs all files and directories without changing any of the existing permissions. In most cases, this means that the application only has read access to the installed files and directories. If your application needs to be able to write to any file or directory, you can specify which files or directories with a setAcl directive in the Manifest.xml file. The setAclResourceType element defines whether the path represents a file or a directory. @@ -58,9 +58,6 @@ The token anonymousAuthenticationUser is automatically compared to the ID that t PHP applications are typically run as the anonymous user because the FastCGI settings usually set the impersonation to be True(run as anonymous user). ASP.NET applications typically run as the worker process identity (application pool identity). If setAclUseris not specified, then the setAcldirective uses the application's Application Pool Identity as the ID for authorization. -> [!NOTE] -> *This article is based on information from: "[Application Packaging Guide for the Windows Web Application Gallery](../../develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md)" by the IIS team, published on September 24, 2009.* - ## Links for Further Information - [Understanding the Built-In User and Group Accounts in IIS 7.0 and Above](understanding-built-in-user-and-group-accounts-in-iis.md). diff --git a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8.md b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8.md index ee5e09c4d..936d47beb 100644 --- a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8.md +++ b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8.md @@ -150,14 +150,20 @@ Example: -## Additional Schema Information in <ConfigSections> +## Additional Schema Information in <configSections> -Not all the required schema information is in the schema XML files. Some of it is in a special section called <ConfigSections>, which resides in the configuration files themselves. This is consistent with the .NET framework configuration system. By default, `` exists in machine.config and applicationHost.config; but customers may add it to any web.config file, to define their custom sections. These sections will be defined for that level in the namespace and downward. +Not all the required schema information is in the schema XML files. Some of it is in a special section called ``, which resides in the configuration files themselves. This is consistent with the .NET framework configuration system. By default, `` exists in machine.config and applicationHost.config; but customers may add it to any web.config file, to define their custom sections. These sections will be defined for that level in the namespace and downward. > [!NOTE] > Customers and third parties should not attempt to change schema information for the built-in sections, either in the inetsrv\config\schema\ folder or in machine.config and applicationHost.config. This may yield to undesirable behavior for these sections. -The content of is a list of sections that are "registered" with the system (this is their registration point). It also defines the hierarchy of section groups. It does not, however, defines properties (or elements) within sections. Some additional metadata is defined for sections: +The content of ``: + +- Defines the sections that are "registered" with the system +- Defines the hierarchy of section groups. +- Does ***not** define properties or elements within sections. + +Some additional metadata is defined for sections: - **Type**: Required attribute. This is the managed-code section handler type; useful only in the context of .NET framework configuration system accessing the section (the System.Configuration classes). The definition is for a strong type, i.e. it includes the assembly name, version, culture and key. - **OverrideModeDefault**: Optional attribute. If missing, the default is "Allow". This is the default lockdown state of the section, i.e. whether it is locked down to the level in which it is defined, or alternatively can be overridden by lower levels of the configuration hierarchy. If it is "Deny", then lower web.config files cannot override its settings (in other words: it is locked down to this level). Most of the IIS web server sections are locked down, but not all. Most of the .NET framework sections are not locked down, because they are considered application-level settings. If the value is "Allow", then lower levels may override the settings. @@ -211,7 +217,7 @@ This example shows how to unlock the section. Since it is locked at the applicat There are cases where it is useful to unlock sections for a specific path only and to keep them locked for all other paths. The following example builds atop the previous one, and shows how to unlock the section for two specific sites only; for all other sites it will remain locked. -[!code-html[Main](deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.html)] +[!code-xml[Main](deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.xml)] For each "exception" path that needs unlocking, there needs to be a different location tag. diff --git a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample3.xml b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample3.xml index 91b43a80f..266256840 100644 --- a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample3.xml +++ b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample3.xml @@ -7,6 +7,6 @@ - + - \ No newline at end of file + diff --git a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.html b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.xml similarity index 64% rename from iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.html rename to iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.xml index 3bb566886..4fdd1c59b 100644 --- a/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.html +++ b/iis/get-started/planning-your-iis-architecture/deep-dive-into-iis-configuration-with-iis-7-and-iis-8/samples/sample8.xml @@ -4,7 +4,7 @@
- + diff --git a/iis/get-started/whats-new-in-iis-10-version-1809/new-features-introduced-in-iis-10-1809.md b/iis/get-started/whats-new-in-iis-10-version-1809/new-features-introduced-in-iis-10-1809.md index 6323f183c..b0730ee17 100644 --- a/iis/get-started/whats-new-in-iis-10-version-1809/new-features-introduced-in-iis-10-1809.md +++ b/iis/get-started/whats-new-in-iis-10-version-1809/new-features-introduced-in-iis-10-1809.md @@ -7,7 +7,6 @@ ms.author: johnhart ms.date: 10/03/2018 ms.topic: article -ms.prod: iis msc.type: authoredcontent --- New Features Introduced in IIS 10.0, version 1809 diff --git a/iis/get-started/whats-new-in-iis-10/introducing-iis-on-nano-server.md b/iis/get-started/whats-new-in-iis-10/introducing-iis-on-nano-server.md index b728a9eff..f44ae55cb 100644 --- a/iis/get-started/whats-new-in-iis-10/introducing-iis-on-nano-server.md +++ b/iis/get-started/whats-new-in-iis-10/introducing-iis-on-nano-server.md @@ -98,15 +98,10 @@ Java applications can be hosted on IIS via [HttpPlatformHandler](https://www.iis My co-worker Jeong Hwan has a blog post here on [how to get Java working with IIS on Nano](https://blogs.iis.net/jeonghwan/running-tomcat-with-iis-on-nano-server) -#### PHP - -PHP on IIS runs the same on Nano the same as on regular server (e.g. through FastCgi). - -Here's a blog post from Jeong Hwan on [how to get a PHP (WordPress) application running on Nano with WinCache and IIS](https://blogs.iis.net/jeonghwan/running-wordpress-with-iis-and-wincache-on-nano-server). #### Others -Supporting Asp.Net Core, Java and PHP on IIS Nano is a great start though we do have plans to get additional platforms supported. The [HttpPlatformHandler](https://www.iis.net/downloads/microsoft/httpplatformhandler) is a general purpose module for managing and sending requests to http listeners, so there could well be more platforms that can run well on Nano that we haven't tested and so haven't listed. +Supporting ASP.NET Core and Java on IIS Nano is a great start though we do have plans to get additional platforms supported. The [HttpPlatformHandler](https://www.iis.net/downloads/microsoft/httpplatformhandler) is a general purpose module for managing and sending requests to http listeners, so there could well be more platforms that can run well on Nano that we haven't tested and so haven't listed. If you do try this (e.g. with Ruby or Node) and get it working let us know! diff --git a/iis/get-started/whats-new-in-iis-10/new-features-introduced-in-iis-10.md b/iis/get-started/whats-new-in-iis-10/new-features-introduced-in-iis-10.md index bb21f2e20..177c9e71c 100644 --- a/iis/get-started/whats-new-in-iis-10/new-features-introduced-in-iis-10.md +++ b/iis/get-started/whats-new-in-iis-10/new-features-introduced-in-iis-10.md @@ -20,7 +20,7 @@ Learn more: [HTTP/2 on IIS](http2-on-iis.md) ## IIS on Nano Server -Nano Server is a new headless, 64-bit-only installation option for Windows 10 and Windows Server 2016 which installs "just enough OS" thereby resulting in a smaller footprint. Nano Server provides higher density, increased uptime, and a smaller attack surface making it suitable for running web workloads. You can currently run [ASP.NET Core](/iis/get-started/whats-new-in-iis-10/running-aspnet-core-with-iis-on-nano-server), [Apache Tomcat](https://blogs.iis.net/jeonghwan/running-tomcat-with-iis-on-nano-server), and [PHP](https://blogs.iis.net/jeonghwan/running-wordpress-with-iis-and-wincache-on-nano-server) workloads on IIS on Nano Server, in addition to using it as an reverse proxy to any HTTP listener via the [HttpPlatformHandler module](https://www.iis.net/downloads/microsoft/httpplatformhandler). +Nano Server is a new headless, 64-bit-only installation option for Windows 10 and Windows Server 2016 which installs "just enough OS" thereby resulting in a smaller footprint. Nano Server provides higher density, increased uptime, and a smaller attack surface making it suitable for running web workloads. You can currently run [ASP.NET Core](/iis/get-started/whats-new-in-iis-10/running-aspnet-core-with-iis-on-nano-server) and [Apache Tomcat](https://blogs.iis.net/jeonghwan/running-tomcat-with-iis-on-nano-server) workloads on IIS on Nano Server, in addition to using it as an reverse proxy to any HTTP listener via the [HttpPlatformHandler module](https://www.iis.net/downloads/microsoft/httpplatformhandler). Learn more: [Introducing IIS on Nano Server](introducing-iis-on-nano-server.md) @@ -34,9 +34,9 @@ Get started with [IIS base images available on Docker Hub](https://hub.docker.co With the advent of Nano Server and Windows Containers, IIS now provides a better management story for all environments running (including those without a GUI). -### Microsoft IIS Administration ([https://manage.iis.net](https://manage.iis.net)) +### Microsoft IIS Administration -Microsoft IIS Administration is a REST API which allows you to configure and monitor your IIS instance, and it is an [open-source project that is under active development on GitHub](https://github.com/Microsoft/IIS.Administration). With this API users can take advantage of the new IIS Web Manager that is available at [https://manage.iis.net](https://manage.iis.net). This browser based application consumes the IIS Administration API to provide a familiar management experience. Microsoft IIS Administration supports IIS 7.5 and above. +Microsoft IIS Administration is a REST API which allows you to configure and monitor your IIS instance, and it is an [open-source project that is under active development on GitHub](https://github.com/Microsoft/IIS.Administration). Learn more: [Microsoft IIS Administration Preview](https://blogs.iis.net/adminapi/microsoft-iis-administration-api-preview). diff --git a/iis/get-started/whats-new-in-iis-7/changes-in-security-between-iis-60-and-iis-7-and-above.md b/iis/get-started/whats-new-in-iis-7/changes-in-security-between-iis-60-and-iis-7-and-above.md index 506835b4b..bf3a1ee3f 100644 --- a/iis/get-started/whats-new-in-iis-7/changes-in-security-between-iis-60-and-iis-7-and-above.md +++ b/iis/get-started/whats-new-in-iis-7/changes-in-security-between-iis-60-and-iis-7-and-above.md @@ -57,7 +57,7 @@ Support for legacy Passport authentication was built into IIS 5/6 and Windows Se In Windows Server 2008 and beyond, the legacy Passport binaries and integration with IIS were removed. -The Passport service has since changed into Windows Live ID. While the new Live ID service certainly grew out of the legacy Passport service, there are major changes. One of the biggest changes is how a partner site integrates with Live ID. You can add Live ID authentication by using the publicly available [Windows Live ID Web Authentication SDK](https://www.microsoft.com/downloads/details.aspx?FamilyId=E565FC92-D5F6-4F5F-8713-4DD1C90DE19F&displaylang=en). While the Windows Live ID service also supports identity Federation and ADFS, that capability is new functionality for specific cases, and is not a replacement for "Passport". +The Passport service has since changed into Windows Live ID. While the new Live ID service certainly grew out of the legacy Passport service, there are major changes. One of the biggest changes is how a partner site integrates with Live ID. You can add Live ID authentication by using the publicly available Windows Live ID Web Authentication SDK. While the Windows Live ID service also supports identity Federation and ADFS, that capability is new functionality for specific cases, and is not a replacement for "Passport". ### Forms authentication diff --git a/iis/get-started/whats-new-in-iis-8/iis-80-using-aspnet-35-and-aspnet-45.md b/iis/get-started/whats-new-in-iis-8/iis-80-using-aspnet-35-and-aspnet-45.md index f17b99985..55cf849ef 100644 --- a/iis/get-started/whats-new-in-iis-8/iis-80-using-aspnet-35-and-aspnet-45.md +++ b/iis/get-started/whats-new-in-iis-8/iis-80-using-aspnet-35-and-aspnet-45.md @@ -78,7 +78,7 @@ With both IIS 8.0 and ASP.NET integration installed we can take a look at the ba 1. From the Windows Start menu select **All Programs** and then expand the **Administrative Tools** menu. In the resulting list, find **Internet Information Services (IIS) Manager** and select it to launch the graphical IIS management tool: ![Screenshot of Administrative Tools menu expanded with Internet Information Services I I S Manager highlighted.](iis-80-using-aspnet-35-and-aspnet-45/_static/image23.png) -2. Once the IIS Manager starts up, expand the server node in the left-hand window so that both the **Application Pools** node and **Sites** node are showing. When you do this the IIS Manager will popup a dialog asking if you want to stay connected with the latest Web Platform Components. For this walkthrough, you can click **No**. However on real-world installations you will probably want to click **Yes** so that the Web Platform Installer is available for your use to download various IIS extensions such as the URL Rewrite Module. At this point the IIS Manager looks like the following picture: +2. Once the IIS Manager starts up, expand the server node in the left-hand window so that both the **Application Pools** node and **Sites** node are showing. When you do this the IIS Manager will popup a dialog asking if you want to stay connected with the latest Web Platform Components. For this walkthrough, you can click **No**. At this point the IIS Manager looks like the following picture: [![Screenshot of I I S Manager showing Application Pools node and Sites node expanded with Web Platform Installer highlighted.](iis-80-using-aspnet-35-and-aspnet-45/_static/image27.png)](iis-80-using-aspnet-35-and-aspnet-45/_static/image25.png) 3. Click the **Application Pools** node to display the application pools that have now been installed for use by IIS 8.0: [![Screenshot of Application Pools node with list of application pools installed for use by I I S 8 dot 0.](iis-80-using-aspnet-35-and-aspnet-45/_static/image31.png)](iis-80-using-aspnet-35-and-aspnet-45/_static/image29.png) diff --git a/iis/index.yml b/iis/index.yml index 24f5d33e4..e685aac74 100644 --- a/iis/index.yml +++ b/iis/index.yml @@ -204,27 +204,3 @@ landingContent: url: /iis/publish/using-the-ftp-service/configuring-ftp-user-isolation-in-iis-7 - text: IIS FTP Logon Attempt Restrictions url: /iis/get-started/whats-new-in-iis-8/iis-80-ftp-logon-attempt-restrictions - - # Card - - title: PHP & IIS - linkLists: - - linkListType: concept - links: - - text: Migrate to a Windows-Based Platform - url: /iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-to-a-windows-based-platform - - text: Planning Step 2 - Plan PHP Settings - url: /iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-2-plan-php-settings - - text: Planning Step 3 - Plan PHP Application Security - url: /iis/application-frameworks/scenario-build-a-php-website-on-iis/planning-step-3-plan-php-application-security - - linkListType: how-to-guide - links: - - text: Install and Configure PHP - url: /iis/application-frameworks/install-and-configure-php-on-iis/install-and-configure-php - - text: Enable Per-Site PHP Configuration on IIS - url: /iis/application-frameworks/install-and-configure-php-on-iis/enable-per-site-php-configuration-on-iis-60-and-iis-7-and-above - - text: Setting Up a Database for a PHP Application on IIS - url: /iis/application-frameworks/install-and-configure-php-on-iis/setting-up-a-database-for-a-php-application-on-iis - - linkListType: reference - links: - - text: Best Practices for PHP on the Microsoft Web Platform - url: /iis/application-frameworks/running-php-applications-on-iis/best-practices-for-php-on-the-microsoft-web-platform diff --git a/iis/install/installing-iis-7/compatibility-and-feature-requirements-for-windows-vista.md b/iis/install/installing-iis-7/compatibility-and-feature-requirements-for-windows-vista.md index f332232a6..9cc9dbe7b 100644 --- a/iis/install/installing-iis-7/compatibility-and-feature-requirements-for-windows-vista.md +++ b/iis/install/installing-iis-7/compatibility-and-feature-requirements-for-windows-vista.md @@ -25,7 +25,7 @@ This section describes the known breaking changes in IIS 7.0 and above. Previous versions of IIS used the metabase to configure Web servers and sites, whereas IIS 7.0 and above use an XML configuration file to configure these settings. Although the metabase is no longer used to configure IIS 7.0 and above, a metabase compatibility feature is available to make IIS 7.0 and above compatible with APIs that relied on the metabase. This feature supports the Admin Base Objects (ABO) interface (also known as IMSAdminBase), Active Directory Service Interfaces (ADSI), and the WMI providers that were built on top of ABO in IIS 6.0. -By default, IIS 7.0 and above does not install the metabase compatibility feature. For more information on how to install the metabase compatibility feature, see [Configuration Compatibility](https://go.microsoft.com/fwlink/?LinkId=78483) on IIS.NET. +By default, IIS 7.0 and above does not install the metabase compatibility feature. ### Metabase Compatibility Considerations @@ -64,7 +64,7 @@ IIS 7.0 and above setup does not re-target the \inetpub folder, which is always IIS 7.0 and above integrates the ASP.NET runtime extensibility model with the core Web server. This integration enables developers to extend the IIS server by using the power of ASP.NET 2.0 and the .NET Framework, instead of using the less robust IIS C++ APIs. Existing ASP.NET applications also immediately benefit from tighter integration by being able to use existing ASP.NET features such as Forms Authentication, Roles, and Output Caching for all kinds of content. -For more information about the ASP.NET integration in IIS and about migrating existing applications, see ASP.NET Integration with IIS 7.0 and Above on IIS.NET. For more information about breaking changes associated with ASP.NET, see [Upgrading ASP.NET Applications to IIS 7: Configuring Applications After Upgrade and Differences Between IIS 7.0 Integrated Mode and ISAPI Mode](https://go.microsoft.com/fwlink/?LinkId=77939) on the ASP.NET site. +For more information about the ASP.NET integration in IIS and about migrating existing applications, see ASP.NET Integration with IIS 7.0 and Above on IIS.NET. For more information about breaking changes associated with ASP.NET, see [Upgrading ASP.NET Applications to IIS 7: Configuring Applications After Upgrade and Differences Between IIS 7.0 Integrated Mode and ISAPI Mode](/iis/application-frameworks/building-and-running-aspnet-applications/upgrading-aspnet-11-to-iis-on-windows-vista-and-windows-server-2008) on the ASP.NET site. diff --git a/iis/install/installing-iis-7/how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008.md b/iis/install/installing-iis-7/how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008.md index b4e3d8933..ff915383e 100644 --- a/iis/install/installing-iis-7/how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008.md +++ b/iis/install/installing-iis-7/how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008.md @@ -1,7 +1,7 @@ --- title: "How to install ASP.NET 1.1 with IIS7 on Vista and Windows 2008" author: walterov -description: "You can use the Web Platform Installer (Web PI) to easily install IIS, and applications that run on IIS. The Web PI is a free, lightweight tool that lets you..." +description: "How to install ASP.NET 1.1 with IIS7 on Vista and Windows 2008..." ms.date: 06/03/2008 ms.assetid: 6b0e9ceb-a1b5-4d31-ae0b-2ddda487161a msc.legacyurl: /learn/install/installing-iis-7/how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008 @@ -13,9 +13,7 @@ by [Walter Oliver](https://github.com/walterov) ## Overview -You can use the Web Platform Installer (Web PI) to easily install IIS, and applications that run on IIS. The Web PI is a free, lightweight tool that lets you install IIS and related technologies such as ASP.NET, SQL Server Express, Visual Web Developer, other popular Web applications, and more. Because the Web PI references and links to the latest versions of available Web Platform offerings, with just a few simple clicks you can download and install any new tools or updates. To learn more about the Web PI, see [Learn more and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510 "Learn about and install the Web PI"). - -You can also install ASP.NET 2.0 (3.0 and 3.5) using the Windows Vista and Windows 2008 user interface - just install the ASP.NET component located under IIS->Word Wide Web Services->Application Development Features. You can find this set of components in Windows 2008 by clicking Start, and click Server Manager. Expand the left-hand treeview in Server Manager and click Manage Roles, and then Web Server (IIS). In the right-hand pane look for an option that says Add Role Services. If you're on Windows Vista, click Start, click Control Panel, click Programs, and then Windows Features. Look for the following tree of features under Internet Information Services (IIS): +You can install ASP.NET 2.0 (3.0 and 3.5) using the Windows Vista and Windows 2008 user interface - just install the ASP.NET component located under IIS->Word Wide Web Services->Application Development Features. You can find this set of components in Windows 2008 by clicking Start, and click Server Manager. Expand the left-hand treeview in Server Manager and click Manage Roles, and then Web Server (IIS). In the right-hand pane look for an option that says Add Role Services. If you're on Windows Vista, click Start, click Control Panel, click Programs, and then Windows Features. Look for the following tree of features under Internet Information Services (IIS): [![Screenshot of the Internet Information Services folder and its contained tree of folders.](how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008/_static/image3.png)](how-to-install-aspnet-11-with-iis-on-vista-and-windows-2008/_static/image1.png) @@ -33,11 +31,7 @@ If you're on Windows Vista, click **Start**, click **Control Panel**, click **Pr ### Step 2: Install the .NET Framework v1.1 and .NET Framework v1.1 SP1 -Install Framework v1.1, SP1, and ASP.NET's security update to SP1: - -- [.NET Framework Version 1.1 Redistributable Package](https://www.microsoft.com/downloads/info.aspx?na=22&p=1&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d262d25e3-f589-4842-8157-034d1e7cf3a3%26DisplayLang%3den) -- [.NET Framework Version 1.1 Service Pack 1](https://www.microsoft.com/downloads/info.aspx?na=22&p=3&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3da8f5654f-088e-40b2-bbdb-a83353618b38%26DisplayLang%3den) -- [ASP.NET Security Update for .NET Framework 1.1 SP1](https://www.microsoft.com/downloads/info.aspx?na=22&p=7&SrcDisplayLang=en&SrcCategoryId=&SrcFamilyId=&u=%2fdownloads%2fdetails.aspx%3fFamilyID%3d8ec6fb8a-29eb-49cf-9dbc-1a0dc2273ff9%26DisplayLang%3den) +Install Framework v1.1, SP1, and ASP.NET's security update to SP1. When you install .NET Framework Version 1.1, and SP1 for .NET Framework Version 1.1, you'll see the following dialog. Click **Run program**. diff --git a/iis/install/installing-iis-7/install-and-configure-iis-on-server-core.md b/iis/install/installing-iis-7/install-and-configure-iis-on-server-core.md index 850788bd6..07f7f807f 100644 --- a/iis/install/installing-iis-7/install-and-configure-iis-on-server-core.md +++ b/iis/install/installing-iis-7/install-and-configure-iis-on-server-core.md @@ -154,7 +154,7 @@ If you plan to use ASP.NET or IIS Remote Management then it is necessary to inst Refer to [Managing IIS with IIS 7.0 PowerShell Snap-in](../../manage/powershell/index.md) and [Managing IIS with the IIS 7.0 PowerShell Snap-in](../../manage/powershell/index.md) for more information. -For information about Windows PowerShell on Server Core, see [Dmitry's PowerBlog: PowerShell and Beyond](http://dmitrysotnikov.wordpress.com/2008/05/15/powershell-on-server-core/). +For information about Windows PowerShell on Server Core, see [Dmitry's PowerBlog: PowerShell and Beyond](https://dmitrysotnikov.wordpress.com/2008/05/15/powershell-on-server-core/). ### Enable IIS Remote Management diff --git a/iis/install/installing-iis-7/install-typical-iis-workloads.md b/iis/install/installing-iis-7/install-typical-iis-workloads.md index 47f29963f..fc2ed3a98 100644 --- a/iis/install/installing-iis-7/install-typical-iis-workloads.md +++ b/iis/install/installing-iis-7/install-typical-iis-workloads.md @@ -39,7 +39,6 @@ The common IIS workloads we will consider are: - Default Install - Static Content web Server - ASP.NET - Classic ASP -- Fast CGI for PHP - IIS Full Install ### Combining and Modifying Workloads @@ -141,30 +140,6 @@ To install IIS features for Classic ASP via ServerManagerCmd.exe, use the follow [!code-powershell[Main](install-typical-iis-workloads/samples/sample8.ps1)] - - -## Install FastCGI for PHP - -FastCGI provides a high-performance alternative to the Common Gateway Interface (CGI), a standard way of interfacing external applications with Web servers that has been supported as part of the IIS feature-set since the very first release. - -FastCGI overcomes the performance penalty of traditional CGI by re-using CGI processes to service subsequent requests, while continuing to ensure single request concurrency. For more information on how FastCGI works, see article [Using FastCGI to Host PHP Applications on IIS 7.0 and Above.](../../application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md) - -To install IIS features for CGI and Fast CGI from the Vista/Windows Server 2008 setup user interface, select the following IIS features by UI name (in addition to features for static content): - -| UI Name | Update Name | -| --- | --- | -| CGI | IIS-CGI | - -To install IIS features for CGI and FastCGI along with features for Static Content Web Server via pkgmgr.exe, use the following command line: - -[!code-console[Main](install-typical-iis-workloads/samples/sample9.cmd)] - -To install IIS features for CGI and FastCGI via ServerManagerCmd.exe, use the following command line: - -[!code-powershell[Main](install-typical-iis-workloads/samples/sample10.ps1)] - - - ## IIS 7.0 and Above Full Install As a developer or one who is just evaluating IIS you may simply just want to install all 40 of the IIS features: This will certainly assure that you're not missing anything; but realistically, even in a development environment there are advantages to limiting your install to just the features needed for your intended application. Doing your development on a partial install of IIS will assure that you have an understanding of your application's IIS module dependencies. It may also be true that the target servers that your IIS applications will be deployed on will not be configured with a full install. Matching the IIS install on your development machine to that of your target hosting machine will assure your application can run as expected when deployed. diff --git a/iis/install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2.md b/iis/install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2.md index 1c6a76f60..5833c40ed 100644 --- a/iis/install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2.md +++ b/iis/install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2.md @@ -1,7 +1,7 @@ --- title: "Installing IIS 7 on Windows Server 2008 or Windows Server 2008 R2" author: rick-anderson -description: "Introduction You can use Microsoft ® Web Platform Installer (Web PI) to easily install Internet Information Services (IIS) and applications that run on IIS...." +description: "Installing IIS 7 on Windows Server 2008 or Windows Server 2008 R2...." ms.date: 10/26/2007 ms.assetid: f784d613-a814-4ec5-ab99-c9b1cc76b30c msc.legacyurl: /learn/install/installing-iis-7/installing-iis-7-and-above-on-windows-server-2008-or-windows-server-2008-r2 @@ -9,7 +9,7 @@ msc.type: authoredcontent --- # Installing IIS 7 on Windows Server 2008 or Windows Server 2008 R2 -You can use Microsoft® Web Platform Installer (Web PI) to easily install Internet Information Services (IIS) and applications that run on IIS. However, if you choose to install IIS manually, you can use this article for guidance. You can also refer to [Installing and Configuring IIS 7 and Above](../index.md). +If you choose to install IIS manually, you can use this article for guidance. You can also refer to [Installing and Configuring IIS 7 and Above](../index.md). IIS is Microsoft Web server role that is included with all versions of Microsoft's operating systems, and also powers [Windows Azure Web Sites](https://www.windowsazure.com/solutions/web/) to provide robust cloud-based PaaS (Platform as a Service). Version 7.0 of IIS is included with Windows Server® 2008 and Windows Vista®. IIS 7.5 is the Web server role in Windows Server® 2008 R2 and the Web server in Windows® 7. IIS 8.0 is the version that is part of Windows Server 2012, and Windows Server 2012 R2 includes IIS 8.5. Windows Server 2008 R2 and Windows Server 2008 operating systems have all the IIS features needed to support the hosting of Web content in production environments. Windows 7 and Windows Vista also include IIS features, but the available features depend on the operating system versions. diff --git a/iis/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7.md b/iis/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7.md index 69db0362e..eca1bca57 100644 --- a/iis/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7.md +++ b/iis/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7.md @@ -1,7 +1,7 @@ --- title: "Installing IIS 7 on Windows Vista and Windows 7" author: rick-anderson -description: "Introduction You can use the Microsoft ® Web Platform Installer (Web PI) to easily install Internet Information Services (IIS), and applications that run on..." +description: "Installing IIS 7 on Windows Vista and Windows 7..." ms.date: 10/26/2007 ms.assetid: 0e9d9685-6391-48cd-8a57-d47f6592d16b msc.legacyurl: /learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7 @@ -13,7 +13,7 @@ by IIS Team ## Introduction -Advances in cloud technologies have led many users to use [Windows Azure Web Sites](https://www.windowsazure.com/solutions/web/) to host both a production site and test site, as it makes it easy to test various configurations without impacting their own personal computers. If you still prefer to do this on your desktop, you can install IIS on it, as well as other applications and extensions easily using the Microsoft® Web Platform Installer (Web PI). To learn more about the Web PI, see [Learn about and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). +Advances in cloud technologies have led many users to use [Windows Azure Web Sites](https://www.windowsazure.com/solutions/web/) to host both a production site and test site, as it makes it easy to test various configurations without impacting their own personal computers. If you still prefer to do this on your desktop, you can install IIS on it, as well as other applications and extensions easily. If you choose to install IIS 7.0 or above manually, you can use this article for guidance. diff --git a/iis/install/installing-iis-7/understanding-setup-in-iis.md b/iis/install/installing-iis-7/understanding-setup-in-iis.md index 19b5ddb1e..8d17488df 100644 --- a/iis/install/installing-iis-7/understanding-setup-in-iis.md +++ b/iis/install/installing-iis-7/understanding-setup-in-iis.md @@ -33,12 +33,6 @@ IIS 7 and above has a completely modular setup design that enables control over The new IIS server pipeline architecture provides a high level of component granularity. Because of this granularity, when you install IIS, you can surfaces this granularity in user selectable, installable components. You can also use IIS Setup to customize your installation by selecting from more than 40 IIS features. New to IIS Setup is the ability to install just the feature modules that you require, allowing you to deploy very thin, task-specific servers, as well as lock out functionality in ways never before possible. - - -## Using the Web Platform Installer (Web PI) - -You can use the Web Platform Installer (Web PI) to easily install IIS, as well as other applications that run on IIS. The Web PI is a free, lightweight tool that lets you install IIS and related technologies such as ASP.NET, SQL Server Express, Visual Web Developer, and other popular Web applications. Because the Web PI references and links to the latest versions of available Web Platform offerings, with just a few simple clicks you can download and install any new tools or updates. To learn more about the Web PI and about how to install it, see the [Microsoft Web Platform](https://go.microsoft.com/fwlink/?LinkID=145510) page. - ## Windows Server 2008 and Windows Vista Component-Based Setup OS and optional features installation for Windows Vista and Windows Server 2008 is based on completely new technology. The new setup technology is now driven by a declarative model, with each feature of the operating system defining its own set of components that make up the feature and its dependencies. diff --git a/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy-on-iis-80-or-later.md b/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy-on-iis-80-or-later.md index 5feb6484a..4e13d1a0f 100644 --- a/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy-on-iis-80-or-later.md +++ b/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy-on-iis-80-or-later.md @@ -19,48 +19,7 @@ Windows 8.0 and 8.1 do not come with the Web Management Service that is required ## Installing Web Deploy -You can install Web Deploy by using the Web Platform Installer (Web PI) or the Web Deploy MSI. - -- Use the Web Platform Installer (Web PI) to install the Recommended Server Configuration for Web Hosting Providers, which includes Web Deploy -- Use Web PI to install Web Deploy separately (with or without its dependencies) -- Use the Web Deploy installer. - -### Installing Web Deploy as Part of the Recommended Server Configuration for Web Hosting Providers - -When the Web Platform Installer installs the Recommended Server Configuration for Web Hosting Providers, it configures the web server with the most common deployment for web hosting providers. This package makes sure that the IIS 8.0 or later prerequisites required for Web Deploy are installed. Dependencies such as SQL Server Management Objects and SQL Server are selected automatically for installation, and installed with the Web PI prerequisites, such as the Web Service Management Handler. The package includes some optional components, such as PHP and MySQL, that you can choose not to install with this bundle by clicking the **X** next to them. - -The Recommended Server Configuration for Web Hosting Providers can be installed on Windows 2012 Server or later. For information about installing on earlier versions of Windows Server with IIS 7, see [Installing and Configuring Web Deploy on IIS 7](installing-and-configuring-web-deploy.md). - -1. Download the [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx). -2. Open Web PI. -3. In Web PI, click in the search bar in the upper-right hand corner, enter "Recommended" in **Search**, and press **Enter**. -4. Select **Recommended Server Configuration for Web Hosting Providers**, and then click **Add**.[![Screenshot of Web Platform Installer four point six. The Recommended Server Configuration for Web Hosting Providers option is highlighted.](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image2.jpg)](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image1.jpg) -5. Click **Install**. -6. On the **Prerequisites** page, click **I accept**. -7. After the installation has completed, click **Finish**. - -### Using the Web Platform Installer to install Web Deploy Separately - -You can install Web Deploy separately with its dependencies, such as the Web Management Service (WMSvc). You can install the following versions of Web Deploy. - -- **Web Deploy 3.5 without bundled SQL**: Installs Web Deploy alone. -- **Web Deploy 3.5**: Web Deploy plus support for SQL database publishing -- **Web Deploy 3.5 for hosting servers**: Web Deploy plus IIS/ASP.NET dependencies and support for SQL database publishing. This includes dependencies to install base IIS plus Management Service (required for non-admin publishing) and PowerShell 2.0 or later (used to do some basic non-admin publishing setup during install). - -If you install Web Deploy directly in Web PI, rather than as part of the Recommended Server Configuration for Web Hosting Providers, the dependencies required for Web Deploy may not be installed. - -Using Web PI, Web Deploy can be installed on Windows 2012 Server or later, or Windows 8.0 or later. For information about installing on earlier versions of Windows Server or Windows with IIS 7, see [Installing and Configuring Web Deploy on IIS 7](installing-and-configuring-web-deploy.md). - -To install Web Deploy separately using Web PI: - -1. Download the [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx). -2. Open WebPI on your desktop. -3. Click in the search bar in the upper-right hand corner, enter "Web Deploy", and press **Enter**. - [![Screenshot of the Web Platform Installer four point six. Windows Azure S D K for Node dot J S is highlighted.](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image4.jpg)](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image3.jpg) -4. Select the Web Deploy that you want, and then click **Add**. - [![Screenshot of the Web Platform Installer four point six. Web Deploy three point five is highlighted.](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image6.jpg)](installing-and-configuring-web-deploy-on-iis-80-or-later/_static/image5.jpg) -5. On the **Prerequisites** page, click **I accept**. -6. After the installation has completed, click **Finish**. +You can install Web Deploy by using the Web Deploy MSI. ### Using the Web Deploy Installer to Install Web Deploy diff --git a/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy.md b/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy.md index 3d654e9b2..4165a817d 100644 --- a/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy.md +++ b/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy.md @@ -25,16 +25,9 @@ The server must have an operating system that comes with IIS7— this means eith #### Use WebPI to install Web Deploy along with its dependencies like the Web Management Service (WMSvc) -1. Install Web Deploy by using either method **i** or **ii** below: +1. Install Web Deploy by using the method below: - 1. Install Web Deploy and dependent products using the [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) - - 1. Download the Web Platform Installer. [https://www.microsoft.com/web/downloads/platform.aspx](https://www.microsoft.com/web/downloads/platform.aspx) - 2. In the upper-right hand corner, click in the search box, type "Web Deploy", and press ENTER - [![Screenshot that shows the Web Platform Installer. Web Deploy is entered in the search box.](installing-and-configuring-web-deploy/_static/image4.png)](installing-and-configuring-web-deploy/_static/image3.png) - 3. Add the "Web Deployment Tool 2.1 for Hosting Servers" product and click **Install**. - ![Screenshot that shows the Web Platform Installer. Web Deploy is entered in the search box field.](installing-and-configuring-web-deploy/_static/image5.png) - 2. Download the Web Deploy installer directly from the [IIS.net Web Deploy page](https://www.iis.net/downloads/microsoft/web-deploy)[https://www.iis.net/download/webdeploy](https://www.iis.net/downloads/microsoft/web-deploy) (x86) | (x64) + 1. Download the Web Deploy installer directly from the [IIS.net Web Deploy page](https://www.iis.net/downloads/microsoft/web-deploy)[https://www.iis.net/download/webdeploy](https://www.iis.net/downloads/microsoft/web-deploy) (x86) | (x64) 1. In the Setup wizard choose the "Complete" setup option. [![Screenshot that shows the Microsoft Web Deploy 2 point 0 Setup wizard. Complete is highlighted.](installing-and-configuring-web-deploy/_static/image7.png)](installing-and-configuring-web-deploy/_static/image6.png) @@ -72,7 +65,7 @@ After installing Web Deploy using method (1) or (2a), described above, all serve #### Requirements: -Install Web Deploy using method (1) or (2a) described above. If you are using a client operating system such as Vista or Windows 7, or a Windows server version without IIS7+, such as Windows Server 2003, you will need to choose the Web Deployment Tool 2.1 product option in the Web Platform Installer (in install method 2a), or install directly from the Web Deployment Tool download page (install method 2b). For these client or server 2003 machines the Web Management Service handler component and associated delegation rules will not be applicable. +Install Web Deploy using the method described above. If you are using a client operating system such as Vista or Windows 7, or a Windows server version without IIS7+, such as Windows Server 2003, you will need to install directly from the Web Deployment Tool download page. For these client or server 2003 machines the Web Management Service handler component and associated delegation rules will not be applicable. ### Trouble-shooting Common Issues: diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer.md b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer.md deleted file mode 100644 index 911227634..000000000 --- a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer.md +++ /dev/null @@ -1,206 +0,0 @@ ---- -title: "Using the Microsoft Web Platform Installer" -author: chrissfanos -description: "Introduction The Microsoft ® Web Platform Installer (Web PI) makes it easy for you to download, install, and keep up to date on the latest software component..." -ms.date: 03/18/2009 -ms.assetid: 00175a11-b9d6-4173-8a17-9be6178d208a -msc.legacyurl: /learn/install/web-platform-installer/using-the-microsoft-web-platform-installer -msc.type: authoredcontent ---- -# Using the Microsoft Web Platform Installer - -by [Chris Sfanos](https://github.com/chrissfanos) - -## Introduction - -The Microsoft® Web Platform Installer (Web PI) makes it easy for you to download, install, and keep up to date on the latest software components of the Microsoft® Web Platform for development and application hosting on the Windows® operating system. Web PI does the work of comparing the newest available components across the Microsoft Web Platform against what is already installed on your computer; you can see what is new and what you haven't yet installed. You can use Web PI to learn more about different components and install one or more components in a chained installation, with Web PI handling reboots and logging failures where applicable. The currently available software components include Microsoft WebMatrix, Internet Information Services (IIS), the latest versions of PHP 5.2 and PHP 5.3, Microsoft® SQL Server® 2008 R2 Express, the Microsoft®.NET Framework, and Microsoft® Visual Web Developer 2010 Express Edition with Service Pack 1. - -Web PI also provides an interface to the [Windows Web App Gallery](https://www.microsoft.com/web/gallery/), a community-driven hub of the most popular open-source and community Web applications that run on Windows. Accessible from anywhere through the Microsoft Web Platform site, the Windows Web App Gallery provides a streamlined way for users to explore, discover, and install Microsoft® ASP.NET, PHP, and other types of Web applications for the Windows operating system, providing Web developers with access to millions of Web users worldwide. The Windows Web App Gallery lets developers submit their own applications for inclusion; once accepted, a Web application can appear in Web PI for anyone to download. - -System requirements for Web PI include an Internet connection and one of the following supported operating systems: - -- Windows Server® 2008 R2 or Windows Server® 2008 -- Windows Server® 2003 Service Pack 2 (SP2) -- Windows Vista® Service Pack 2 (SP2) -- Windows® XP Service Pack 3 (SP3) -- Windows® 7 - -## Web PI for Hosters - -Web PI can help in the following scenarios: - -- Building reference machines used for the creation of images for dedicated or virtual dedicated offerings. -- Building the Web Server reference machine for a shared hosting environment. -- Updating existing machines with the latest components. -- Deploying an internal development or testing environment. -- Referring customers to use Web PI to setup their own dedicated machines or local environments for development and testing before deploying to hosted environments. - -## Web PI for Web Hosting Customers - -Web PI can help in the following scenarios: - -- Deploying a development environment with the entire Web Platform stack of components. Includes the latest Web, database, and development tools and technologies. -- Updating the development environment with the latest components. - -## Install the Web Platform - -Web PI automates the discovery and installation of the Microsoft Web Platform, which includes the Web Server, Frameworks and Runtimes, Database, and Tools sections. In version 3.0, the Microsoft Web Platform also installs the latest 5.2 and 5.3 versions of PHP. - -Download [Web PI](https://www.microsoft.com/web/Downloads/platform.aspx). WebPI starts up on the "Spotlight" tab, where we highlight products and applications that we think will be the most interesting for our users - -![Screenshot of the Web Platform Installer 3 displaying the Spotlight page.](using-the-microsoft-web-platform-installer/_static/image2.png "WebPI v3 Spotlight") - -###### Figure 1: "WebPI Spotlight" tab - -WebPI separates the components you can install into two main categories: Products and Applications. In the Products tab, you will find all the components you need to build and maintain your web sites. The Applications tab is home to our wide collection of open-source applications that you can use as a great starting place for developing your sites - -The "Products" tab shows the four main components: Server, Frameworks, Database and Tools. - -![Screenshot of the Web Platform Installer 3 displaying the Products page.](using-the-microsoft-web-platform-installer/_static/image4.png) - -###### Figure 2: "Products" tab - -### Server - -The Internet Information Services (IIS) Web server ships in the Windows client and server operating systems, providing a secure, easy-to-manage Web platform for reliably hosting rich Web applications and Web services. - -As of the IIS 7.0 release (which shipped in Windows Server 2008), IIS began using its new extensible architecture to release free Web extensions, such as the Web Deployment Tool and Database Manager. Microsoft fully supports these extensions for the lifetime of the operating system and also has plans of localizing the extensions for international customers. - -WebPI currently installs the latest IIS release (version 7.5, which shipped with Windows Server 2008 R2). - -Also included in WebPI is IIS Express 7.5, the lightweight self-contained version optimized for developers. IIS Express makes it easy to use the most current version of IIS to develop and test websites. It has all the core capabilities of IIS 7.5 as well as additional features designed to ease website development including: - -- It doesn't run as a service or require administrator user rights to perform most tasks -- IIS Express works well with ASP.NET and PHP applications -- Multiple users of IIS Express can work independently on the same computer - -Web PI simplifies the discovery and installation of Web server components by: - -- **Automatically configuring the IIS Web server components that ship in Windows.** On Windows 7 and Windows Vista, the Web server components are "Optional Windows Components." Optional Windows components are part of the Windows installation but are not activated until the user explicitly goes through the process of activating the IIS Windows feature. Likewise, with Windows Server® 2003 and Windows Server 2008, a systems administrator uses Server Manager to install the Web Server role (which installs IIS). With Web PI, setting up the Windows components involves selecting a single product entry -- **Automatically "discovering" IIS Extensions that ship on the Web.** - The IIS team ships extensions that expand the management and runtime capabilities of the IIS Web server and applications hosted on IIS. Users can select from the IIS Web extensions that appear alongside the IIS components that ship in Windows. This integration makes it easy to find and install the Web extensions that the IIS product team delivers on a quarterly basis. - -To see all the IIS components available for installation, just search for **IIS** or to install the recommended set, search for and install the **IIS 7 Recommended Configuration** - -![Screenshot of the Web Platform Installer 3 displaying the Search results for I I S page.](using-the-microsoft-web-platform-installer/_static/image10.png) - -###### Figure 3: Searching for IIS components in WebPI - -You can learn more about the IIS extension by double-clicking the extension name. For example, on the details page for an IIS component, you can learn more about what the extension does before installing it, and there are links to even more detailed descriptions. - -![Screenshot of the Web Platform Installer 3 displaying the I I S : F T P Publishing Service 7 dot 5 installation page.](using-the-microsoft-web-platform-installer/_static/image14.png) - -###### Figure 4: More information on the IIS: FTP Publishing Service 7.5 - -### Frameworks - -The Frameworks section provides developers with programming frameworks for application development. - -![Screenshot of the Web Platform Installer 3 displaying the Products page. The Frameworks section is selected.](using-the-microsoft-web-platform-installer/_static/image16.png) - -###### Figure 5: Frameworks - -Web Pl 3.0 currently installs the latest community PHP 5.2.and 5.3 from the community PHP download page. Web PI installs PHP along with the following optional PHP components: - -- [MySQL Extension](http://us3.php.net/mysql) -- [MySQL Improved Extension](http://us3.php.net/mysqli) -- [SQL Server Improved Extension](http://us3.php.net/mysqli) -- [Image Processing and GD](http://us3.php.net/gd) -- [Gettext extension](http://us3.php.net/gettext) -- [Client URL Library](http://us3.php.net/curl) -- [Exchangeable Image Information](http://us3.php.net/exif) -- [XML-RPC](http://us3.php.net/xmlrpc) -- [OpenSSL](http://us3.php.net/openssl) - -Web PI also installs ASP.NET MVC 3.0. ASP.NET is a powerful framework for building dynamic Web applications. As a programming framework, ASP.NET is adaptable to a wide variety of projects and development styles. ASP.NET is part of the .NET Framework, and when coding ASP.NET applications developers have access to the entire .NET Framework. The Model View Controller (MVC) extension enables users to build MVC applications by using the ASP.NET framework. - -### Database - -The Database section includes the SQL Server tools for application development and management. - -SQL Server 2008 R2 is a complete database engine providing ease of use and manageability for running high-performance Web applications. You can select SQL Server 2008 Express SP1 for a flexible runtime environment for database programming. - -SQL Server 2008 R2 Management Studio Express gives developers tools to more easily manage databases in development, staging, or production environments—you can use this option if the SQL Server Express runtime itself is already installed to simplify the management of databases. - -![Screenshot of the Web Platform Installer 3 displaying the Products page. The Database section is selected.](using-the-microsoft-web-platform-installer/_static/image18.png) - -###### Figure 6: Database - -The SQL Server 2008 R2 Management Objects gets pulled in as a dependency for some extensions and/or applications. (Typically, a user will not install this option.) - -Web PI includes the Microsoft® SQL Server® 2008 Driver v 2.0 for PHP, which enables reliable, scalable integration with SQL Server for PHP applications deployed on the Windows platform. The extension allows the reading and writing of data from within PHP scripts and provides a procedural interface for accessing data in all editions of SQL Server 2008 (including Express). The extension also supports the use of PHP streams to read and write large objects. Information, including the source code, is available on [CodePlex](http://www.codeplex.com/SQL2K5PHP). - -### Tools - -The Tools section provides developer tools to build Web applications for the Microsoft Web Platform. - -Visual Web Developer Express is a free Microsoft® Visual Studio® Web development environment for building and testing next-generation, standards-based Web applications and services. With full support for Web standards, JavaScript, and ASP.NET, Visual Web Developer Express enables developers to quickly build out new applications. - -The Microsoft® Silverlight™ 4 Tools for Visual Studio provide a development environment for Microsoft® Silverlight™ programmers. The Silverlight Tools are free add-ons to the free download version of Visual Web Developer Express or the full version of Microsoft® Visual Studio® 2010 SP1. - -![Screenshot of the Web Platform Installer 3 displaying the Products page.The tools section is selected.](using-the-microsoft-web-platform-installer/_static/image22.png) - -###### Figure 7: Tools - -## Install Applications from the Microsoft Web Application Gallery - -The Web Platform Installer 3.0 simplifies discovery and deployment of ASP.NET and PHP applications in the [Windows Web App Gallery](https://www.microsoft.com/web/gallery/). - -To learn more about the Web Application Gallery, see [Introducing the Windows Web Application Gallery](../../develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md). - -When an application is added to the Windows Web Application Gallery, the application integrates into an Atom feed which Web PI consumes; every time a user opens the Web Applications tab, the user sees the latest applications in the Web Application Gallery. - -![Screenshot of the Web Platform Installer 3 displaying the Applications page. The All section is selected.](using-the-microsoft-web-platform-installer/_static/image26.png) - -###### Figure 8: Web Applications - -By default, you see the full list of applications in the Windows Web Application Gallery. You can also browse by category to discover applications. These applications are free of charge (although the application provider can offer premium paid support) and follow the [Windows Web Application Gallery Principles](../../develop/windows-web-application-gallery/windows-web-application-gallery-principles.md) for running well on Windows. - -When you select an application, Web PI automatically installs the prerequisite Windows components and other components (such as PHP) to run the application. The list of required Web Platform dependencies for WordPress is displayed for you before installation. In this example, Wordpress is being installed on a Windows 7 machine. By default, WebPI will bring along Microsoft WebMatrix, a free, solid and reliable platform for customizing popular web applications - -The prerequisite information comes from the application developer. As part of the application submission process, the application provider gives Microsoft information such as a prerequisite environment and a URL to the Microsoft Web Deployment–enabled package. Web PI uses that information to make sure that the environment is set up properly to run the application on Windows, using the application package that is publicly available for download on the application community site. - -For more developer information on Web Application Gallery, see the [Windows Web App Gallery Developer site](https://www.microsoft.com/web/gallery/developer.aspx). - -## Best Practices for Using Web PI - -Follow these best practices to prevent errors or installation issues when using the Web PI. - -**Close all programs and restart your computer.** -The Web PI functions by running the setup for the selected applications one after the other, as in a chain. These setup programs are run "silently," meaning they run without displaying a user interface. In some cases, setup programs will block an installation if certain applications are running. For this reason, all applications should be closed or stopped. A simple way to do this is to restart your computer. If an application is configured to start when Windows starts, you will need to close it manually. - -Sometimes the Web PI encounters a problem due to a pending restart. Certain operations require a restart (for example, if system dynamic-link libraries (DLLs) are replaced by a system update or hotfix installation). Setup programs can, and do, block the installation when a restart is pending. - -**Keep Windows up to date.** -Make sure your operating system and the any applications or components that are already installed have been updated. Software that is out of date may cause issues for which the Web PI has not been tested. - -**Uninstall pre-release applications and components.** -Beta versions can create difficulty for installers because they use many of the same resources as the released version. For this reason, many setup programs block the installation of an application if a pre-released version is detected on the computer. - -**Avoid using the computer when installing Web PI.** -Modifying the state of the machine while an installation is in progress can cause the installation to fail. For example, when a setup program starts it determines whether there is enough hard disk space available to install the application. Running applications or performing other tasks during the installation may cause the hard disk to have less space available and cause the installation to fail. - -## Troubleshooting and Finding Help - -If you have an issue using the Web Platform Installer, visit the [Web Platform Installer forum](https://forums.iis.net/1155.aspx) for free, best-effort support by the product team, or review [Troubleshoot Microsoft Web Platform Installer Issues](../../troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md). - -Note that because Web PI brings together community applications, Microsoft Web Platform components, and PHP, issues may occur at: - -- Web PI level—usually based on proxies, since Web PI depends on accessing public URLs. -- Application package level—usually based on Web Deployment integration for application packaging. -- Application functionality—questions about how applications work are redirected by Microsoft to the community forums for that application. - -You can also refer to [Windows Web Application Gallery: Known Issues](../../develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md). - -> [!NOTE] -> *This article updates:*[Web Platform Installer 2.0 Walkthrough](../../web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md)*by the IIS Team, published on September 28, 2009.* - -## Links for Further Information - -- [Web Platform Installer Resources](web-platform-installer-resources.md). -- [Videocast: Simplified Application Deployment on the Microsoft Web Platform](../../publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform.md). -- [Real World IIS: Staying Current with the Latest Microsoft Web Platform with Web Platform Installer (videocast)](https://blogs.iis.net/mailant/archive/2009/05/02/real-world-iis-staying-current-with-the-latest-microsoft-web-platform-with-web-platform-installer-videocast.aspx). -- [Microsoft Web Platform](/iis/install/web-platform-installer/web-platform-installer-20-walkthrough). -- [Windows Web Application Gallery Principles](../../develop/windows-web-application-gallery/windows-web-application-gallery-principles.md). -- [Web Platform Installer](https://technet.microsoft.com/library/ee506569(WS.10).aspx). -- [Microsoft.Web.PlatformInstaller Namespace](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.aspx). diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.jpg deleted file mode 100644 index 577328eca..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.png deleted file mode 100644 index b12f08eeb..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image1.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image10.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image10.png deleted file mode 100644 index 2e01b1752..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image10.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image11.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image11.png deleted file mode 100644 index 2e01b1752..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image11.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image12.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image12.png deleted file mode 100644 index 8ed14f3a7..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image12.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image13.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image13.png deleted file mode 100644 index 8ed14f3a7..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image13.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image14.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image14.png deleted file mode 100644 index 256ce747f..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image14.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image15.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image15.png deleted file mode 100644 index 256ce747f..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image15.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image16.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image16.png deleted file mode 100644 index ef66e2dfc..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image16.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image17.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image17.png deleted file mode 100644 index ef66e2dfc..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image17.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image18.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image18.png deleted file mode 100644 index ce20f5b87..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image18.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image19.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image19.png deleted file mode 100644 index ce20f5b87..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image19.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.jpg deleted file mode 100644 index 577328eca..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.png deleted file mode 100644 index b12f08eeb..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image2.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image20.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image20.png deleted file mode 100644 index f16361f2e..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image20.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image21.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image21.png deleted file mode 100644 index f16361f2e..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image21.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image22.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image22.png deleted file mode 100644 index 3b4cfb0bd..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image22.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image23.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image23.png deleted file mode 100644 index 3b4cfb0bd..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image23.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image24.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image24.png deleted file mode 100644 index f599e3e95..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image24.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image25.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image25.png deleted file mode 100644 index f599e3e95..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image25.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image26.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image26.png deleted file mode 100644 index f17fefcb5..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image26.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image27.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image27.png deleted file mode 100644 index f17fefcb5..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image27.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.jpg deleted file mode 100644 index 3671e6053..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.png deleted file mode 100644 index b12f08eeb..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image3.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.jpg deleted file mode 100644 index 027d75a64..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.png deleted file mode 100644 index 1283016bd..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image4.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.jpg deleted file mode 100644 index f4274be78..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.png deleted file mode 100644 index 1283016bd..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image5.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.jpg deleted file mode 100644 index 54781dff2..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.png deleted file mode 100644 index 7ec67b83e..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image6.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.jpg deleted file mode 100644 index d323c1040..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.png deleted file mode 100644 index 7ec67b83e..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image7.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.jpg b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.jpg deleted file mode 100644 index 722d8a64d..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.jpg and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.png deleted file mode 100644 index 7ef30739b..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image8.png and /dev/null differ diff --git a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image9.png b/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image9.png deleted file mode 100644 index 7ef30739b..000000000 Binary files a/iis/install/web-platform-installer/using-the-microsoft-web-platform-installer/_static/image9.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough.md b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough.md deleted file mode 100644 index 78fc6905f..000000000 --- a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough.md +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: "Web Platform Installer 2.0 Walkthrough" -author: crystalhoyer -description: "The Microsoft Web Platform Installer (Web PI) is a free tool that makes it simple to download and install the latest components of the Microsoft Web Platform..." -ms.date: 11/09/2008 -ms.assetid: 033c92fb-3c1e-403c-8a96-0f4fed1369cb -msc.legacyurl: /learn/install/web-platform-installer/web-platform-installer-20-walkthrough -msc.type: authoredcontent ---- -# Web Platform Installer 2.0 Walkthrough - -by [Crystal Hoyer](https://github.com/crystalhoyer) - -The Microsoft Web Platform Installer (Web PI) is a free tool that makes it simple to download and install the latest components of the Microsoft Web Platform, including the IIS, SQL Server Express, .NET Framework, and Visual Web Developer. To help you stay up-to-date with product releases, the Web Platform Installer tool always installs the latest version of Web Platform components as well as new additions to the Microsoft Web Platform. - -The software offered through Web PI is free to download, and can be installed on a computer that is running Windows XP SP2+, Windows Vista, Windows Vista SP1, Windows 7, Windows Server 2003 SP1+, Windows Server 2008, and Windows Server 2008 R2. - -## Installing and Starting the Web PI - -To get started, you need to download and install the Web Platform Installer. To install the Web PI, select one of the following options: - -1. Visit the newly designed Web PI download site. -2. View the following terms and then click **Install Now**. - - By clicking **Install Now** and by using the Web PI, you agree to the [terms of use](https://go.microsoft.com/?linkid=9546162 "terms of use") for the Microsoft Web Platform Installer. The Web PI will contact Microsoft over the Internet to retrieve product information. - - [Install Now](https://www.microsoft.com/web/downloads/platform.aspx) - - When the installation is completed, to start the Web PI, in the Windows **Start** menu, click **All Programs**, and then click **Microsoft Web Platform Installer**. - -## Customizing the Web PI - -By default, the Web PI displays the following tabs: **What's New**, **Web Platform**, and **Web Applications**. You can also use the Web PI to install Developer Tools and components of the Media Platform, such as IIS Media Services and Application Request Routing. To display the **Media Platform** and **Developer Tools** tabs, click **Options**, displayed in the lower left corner of the Web PI interface. - -![Screenshot of Web P I Window. The What's New tab is displayed. The options link is circled.](web-platform-installer-20-walkthrough/_static/image1.png) - -The **Change Options** dialog box is displayed. - -![Screenshot of the Web P I change options dialog box.](web-platform-installer-20-walkthrough/_static/image3.png) - -Select the check box for the **Media** and/or **Developer Tools** to display those tabs in the Web PI interface, and then click **OK**. The tabs are then displayed when the Web PI interface refreshes. - -You can also specify the language you want displayed in the Web PI and configure settings for the Installer cache. - -## Selecting the applications you want to install - -Select the tab that describes the type of products you want to install. - -### What's New tab - -Products listed on the **What's New** tab include products that have been released in the last few months. - -![Screenshot of the Web P I What's New tab.](web-platform-installer-20-walkthrough/_static/image5.png) - -### Web Platform tab - -The **Web Platform** tab includes the products and components that comprise the Microsoft Web Platform. The Web PI automates the discovery and installation of the Microsoft Web Platform components, which includes the Web Server, Frameworks and Runtimes, Database, and Tools sections. In version 2.0, the Microsoft Web Platform also installs PHP version 5.2.9-2, by using the publicly available Windows installer for PHP. - -![Screenshot of the Web P I Web Platform tab with products listed.](web-platform-installer-20-walkthrough/_static/image7.png) - -A green checkmark next to a category indicates that all the recommended products for that category are already installed on your computer. To select specific products or components for a category, click **Customize**. - -![Screenshot of the Web P I Web Platform tab with customization options listed.](web-platform-installer-20-walkthrough/_static/image9.png) - -Click **Back to the Web Platform** after you select the applications you want to install. - -### Web Applications tab - -The **Web Applications** tab includes popular community ASP.Net and PHP applications. - -![Screenshot of the Web P I Web Applications Tab displaying list of applications. The A to Z sort tab is highlighted.](web-platform-installer-20-walkthrough/_static/image11.png) - -You can change the sort order of the applications by using the buttons displayed at the top of the page. - -Click **A to Z** to sort alphabetically by application name. - -Click **Most Popular** to display the most downloaded applications at the top of the list. - -Click **Highest Rating** to display the applications with the highest average user rating first. - -Click on a tab to display only the applications in that category. You can sort applications within each category as well. - -### Media Platform tab - -The **Media Platform** tab displays IIS Media Services and related components. - -![Screenshot of the Web P I Media Platform tab displaying I I S Media Services.](web-platform-installer-20-walkthrough/_static/image13.png) - -### Developer Tools tab - -The **Developer Tools** tab displays tools for developing Web applications, including Visual Studio tools and a trial version of the latest release of Microsoft Expression Studio. - -![Screenshot of the Web P I Developer Tools tab with available applications listed.](web-platform-installer-20-walkthrough/_static/image15.png) - -## Confirm your selections and accept the license agreement - -After you select the products and applications you want, click **Install**. The **Web Platform Installation** page displays the products you selected as well as any required dependencies. When you select a product or application, the Web PI automatically adds the dependencies for those products to the list of products to install. - -![Screenshot of the Web Platform Installation page displaying selected products and dependencies to install. The I Accept button is highlighted.](web-platform-installer-20-walkthrough/_static/image17.png) - -If you do not agree with the license terms, click **I Decline** to cancel the installation. - -Click **I Accept** to agree with the license terms for each selected product or application and begin the installation. - -![Screenshot of the Web P I window displaying download and install progress bars.](web-platform-installer-20-walkthrough/_static/image19.png) - -Most of the products that are offered in the Web PI do not require any further input from you and will seamlessly download and install. However, if a product requires input, a dialog box is displayed and you must then enter the information for that product's installation. For example, some applications ask for an application name and a Web site name as part of the installation process. - -## Finishing the installation - -When the Web PI completes the installation of the products that you selected, a page is displayed that indicates the status of the installation. If any products did not successfully install, an indication of the cause for the error is displayed, as well as a link to get more information. - -After you have reviewed the information, click **Finish** to close the Web PI. - -Congratulations, you have now successfully downloaded and installed the Microsoft Web Platform through the Web PI. Run the tool again to see what new products have been added as we will continually add new products as they are released. - -## Where to get more information - -To learn more about the Microsoft Web Platform, visit the [Microsoft Web Platform](/iis/install/web-platform-installer/web-platform-installer-20-walkthrough) page. - -To learn more about the Microsoft Web Platform Installer, visit the Web Platform Installer page on IIS.net. - -To learn more about the Web PI schema, see the [Web Platform Installer Schema Reference](https://technet.microsoft.com/library/ee506569(WS.10).aspx). - -To view the Web PI API documentation, see the [Microsoft.Web.PlatformInstaller Namespace](https://msdn.microsoft.com/library/microsoft.web.platforminstaller.aspx) article on MSDN. - -For troubleshooting information, including a list of known issues with the Web PI, see [Troubleshooting Problems with Web Platform Installer 2.0](../../troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md) on IIS.net. diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image1.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image1.png deleted file mode 100644 index cbf1ed5d8..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image1.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image10.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image10.png deleted file mode 100644 index 9058158f2..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image10.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image11.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image11.png deleted file mode 100644 index d2a839434..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image11.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image12.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image12.png deleted file mode 100644 index d2a839434..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image12.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image13.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image13.png deleted file mode 100644 index 4ddc8c942..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image13.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image14.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image14.png deleted file mode 100644 index 4ddc8c942..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image14.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image15.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image15.png deleted file mode 100644 index 6a2c91540..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image15.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image16.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image16.png deleted file mode 100644 index 6a2c91540..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image16.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image17.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image17.png deleted file mode 100644 index 77328b041..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image17.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image18.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image18.png deleted file mode 100644 index 77328b041..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image18.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image19.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image19.png deleted file mode 100644 index b46c80779..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image19.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image2.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image2.png deleted file mode 100644 index cbf1ed5d8..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image2.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image20.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image20.png deleted file mode 100644 index b46c80779..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image20.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image3.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image3.png deleted file mode 100644 index d05216c10..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image3.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image4.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image4.png deleted file mode 100644 index d05216c10..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image4.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image5.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image5.png deleted file mode 100644 index 73ed03fa5..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image5.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image6.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image6.png deleted file mode 100644 index 73ed03fa5..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image6.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image7.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image7.png deleted file mode 100644 index e4876c11d..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image7.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image8.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image8.png deleted file mode 100644 index e4876c11d..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image8.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image9.png b/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image9.png deleted file mode 100644 index 9058158f2..000000000 Binary files a/iis/install/web-platform-installer/web-platform-installer-20-walkthrough/_static/image9.png and /dev/null differ diff --git a/iis/install/web-platform-installer/web-platform-installer-direct-downloads.md b/iis/install/web-platform-installer/web-platform-installer-direct-downloads.md deleted file mode 100644 index aee747701..000000000 --- a/iis/install/web-platform-installer/web-platform-installer-direct-downloads.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: "Web Platform Installer Direct Downloads" -author: chrissfanos -description: "Direct download links for Web Platform Installer (WebPI)" -ms.date: 02/20/2015 -ms.assetid: 4003c4b8-ccd1-43d7-a5d5-45ab60e7ed91 -msc.legacyurl: /learn/install/web-platform-installer/web-platform-installer-direct-downloads -msc.type: authoredcontent ---- -# Web Platform Installer Direct Downloads - -by [Chris Sfanos](https://github.com/chrissfanos) - -**WebPI Direct Download Links** - - In some cases, it may be helpful to be able to download the Web Platform Installer directly rather than using the launcher to get started. The following links are for the current version, WebPI 5.1: - -**WebPI 5.1** - - x86: [WebPI 5.1 x86 MSI](https://go.microsoft.com/fwlink/?LinkId=287165) - - x64: [WebPI 5.1 x64 MSI](https://go.microsoft.com/fwlink/?LinkId=287166) diff --git a/iis/install/web-platform-installer/web-platform-installer-resources.md b/iis/install/web-platform-installer/web-platform-installer-resources.md deleted file mode 100644 index 6a33f09f7..000000000 --- a/iis/install/web-platform-installer/web-platform-installer-resources.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "Web Platform Installer Resources" -author: chrissfanos -description: "Welcome to Web Platform Installer Resources! This article provides a list of resources to help you find answers and help when using the Web Platform Installe..." -ms.date: 03/18/2009 -ms.assetid: 9a2a5b56-7848-4dc1-ad0a-faf1d35132cb -msc.legacyurl: /learn/install/web-platform-installer/web-platform-installer-resources -msc.type: authoredcontent ---- -# Web Platform Installer Resources - -by [Chris Sfanos](https://github.com/chrissfanos) - -Welcome to Web Platform Installer Resources! This article provides a list of resources to help you find answers and help when using the Web Platform Installer. - -## Users - -- To learn more about the Web Platform Installer, see [Introducing the Web Platform Installer](using-the-microsoft-web-platform-installer.md). -- If you want to find out more about the Web Application Gallery, see [Introducing the Web Application Gallery](../../develop/windows-web-application-gallery/introducing-the-windows-web-application-gallery.md). You can also visit the [Web Application Gallery forum](https://forums.iis.net/1159.aspx "Web Application Gallery: Users forum") for free, best effort support. -- If you are looking for help with installing the Web Platform or applications using Web Platform Installer 3.0, visit the [IIS.NET Web Platform Installer forum](https://forums.iis.net/1155.aspx "Web Platform Installer Forum") for free, best effort support. You can also review the [Known Issues with Web Application Gallery](../../develop/windows-web-application-gallery/windows-web-application-gallery-known-issues.md) or see [Troubleshooting Problems with Web Platform Installer 3.0](../../troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer.md). -- If you want to learn how to set up MySQL to work with applications installed by Web Platform Installer 3.0, see the [step-by-step walkthrough of Installing MySQL 5.1](../../application-frameworks/install-and-configure-php-on-iis/walkthrough-set-up-mysql-51-for-php-applications.md). - -## Developers - -- If you want to learn more about optimizing PHP applications on IIS, see [Running PHP Applications on IIS](../../application-frameworks/running-php-applications-on-iis/index.md). -- If you want to learn more about optimizing ASP.NET applications on IIS, see [Running ASP.NET Applications](../../application-frameworks/building-and-running-aspnet-applications/index.md). You can also start from the [ASP.NET Technical Resources](../../application-frameworks/building-and-running-aspnet-applications/aspnet-technical-resources.md) article. -- If you want to learn more about Web Application Gallery integration, see the [Web Application Gallery Developer](https://www.microsoft.com/web/gallery/developer.aspx "Web Application Gallery Developer site") site to get started. -- If you want to learn about extending control panels and other hosts with the Web Application Gallery, see [Integrating the Web Application Gallery](../../develop/windows-web-application-gallery/integrate-the-windows-web-application-gallery-into-a-control-panel.md). diff --git a/iis/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release.md b/iis/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release.md deleted file mode 100644 index 89ef82615..000000000 --- a/iis/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release.md +++ /dev/null @@ -1,238 +0,0 @@ ---- -title: "Web Platform Installer v5.1 Command Line (WebPICMD.exe) - RTW release" -author: chrissfanos -description: "The Web Platform Installer v5.1 (WebPI) command line tool is now available as part of the WebPI MSI! We've added a bunch of new features and fix several issues..." -ms.date: 08/27/2012 -ms.assetid: d0440577-9e53-4202-9df3-199bc567e1c1 -msc.legacyurl: /learn/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release -msc.type: authoredcontent ---- -# Web Platform Installer v5.1 Command Line (WebPICMD.exe) - RTW release - -by [Chris Sfanos](https://github.com/chrissfanos) - -## WebPI Command line - -The Web Platform Installer v5.1 (WebPI) command line tool is now available as part of the WebPI MSI! We've added a bunch of new features and fix several issues, and now it's ready for it's full release - -For those of you who aren't familiar with WebPI, it's a great little tool for deploying your favorite open-source applications and all the necessary platform components required to get you up and running quickly and seamlessly. Over the years, we've heard a lot of feedback from the community about fully supporting a command line version of the tool - users want to script installs and automate deployment of servers. - -## Downloading WebPI - -You can download WebPI v5 RTW (and the included WebPICMD.exe) from the links below: - -**By downloading and using the Web Platform Installer (WebPI), you agree to the *[license terms](https://go.microsoft.com/fwlink/?LinkId=251729)* and *[privacy statement](https://go.microsoft.com/fwlink/?LinkId=251732)* for WebPI. This installer will contact Microsoft over the Internet to retrieve product information. Some of the Microsoft software obtained through WebPI may use Microsoft's Customer Experience Improvement Program (CEIP).** - -WebPI v5.1 [x86](https://download.microsoft.com/download/8/4/9/849DBCF2-DFD9-49F5-9A19-9AEE5B29341A/WebPlatformInstaller_x86_en-US.msi) - -WebPI v5.1 [x64](https://download.microsoft.com/download/8/4/9/849DBCF2-DFD9-49F5-9A19-9AEE5B29341A/WebPlatformInstaller_x64_en-US.msi) - -## Setting up WebPICMD.exe - -Just run the installer and that's it - you'll find WebPICMD.exe in the `%programfiles%\microsoft\web platform installer` directory - -## Using WebPICMD.exe - -WebPICMD.exe has three main modes of operation that you can use - you specify the mode with the first switch on the command line. - -The three modes are: - -1. /List: Used to display the list of products available, installed and return information about the various XML feeds -2. /Install: Used to install products or applications to your machine -3. /Offline [NEW!] Creates an offline cached copy of a specified set of products and applications so you can install while offline - -Let's walk through each mode and describe the command line options in more detail and give a few examples to help you get started! - -### /List mode - -Here's the full set of list mode parameters: - -/List /ListOption:[All | Available | Feeds | Installed | Languages] - -##### Let's try looking at the "All" option - -Ex: >WebPICMD.exe /List /ListOption:All - -This returns the list of installed products as well as the list of available products and applications for your machine - -##### Curious as to what feeds WebPICMD.exe is loading? Let's try the "Feeds" option - -Ex: >WebPICMD.exe /List /ListOption:Feeds - -This returns the 5 feeds that WebPI is currently loading and the URL where the live - -##### Curious as to what languages WebPICMD.exe supports? Let's try the "Languages" option - -Ex: >WebPICMD.exe /List /ListOption:Languages - -This returns the list of languages and their associated language IDs - -### /Install mode - -Install mode is just that - it allows you to select a set of products and/or an application that you want to install. This is great if you need to configure a set of machines with the same set of products - WebPICMD.exe will handle only installing the items that you need and you don't have to run the UX each time! - -#### Installing Products - -Here's how installing Products works - you just specify the /Products switch and then a comma delimited set of product IDs (not sure which ID to use? Use the **/List /ListOption:Available** to see all the available products for your machine - -Ex: >WebPICMD.exe /Install /Products:MVC3,WebMatrix - -In the above example, we are installing MVC3 and WebMatrix. WebPICMD.exe will calculate all the required dependencies for both products and install all of them in advance of installing MVC3 and WebMatrix. It's that easy! - -> [!NOTE] -> If you are scripting this out in PowerShell, you'll need to put quotes (" ") around the productIDs (so in the example above, it would look like: - -Ex: >WebPICMD.exe /Install /Products:"MVC3,WebMatrix" - -#### Installing Applications - -Here's the full set of install mode parameters: - -*Required* - -/Install /Application:<ID or Title> - -Here's how installing Applications works - you just specify the /Application switch and then product ID (or title) of the application. - -Ex: >WebPICMD.exe /Install /Application:DotNetNuke - -This example installs DotNetNuke - the install will be required to answer all the application parameters inputs during the installation process - -##### Optional Parameters for /Install - -The /Install mode has several optional parameters for automating the installation - -/XML:<FilePath> Absolute path or URL for the XML feed - this overrides the main WebProductList.xml feed - -/Feeds:<Custom Feed URI> Comma separated list of custom XML feeds that you want to load in addition to the main WebPI feeds - -/Language:<languageID> Language of installers to be used. - -/Log:<LogPath> Path to log the results of your installation - -/SQLPassword:<password> When installing SQL Express, allows you to pass the desired SA password to set - -/MySQLPassword:<password> When installing MySQL, allows you to pass the desired root password to set - -/SuppressReboot Suppress any required reboots - the user will need to reboot manually - -/ForceReboot Reboot automatically without prompting the user - -/AcceptEULA Suppress I Accept/I Decline. Using this switch *is the same as accepting ALL EULAs* - -/IISExpress Install applications to IIS Express (WebMatrix) - default is to always install to IIS - -@[Paramfile.app] Per application answer file - -Now let's take a look at a few more examples of /Install using some of the optional parameters - -##### Installing SQL Express and passing the SA password - -Ex: >WebPICMD.exe /Install /Products:SQLExpress /SQLPassword:ILoveaGoodPassword! - -##### Installing WebMatrix while Accepting the EULA and installing in Russian - -Ex: >WebPICMD.exe /Install /Products:WebMatrix /AcceptEula /Language:ru - -##### Installing an application to WebMatrix - -Ex: >WebPICMD.exe /Install /Application:DotNetNuke /IISExpress - -### /Offline mode [NEW!] - -Offline mode is a brand new feature (so treat it gently) that provides the ability to create an offline cache of products or applications and automatically updated XML feeds to refer to the newly downloaded versions (instead of the live versions). We also download icons so the experience offline is seamless for the user - -Here's how the offline mode works in a nutshell: - -1. Run WebPICMD.exe and specify the products you want to make available offline -2. WebPICMD.exe calculates ALL the possible dependencies (independent of what is installed on your machine today) and builds a complete install plan -3. WebPICMD.exe then downloads all the installers as well as the WebPI XML feeds and stores them locally -4. Finally, WebPICMD.exe parses the newly downloaded feeds and: 1) removes all the products not currently available offline and 2) replaces the URLs of the offline products with the new local URI - -I'll cover the available options in the current release and then discuss at set of known issues/improvements we'd like to make going forward :-) - -#### Creating an offline cache of products - -Here's the full set of offline mode parameters: - -*Required* - -/Offline /Products:[All | productID] /Path:<offline-directory-location] - -(you can also do a comma delimited list of products) - -**A word of warning about the "All" option**: It does what it says - it will create an offline cache with *everything* in the WebPI feed. That's a lot of stuff. And it's probably going to take a long while. Use it with great care. - -Now let's see it in action: - -Ex: `> WebPICMD.exe /Offline /Products:WebMatrix,SQLExpress /Path:c:\OfflineCache` - -The above will create an offline cache at `c:\offlineCache` that contains WebMatrix and all it's possible dependencies! - -##### Optional Parameters for /Offline - -The /Offline mode has several optional parameters - -/XML:<FilePath> Absolute path or URL for the XML feed - this overrides the main WebProductList.xml feed - -/Feeds:<custom feed URI> List of URIs to load in addition to the main WebPI feed for creating offline cache with your own products - -/Language:<languageId> Languages you want to download (default: English only) - -/Url:<url path> Substitute a URL path (instead of a file path) when creating the updated install locations in the feed - -Now let's take a look at a few more examples of /Offline using some of the optional parameters - -##### Setting up the offline cache on a file share - -Ex: >WebPICMD.exe /Offline /Products:WebMatrix,MVC3 /Path:\\testserver\public - -In the above example, we created our offline cache on a public server that we can share out with other users - -##### Setting up the offline cache that includes your own products - -Ex: `> WebPICMD.exe /Offline /Products:SQLExpress,MyCompanyProduct /Feeds:c:\myproductfeed.xml /Path:c:\MyOfflineCache` - -Now I can add my own products to the cache for use offline - -#### More details about the offline cache - -The offline cache sets up a directory structure as described below that contains everything you need to take your installation offline, including a copy of WebPICMD.exe itself. I'll describe the directories, what's inside them and talk a little bit more about how you might want to use it - -/Offline creates four directories when setting up an offline cache: - -/bin Contains WebPICMD.exe and the Microsoft.Web.PlatformInstaller.dll - -/feeds Contains the modified feeds (shadow-<originalfeedname>.xml) as well as a subdirectory of original feeds - -/installers Contains subdirectories for each installer that is part of the offline cache - -/resources Contains the /icons and associated subdirectories for each product and their WebPI icon - -#### Take the offline cache on the road with you ... or give it to a friend - -One of the key features we wanted to enable for the Offline cache was the ability to put your cache "on a stick" and pass it around to your friends or coworkers. That's why we have the /bin directory and more importantly, why we introduced the concept of "relativeURLs" in the feed. If you open the modified XML file and find the first product entry, you'll see an <installerURL> element that contains the full path to the offline cached version of the installer. But you'll also notice the new <relativeInstallerURL> attribute - this new attribute is a relative path to the installer based on the known directory structure. - -What does that mean? If you copy the full directory structure (let's say it was on c:\) to a USB key and hand it over to a friend and they fire it up, the full path won't be valid anymore (their USB key will be g: or some other drive). But the relativeURL doesn't care - it works off the relative paths and installs will still work. So your friend can use it with WebPICMD.exe! - -#### Enabling WebPI (UX) to use a custom "main" feed - -One of the great opportunities for the offline cache is to point the WebPI UX version to the new feed and offer it to users who do not have internet access. These users will only see the products available offline and can have a complete and seamless experience. To enable this, please do the following: - -1. Click the Options link in the WebPI UX -2. Browse/enter the full path to the offline feed in the **Primary Feed** (not Custom Feed) box -3. Click OK - that's it! - -#### Future features for offline and your feedback - -This is the first preview release of the new /Offline cache support and therefore it's not feature complete - below are a list of some features we are considering. We'd like to hear from you though - are these features important? What other features should be add? - -What do you think? Our friends on the WebMatrix team are sharing their UserVoice site to help us collect feedback - you can access that site here: `http://webmatrix.uservoice.com/forums/128313-webmatrix-suggestions` - -#### Wrap up - -If you've made it this far - thanks! We hope you find WebPICMD.exe useful - we are excited about the new features and look forward to delivering upcoming versions with the help of your feedback! - -Thanks - -WebPICMD.exe Team diff --git a/iis/manage/configuring-security/configure-request-filtering-in-iis.md b/iis/manage/configuring-security/configure-request-filtering-in-iis.md index 9e5264e20..7dd89757d 100644 --- a/iis/manage/configuring-security/configure-request-filtering-in-iis.md +++ b/iis/manage/configuring-security/configure-request-filtering-in-iis.md @@ -354,7 +354,6 @@ The following table shows the request filter error codes that you see in the log - [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) - [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) - [Build a Static Website on IIS](../creating-websites/scenario-build-a-static-website-on-iis.md) -- [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) - [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) - [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) - [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/manage/configuring-security/iis-8-certificate-management-and-deployment.md b/iis/manage/configuring-security/iis-8-certificate-management-and-deployment.md deleted file mode 100644 index bbdee18dc..000000000 --- a/iis/manage/configuring-security/iis-8-certificate-management-and-deployment.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "IIS 8 - Certificate Management and Deployment" -author: shauneagan -description: "Shaun Eagan describes the performance and management improvement for certificates in IIS 8." -ms.date: 09/19/2013 -ms.assetid: 07353f2d-9a24-4069-9e93-5696727ad89c -msc.legacyurl: /learn/manage/configuring-security/iis-8-certificate-management-and-deployment -msc.type: video ---- -# IIS 8 - Certificate Management and Deployment - -by [Shaun Eagan](https://github.com/shauneagan) - -Shaun Eagan describes the performance and management improvement for certificates in IIS 8. diff --git a/iis/manage/configuring-security/iis-8-sandboxing-and-security.md b/iis/manage/configuring-security/iis-8-sandboxing-and-security.md deleted file mode 100644 index c27faa285..000000000 --- a/iis/manage/configuring-security/iis-8-sandboxing-and-security.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "IIS 8 - Sandboxing and Security" -author: rmcmurray -description: "Robert McMurray covers the sandboxing and security features in IIS 8." -ms.date: 09/19/2013 -ms.assetid: 03067dff-c8e2-4be3-913b-627e391615ec -msc.legacyurl: /learn/manage/configuring-security/iis-8-sandboxing-and-security -msc.type: video ---- -# IIS 8 - Sandboxing and Security - -by [Robert McMurray](https://github.com/rmcmurray) - -Robert McMurray covers the sandboxing and security features in IIS 8. diff --git a/iis/manage/creating-websites/scenario-build-a-static-website-on-iis.md b/iis/manage/creating-websites/scenario-build-a-static-website-on-iis.md index d1e6f4773..7b0cf37f6 100644 --- a/iis/manage/creating-websites/scenario-build-a-static-website-on-iis.md +++ b/iis/manage/creating-websites/scenario-build-a-static-website-on-iis.md @@ -28,9 +28,7 @@ To get the most from this tutorial, you must have access to a computer that is r ## Step 1: Install the IIS Web Server -You can use the Web Platform Installer (Web PI) to install IIS and applications that run on IIS. The Web PI installs the latest versions of web platform offerings, including updates. To learn more about the Web PI, see [Learn more and install the Web PI](https://go.microsoft.com/fwlink/?LinkID=145510). If you use the Web PI to install IIS, you can skip to step 2. - -You can also perform this procedure by using the Windows user interface (UI) or from a command line. +You can perform this procedure by using the Windows user interface (UI) or from a command line. ### To install IIS on Windows Server 2012 by using the UI @@ -223,6 +221,5 @@ Test your website thoroughly to ensure that it functions as expected. Then consi - [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) - [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) - [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) -- [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) - [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) - [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) diff --git a/iis/manage/managing-performance-settings/configure-iis-7-output-caching.md b/iis/manage/managing-performance-settings/configure-iis-7-output-caching.md index 4a8c0a9a9..100c527ed 100644 --- a/iis/manage/managing-performance-settings/configure-iis-7-output-caching.md +++ b/iis/manage/managing-performance-settings/configure-iis-7-output-caching.md @@ -141,4 +141,3 @@ You can set the output cache to cache only your default page (the most frequentl ## See also - [IIS Output Caching](walkthrough-iis-output-caching.md) -- [PHP on IIS7 w/FastCGI](https://blogs.iis.net/bills/archive/2006/10/31/PHP-on-IIS.aspx) diff --git a/iis/manage/managing-performance-settings/using-wsrm-to-manage-iis-7-apppool-cpu-utilization.md b/iis/manage/managing-performance-settings/using-wsrm-to-manage-iis-7-apppool-cpu-utilization.md index 8eb53758d..130f53ba0 100644 --- a/iis/manage/managing-performance-settings/using-wsrm-to-manage-iis-7-apppool-cpu-utilization.md +++ b/iis/manage/managing-performance-settings/using-wsrm-to-manage-iis-7-apppool-cpu-utilization.md @@ -43,7 +43,7 @@ WSRM integrates resource management with Web pools through a built-in policy cal d. If prompted to disable the calendar, click OK ![Screenshot of the warning message that displays before disabling the calendar.](using-wsrm-to-manage-iis-7-apppool-cpu-utilization/_static/image9.jpg) - e. Observe the behavior of the system under an IIS load. You could use WCAT for simulating a load on the server. This tools is part of IIS 6.0 Resource Kit which can be downloaded from the following link: . + e. Observe the behavior of the system under an IIS load. You could use WCAT for simulating a load on the server. This tool is part of IIS 6.0 Resource Kit. ## Creating a Custom IIS Policy (Optional) diff --git a/iis/manage/managing-performance-settings/walkthrough-iis-output-caching.md b/iis/manage/managing-performance-settings/walkthrough-iis-output-caching.md index 1bced374e..79db57036 100644 --- a/iis/manage/managing-performance-settings/walkthrough-iis-output-caching.md +++ b/iis/manage/managing-performance-settings/walkthrough-iis-output-caching.md @@ -89,7 +89,7 @@ Then we add Output Caching to regain performance degradation incurred by adding Once the JPG Copyright Handler works, we must determine how fast our code is. Install an IIS 6.0 Resource Kit Tool to run performance tests: -1. Download the [IIS 6.0 Resource Kit Tools](https://www.microsoft.com/downloads/details.aspx?FamilyID=56fc92ee-a71a-4c73-b628-ade629c89499&DisplayLang=en) and install them. Do a custom install and install only the Web Capacity Analysis Tool (WCAT). WCAT is the only feature of the IIS 6.0 Resource Kit Tools we need to do our performance tests. +1. Download the IIS 6.0 Resource Kit Tools and install them. Do a custom install and install only the Web Capacity Analysis Tool (WCAT). WCAT is the only feature of the IIS 6.0 Resource Kit Tools we need to do our performance tests. > [!NOTE] > Due to the high Internet Explorer security settings on Windows Server 2008, you might get a security dialog box telling you that the web-site is blocked. To download the IIS 6.0 Resource Kit, add \*.microsoft.com to the list of trusted sites. diff --git a/iis/manage/managing-your-configuration-settings/shared-configuration_264.md b/iis/manage/managing-your-configuration-settings/shared-configuration_264.md index 8e0d45e43..7ac01c481 100644 --- a/iis/manage/managing-your-configuration-settings/shared-configuration_264.md +++ b/iis/manage/managing-your-configuration-settings/shared-configuration_264.md @@ -1,5 +1,5 @@ --- -title: "Shared Configuration" +title: "Shared Configuration with IIS 7" author: rick-anderson description: "The Internet changes the ways in which companies handle their day-to-day business and how they compete in the marketplace. With the advent of new Web technol..." ms.date: 12/10/2007 @@ -7,7 +7,7 @@ ms.assetid: cd23d12b-4c44-4e80-bdaf-163c3f03632e msc.legacyurl: /learn/manage/managing-your-configuration-settings/shared-configuration_264 msc.type: authoredcontent --- -# Shared Configuration +# Shared Configuration with IIS 7 ## Introduction diff --git a/iis/manage/powershell/installing-the-iis-powershell-snap-in.md b/iis/manage/powershell/installing-the-iis-powershell-snap-in.md index d4673e0e2..1633abbaf 100644 --- a/iis/manage/powershell/installing-the-iis-powershell-snap-in.md +++ b/iis/manage/powershell/installing-the-iis-powershell-snap-in.md @@ -24,7 +24,7 @@ The IIS PowerShell Snap-in requires the following prerequisites: ### To install IIS PowerShell Snap-in: -1. The IIS PowerShell Snap-in is available as x86 and x64 version. Download the [32-Bit version](https://iis-umbraco.azurewebsites.net/downloads "32-Bit IIS 7.0 PowerShell Provider") or [64-Bit version](https://iis-umbraco.azurewebsites.net/downloads "64-Bit PowerShell Provider"). +1. Download IIS PowerShell Snap-in x86 or x64 version. 2. Run the MSI file to install the IIS PowerShell Snap-in. ### To use the IIS PowerShell Snap-in diff --git a/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis.md b/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis.md index 339cbf5fa..47989065f 100644 --- a/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis.md +++ b/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis.md @@ -212,7 +212,6 @@ You can perform this procedure by using the user interface (UI), or by editing c - [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) - [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) - [Build a Static Website on IIS](../creating-websites/scenario-build-a-static-website-on-iis.md) -- [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) - [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) - [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) - [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) diff --git a/iis/manage/provisioning-and-managing-iis/installing-iis-modules-in-shared-configuration-environments.md b/iis/manage/provisioning-and-managing-iis/installing-iis-modules-in-shared-configuration-environments.md index 5db267b23..72c731b52 100644 --- a/iis/manage/provisioning-and-managing-iis/installing-iis-modules-in-shared-configuration-environments.md +++ b/iis/manage/provisioning-and-managing-iis/installing-iis-modules-in-shared-configuration-environments.md @@ -39,7 +39,7 @@ This is accomplished through the IIS Manager UI and Command line prompt. See art ## Step 4 - Install the IIS Module in server 1 -Use Web Platform Installer to install the new IIS Modules: [https://www.microsoft.com/web/downloads/platform.aspx](https://www.microsoft.com/web/downloads/platform.aspx) +Install IIS modules manually. ## Step 5 – Export the configuration from server 1 to a new shared configuration location diff --git a/iis/manage/provisioning-and-managing-iis/setting-up-components.md b/iis/manage/provisioning-and-managing-iis/setting-up-components.md index 7948dfb83..4348790a0 100644 --- a/iis/manage/provisioning-and-managing-iis/setting-up-components.md +++ b/iis/manage/provisioning-and-managing-iis/setting-up-components.md @@ -15,10 +15,9 @@ by [Walter Oliver](https://github.com/walterov) From an implementation standpoint, the solution follows recommended patterns and practices for building Web Services using the Windows Communication Foundation (WCF) as described in the Web Service Software Factory guidance. -Additional information can be found at the following sites: +Additional information can be found at the following site: - [https://msdn.microsoft.com/library/ms735119.aspx](https://msdn.microsoft.com/library/ms735119.aspx) -- [http://www.codeplex.com/servicefactory](http://www.codeplex.com/servicefactory) In the following sections, we describe each subsystem implementation in detail. diff --git a/iis/manage/provisioning-and-managing-iis/websitepanel.md b/iis/manage/provisioning-and-managing-iis/websitepanel.md index a877e2aac..9a4633141 100644 --- a/iis/manage/provisioning-and-managing-iis/websitepanel.md +++ b/iis/manage/provisioning-and-managing-iis/websitepanel.md @@ -29,4 +29,4 @@ The WebsitePanel features list includes: · Strong community support -WebsitePanel has recently been submitted as an open-source project on [SourceForge](http://sourceforge.net/) and carries a BSD license. For more information on WebsitePanel, visit: [http://websitepanel.net](http://websitepanel.net/). +WebsitePanel has recently been submitted as an open-source project on [SourceForge](https://sourceforge.net/projects/websitepanel/) and carries a BSD license. diff --git a/iis/manage/scripting/get-to-know-the-iis-wmi-provider-using-cim-studio.md b/iis/manage/scripting/get-to-know-the-iis-wmi-provider-using-cim-studio.md index 6ac1a1360..fd4e53898 100644 --- a/iis/manage/scripting/get-to-know-the-iis-wmi-provider-using-cim-studio.md +++ b/iis/manage/scripting/get-to-know-the-iis-wmi-provider-using-cim-studio.md @@ -33,7 +33,7 @@ Install the IIS WMI provider by selecting the **IIS Management Scripts and Tools ### Install WMI Tools (includes CIM Studio) -Install the WMI Tools suite from the [Microsoft Download Center](https://www.microsoft.com/downloads/details.aspx?FamilyID=6430f853-1120-48db-8cc5-f2abdc3ed314&DisplayLang=en.) before starting. +Install the WMI Tools suite before starting. ### Required Privileges and User Account Control (UAC) diff --git a/iis/manage/scripting/managing-sites-with-the-iis-wmi-provider.md b/iis/manage/scripting/managing-sites-with-the-iis-wmi-provider.md index c1b4448bc..edb9ac002 100644 --- a/iis/manage/scripting/managing-sites-with-the-iis-wmi-provider.md +++ b/iis/manage/scripting/managing-sites-with-the-iis-wmi-provider.md @@ -46,7 +46,7 @@ Install the IIS WMI provider by selecting the **IIS Management Scripts and Tools ### Install WMI Tools (includes CIM Studio) -Install the WMI Tools suite from the [Microsoft Download Center](https://www.microsoft.com/downloads/details.aspx?FamilyID=6430f853-1120-48db-8cc5-f2abdc3ed314&DisplayLang=en.). +Install the WMI Tools suite. ### Required Privileges and User Account Control (UAC) diff --git a/iis/manage/working-with-server-core/iis-70-on-server-core.md b/iis/manage/working-with-server-core/iis-70-on-server-core.md index c8fdf7dcc..710c1f6ba 100644 --- a/iis/manage/working-with-server-core/iis-70-on-server-core.md +++ b/iis/manage/working-with-server-core/iis-70-on-server-core.md @@ -13,7 +13,7 @@ by [Tobin Titus](https://github.com/tobint) As you may know from TechEd 2007 announcements and [a Bill Staples' blog post](https://blogs.iis.net/bills/archive/2007/06/04/iis7-on-server-core.aspx), IIS 7.0 is supported on the Server Core installation option of Windows Server® 2008. IIS 7.0 on Server Core combines a powerful new Web server with a minimal footprint server operating system, which has a smaller disk space requirement, lower memory utilization, a reduced attack surface, and lower servicing needs. -This article provides basic instructions for getting started with IIS 7.0 on Server Core, including installation instructions for running Classic ASP and PHP applications. +This article provides basic instructions for getting started with IIS 7.0 on Server Core, including installation instructions for running Classic ASP applications. ## IIS Deployment and Configuration Tips @@ -53,41 +53,6 @@ A. Type following pkgmgr.exe command to install Classic ASP along with features [!code-console[Main](iis-70-on-server-core/samples/sample3.cmd)] -**Q4. How do you install PHP on Server Core?** - -A. Steps to install and configure PHP on Server Core are as follows: - -1. Unzip the content of PHP download from to a file share. - - > [!NOTE] - > Since Server Core does not have browser support, it is recommended to download the PHP content on a file share where browser access is available. - -2. Create a `%SystemDrive%\PHP` directory on Server Core machine and xcopy the content of the folder from the file share above onto `%SystemDrive%\PHP` folder on local machine. - -3. Copy the `%SystemDrive%\PHP\PHP.INI-Recommended` file as `%SystemDrive%\PHP\PHP.INI`. - -**Q5. How do you install and configure Fast-CGI support on the IIS Server?** - -A. After completing the steps on installing PHP in Q4, please follow the steps below to install Fast-CGI and configure it. - -Step 1. Please use following command-line to install IIS features for FastCGI along with features for Static Content Web Server: - -[!code-console[Main](iis-70-on-server-core/samples/sample4.cmd)] - -> [!NOTE] -> Alternatively, you can choose to install Full IIS option indicated in Q1. Default IIS install option does not contain FastCGI installation. - -Step 2. Create the PHP/FastCGI handler mapping from command line by typing following two appcmd.exe commands: - -> AppCmd set config /section:system.webServer/fastCGI /+[fullPath='d:\php\php-cgi.exe'] - -> AppCmd set config /section:system.webServer/handlers /+[name='PHP-FastCGI',path='\*.php',verb='\*',modules='FastCgiModule',scriptProcessor='d:\php\php-cgi.exe',resourceType='Either'] - -> [!NOTE] -> -> 1. AppCmd.exe is a new command-line tool that ships with IIS 7.0. AppCmd.exe can be found at `%WinDir%\System32\InetSrv` directory. For more information on AppCmd command-line tool, see the [Getting Started with AppCmd.exe](../../get-started/getting-started-with-iis/getting-started-with-appcmdexe.md) article. -> 2. Depending on PHP installation location described in Q4, paths to executables on the hard disk may require updates. All appcmd example commands above assume that PHP installation is in D:\PHP folder. - ## Server Core Administration Tips This section includes a few command line utilities and commands to perform common tasks/actions on command-line. diff --git a/iis/overview/powerful-admin-tools.md b/iis/overview/powerful-admin-tools.md index 72ea70b72..c4d30a3bb 100644 --- a/iis/overview/powerful-admin-tools.md +++ b/iis/overview/powerful-admin-tools.md @@ -31,4 +31,4 @@ IIS supports a command line tool [AppCmd.exe](../get-started/getting-started-wit ## Microsoft IIS Administration API -The [Microsoft IIS Administration API](/iis-administration/) is REST API that enables customers to configures and monitor their IIS web server. With the API installed on a machine with IIS, one can configure an IIS instance with any HTTP client including the web management tool at [manage.iis.net](https://manage.iis.net/). +The [Microsoft IIS Administration API](/iis-administration/) is REST API that enables customers to configures and monitor their IIS web server. With the API installed on a machine with IIS, one can configure an IIS instance with any HTTP client. diff --git a/iis/publish/deploying-application-packages/blogenginenet.md b/iis/publish/deploying-application-packages/blogenginenet.md deleted file mode 100644 index 780f5a4a4..000000000 --- a/iis/publish/deploying-application-packages/blogenginenet.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: "BlogEngine.NET" -author: simtan -description: "Introduction BlogEngine.NET is an open source .NET blogging platform for Microsoft .NET. For more information about BlogEngine.Net, refer to the BlogEngine.N..." -ms.date: 03/10/2011 -ms.assetid: 63fcc706-7f61-40c0-bc17-8b57118ffd4f -msc.legacyurl: /learn/publish/deploying-application-packages/blogenginenet -msc.type: authoredcontent ---- -# BlogEngine.NET - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -BlogEngine.NET is an open source .NET blogging platform for Microsoft .NET. For more information about BlogEngine.Net, refer to the [BlogEngine.NET](http://www.dotnetblogengine.net/) Web site. For step-by-step instructions on installing this application in an IIS environment, see the *Procedure* section of this document. - -## Requirements - -For information about technical requirements for your IIS environment, refer to [Install Server Components](../../web-hosting/joining-the-web-hosting-gallery/install-server-components.md). - -## Procedure - -### Step 1. Install the application in an IIS test environment. - -To install the application, you can use Web Platform Installer or WebMatrix. These procedures are described in this step. - -#### Web Platform Installer - -The Microsoft Web Platform Installer 2.0 (Web PI) is a free tool that allows you to easily install and run the most popular free web applications for blogging, content management and more with the built-in Windows Web Application Gallery. For more information about Web PI, refer to the [Microsoft Web Platform Installer 2.0](https://www.microsoft.com/web/downloads/platform.aspx) Web site. - -To use Web PI to install this application, complete these steps: - -1. From the Windows Start menu, click **Programs**, and then click **Web Platform Installer**. - - The Web Platform Installation window appears. - ![Screenshot of the Web Platform Installer window. The box next to BlogEngine dot net is checked.](blogenginenet/_static/image2.jpg) -2. Click the **Web Applications** tab, select the **BlogEngine.NET** check box, and click **Install**. - - ![Screenshot showing the selected third party applications. The I Accept button is selected.](blogenginenet/_static/image4.jpg) -3. Select the **BlogEngine.NET** check box, and click **I Accept**. - - ![Screenshot showing the S Q L server express administrator password page. Mixed mode authentication is selected.](blogenginenet/_static/image6.jpg) -4. Select **Mixed Mode Authentication**, enter a password, and click **Continue**. - - Once the preinstallation steps complete, the site information window appears. - ![Screenshot showing the site information window. The Continue button is selected.](blogenginenet/_static/image8.jpg) -5. In the Web Site list, click **New Web Site**. -6. Enter an application name in the application name field. -7. Enter a web site name in the Web Site Name field. -8. Enter a physical path in the Physical path field. -9. In the IP address list, click **All Unassigned**, and enter **80** in the Port field. -10. Enter a host name in the Host Name field, and click **Continue**. - - The application information window appears. - ![Screenshot showing the application information window. The continue button is selected.](blogenginenet/_static/image10.jpg) -11. In the Choose your database list, click **SQL Server**. -12. In the Create a new or use an existing database list, click **Create new database**. -13. Enter a database administrator user name in the Database Admin Username field. -14. Enter a password in the Database Admin Password field. -15. Click **Continue**. - - Once the installation process completes, the final installation window appears. - ![Screenshot showing the successful installation window with Finish button.](blogenginenet/_static/image12.jpg) -16. Click **Finish**. - - The BlogEngine.NET web page appears. - ![Screenshot showing the initial blog engine dot net web page.](blogenginenet/_static/image14.jpg) - -#### WebMatrix - -WebMatrix is a free, easy way to customize and build Web sites from popular open-source applications, such as WordPress, Drupal, and Joomla. In addition, you can build sites from the ground up using ASP.NET, PHP, HTML and a number of other leading technologies. For more information about WebMatrix, refer to the [WebMatrix](https://www.microsoft.com/web/webmatrix/) Web site. - -To use WebMatrix to install this application, complete these steps: - -1. Launch WebMatrix. - - The WebMatrix home page appears. - ![Screenshot showing the WebMatrix home page window.](blogenginenet/_static/image16.jpg) -2. Click **Site From Web Gallery**. - - The Site from Web Gallery page appears. - ![Screenshot showing the web gallery page. The Next button is highlighted.](blogenginenet/_static/image18.jpg) -3. Click **BlogEngine.NET**, and click **Next**. - - The Accept EULA page appears. - ![Screenshot showing the Accept E U L A dialog. The I Accept button is highlighted.](blogenginenet/_static/image20.jpg) -4. Click **I Accept** to agree to the end-user license agreement. - - WebMatrix installs the BlogEngine.NET software on your local computer. This page appears once installation is complete. - - ![Screenshot showing the successfully installed dialog with an O K button.](blogenginenet/_static/image22.jpg) -5. Click **OK**. - - The BlogEngine.NET application starts as indicated in bottom-left corner of the page. - ![Screenshot of the BlogEngine dot net window. A message showing that the session started successfully is circled.](blogenginenet/_static/image24.jpg) -6. Click **Settings** in the left navigation area. -7. Select **.Net 4 (Integrated)** from the Select .NET Framework Version drop-down list. -8. To configure the settings for your hosting provider and domain, select **Publish > Configure**. - - ![Screenshot showing the Publishing Settings dialog. Protocol is set to Web Display.](blogenginenet/_static/image27.jpg) -9. Add your hosting provide and domain-specific information, and click **Validate Connection**. -10. If the connection was successful, click **Apply**, and then click **Publish**. - - WebMatrix determines changes to be made. - ![Screenshot showing the Publish Preview dialog with a notification message displayed](blogenginenet/_static/image29.jpg) -11. Once changes have been determined, check the **Publish to SQL Server** check box, and click **Continue**. - - Once the process completes, the Publish Preview dialog box appears. - ![Screenshot of the Publish Preview dialog. The BlogEngine box is checked.](blogenginenet/_static/image31.jpg) -12. Click **Continue**. - - The status of the publishing process is indicated in the bottom-left corner of the page. - ![Screenshot showing the BlogEngine window. Publish Starting is circled.](blogenginenet/_static/image33.jpg) -13. Once publishing is complete, go to your domain, and verify BlogEngine.NET is running. - ![Screenshot of a browser window showing the BlogEngine web page.](blogenginenet/_static/image35.jpg) - -### Step 2. Build the application package from the IIS site. - -To build the application package from the IIS site, complete the steps described in [Export a Package through IIS Manager](../using-web-deploy/export-a-package-through-iis-manager.md). - -### Step 3. Install the application on the target server. - -To install the application on the target server, complete the steps described in [Import a Package through IIS Manager](../using-web-deploy/import-a-package-through-iis-manager.md). diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image1.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image1.jpg deleted file mode 100644 index f493b7e58..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image10.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image10.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image11.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image11.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image12.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image12.jpg deleted file mode 100644 index 7f3499db4..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image13.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image13.jpg deleted file mode 100644 index 7f3499db4..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image14.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image14.jpg deleted file mode 100644 index 0cdc09c90..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image15.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image15.jpg deleted file mode 100644 index 0cdc09c90..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image16.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image16.jpg deleted file mode 100644 index f493b7e58..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image17.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image17.jpg deleted file mode 100644 index f493b7e58..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image18.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image18.jpg deleted file mode 100644 index 05676504d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image19.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image19.jpg deleted file mode 100644 index 05676504d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image2.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image2.jpg deleted file mode 100644 index 59f5447e5..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image20.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image20.jpg deleted file mode 100644 index cb07beaed..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image21.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image21.jpg deleted file mode 100644 index cb07beaed..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image22.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image22.jpg deleted file mode 100644 index e007c6847..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image23.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image23.jpg deleted file mode 100644 index e007c6847..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image24.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image24.jpg deleted file mode 100644 index 4701f1740..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image25.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image25.jpg deleted file mode 100644 index 4701f1740..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image26.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image26.jpg deleted file mode 100644 index 10b33169c..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image27.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image27.jpg deleted file mode 100644 index 90bc34a17..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image28.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image28.jpg deleted file mode 100644 index 90bc34a17..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image29.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image29.jpg deleted file mode 100644 index 3135aca31..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image3.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image3.jpg deleted file mode 100644 index 59f5447e5..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image30.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image30.jpg deleted file mode 100644 index 3135aca31..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image31.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image31.jpg deleted file mode 100644 index 22829b4ca..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image32.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image32.jpg deleted file mode 100644 index 22829b4ca..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image32.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image33.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image33.jpg deleted file mode 100644 index 89039f9a2..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image34.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image34.jpg deleted file mode 100644 index 89039f9a2..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image34.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image35.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image35.jpg deleted file mode 100644 index ab40f458d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image36.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image36.jpg deleted file mode 100644 index ab40f458d..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image36.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image4.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image4.jpg deleted file mode 100644 index 9100c1fcb..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image5.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image5.jpg deleted file mode 100644 index 9100c1fcb..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image6.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image6.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image7.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image7.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image8.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image8.jpg deleted file mode 100644 index 06b6d20bc..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/blogenginenet/_static/image9.jpg b/iis/publish/deploying-application-packages/blogenginenet/_static/image9.jpg deleted file mode 100644 index 06b6d20bc..000000000 Binary files a/iis/publish/deploying-application-packages/blogenginenet/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment.md b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment.md deleted file mode 100644 index fdfa1309c..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment.md +++ /dev/null @@ -1,357 +0,0 @@ ---- -title: "Deploying Drupal via Packages in a Hosting Environment" -author: simtan -description: "Introduction Drupal is an open source content management system (CMS) often used as a back-end system for Web sites. This document provides step-by-step inst..." -ms.date: 03/10/2011 -ms.assetid: aec5ac11-ffa8-4366-84ef-e5176633a2d4 -msc.legacyurl: /learn/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment -msc.type: authoredcontent ---- -# Deploying Drupal via Packages in a Hosting Environment - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -Drupal is an open source content management system (CMS) often used as a back-end system for Web sites. This document provides step-by-step instructions on how to easily create a package containing the Drupal application for one-click deployment in a hosting environment. For more information about the Drupal application, visit the link: [*Windows Web App page for Acquia Drupal*](https://www.microsoft.com/web/gallery/acquiadrupal.aspx). - -Here is a zipped PDF of this complete document: [DrupalDocPDF](deploying-drupal-via-packages-in-a-hosting-environment/_static/deploying-drupal-via-packages-in-a-hosting-environment-994-drupal-v051.zip) - -## Requirements - -Environment Requirements: - -- Windows Server 2008 R2 or greater -- IIS 7.0 or above -- Web Deploy 2.0 - -Application Requirements: - -- PHP 5.2 -- MySQL 5.1 -- Windows Cache 1.1 for PHP 5.2 - -For information about how to install the necessary components see [Step 1. Set Up Your Servers for Hosting](#step-1-set-up-your-servers-for-hosting). - - - -## Procedure - -This procedure describes how to install Drupal using IIS with Web Deploy. IIS with Web Deploy makes installing sites simple and extremely flexible for Hoster Service Providers by allowing them to create deployment packages that include the site, its content, and its database. The package can then be deployed by importing it into IIS via the console or a script. For more information about Web Deploy, refer to the link: [*Web Deploy 2.0: The Official Microsoft IIS Site*](https://www.iis.net/downloads/microsoft/web-deploy). - -This procedure requires 3 basic steps: - -Step 1. Set Up Your Servers for Hosting -Step 2. Create an Application Package for Deployment -Step 3. Deploy a Customer Site using IIS with Web Deploy - - - -### Step 1. Set Up Your Servers for Hosting - - - -#### Overview - -This step describes the server components that are required to support deployment of install packages via Web Deploy. - -#### Prerequisites - -While it is possible to run a web server and database server on the same machine, it is not recommended due to performance and security reasons. We recommend that you use two separate machines running Windows Server 2008 R2: one acting as the Web server and one acting as the database server. - -> [!NOTE] -> Both machines must be connected to the Internet to download the required server components. - -To simplify installation of the Web server components, installing Web Platform Installer (Web PI) on both machines is highly recommended. Web PI is a tool that automates the installation of a vast majority of server components and other products for Microsoft's Web Platform. - -#### Install Web Server Components on Your Web Server and Database Server - -To install the required components on your Web server and database server using Web PI 3.0, visit the link: [*Install Spotlight Components plus PHP/MySQL related components using Web PI*](https://www.microsoft.com/web/gallery/install.aspx?appid=IIS7;NETFramework35;NETFramework4;ASPNET;MVC;WDeploy;FTPServer;MediaServices3;ManagementService;CGI;URLRewrite2;SMO;PHP52;WinCache52_11;MySQLConnector;SQLDriverPHPForIIS "Install Components") and click **Install**, following the onscreen instructions. - -> [!NOTE] -> A complete list of components that are installed by default with Web PI 3.0 is included in the Products Installed by Default using Web PI section of this document. You can also review the list of products before installation begins. - - - -#### Install MySQL on your Database Server - -To install MySQL, go to [Download MySQL Community Server](http://dev.mysql.com/downloads/mysql/5.1.html) to download MySQL 5.1 and complete the steps described in the **Install MySQL on Your Database Server** in this document. - -**Next Steps:** - -- If the Web Deploy 2.0 component is newly installed, you must configure it to allow delegated deployments. Refer to the link: [*Configure the Web Deploy Component on the Web Server*](../../web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md) for more information. -- After you install and configure the server components, validate your server configuration by following the procedures described at the link: [*Validate Your Server Configuration*](../../web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md). - - - -### Step 2. Create an Application Package for Deployment - -This step describes how to export an application package that can be used to quickly provision IIS sites and includes these sub steps: - -A. Create an IIS Web Site for this Application -B. Install the Application to the IIS Application Web Site -C. Export the Package from the IIS Application Web Site - -#### A. Create an IIS Web Site for this Application - -1. Open Internet Information Services (IIS) Manager. - - The Internet Information Services (IIS) Manager application opens. - ![Screenshot that shows I I S Manager.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image2.jpg) -2. Expand your server connection, and click **Sites**. -3. In the Actions area, click the **Add Web Site** link. - - ![Screenshot that shows the Add Web Site dialog box.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image4.jpg) - The Add Web Site dialog box appears. -4. Enter a site name for your Web site. -5. In the Physical path field, type the physical path to the folder in which the application is installed, or click the browse button (...) to navigate to the folder. -6. In the Binding area, select the protocol for your Web site from the Type drop-down list. -7. Type the IP address to your Web site in the IP address drop-down list. The default value is All Unassigned. -8. Type a port number in the Port field. -9. Type a host name for the Web site in the Host name field. -10. If you want the Web site to be immediately available and do not need to make further changes, select the **Start Web site immediately** check box. -11. Click **OK**. - - - -#### B. Install the Application to the IIS Application Web Site - -1. Open Web Platform Installer (Web PI) locally from the web server. - The Web Platform Installer application opens. - - ![Screenshot that shows Web Platform Installer 3 point 0.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image6.jpg) -2. Select **Acquia Drupal**, and click **Install**. - The Web Platform Installation window appears. - - ![Screenshot that shows the Web Platform Installation window.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image8.jpg) -3. Click **I Accept** to accept the end-user license agreement. - - ![Screenshot that shows Step 1 of 2 in the Web Platform Installation window, Enter your site information.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image10.jpg) -4. From the Web Site drop-down list, select the Web site you created earlier in this procedure. -5. In the application name field, enter an application name if it is different from the default value. - The remaining fields are populated automatically based on your Web site information. -6. Click **Continue**. - ![Screenshot that shows Step 2 of 2 in the Web Platform Installation window, Enter application information.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image12.jpg) -7. From the Create a new or use an existing database drop-down list, select **Create new database**. -8. Enter the following information in the appropriate fields to create a new database: - - - Database administrator user name and password—User name and password to allow administrative access to this database. - - Database user name and password—User name and password to allow general access to this database. - - Database server—Name of the server on which this database resides. - - Database name—Name of this database. - - Database prefix—Prefix added to database table names used to identify this database. - - Load sample data—Indicate whether you want to load sample data into this database. - - Web site name—Name of your Web site. - - Site administrator—User name for the Web site specified in the Website Name field. - - Site administrator password—Password for the Web site administrator. - - Site administrator email address—Email address for the Web site administrator. - - > [!NOTE] - > You must scroll down to view all required fields. -9. Click **Continue**. - - ![Screenshot that shows text reading, Congratulations You have successfully installed the following products, in the Web Platform Installation window.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image14.jpg) -10. Once the Web PI process is complete, you can do one of the following: - - - Click **Finish** to complete the installation process. If you click Finish to complete the installation process, proceed to step C. Enable Permalinks (Optional) to continue creating an application package for deployment. - - Click **Launch Drupal** to launch your Drupal application. If you click the Launch Drupal link, the Drupal application page appears: - ![Screenshot that shows Internet Explorer. The Drupal application page is shown in the browser.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image16.jpg) - -For information about setting up your Drupal site, see the [Drupal documentation](https://www.drupal.org/documentation). - - - -#### C. Enable Permalinks (Optional) - -By default, Drupal uses query string parameters for all the URLs it generates for your Web site. You can change this default behavior by enabling clean URLs, a feature which relies on the URL rewriting functionality. To enable permalinks (clean URLs) in Drupal, complete these steps: - -1. Open the Web.config file located in the root of the Drupal install directory. The root directory path should be similar to the following: `C:\inetpub\wwwroot\drupal` -2. Copy and paste the following XML code into the Web.config file. - - [!code-xml[Main](deploying-drupal-via-packages-in-a-hosting-environment/samples/sample1.xml)] -3. Save the web.config file. -4. Launch your Drupal application in a Web browser and log in as the administrator -5. Browse to **Administer > Site Configuration > Clean** **URLs**. -6. Under **Clean URLs**,click the **Enabled** option button, and then click **Save configuration**. - - - -#### D. Export the Package from the IIS Application Web Site - -1. Open IIS Manager. - The Internet Information Services (IIS) Manager application opens. - ![Screenshot of the I I S Manager, with the WEB DEPLOY 0 2 Home pane open.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image18.jpg) -2. In the Connections navigation pane, expand **Sites**, and select the Web site you just created. - ![Screenshot of the I I S Manager, with the drupal Home pane open.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image20.jpg) -3. Click the **Export Application** link located in the Deploy section of the Actions pane. - - The Export Application Package (Select the Contents of the Package) dialog box appears. - ![Screenshot of the Export Application Package dialog box.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image22.jpg) -4. Click **Manage Components**. - The Manage Components dialog box appears. - ![Screenshot of the Manage Components dialog box.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image24.jpg) -5. Double-click the second row of the Provider Name column. - ![Screenshot of the Manage Components dialog box. The drop down list for the cell under i i s App is shown.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image26.jpg) -6. Select **dbMySql** from the drop-down list. - ![Screenshot of the Manage Components dialog box. d b My Sql is selected under the i i s App cell.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image28.jpg) -7. Double-click the second row of the Path column, and enter the connection string for your package export. - ![Screenshot of the Manage Components dialog box. The row with d b My Sql is selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image31.jpg) -8. Click outside of the box in which you entered the connection string, and click **OK**. - - The newly created parameter now appears in the Export Application Package (Select Parameters) dialog box. - ![Screenshot that shows the Export Application Package dialog box.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image33.jpg) -9. Rename the parameters: - - - Select **Parameter 1**, and click **Edit**. - The Edit Parameter dialog box appears. - ![Screenshot that shows the Edit Parameter dialog box.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image35.jpg) - - Enter **SiteName** in the Name field, and click **OK**. - - Repeat these steps to rename Parameter 2 to "ConnectionString." - - The parameters appear renamed in the Export Application Package (Select Parameters) dialog box. - ![Screenshot that shows the Export Application Package dialog box. Both parameters have been renamed, one to Site Name and the other to Connection String.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image37.jpg) -10. Click **Next**. The Export Application Package (Save Package) dialog box appears. - ![Screenshot that shows the Export Application Package dialog box for Save Package.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image39.jpg) -11. Enter the path to the application package, or click Browse to locate the application file. -12. Click **Next**. - - The Export Application Package (Export Progress and Summary) dialog box displays the progress of the export process. Once the process is complete, a summary report appears. - ![Screenshot that shows the Export Application Package dialog box for Export Progress and Summary.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image41.jpg) -13. Click **Finish**.Use this application package to deploy to customer Web sites as described in Step 3. Deploy a Customer Site using IIS with Web Deploy. - - - -### Step 3. Deploy a Customer Site using IIS with Web Deploy - -#### Overview - -When deploying a customer site, most Hosting Service Providers use a control panel that allows them to capture the information required for deployment. This information can then be passed to scripts that create the user, configure the site for hosting, create a database, and import the application package. Here are the basic steps required to deploy a customer site: - -A. Create a Customer Application Web Site -B. Create a Customer Application Database -C. Import the Application Package using a CLI Command or PowerShell Script - -#### A. Create a Customer Application Web Site - -To create a customer application Web site, complete the steps described in A. Create an IIS Web Site for this Application. - - - -**Tips:** - -- When you create the Web site in IIS, give your application a user-friendly name by creating a fully qualified domain name (FQDN) for the host header and adding that FQDN to your Domain Name Service. -- You can automate this process using a script similar to the one described in the section: Automated Deployment Script. - -#### B. Create a Customer Application Database - -To create a customer application database, complete these steps: - -1. Open a command-line prompt (or MySQL Manager) at the MySQL bin directory. If you used the default installation path, the bin directory path will be similar to the following: `C:\Program Files\MySQL\MySQL Server 5.1\bin` -2. Enter the administrator password, and press **Enter**. -3. Type the following command to create the database, and press **Enter**. - `mysql> create database drupal;` -4. Type this command to create a user, and press **Enter**. - `mysql> create user ‘drupaluser'@'localhost' identified by ‘password';` -5. Type this command to grant permissions, and press **Enter**. - `mysql> grant all on drupal. \* to ‘drupal'@'localhost';` - -Your command window should appear similar to the following: -![Screenshot of a command window. Commands for create database, create user, and grant all are entered.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image43.jpg) - -> [!TIP] -> You can automate this process using a script similar to the one described in the section: MySQL Database Creation Script. - - - -#### C. Import the Application Package using a CLI Command or PowerShell Script - -Once you export the application package (as described in Step 2. Create an Application Package for Deployment), you can easily import the package into the customer site using the CLI command or PowerShell script listed below. These methods allow you to add the parameters that are required to configure an application for use. - -The examples in this topic show how to import Drupal into an IIS Web site and install the application database. This package is configured to allow two parameters: one for the IIS site name and one for the database connection string. - -##### CLI Command - -[!code-console[Main](deploying-drupal-via-packages-in-a-hosting-environment/samples/sample2.cmd)] - -##### PowerShell Script - -[!code-console[Main](deploying-drupal-via-packages-in-a-hosting-environment/samples/sample3.cmd)] - -## Sample Powershell Scripts - - - -### Automated Deployment Script - -[!code-powershell[Main](deploying-drupal-via-packages-in-a-hosting-environment/samples/sample4.ps1)] - - - -### MySQL Database Creation Script - -[!code-powershell[Main](deploying-drupal-via-packages-in-a-hosting-environment/samples/sample5.ps1)] - - - -#### Install MySQL on your Database Server - -1. Download the latest stable version of MySQL from the [official website](https://www.mysql.com/ "MySQL website") and run the installer on a dedicated **database server.** - The MySQL Server Instance Configuration Wizard appears. - ![Screenshot that shows My SQL Server Instance Configuration Wizard. Dedicated My SQL Server Machine is selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image45.jpg) -2. Click the **Dedicated MySQL Server Machine** option button, and click **Next**. - - ![Screenshot that shows My SQL Server Instance Configuration Wizard for Inno D B Table space Settings.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image47.jpg) -3. Click **Next**. - ![Screenshot that shows My SQL Server Instance Configuration Wizard with Online Transaction Processing selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image49.jpg) -4. For concurrent connections, click the **Online Transaction Processing (OLTP)** option button (since this option reflects the workload of a typical shared hosting database server), and then click **Next**. - ![Screenshot that shows My SQL Server Instance Configuration Wizard with Enable T C P I P Networking selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image51.jpg) -5. Click the **Enable TCP/IP Networking** check box, and then click the **Add firewall exception for this post** check box. -6. Clear the **Enable Strict Mode** check box if it is checked. - ![Screenshot that shows My SQL Server Instance Configuration Wizard with Best Support for Multilingualism selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image53.jpg) -7. Click the Best Support For Multilingualism option button to enable support for the UTF-8 character set. - **IMPORTANT!** You must choose the Best Support for Multilingualism option button since several applications in the Web Application Gallery require UTF-8 support in the database. -8. Click **Next**. - ![Screenshot that shows My SQL Server Instance Configuration Wizard with Include Bin Directory in Windows PATH selected.](deploying-drupal-via-packages-in-a-hosting-environment/_static/image55.jpg) -9. Click the **Include Bin Directory in Windows PATH** check box, and click **Next**. -10. Since MySQL is installed on the database server (which is different than the Web server that runs the Web Deploy web server component), you must complete these steps to ensure Web Deploy can access the database server: - - - Copy mysqldump.exe (typically located in `C:\Program Files\MySQL\MySQL Server 5.1\bin`) to your **Web server** in `C:\mysqldump\mysqldump.exe`. - - On the **Web server**, set a registry key (`HKEY\_LOCAL\_MACHINE\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\1\mysqldumppath`) to string value == "c:\mysqldump\mysqldump.exe" - - > [!NOTE] - > If you lose the credentials to your MySQL database, refer to the link: [*Resetting the Root Password: Windows Systems*](http://dev.mysql.com/doc/refman/5.1/en/resetting-permissions.html#resetting-permissions-windows) to reset your password. - - - -## Products Installed by Default using Web PI - -This table provides additional information about the products that are installed by default using Web PI: - -| Product | Description | -| --- | --- | -| .NET Framework 3.5 SP1 | .NET Framework 3.5 SP1 is a full cumulative update that contains many new features building incrementally upon .NET Framework 2.0, 3.0, 3.5, and includes cumulative servicing updates to the .NET Framework 2.0 and .NET Framework 3.0 subcomponents. For more information, refer to the link: [*Microsoft Download Center*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en). | -| .NET Framework 4.0 | The .NET Framework is Microsoft's comprehensive and consistent programming model for building applications that have visually stunning user experiences, seamless and secure communication, and the ability to model a range of business processes. For more information, refer to the link: [*.NET Framework Developer Center*](https://msdn.microsoft.com/netframework/aa569263). | -| ASP.NET | ASP.NET is a free web framework that enables great Web applications. Used by millions of developers, it runs some of the biggest sites in the world. For more information, refer to the link: [Microsoft ASP.net](https://www.asp.net/get-started). | -| ASP.NET MVC | ASP.NET MVC is part of the ASP.NET Web application framework and is one of the two different programming models you can use to create ASP.NET Web applications. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/whatisaspmvc). | -| ASP.NET MVC3 | ASP.NET MVC 3 builds on top of the features in ASP.NET MVC 1 and 2, adding on great features that both simplify your code and allow for deeper extensibility. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/mvc3). | -| ASP.NET Web Pages | The ASP.NET Web Forms page framework is a scalable common language runtime programming model that can be used on the server to dynamically generate Web pages. For more information, refer to the Microsoft .net Framework SDK link: [*Introduction to ASP.NET Pages*](https://quickstarts.asp.net/QuickStartv20/aspnet/doc/pages/pages.aspx). | -| Common Gateway Interface (CGI) | CGI is a standard for interfacing external programs with information servers on the Internet. For more information, refer to the link: [*CGI: Common Gateway Interface*](http://www.w3.org/CGI/). | -| FTP Publishing Service | The FTP Publishing Service for IIS allows Web content creators to publish content more easily and securely to IIS Web servers using modern Internet publishing standards. For more information, refer to the link: [*FTP Publishing Service*](https://www.iis.net/downloads/microsoft/ftp). | -| IIS 7 Web Server | Internet Information Services (IIS) for Windows Server is a flexible, secure and easy-to-manage Web server for hosting anything on the Web. For more information, refer to the link: [*IIS*](https://www.iis.net/overview). | -| IIS Remote Management Service | Internet Information Services (IIS) Manager for Remote Administration provides end users and administrators with the ability to securely manage remote IIS servers from Windows 7, Windows Vista, Windows XP, and Windows Server 2003. For more information, refer to the link: [*IIS Manager for Remote Administration*](https://www.iis.net/downloads/microsoft/iis-manager). | -| Media Services 3.0 | IIS Media Services, an integrated HTTP-based media delivery platform, delivers true HD (720p+) live and on-demand streaming, DVR functionality, and real-time analytics support to computers, TVs, and mobile devices. For more information, refer to the link: [*IIS Media Services*](https://www.iis.net/media). | -| Microsoft Driver for PHP for SQL Server 2.0 in IIS | The Microsoft Drivers for PHP for SQL Server provide connectivity to Microsoft SQL Server from PHP applications. For more information, refer to the link: [*Microsoft Drivers for PHP for SQL Server*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=80e44913-24b4-4113-8807-caae6cf2ca05&displaylang=en). | -| Microsoft SQL Server 2008 | SQL Server delivers on Microsoft's Data Platform vision by helping your organization manage your data by enabling you to store data from structured, semi-structured, and unstructured documents within the database. For more information, refer to the link: [*Microsoft SQL Server 2008*](https://www.microsoft.com/sqlserver/2008/en/us/default.aspx). | -| Microsoft Web Deploy 2.0 | Web Deploy (Web Deployment Tool) simplifies the migration, management and deployment of IIS Web servers, Web applications and Web sites. For more information, refer to the link: [*Web Deploy*](https://www.iis.net/downloads/microsoft/web-deploy). | -| MySQL Connector/Net 6.2.3 | Connector/Net is a fully-managed ADO.NET driver for MySQL. For more information, refer to the link: [*MySQL Download Connector/Net*](http://dev.mysql.com/downloads/connector/net/6.2.html). | -| PHP Driver for SQL Server | The SQL Server Driver for PHP v1.1 is designed to enable reliable, scalable integration with SQL Server for PHP applications deployed on the Windows platform. For more information, refer to the link: [*SQL Server Driver for PHP*](https://www.microsoft.com/sqlserver/2005/en/us/php-driver.aspx). | -| PHP | PHP is a general-purpose scripting language that can be embedded into HTML and is especially suited for Web development. For more information, refer to the link: [*PHP*](http://www.php.net/). | -| SQL Server 2008 Management Objects | The SQL Server Management Objects (SMO) is a .NET Framework object model that enables software developers to create client-side applications to manage and administer SQL Server objects and services. For more information, refer to the link: [*Microsoft TechNet SQL Server Management Objects (SMO)*](https://technet.microsoft.com/library/ms162169.aspx). | -| URL Rewrite 2.0 | IIS URL Rewrite 2.0 enables Web administrators to create powerful rules to implement URLs that are easier for users to remember and easier for search engines to find. For more information, refer to the link: [*URL Rewrite*](https://www.iis.net/downloads/microsoft/url-rewrite). | -| Windows Cache 1.1 for PHP | Windows Cache Extension for PHP is a PHP accelerator that is used to increase the speed of PHP applications running on Windows and Windows Server. For more information, refer to the link: [*Windows Cache Extension for PHP*](https://www.iis.net/downloads/microsoft/wincache-extension). | - -## Related Information Links - -- [Web Deployment Tool (MS Deploy) Forum](https://forums.iis.net/1144.aspx) -- [PHP Manager for IIS 7 Community](https://www.iis.net/downloads/community/2010/09/php-manager-for-iis-7) -- [Configure and Optimize the Microsoft Web Platform for PHP Applications](../../application-frameworks/install-and-configure-php-on-iis/index.md) diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/deploying-drupal-via-packages-in-a-hosting-environment-994-drupal-v051.zip b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/deploying-drupal-via-packages-in-a-hosting-environment-994-drupal-v051.zip deleted file mode 100644 index 7ca839141..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/deploying-drupal-via-packages-in-a-hosting-environment-994-drupal-v051.zip and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image1.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image1.jpg deleted file mode 100644 index d995ab2d4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image10.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image10.jpg deleted file mode 100644 index bdb2108b6..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image12.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image12.jpg deleted file mode 100644 index 498873e60..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image14.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image14.jpg deleted file mode 100644 index 140c08830..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image16.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image16.jpg deleted file mode 100644 index 91a5775d4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image18.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image18.jpg deleted file mode 100644 index f2bccc554..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image2.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image2.jpg deleted file mode 100644 index 886358c98..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image20.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image20.jpg deleted file mode 100644 index 31c07eedb..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image22.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image22.jpg deleted file mode 100644 index a355f29a6..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image24.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image24.jpg deleted file mode 100644 index 75d572497..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image26.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image26.jpg deleted file mode 100644 index db5f33af1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image28.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image28.jpg deleted file mode 100644 index f6833107f..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image30.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image30.jpg deleted file mode 100644 index edb3c5419..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image31.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image31.jpg deleted file mode 100644 index 18113488a..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image33.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image33.jpg deleted file mode 100644 index 77668f5dd..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image35.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image35.jpg deleted file mode 100644 index 79aeea3c4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image37.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image37.jpg deleted file mode 100644 index 14ca47668..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image37.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image39.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image39.jpg deleted file mode 100644 index f7530d717..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image39.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image4.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image4.jpg deleted file mode 100644 index d995ab2d4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image41.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image41.jpg deleted file mode 100644 index af7d147d4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image41.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image43.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image43.jpg deleted file mode 100644 index 2743421d8..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image43.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image45.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image45.jpg deleted file mode 100644 index 5e1b1b27d..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image45.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image47.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image47.jpg deleted file mode 100644 index 4f3dfe565..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image47.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image49.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image49.jpg deleted file mode 100644 index ba41b6c7b..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image49.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image51.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image51.jpg deleted file mode 100644 index 0b76601b1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image51.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image53.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image53.jpg deleted file mode 100644 index 549ecaa12..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image53.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image55.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image55.jpg deleted file mode 100644 index cacb0ac69..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image55.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image6.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image6.jpg deleted file mode 100644 index c93c62714..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image8.jpg b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image8.jpg deleted file mode 100644 index 0bbaa3829..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample1.xml b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample1.xml deleted file mode 100644 index 4246fda74..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample1.xml +++ /dev/null @@ -1,17 +0,0 @@ - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample2.cmd b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample2.cmd deleted file mode 100644 index 5da4cdf67..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample2.cmd +++ /dev/null @@ -1,4 +0,0 @@ -msdeploy.exe -verb:sync -source:package=C:\Websites\Packages\Temp\drupalMSDeployPackage.zip - -dest:auto -setParam:name="SiteName",kind=ProviderPath,scope=iisApp,Value=drupal/; - -setParam:name="ConnectionString",kind=ProviderPath,scope=dbMySql,Value=server=localhost; - database=drupal;Uid=drupal;Pwd=password; > DWSpackage7.log \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample3.cmd b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample3.cmd deleted file mode 100644 index 90bdc9c5d..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample3.cmd +++ /dev/null @@ -1,4 +0,0 @@ -[Array]$arguments = "-verb:sync", "-source:contentPath=`"$web_staging_directory`"", - "-dest:contentPath=`"\\$Server\$share\$appname\$web_project_name`"" - $proc = Start-Process $msdeploy -ArgumentList $arguments -NoNewWindow -Wait -PassThru -if($proc.ExitCode -ne 0) { throw "Failed to deploy" } \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample4.ps1 b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample4.ps1 deleted file mode 100644 index b8f1d6b01..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample4.ps1 +++ /dev/null @@ -1,160 +0,0 @@ -# Web Deploy: Powershell script to setup IIS sites for Hosting. -# Copyright (C) Microsoft Corp. 2010 -# -# Requirements: IIS 7, Windows Server 2008 (or higher) -# -# You should use this script if you want to set up a Windows 2008 (or higher) -# server for delegated Web Deploy deployments. -# 1. Create an IIS Site -# 2. Creates an IIS Manager user and assigns it -# permissions to the IIS Site Created -# -# ================= PARAMS ======================= -# -# All of these parameters are required. -# -# $website IIS Web site. -# $iisManagerUsername User name of IIS Manager user -# $iisManagerPassword Password of above user. -# $hostheaderName Web site Host Header/FQDN -# -# All of these parameters are optional. -# -# $wmsvcUsername, -# $directory App physical directory c:\websites by default. -# $serverPort Web site Port 80 by default. -# -# sample usage AddHostingSite.ps1 -# -website MyWebSite01 -# -iisManagerUsername TestUser01 -# -iisManagerPassword TestPass01 -# -hostheaderName www.mysite.com -# -directory c:\Websites -serverPort 80 -param($website, $iisManagerUsername, $iisManagerPassword, $hostheaderName, $wmsvcUsername, $directory, $serverPort) -clear-host -sv APPCMD -value $env:systemroot\system32\inetsrv\AppCmd.exe -# Check if params are missing -if($website -eq $null){ - write-host 'Please specify a website. Script aborting.' - break -} -if($iisManagerUsername -eq $null){ - write-host 'Please supply an IIS Manager username to create account. Script aborting.' - break -} -if($iisManagerPassword -eq $null){ - write-host 'Please supply an IIS Manager password to create account. Script aborting.' - break -} -if($wmsvcUsername -eq $null){ - $wmsvcUsername = "LOCAL SERVICE" -} -if($directory -eq $null){ - $directory = "c:\Websites" -} -if($hostheaderName -eq $null){ - write-host 'Please specify a domain name for the websites host header. Script aborting.' - break -} -if($serverPort -eq $null){ - $serverPort = '80' -} -# ================= GLOBAL VARIABLES ==================== -# IIS management assemblies -$ENV_APPPOOL_NAME = $website + "_AP" -$global:mwaAssembly = $null -$global:mwmAssembly = $null -# the instance Microsoft.Web.Administration.ServerManager we use to interact -# with IIS's administration.config -$global:serverManager = $null -# collection of Web Deploy delegation rules -$global:delegationRulesCollection = $null -# ================ METHODS ======================= -function LoadAssemblies{ - trap [Exception]{ - write-host 'Failed to load Microsoft.Web.*.dll. Are you sure IIS 7 is installed?' - break - } - $global:mwaAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Administration.dll" ) - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:mwmAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Management.dll" ) -} - function NotServerOS{ - $sku = $((gwmi win32_operatingsystem).OperatingSystemSKU) - $server_skus = @(7,8,9,10,12,13,14,15,17,18,19,20,21,22,23,24,25) - - return ($server_skus -notcontains $sku) -} - function CheckDelegationRulesExist{ - trap [Exception]{ - write-host 'Did not find delegation rules in administration.config' - return $false - } - $global:delegationRulesCollection = $serverManager.GetAdministrationConfiguration().GetSection("system.webServer/management/delegation").GetCollection() - - if($global:delegationRulesCollection.Count -eq 0){ - return $false - } - else{ - return $true - } -} -function CreateAndAuthorizeIISManagerUser { - param ($username, $pwd) - trap [Exception]{ - write-host "Could not create and / or authorize IIS Manager user on Default Web Site: $username" - } - [Microsoft.Web.Management.Server.ManagementAuthentication]::CreateUser($username, $pwd) - [Microsoft.Web.Management.Server.ManagementAuthorization]::Grant($username, $website, $FALSE) - write-host "Created IIS Manager user: $username and granted it permissions on website: $website" -} - function GetPhysicalPathOfWebsite{ - $path = "" - if($website -eq $null){ - $path = $serverManager.Sites[0].Applications[0].virtualDirectories[0].physicalPath - } - else{ - $i = 0 - $found = $false - for ($i=0; $i -lt $serverManager.Sites.Count; $i++){ - if($serverManager.Sites[$i].Name -eq $website){ - $found = $true - break; - } - } - if($found){ - $path = $serverManager.Sites[$i].Applications[0].virtualDirectories[0].physicalPath - } - } - # if website doesn't exist, create it - if($path -eq ""){ - $fp = $directory+ "\" +$website - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:serverManager.Sites.Add($website, $fp, 8080) - $global:serverManager.CommitChanges() - new-item $fp -type directory - $path = $fp - # Create the AppPool for this site - Invoke-Expression "$APPCMD add apppool /name:$ENV_APPPOOL_NAME" - Invoke-Expression "$APPCMD set apppool /apppool.name:$ENV_APPPOOL_NAME /processModel.identityType:NetworkService" - Invoke-Expression "$APPCMD add app /site.name:$WebSite /path:/ /physicalPath:`"$path`" /applicationPool:$ENV_APPPOOL_NAME" - - #appcmd add site /name: $website /physicalPath: $path /bindings:http/*:$serverPort: $hostheaderName - - echo $error - write-host "Created new website name: $website, directory: $path , port:$serverport" - } - - return $path -} -#================= Main Script ================= -if(NotServerOS){ - write-host 'Please run this script on a server OS only. Script aborting.' - break -} -LoadAssemblies -$physicalPathOfWebSite = GetPhysicalPathOfWebsite -$physicalPathOfApplicationHost = [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + "\system32\inetsrv\config\applicationHost.config" -CreateAndAuthorizeIISManagerUser $iisManagerUsername $iisManagerPassword \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample5.ps1 b/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample5.ps1 deleted file mode 100644 index 96ef377e1..000000000 --- a/iis/publish/deploying-application-packages/deploying-drupal-via-packages-in-a-hosting-environment/samples/sample5.ps1 +++ /dev/null @@ -1,30 +0,0 @@ -# Powershell Args -$dbusername = $args[0] # Administrative Username -$dbpassword = $args[1] # Administrative Password -$dbname = $args[2] # Database Name to Create -$appUsername = $args[3] # Application Username -$appPassword = $args[4] # Application Users Username -# Add MySQL Data Connector -[void][system.reflection.Assembly]::LoadWithPartialName("MySql.Data") -# Open Connection to SQL Server -$connStr = "server=127.0.0.1;port=3306;uid=root;pwd=SQLPassword" -$conn = New-Object MySql.Data.MySqlClient.MySqlConnection($connStr) -$conn.Open() -# Create MySQL Database -$createmysqldatabase = 'CREATE DATABASE `' + $dbname + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqldatabase, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Create MySQL User -$createmysqluser = 'CREATE USER `' + $appUsername + '`@`localhost` ' + ' identified by `' + $appPassword + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqluser, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Grant permissions to Database -$grantmysqldatabaseperms = 'Grant ALL on ' + $dbname + '.* to `' + $appUsername + '`@`localhost` ' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($grantmysqldatabaseperms, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment.md b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment.md deleted file mode 100644 index 5519ab27b..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment.md +++ /dev/null @@ -1,326 +0,0 @@ ---- -title: "Deploying Joomla! via Packages in a Hosting Environment" -author: simtan -description: "Introduction Joomla! is an open source content management system (CMS) for publishing content to the World Wide Web and intranets. This document provides ste..." -ms.date: 03/10/2011 -ms.assetid: 7816c14c-a519-4fd4-8313-1cbb0baea7f8 -msc.legacyurl: /learn/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment -msc.type: authoredcontent ---- -# Deploying Joomla! via Packages in a Hosting Environment - -by [Simon Tan](https://github.com/simtan) - -Joomla! is an open source content management system (CMS) for publishing content to the World Wide Web and intranets. This document provides step-by-step instructions on how to easily create a package containing the Joomla! application for one-click deployment in a hosting environment. For more information about the Joomla! application, visit the link: [*Windows Web App page for Joomla!*](https://www.microsoft.com/web/gallery/joomla16.aspx). - -Here is a zipped PDF of this complete document: [JoomlaDocPDF](deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v051.zip) - -## Requirements - -Environment Requirements: - -- Windows Server 2008 R2 or greater -- IIS 7.0 or above -- Web Deploy 2.0 - -Application Requirements: - -- PHP 5.2 -- MySQL 5.1 -- Windows Cache 1.1 for PHP - -For information about how to install the necessary components, see the section Step 1. Set Up Your Servers for Hosting. - -## Procedure - -This procedure describes how to install Joomla! using IIS with Web Deploy. IIS with Web Deploy makes installing sites simple and extremely flexible for Hosting Service Providers by allowing them to create deployment packages that include the site, its content, and its database. The package can then be deployed by importing it into IIS via the console or a script. For more information about Web Deploy, refer to the link: [*Web Deploy 2.0 : The Official Microsoft IIS Site*](https://www.iis.net/downloads/microsoft/web-deploy). - -This procedure requires three basic steps: - -Step 1. Set Up Your Servers for Hosting -Step 2. Create an Application Package for Deployment -Step 3. Deploy a Customer Site using IIS with Web Deploy - -### Step 1. Set Up Your Servers for Hosting - -#### Overview - -This step describes the server components that are required to support deployment of install packages via Web Deploy. - -#### Prerequisites - -While it is possible to run a web server and database server on the same machine, it is not recommended due to performance and security reasons. We recommend that you use two separate machines running Windows Server 2008 R2: one acting as the Web server and one acting as the database server. - -> [!NOTE] -> Both machines must be connected to the Internet to download the required server components. - -To simplify installation of the Web server components, installing Web Platform Installer (Web PI) on both machines is highly recommended. Web PI is a tool that automates the installation of a vast majority of server components and other products for Microsoft's Web Platform. - -#### Install Web Server Components on Your Web Server and Database Server - -To install the required components on your Web server and database server using Web PI 3.0, visit the link: [*Install Spotlight Components plus PHP/MySQL related components using Web PI*](https://www.microsoft.com/web/gallery/install.aspx?appid=IIS7;NETFramework35;NETFramework4;ASPNET;MVC;WDeploy;FTPServer;MediaServices3;ManagementService;CGI;URLRewrite2;SMO;PHP52;WinCache52_11;MySQLConnector;SQLDriverPHPForIIS "Install Components") and click **Install,** follow the onscreen instructions. - -> [!NOTE] -> A complete list of components that are installed by default with Web PI 3.0 is included in the Products Installed by Default using Web PI section of this document. You can also review the list of products before installation begins. - -#### Install MySQL on Your Database Server - -To install MySQL, [click here on this link](http://dev.mysql.com/downloads/mysql/5.1.html) to download MySQL 5.1 and complete the steps described in the **Install MySQL on Your Database Server** in this document. - -#### Next Steps - -- If the Web Deploy 2.0 component is newly installed, you must configure it to allow delegated deployments. Refer to the link: [*Configure the Web Deploy Component on the Web Server*](../../web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md) for more information. -- After you install and configure the server components, validate your server configuration by following the procedures described at the link: [*Validate Your Server Configuration*](../../web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md). - -### Step 2. Create an Application Package for Deployment - -This step describes how to export an application package that can be used to quickly provision IIS sites and includes these substeps: - -A. Create an IIS Web Site -B. Install the Application to the IIS Application Web Site -C. Enable Permalinks for Your Application (Optional) -D. Export the Package from the IIS Application Web Site - -#### A. Create an IIS Web Site for this Application - -1. Open Internet Information Services (IIS) Manager. - - The Internet Information Services (IIS) Manager application opens. - ![Screenshot of the Internet Information Services Manager Window. The Sites folder is highlighted.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image1.jpg) -2. Expand your server connection, and click **Sites**. -3. In the Actions area, click the **Add Web Site** link. The Add Web Site dialog box appears. - ![Screenshot of the Add Web Site dialog box.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image3.jpg) -4. Enter a site name for your Web site. -5. In the Physical path field, type the physical path to the folder in which the application is installed, or click the browse button (...) to navigate to the folder. -6. In the Binding area, select the protocol for your Web site from the Type drop-down list. -7. Type the IP address to your Web site in the IP address drop-down list. The default value is All Unassigned. -8. Type a port number in the Port field. -9. Type a host name for the Web site in the Host name field. -10. If you want the Web site to be immediately available and do not need to make further changes, select the **Start Web site immediately** check box. -11. Click **OK**. - -#### B. Install the Application to the IIS Application Web Site - -1. Open Web Platform Installer (Web PI) locally from the Web server. The Web Platform Installer application opens. - ![Screenshot of the Web Platform Installer window. The Joomla application is highlighted.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image5.jpg) -2. Select **Joomla!**, and click **Install**. The Web Platform Installation window appears. - ![Screenshot of the Web Platform Installation window.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image7.jpg) -3. Click **I Accept** to accept the end-user license agreement. - ![Screenshot of the Web Platform Installation window displaying Step 1 of 2.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image9.jpg) -4. From the Web Site drop-down list, select the Web site you created earlier in this procedure. -5. In the application name field, enter an application name if it is different from the default value. - The remaining fields are populated automatically based on your Web site information. -6. Click **Continue**. - ![Screenshot of the Web Platform Installation window displaying Step 2 of 2.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image11.jpg) -7. From the Create a new or use an existing database drop-down list, select **Create new database**. -8. Enter the following information in the appropriate fields to create a new database: - - - Database administrator user name and password—User name and password to allow administrative access to this database. - - Database user name and password—User name and password to allow general access to this database. - - Database server—Name of the server on which this database resides. - - Database name—Name of this database. - - Database prefix—Prefix added to database table names used to identify this database. - - Load sample data—Indicate whether you want to load sample data into this database. - - Web site name—Name of your Web site. - - Site administrator—User name for the Web site specified in the Website Name field. - - Site administrator password—Password for the Web site administrator. - - Site administrator email address—Email address for the Web site administrator. - - > [!NOTE] - > You must scroll down to view all required fields. -9. Click **Continue**. - ![Screenshot of the Web Platform Installation window displaying the successful installation message.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image13.jpg) -10. Once the Web PI process is complete, you can do one of the following: - - - Click **Finish** to complete the installation process. If you click Finish to complete the installation process, proceed to step C. Enable Permalinks (Optional) to continue creating an application package for deployment. - - Click **Launch Joomla!** to launch your Joomla application. If you click Launch Joomla! link, the Joomla! application page appears: - ![Screenshot of a browser window displaying the Joomla! application page.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image15.jpg) - -For information about setting up your Joomla! site, refer to the link: [*Joomla! documentation Web page*](http://help.joomla.org/). - -#### C. Enable Permalinks (Optional) - -By default, Joomla uses query string parameters for all the URLs it generates for your Web site. You can change this default behavior by enabling Search Engine Friendly URLs, a feature which relies on the URL rewriting functionality. To enable permalinks in Joomla, complete these steps: - -1. If it does not already exist, create and open a Web.config file located in the root of the Joomla! install directory; for example: `C:\inetpub\wwwroot\joomla` -2. Paste the following XML code into the file: - - [!code-xml[Main](deploying-joomla-via-packages-in-a-hosting-environment/samples/sample1.xml)] - - **IMPORTANT!** The backslashes (\) in the source code above indicate new lines. The backslashes are not part of the code and should be removed (along with the new line) before you paste the code into the Web.config file. -3. Save the web.config file. -4. Open a Web browser, and log in to the Joomla administrator console at `http://localhost/joomla/administrator/`. -5. Select **Site** > **Global Configuration** to configure the following SEO settings: - - - Search Engine Friendly URLs - **Yes** - - Add suffix to URLs - **No** -6. Click **Apply** to save the configuration. - -#### D. Export the Package from the IIS Application Web Site - -1. Open IIS Manager. - The Internet Information Services (IIS) Manager application opens. - ![Screenshot of the I I S Manager Window. The sites page is open and Joomla! is highlighted.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image17.jpg) -2. In the Connections navigation pane, expand **Sites**, and select the Web site you just created. - ![Screenshot of the I I S Manager window displaying the connections navigation pane.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image19.jpg) -3. Click the **Export Application** link located in the Deploy section of the Actions pane. - - The Export Application Package (Select the Contents of the Package) dialog box appears. - ![Screenshot of the Export Application Package dialog box. Web Application (Joomla!) is highlighted.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image21.jpg) -4. Click **Manage Components**. - - The Manage Components dialog box appears. - ![Screenshot of the Manage Components dialog box.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image23.jpg) -5. Double-click the second row of the Provider Name column. - ![Screenshot of the Manage Components dialog box with the drop down menu of the Provider name column displayed.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image25.jpg) -6. Select **dbMySql** from the drop-down list. - ![Screenshot of the Manage Components dialog box with d b My S Q L selected in the drop down list.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image27.jpg) -7. Double-click the second row of the Path column, and enter the connection string for your package export. - ![Screenshot of the Manage Components dialog box with the Path field displayed.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image29.jpg) -8. Click outside of the box in which you entered the connection string, and click **OK**. - - The newly created parameter now appears in the Export Application Package (Select Parameters) dialog box. - ![Screenshot of the Application Package Select Parameters dialog box.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image31.jpg) -9. Rename the parameters: - - - Select **Parameter 1**, and click **Edit**. - - The Edit Parameter dialog box appears. - ![Screenshot of the Edit Parameter dialog box.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image33.jpg) - - Enter **SiteName** in the Name field, and click **OK**. - - Repeat these steps to rename Parameter 2 to "ConnectionString." - - The parameters appear renamed in the Export Application Package (Select Parameters) dialog box. - ![Screenshot of the Export Application Package Select Parameters dialog box displaying the renamed parameter.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image35.jpg) -10. Click **Next**. - - The Export Application Package (Save Package) dialog box appears. - ![Screenshot of the Export Application Package Save Package dialog box displaying the package path info.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image37.jpg) -11. Enter the path to the application package, or click Browse to locate the application file. -12. Click **Next**. - - The Export Application Package (Export Progress and Summary) dialog box displays the progress of the export process. Once the process is complete, a summary report appears. - ![Screenshot of the Export Application Package on the Export Progress and Summary page. The Summary tab is displayed.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image39.jpg) -13. Click **Finish**.Use this application package to deploy to customer Web sites as described in Step 3. Deploy a Customer Site using IIS with Web Deploy. - - - -### Step 3. Deploy a Customer Site using IIS with Web Deploy - -When deploying a customer site, most Hosting Service Providers use a control panel that allows them to capture the information required for deployment. This information can then be passed to scripts that create the user, configure the site for hosting, create a database, and import the application package. Here are the basic steps required to deploy a customer site: - -A. Create a Customer Application Web Site -B. Create a Customer Application Database -C. Import the Application Package using a CLI Command or PowerShell Script - -#### A. Create a Customer Application Web Site - -To create a customer application Web site, complete the steps described in A. Create an IIS Web Site for this Application. - -**Tips:** - -- When you create the Web site in IIS, give your application a user-friendly name by creating a fully qualified domain name (FQDN) for the host header and adding that FQDN to your Domain Name Service. -- You can automate this process using a script similar to the one described in the section Automated Deployment Script. - -#### B. Create a Customer Application Database - -To create a customer application database, complete these steps: - -1. Open a command-line prompt (or MySQL Manager) at the MySQL bin directory. If you used the default installation path, the bin directory path will be similar to the following: `C:\Program Files\MySQL\MySQL Server 5.1\bin` -2. Enter the administrator password, and press **Enter**. -3. Type the following command to create the database, and press **Enter**. - `mysql> create database Joomla;` -4. Type this command to create a user, and press **Enter**. - `mysql> create user ‘Joomla01'@'localhost' identified by ‘password';` -5. Type this command to grant permissions, and press **Enter**. - `mysql> grant all on Joomla. \* to ‘Joomla01'@'localhost';` - -![Screenshot of a command line prompt displaying the My S Q L database creation steps.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image41.jpg) - -> [!TIP] -> You can automate this process using a script similar to the one described in the section MySQL Database Creation Script. - -#### C. Import the Application Package using a CLI Command or PowerShell Script - -Once you export the application package (as described in Step 2. Create an Application Package for Deployment), you can easily import the package into the customer site using the CLI command or PowerShell script listed below. These methods allow you to add the parameters that are required to configure an application for use. - -The examples in this topic show how to import Joomla! into an IIS Web site and install the application database. This package is configured to allow two parameters: one for the IIS site name and one for the database connection string. - -##### CLI Command - -[!code-console[Main](deploying-joomla-via-packages-in-a-hosting-environment/samples/sample2.cmd)] - -##### PowerShell MSDeploy Script - -[!code-console[Main](deploying-joomla-via-packages-in-a-hosting-environment/samples/sample3.cmd)] - -## Sample Powershell Scripts - -### Automated Website Deployment Script - -[!code-powershell[Main](deploying-joomla-via-packages-in-a-hosting-environment/samples/sample4.ps1)] - -### MySQL Database Creation Script - -[!code-powershell[Main](deploying-joomla-via-packages-in-a-hosting-environment/samples/sample5.ps1)] - -#### Install MySQL on Your Database Server - -1. Download the latest stable version of MySQL from the [official website](http://www.mysql.com/) and run the installer on a dedicated **database server.** - The MySQL Server Instance Configuration Wizard appears. - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The Dedicated My S Q L Server Machine type is selected.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image43.jpg) - - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box displaying the settings options.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image45.jpg) -2. Click the **Dedicated MySQL Server Machine** option button, and click **Next**. -3. Click **Next**. - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The Online Transaction Processing (O L T P) connection type is selected.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image47.jpg) -4. For concurrent connections, click the **Online Transaction Processing (OLTP)** option button (since this option reflects the workload of a typical shared hosting database server), and then click **Next**. - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box displaying the networking options. Enable T C P/ I P Networking option is selected.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image49.jpg) -5. Click the **Enable TCP/IP Networking** check box, and then click the **Add firewall exception for this post** check box. -6. Clear the **Enable Strict Mode** check box if it is checked. - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box displaying the default character setting options. The Best Support for Multilingualism option is selected.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image51.jpg) -7. Click the Best Support For Multilingualism option button to enable support for the UTF-8 character set. - **IMPORTANT!** You must choose the Best Support for Multilingualism option button since several applications in the Web Application Gallery require UTF-8 support in the database. -8. Click **Next**. - ![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box displaying the windows options page. The box for Include Bin Directory in Windows PATH is checked.](deploying-joomla-via-packages-in-a-hosting-environment/_static/image53.jpg) -9. Click the **Include Bin Directory in Windows PATH** check box, and click **Next**. -10. Since MySQL is installed on the database server (which is different than the Web server that runs the Web Deploy web server component), you must complete these steps to ensure Web Deploy can access the database server: - - - Copy mysqldump.exe (typically located in `C:\Program Files\MySQL\MySQL Server 5.1\bin`) to your **Web server** in `C:\mysqldump\mysqldump.exe`. - - On the **Web server**, set a registry key (`HKEY\_LOCAL\_MACHINE\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\1\mysqldumppath`) to string value == "c:\mysqldump\mysqldump.exe" - -> [!NOTE] -> If you lose the credentials to your MySQL database, refer to the link: [*Resetting the Root Password: Windows Systems*](http://dev.mysql.com/doc/refman/5.1/en/resetting-permissions.html#resetting-permissions-windows) to reset your password. - -## Products Installed by Default using Web PI - -This table provides additional information about the products that are installed by default using Web PI: - -| Product | Description | -| --- | --- | -| .NET Framework 3.5 SP1 | .NET Framework 3.5 SP1 is a full cumulative update that contains many new features building incrementally upon .NET Framework 2.0, 3.0, 3.5, and includes cumulative servicing updates to the .NET Framework 2.0 and .NET Framework 3.0 subcomponents. For more information, refer to the link: [*Microsoft Download Center*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en). | -| .NET Framework 4.0 | The .NET Framework is Microsoft's comprehensive and consistent programming model for building applications that have visually stunning user experiences, seamless and secure communication, and the ability to model a range of business processes. For more information, refer to the link: [*.NET Framework Developer Center*](https://msdn.microsoft.com/netframework/aa569263). | -| ASP.NET | ASP.NET is a free web framework that enables great Web applications. Used by millions of developers, it runs some of the biggest sites in the world. For more information, refer to the link: [Microsoft ASP.net](https://www.asp.net/get-started). | -| ASP.NET MVC | ASP.NET MVC is part of the ASP.NET Web application framework and is one of the two different programming models you can use to create ASP.NET Web applications. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/whatisaspmvc). | -| ASP.NET MVC3 | ASP.NET MVC 3 builds on top of the features in ASP.NET MVC 1 and 2, adding on great features that both simplify your code and allow for deeper extensibility. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/mvc3). | -| ASP.NET Web Pages | The ASP.NET Web Forms page framework is a scalable common language runtime programming model that can be used on the server to dynamically generate Web pages. For more information, refer to the Microsoft .net Framework SDK at the link: [*Introduction to ASP.NET Pages*](https://quickstarts.asp.net/QuickStartv20/aspnet/doc/pages/pages.aspx). | -| Common Gateway Interface (CGI) | CGI is a standard for interfacing external programs with information servers on the Internet. For more information, refer to the link: [*CGI: Common Gateway Interface*](http://www.w3.org/CGI/). | -| FTP Publishing Service | The FTP Publishing Service for IIS allows Web content creators to publish content more easily and securely to IIS Web servers using modern Internet publishing standards. For more information, refer to the link: [*FTP Publishing Service*](https://www.iis.net/downloads/microsoft/ftp). | -| IIS 7 Web Server | Internet Information Services (IIS) for Windows Server is a flexible, secure and easy-to-manage Web server for hosting anything on the Web. For more information, refer to the link: [IIS](https://www.iis.net/overview). | -| IIS Remote Management Service | Internet Information Services (IIS) Manager for Remote Administration provides end users and administrators with the ability to securely manage remote IIS servers from Windows 7, Windows Vista, Windows XP, and Windows Server 2003. For more information, refer to the link: [*IIS Manager for Remote Administration*](https://www.iis.net/downloads/microsoft/iis-manager). | -| Media Services 3.0 | IIS Media Services, an integrated HTTP-based media delivery platform, delivers true HD (720p+) live and on-demand streaming, DVR functionality, and real-time analytics support to computers, TVs, and mobile devices. For more information, refer to the link: [*IIS Media Services*](https://www.iis.net/media). | -| Microsoft Driver for PHP for SQL Server 2.0 in IIS | The Microsoft Drivers for PHP for SQL Server provide connectivity to Microsoft SQL Server from PHP applications. For more information, refer to the link: [*Microsoft Drivers for PHP for SQL Server*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=80e44913-24b4-4113-8807-caae6cf2ca05&displaylang=en). | -| Microsoft SQL Server 2008 | SQL Server delivers on Microsoft's Data Platform vision by helping your organization manage your data by enabling you to store data from structured, semi-structured, and unstructured documents within the database. For more information, refer to the link: [*Microsoft SQL Server 2008*](https://www.microsoft.com/sqlserver/2008/en/us/default.aspx). | -| Microsoft Web Deploy 2.0 | Web Deploy (Web Deployment Tool) simplifies the migration, management and deployment of IIS Web servers, Web applications and Web sites. For more information, refer to the link: [*Web Deploy*](https://www.iis.net/downloads/microsoft/web-deploy). | -| MySQL Connector/Net 6.2.3 | Connector/Net is a fully-managed ADO.NET driver for MySQL. For more information, refer to the link: [*MySQL Download Connector/Net*](http://dev.mysql.com/downloads/connector/net/6.2.html). | -| PHP Driver for SQL Server | The SQL Server Driver for PHP v1.1 is designed to enable reliable, scalable integration with SQL Server for PHP applications deployed on the Windows platform. For more information, refer to the link: [*SQL Server Driver for PHP*](https://www.microsoft.com/sqlserver/2005/en/us/php-driver.aspx). | -| PHP | PHP is a general-purpose scripting language that can be embedded into HTML and is especially suited for Web development. For more information, refer to the link: [*PHP*](http://www.php.net/). | -| SQL Server 2008 Management Objects | The SQL Server Management Objects (SMO) is a .NET Framework object model that enables software developers to create client-side applications to manage and administer SQL Server objects and services. For more information, refer to the link: [*Microsoft TechNet SQL Server Management Objects (SMO)*](https://technet.microsoft.com/library/ms162169.aspx). | -| URL Rewrite 2.0 | IIS URL Rewrite 2.0 enables Web administrators to create powerful rules to implement URLs that are easier for users to remember and easier for search engines to find. For more information, refer to the link: [*URL Rewrite*](https://www.iis.net/downloads/microsoft/url-rewrite). | -| Windows Cache 1.1 for PHP | Windows Cache Extension for PHP is a PHP accelerator that is used to increase the speed of PHP applications running on Windows and Windows Server. For more information, refer to the link: [*Windows Cache Extension for PHP*](https://www.iis.net/downloads/microsoft/wincache-extension). | - -## Related Information - -- [*Web Deployment Tool (MS Deploy) Forum*](https://forums.iis.net/1144.aspx) -- [*PHP Manager for IIS 7 Community*](https://www.iis.net/downloads/community/2010/09/php-manager-for-iis-7) -- [*Configure and Optimize the Microsoft Web Platform for PHP Applications*](../../application-frameworks/install-and-configure-php-on-iis/index.md) diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v051.zip b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v051.zip deleted file mode 100644 index 2943d9c8f..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v051.zip and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v052.zip b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v052.zip deleted file mode 100644 index 2943d9c8f..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/deploying-joomla-via-packages-in-a-hosting-environment-993-joomla-v052.zip and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image1.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image1.jpg deleted file mode 100644 index 80b8b8866..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image11.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image11.jpg deleted file mode 100644 index a0dbba870..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image13.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image13.jpg deleted file mode 100644 index ad540c68a..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image15.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image15.jpg deleted file mode 100644 index 55d03cc49..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image17.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image17.jpg deleted file mode 100644 index 28a89e234..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image19.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image19.jpg deleted file mode 100644 index f87fc79be..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image21.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image21.jpg deleted file mode 100644 index d1d03b3e2..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image23.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image23.jpg deleted file mode 100644 index 133319168..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image25.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image25.jpg deleted file mode 100644 index b898d6aa8..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image27.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image27.jpg deleted file mode 100644 index b691053fb..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image29.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image29.jpg deleted file mode 100644 index c189d3331..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image3.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image3.jpg deleted file mode 100644 index 926b881dc..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image31.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image31.jpg deleted file mode 100644 index 0c0e961d0..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image33.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image33.jpg deleted file mode 100644 index 19285d376..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image35.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image35.jpg deleted file mode 100644 index db976fe06..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image37.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image37.jpg deleted file mode 100644 index 513839921..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image37.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image39.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image39.jpg deleted file mode 100644 index af7d147d4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image39.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image41.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image41.jpg deleted file mode 100644 index adfde1f95..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image41.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image43.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image43.jpg deleted file mode 100644 index 2a894d535..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image43.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image45.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image45.jpg deleted file mode 100644 index 94745b0a0..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image45.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image47.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image47.jpg deleted file mode 100644 index 150ef6bf9..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image47.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image49.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image49.jpg deleted file mode 100644 index c391e68be..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image49.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image5.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image5.jpg deleted file mode 100644 index b8e7d2dd5..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image51.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image51.jpg deleted file mode 100644 index 17dace540..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image51.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image53.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image53.jpg deleted file mode 100644 index d67692b94..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image53.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image7.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image7.jpg deleted file mode 100644 index 1a475ac52..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image9.jpg b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image9.jpg deleted file mode 100644 index eb1367cc7..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample1.xml b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample1.xml deleted file mode 100644 index 213c876a0..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample1.xml +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample2.cmd b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample2.cmd deleted file mode 100644 index c47d9a429..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample2.cmd +++ /dev/null @@ -1,4 +0,0 @@ -msdeploy.exe -verb:sync -source:package=C:\Websites\Packages\Temp\JoomlaMSDeployPackage.zip - -dest:auto -setParam:name="SiteName",kind=ProviderPath,scope=iisApp,Value=Joomla/; - -setParam:name="ConnectionString",kind=ProviderPath,scope=dbMySql,Value=server=localhost; - database=Joomla;Uid=Joomla;Pwd=password; > DWSpackage7.log \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample3.cmd b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample3.cmd deleted file mode 100644 index 29e83e05a..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample3.cmd +++ /dev/null @@ -1,6 +0,0 @@ -[Array]$arguments = "-verb:sync", "-source:contentPath=`"$web_staging_directory`"", - "-dest:contentPath=`"\\$Server\$share\$appname\$web_project_name`"" - $proc = Start-Process $msdeploy -ArgumentList $arguments -NoNewWindow -Wait -PassThru -if($proc.ExitCode -ne 0) { -throw "Failed to deploy" -} \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample4.ps1 b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample4.ps1 deleted file mode 100644 index 60eaad942..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample4.ps1 +++ /dev/null @@ -1,159 +0,0 @@ -# Web Deploy: Powershell script to setup IIS Sites for Hosting. -# Copyright (C) Microsoft Corp. 2010 -# -# Requirements: IIS 7, Windows Server 2008 (or higher) -# -# You should use this script if you want to set up a Windows 2008 (or higher) -# server for delegated Web Deploy deployments. -# 1. Create an IIS Site -# 2. Creates an IIS Manager user and assigns it -# permissions to the IIS Site Created -# -# ================= PARAMS ======================= -# -# All of these parameters are required. -# -# $website IIS web site. -# $iisManagerUsername user name of IIS Manager user -# $iisManagerPassword password of above user. -# $hostheaderName Website Host Header/FQDN -# -# All of these parameters are optional. -# -# $wmsvcUsername, -# $directory App physical directory c:\websites by default. -# $serverPort Website Port 80 by default. -# -# sample usage AddHostingSite.ps1 -# -website MyWebSite01 -# -iisManagerUsername TestUser01 -# -iisManagerPassword TestPass01 -# -hostheaderName www.mysite.com -# -directory c:\Websites -serverPort 80 -param($website, $iisManagerUsername, $iisManagerPassword, $hostheaderName, $wmsvcUsername, $directory, $serverPort) -clear-host -sv APPCMD -value $env:systemroot\system32\inetsrv\AppCmd.exe -# Check if params are missing -if($website -eq $null){ - write-host 'Please specify a website. Script aborting.' - break -} -if($iisManagerUsername -eq $null){ - write-host 'Please supply an IIS Manager username to create account. Script aborting.' - break -} -if($iisManagerPassword -eq $null){ - write-host 'Please supply an IIS Manager password to create account. Script aborting.' - break -} -if($wmsvcUsername -eq $null){ - $wmsvcUsername = "LOCAL SERVICE" -} -if($directory -eq $null){ - $directory = "c:\Websites" -} -if($hostheaderName -eq $null){ - write-host 'Please specify a domain name for the websites host header. Script aborting.' - break -} -if($serverPort -eq $null){ - $serverPort = '80' -} -# ================= GLOBAL VARIABLES ==================== -# IIS management assemblies -$ENV_APPPOOL_NAME = $website + "_AP" -$global:mwaAssembly = $null -$global:mwmAssembly = $null -# the instance Microsoft.Web.Administration.ServerManager we use to interact -# with IIS's administration.config -$global:serverManager = $null -# collection of Web Deploy delegation rules -$global:delegationRulesCollection = $null -# ================ METHODS ======================= -function LoadAssemblies{ - trap [Exception]{ - write-host 'Failed to load Microsoft.Web.*.dll. Are you sure IIS 7 is installed?' - break - } - $global:mwaAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Administration.dll" ) - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:mwmAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Management.dll" ) -} - function NotServerOS{ - $sku = $((gwmi win32_operatingsystem).OperatingSystemSKU) - $server_skus = @(7,8,9,10,12,13,14,15,17,18,19,20,21,22,23,24,25) - - return ($server_skus -notcontains $sku) -} - function CheckDelegationRulesExist{ - trap [Exception]{ - write-host 'Did not find delegation rules in administration.config' - return $false - } - $global:delegationRulesCollection = $serverManager.GetAdministrationConfiguration().GetSection("system.webServer/management/delegation").GetCollection() - - if($global:delegationRulesCollection.Count -eq 0){ - return $false - } - else{ - return $true - } -} -function CreateAndAuthorizeIISManagerUser { - param ($username, $pwd) - trap [Exception]{ - write-host "Could not create and / or authorize IIS Manager user on Default Web Site: $username" - } - [Microsoft.Web.Management.Server.ManagementAuthentication]::CreateUser($username, $pwd) - [Microsoft.Web.Management.Server.ManagementAuthorization]::Grant($username, $website, $FALSE) - write-host "Created IIS Manager user: $username and granted it permissions on website: $website" -} function GetPhysicalPathOfWebsite{ - $path = "" - if($website -eq $null){ - $path = $serverManager.Sites[0].Applications[0].virtualDirectories[0].physicalPath - } - else{ - $i = 0 - $found = $false - for ($i=0; $i -lt $serverManager.Sites.Count; $i++){ - if($serverManager.Sites[$i].Name -eq $website){ - $found = $true - break; - } - } - if($found){ - $path = $serverManager.Sites[$i].Applications[0].virtualDirectories[0].physicalPath - } - } - # if website doesn't exist, create it - if($path -eq ""){ - $fp = $directory+ "\" +$website - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:serverManager.Sites.Add($website, $fp, 8080) - $global:serverManager.CommitChanges() - new-item $fp -type directory - $path = $fp - # Create the AppPool for this site - Invoke-Expression "$APPCMD add apppool /name:$ENV_APPPOOL_NAME" - Invoke-Expression "$APPCMD set apppool /apppool.name:$ENV_APPPOOL_NAME /processModel.identityType:NetworkService" - Invoke-Expression "$APPCMD add app /site.name:$WebSite /path:/ /physicalPath:`"$path`" /applicationPool:$ENV_APPPOOL_NAME" - - #appcmd add site /name: $website /physicalPath: $path /bindings:http/*:$serverPort: $hostheaderName - - echo $error - write-host "Created new website name: $website, directory: $path , port:$serverport" - } - - return $path -} -#================= Main Script ================= -if(NotServerOS){ - write-host 'Please run this script on a server OS only. Script aborting.' - break -} -LoadAssemblies -$physicalPathOfWebSite = GetPhysicalPathOfWebsite -$physicalPathOfApplicationHost = [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + "\system32\inetsrv\config\applicationHost.config" -CreateAndAuthorizeIISManagerUser $iisManagerUsername $iisManagerPassword \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample5.ps1 b/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample5.ps1 deleted file mode 100644 index 96ef377e1..000000000 --- a/iis/publish/deploying-application-packages/deploying-joomla-via-packages-in-a-hosting-environment/samples/sample5.ps1 +++ /dev/null @@ -1,30 +0,0 @@ -# Powershell Args -$dbusername = $args[0] # Administrative Username -$dbpassword = $args[1] # Administrative Password -$dbname = $args[2] # Database Name to Create -$appUsername = $args[3] # Application Username -$appPassword = $args[4] # Application Users Username -# Add MySQL Data Connector -[void][system.reflection.Assembly]::LoadWithPartialName("MySql.Data") -# Open Connection to SQL Server -$connStr = "server=127.0.0.1;port=3306;uid=root;pwd=SQLPassword" -$conn = New-Object MySql.Data.MySqlClient.MySqlConnection($connStr) -$conn.Open() -# Create MySQL Database -$createmysqldatabase = 'CREATE DATABASE `' + $dbname + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqldatabase, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Create MySQL User -$createmysqluser = 'CREATE USER `' + $appUsername + '`@`localhost` ' + ' identified by `' + $appPassword + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqluser, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Grant permissions to Database -$grantmysqldatabaseperms = 'Grant ALL on ' + $dbname + '.* to `' + $appUsername + '`@`localhost` ' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($grantmysqldatabaseperms, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment.md b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment.md deleted file mode 100644 index b94a95c03..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment.md +++ /dev/null @@ -1,339 +0,0 @@ ---- -title: "Deploying WordPress via Packages in a Hosting Environment" -author: simtan -description: "Introduction WordPress is a personal publishing platform that focuses on aesthetics, web standards, and usability. This document provides step-by-step instru..." -ms.date: 03/10/2011 -ms.assetid: 6bb2a86b-d812-413a-8802-91c36e398883 -msc.legacyurl: /learn/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment -msc.type: authoredcontent ---- -# Deploying WordPress via Packages in a Hosting Environment - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -WordPress is a personal publishing platform that focuses on aesthetics, web standards, and usability. This document provides step-by-step instructions on how to easily create a package containing the WordPress application for one-click deployment in a hosting environment. For more information about the WordPress application, visit the link: [*Windows Web App page for WordPress*](https://www.microsoft.com/web/gallery/wordpress.aspx). - -Here is a zipped PDF of the complete document: [WordPressDocPDF](deploying-wordpress-via-packages-in-a-hosting-environment/_static/deploying-wordpress-via-packages-in-a-hosting-environment-992-wordpress-v051.zip) - -## Requirements - -Environment Requirements: - -- Windows Server 2008 R2 or greater -- IIS 7.0 or greater -- Web Deploy 2.0 - -Application Requirements: - -- PHP 5.2 -- MySQL 5.1 -- Windows Cache 1.1 for PHP - -For information about how to install the necessary components, see Step 1. Set Up Your Servers for Hosting. - - - -## Procedure - -This procedure describes how to install WordPress using IIS with Web Deploy. IIS Web Deploy makes installing sites simple and extremely flexible for Hosting Service Provider by allowing them to create deployment packages that include the site, its content, and its database. The package can then be deployed by importing it into IIS via the console or a script. For more information about Web Deploy, refer to the link: [*Web Deploy 2.0: The Official Microsoft IIS Site*](https://www.iis.net/downloads/microsoft/web-deploy). - -This procedure requires 3 basic steps: - -Step 1. Set Up Your Servers for Hosting -Step 2. Create an Application Package for Deployment -Step 3. Deploy a Customer Site using IIS with Web Deploy - -### Step 1. Set Up Your Servers for Hosting - - - -#### Overview - -This step describes the server components that are required to support deployment of install packages via Web Deploy. - -#### Prerequisites - -While it is possible to run a web server and database server on the same machine, it is not recommended due to performance and security reasons. We recommend that you use two separate machines running Windows Server 2008 R2: one acting as the Web server and one acting as the database server. - -> [!NOTE] -> Both machines must be connected to the Internet to download the required server components. - -To simplify installation of the Web server components, installing Web Platform Installer (Web PI) on both machines is highly recommended. Web PI is a tool that automates the installation of a vast majority of server components and other products for Microsoft's Web Platform. - -#### Install Web Server Components on Your Web Server and Database Server - -To install the required components on your Web server and database server using Web PI 3.0, visit the link: [Install Spotlight Components plus PHP/MySQL related components using Web PI](https://www.microsoft.com/web/gallery/install.aspx?appid=IIS7;NETFramework35;NETFramework4;ASPNET;MVC;WDeploy;FTPServer;MediaServices3;ManagementService;CGI;URLRewrite2;SMO;PHP52;WinCache52_11;MySQLConnector;SQLDriverPHPForIIS "Install Components") and click **Install**, following the onscreen instructions. - -> [!NOTE] -> A complete list of components that are installed by default with Web PI 3.0 is included in the Products Installed by Default using Web PI section of this document. You can also review the list of products before installation begins. - -#### Install MySQL on your Database Server - -To install MySQL, [click here on this link](http://dev.mysql.com/downloads/mysql/5.1.html) to download MySQL 5.1 and complete the steps described in the **Install MySQL on Your Database Server** in this document. **Next Steps:** - -- If the Web Deploy 2.0 component is newly installed, you must configure it to allow delegated deployments. Refer to the link: *[Configure the Web Deploy Component on the Web Server](../../web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md)* for more information. -- After you install and configure the server components, validate your server configuration by following the procedures described at the link: *[Validate Your Server Configuration](../../web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md)*. - - - -### Step 2. Create an Application Package for Deployment - -This step describes how to export an application package that can be used to quickly provision IIS sites and includes these substeps: - -A. Create an IIS Web Site for this Application -B. Install the Application to the IIS Application Web Site -C. Enable Permalinks (Optional) -D. Export the Package from the IIS Application Web Site - - - -#### A. Create an IIS Web Site for this Application - -1. Open Internet Information Services (IIS) Manager. - The Internet Information Services (IIS) Manager application opens. - [![Screenshot of Internet Information Services I I S Manager application. The Sites node is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image2.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image1.jpg) -2. Expand your server connection, and click **Sites**. -3. In the Actions area, click the **Add Web Site** link. - The Add Web Site dialog box appears. - [![Screenshot of the Add Web Site dialog box. In the Site name box the text Word Press zero one is written. The checkbox next to the Start Web site immediately option is checked.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image4.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image3.jpg) -4. Enter a site name for your Web site. -5. In the Physical path field, type the physical path to the folder in which the application is installed, or click the browse button (...) to navigate to the folder. -6. In the Binding area, select the protocol for your Web site from the Type drop-down list. -7. Type the IP address to your Web site in the IP address drop-down list. The default value is All Unassigned. -8. Type a port number in the Port field. -9. Type a host name for the Web site in the Host name field. -10. If you want the Web site to be immediately available and do not need to make further changes, select the **Start Web site immediately** check box. -11. Click **OK**. - - - -#### B. Install the Application to the IIS Application Web Site - -1. Open Web Platform Installer (Web PI) locally from the web server. - The Web Platform Installer application opens. - [![Screenshot of the Web Platform Installer application. Wordpress is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image6.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image5.jpg) -2. Select **WordPress**, and click **Install**. - - The Web Platform Installation window appears. - [![Screenshot of the Web Platform Installation window. Wordpress appears in the text box. The I Decline and I Accept buttons can be found at the bottom of the pane.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image8.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image7.jpg) -3. Click **I Accept** to accept the end-user license agreement. - [![Screenshot of the Web Platform Installation window. The text Step one of two Enter your site information is found at the top.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image10.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image9.jpg) -4. From the Web Site drop-down list, select the Web site you created earlier in this procedure. -5. In the application name field, enter an application name if it is different from the default value. - The remaining fields are populated automatically based on your Web site information. -6. Click **Continue**. - [![Screenshot of the Web Platform Installation dialog. The text Step two of two Enter application information is found at the top.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image12.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image11.jpg) -7. From the Create a new or use an existing database drop-down list, select **Create new database**. -8. Enter the following information in the appropriate fields to create a new database: - - - Database administrator user name and password—User name and password to allow administrative access to this database. - - Database user name and password—User name and password to allow general access to this database. - - Database server—Name of the server on which this database resides. - - Database name—Name of this database. - - Database prefix—Prefix added to database table names used to identify this database. - - Load sample data—Indicate whether you want to load sample data into this database. - - Web site name—Name of your Web site. - - Site administrator—User name for the Web site specified in the Website Name field. - - Site administrator password—Password for the Web site administrator. - - Site administrator email address—Email address for the Web site administrator. - - > [!NOTE] - > You must scroll down to view all required fields. -9. Click **Continue**. - - [![Screenshot of the Web Platform Installation dialog. The text Congratulations! You have successfully installed the following products is written in the text box. Below it is a button to Launch Word Press.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image14.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image13.jpg) -10. Once the Web PI process is complete, you can do one of the following: - - - Click **Finish** to complete the installation process. If you click Finish to complete the installation process, proceed to step C. Enable Permalinks (Optional) to continue creating an application package for deployment. - - Click **Launch WordPress** to launch your WordPress application. If you click Launch WordPress, the WordPress application page appears: - [![Screenshot of the Word Press application page. Boxes for Blog Title and Your Email are displayed.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image16.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image15.jpg) - -For information about setting up your WordPress site, refer to the link: [WordPress documentation Web page](http://codex.wordpress.org/Main_Page "WordPress documentation Web page"). - - - -#### C. Enable Permalinks (Optional) - -To enable permalinks (search engine friendly URLs) in WordPress, complete these steps: - -1. Log in to WordPress with Administrator user rights. -2. In WordPress, click the **Options** tab. -3. On the Options page, click the **Permalinks** tab. - This step takes you to the page from which you can customize how WordPress generates permalinks for blog posts. -4. On the Permalinks page, select **Custom, specify below**, and enter the following string in the **Custom structure** text box: - "/%year%/%monthnum%/%day%/%postname%/" -5. Click **Update Permalink Structure**. All the blog post links have URLs that follow the format that you have specified; however, if you click any one of those links, the Web server returns a *404 - File Not Found* error. This error occurs because WordPress relies on a URL rewriting capability within the server to rewrite requests that include "pretty permalinks" to an Index.php file. In the next step, you create a rule that provides this capability. -6. Create a rewrite rule. Open the Web.config file that is located in the WordPress install directory, and paste the following XML section into the system.webServer element: - - [!code-xml[Main](deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample1.xml)] - - This rule attempts to match any requested URL. If the URL does not correspond to a file or a folder on the file system, it rewrites the URL to the Index.php file. At that point, WordPress determines which content to serve based on the REQUEST\_URI server variable that contains the original URL before it was modified by this rule. - - - -#### D. Export the Package from the IIS Application Web Site - -1. Open IIS Manager. The Internet Information Services (IIS) Manager application opens. - [![Screenshot of the Internet Information Services I I S Manager application. The Web Deploy zero two node is highlighted and selected. Icons appear in the Home pane.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image18.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image17.jpg) -2. In the Connections navigation pane, expand **Sites**, and select the Web site you just created. - [![Screenshot of the Connections navigation pane in the I I S Manager application. The Sites node is expanded and Word Press zero one is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image20.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image19.jpg) -3. Click the **Export Application** link located in the Deploy section of the Actions pane. - The Export Application Package (Select the Contents of the Package) dialog box appears. - [![Screenshot of the Export Application Package dialog box. The Web Application Word Press zero one selection is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image22.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image21.jpg) -4. Click **Manage Components**. The Manage Components dialog box appears. - [![Screenshot of the Manage Components dialog box. Boxes for Provider Name, Path, and Provider Settings are highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image24.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image23.jpg) -5. Double-click the second row of the Provider Name column. - [![Screenshot of the Manage Components dialog box. The Provider Name column is expanded and a drop-down list appears. The My S Q L database is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image26.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image25.jpg) -6. Select **dbMySql** from the drop-down list. - [![Screenshot of the Manage Components dialog box. In the Provider Name column d b My S Q L is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image28.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image27.jpg) -7. Double-click the second row of the Path column, and enter the connection string for your package export. - [![Screenshot of the Manage Components dialog box. In the Path column, the connection string for package export is written.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image30.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image29.jpg) -8. Click outside of the box in which you entered the connection string, and click **OK**. The newly created parameter now appears in the Export Application Package (Select Parameters) dialog box. - [![Screenshot of the Export Application Package, Select Parameters dialog box. Parameter two is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image32.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image31.jpg) -9. Rename the parameters: - - - Select **Parameter 1**, and click **Edit**. The Edit Parameter dialog box appears. - [![Screenshot of the Edit parameter dialog box. In the Name box is the text Site Name.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image34.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image33.jpg) - - Enter **SiteName** in the Name field, and click **OK**. - - Repeat these steps to rename Parameter 2 to "ConnectionString". The parameters appear renamed in the Export Application Package (Select Parameters) dialog box. - [![Screenshot of the Export Application Package, Select Parameters dialog box. Under Name, Connection String appears.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image36.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image35.jpg) -10. Click **Next**. The Export Application Package (Save Package) dialog box appears. - [![Screenshot of the Export Application Package, Save Package dialog box. The text Specify a file name and location for your package appears. Below that is the Package path box.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image38.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image37.jpg) -11. Enter the path to the application package, or click Browse to locate the application file. -12. Click **Next**. The Export Application Package (Export Progress and Summary) dialog box displays the progress of the export process. Once the process is complete, a summary report appears. - [![Screenshot of the Export Application Package, Save Package dialog box. The Package path box is displayed, and the file name and location of the package is written.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image40.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image39.jpg) -13. Click **Finish**. Use this application package to deploy to customer Web sites as described in Step 3. Deploy a Customer Site using IIS with Web Deploy. - - - -### Step 3. Deploy a Customer Site using IIS with Web Deploy - -#### Overview - -When deploying a customer site, most Hosting Service Providers use a control panel that allows them to capture the information required for deployment. This information can then be passed to scripts that create the user, configure the site for hosting, create a database, and import the application package. Here are the basic steps required to deploy a customer site: - -1. Create a Customer Application Web Site -2. Create a Customer Application Database -3. Import the Application Package using a CLI Command or PowerShell Script - - - -#### A. Create a Customer Application Web Site - -To create a customer application Web site, complete the steps described in A. Create an IIS Web Site for this Application. - -**Tips:** - -- When you create the Web site in IIS, give your application a user-friendly name by creating a fully qualified domain name (FQDN) for the host header and adding that FQDN to your Domain Name Service. -- You can automate this process using a script similar to the one described in the section Automated Deployment Script. - -#### B. Create a Customer Application Database - -To create a customer application database, complete these steps: - -1. Open a command-line prompt (or MySQL Manager) at the MySQL bin directory. If you used the default installation path, the bin directory path will be similar to the following: `C:\Program Files\MySQL\MySQL Server 5.1\bin` -2. Enter the administrator password, and press **Enter**. -3. Type the following command to create the database, and press **Enter**. - mysql> create database wordpress01; -4. Type this command to create a user, and press **Enter**. - mysql> create user ‘wordpressuser'@'localhost' identified by ‘pass@word1'; -5. Type this command to grant permissions, and press **Enter**. - mysql> grant all on wordpress01. \* to ‘wordpress01'@'localhost'; - -Your command window should appear similar to the following: - -[![Screenshot of a command window. The directory path is found at the top of the window.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image42.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image41.jpg) - -> [!TIP] -> You can automate this process using a script similar to the one described in the section MySQL Database Creation Script. - - - -#### C. Import the Application Package using a CLI Command or PowerShell Script - -Once you export the application package (as described in Step 2. Create an Application Package for Deployment), you can easily import the package into the customer site using the CLI command or PowerShell script listed below. These methods allow you to add the parameters that are required to configure an application for use. - -The examples in this topic show how to import WordPress into an IIS Web site and install the application database. This package is configured to allow two parameters: one for the IIS site name and one for the database connection string. - -##### *CLI Command* - -[!code-console[Main](deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample2.cmd)] - -##### *PowerShell Script* - -[!code-console[Main](deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample3.cmd)] - -## Sample Powershell Scripts - - - -##### *Automated Deployment Script* - -[!code-powershell[Main](deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample4.ps1)] - - - -##### *MySQL Database Creation Script* - -[!code-powershell[Main](deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample5.ps1)] - - - -#### Install MySQL on your Database Server - -1. Download the latest stable version of MySQL from the [official website](http://www.mysql.com/) and run the installer on a dedicated database server. The MySQL Server Instance Configuration Wizard appears. - [![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The option for the Dedication My S Q L Server Machine is selected.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image44.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image43.jpg) -2. Click the **Dedicated MySQL Server Machine** option button, and click **Next**.[![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The option for the Dedication My S Q L Server Machine is selected. The Next button is highlighted.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image46.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image45.jpg) -3. Click **Next**.[![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The option for Online Transaction Processing O L T P is selected. In the Concurrent connections box, the number displayed and highlighted is fifteen.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image48.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image47.jpg) -4. For concurrent connections, click the **Online Transaction Processing (OLTP)** option button (since this option reflects the workload of a typical shared hosting database server), and then click **Next**. - [![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The checkbox next to Enable T C P and I P Networking is checked. The Port Number is three three zero six. The option to Add firewall exception for this port is selected.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image50.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image49.jpg) -5. Click the **Enable TCP/IP Networking** check box, and then click the **Add firewall exception for this post** check box. -6. Clear the **Enable Strict Mode** check box if it is checked. - [![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The option for Best Support for Multilingualism is selected. The Character Set chosen is latin one.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image52.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image51.jpg) -7. Click the Best Support For Multilingualism option button to enable support for the UTF-8 character set. - **IMPORTANT!** You must choose the Best Support for Multilingualism option button since several applications in the Web Application Gallery require UTF-8 support in the database. -8. Click **Next**. - [![Screenshot of the My S Q L Server Instance Configuration Wizard dialog box. The option to Include Bin Directory in Windows Path is selected.](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image54.jpg)](deploying-wordpress-via-packages-in-a-hosting-environment/_static/image53.jpg) -9. Click the **Include Bin Directory in Windows PATH** check box, and click **Next**. -10. Since MySQL is installed on the database server (which is different than the Web server that runs the Web Deploy web server component), you must complete these steps to ensure Web Deploy can access the database server: - - - Copy mysqldump.exe (typically located in `C:\Program Files\MySQL\MySQL Server 5.1\bin`) to your **Web server** in `C:\mysqldump\mysqldump.exe`. - - On the **Web server**, set a registry key (`HKEY\_LOCAL\_MACHINE\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\1\mysqldumppath`) to string value == "c:\mysqldump\mysqldump.exe" - -> [!NOTE] -> If you lose the credentials to your MySQL database, refer to the link: [*Resetting the Root Password: Windows Systems*](http://dev.mysql.com/doc/refman/5.1/en/resetting-permissions.html#resetting-permissions-windows) to reset your password. - -## Products Installed by Default using Web PI - -This table provides additional information about the products that are installed by default using Web PI: - -| Product | Description | -| --- | --- | -| .NET Framework 3.5 SP1 | .NET Framework 3.5 SP1 is a full cumulative update that contains many new features building incrementally upon .NET Framework 2.0, 3.0, 3.5, and includes cumulative servicing updates to the .NET Framework 2.0 and .NET Framework 3.0 subcomponents. For more information, refer to the link: [*Microsoft Download Center*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en). | -| .NET Framework 4.0 | The .NET Framework is Microsoft's comprehensive and consistent programming model for building applications that have visually stunning user experiences, seamless and secure communication, and the ability to model a range of business processes. For more information, refer to the link: [*.NET Framework Developer Center*](https://msdn.microsoft.com/netframework/aa569263). | -| ASP.NET | ASP.NET is a free web framework that enables great Web applications. Used by millions of developers, it runs some of the biggest sites in the world. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/get-started). | -| ASP.NET MVC | ASP.NET MVC is part of the ASP.NET Web application framework and is one of the two different programming models you can use to create ASP.NET Web applications. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/whatisaspmvc). | -| ASP.NET MVC3 | ASP.NET MVC 3 builds on top of the features in ASP.NET MVC 1 and 2, adding on great features that both simplify your code and allow for deeper extensibility. For more information, refer to the link: [*Microsoft ASP.net*](https://www.asp.net/mvc/mvc3). | -| ASP.NET Web Pages | The ASP.NET Web Forms page framework is a scalable common language runtime programming model that can be used on the server to dynamically generate Web pages. For more information, refer to the Microsoft .net Framework SDK link: [*Introduction to ASP.NET Pages*](https://quickstarts.asp.net/QuickStartv20/aspnet/doc/pages/pages.aspx). | -| Common Gateway Interface (CGI) | CGI is a standard for interfacing external programs with information servers on the Internet. For more information, refer to the link: [*CGI: Common Gateway Interface*](http://www.w3.org/CGI/). | -| FTP Publishing Service | The FTP Publishing Service for IIS allows Web content creators to publish content more easily and securely to IIS Web servers using modern Internet publishing standards. For more information, refer to the link: [*FTP Publishing Service*](https://www.iis.net/downloads/microsoft/ftp). | -| IIS 7 Web Server | Internet Information Services (IIS) for Windows Server is a flexible, secure and easy-to-manage Web server for hosting anything on the Web. For more information, refer to the link: [*IIS*](https://www.iis.net/overview). | -| IIS Remote Management Service | Internet Information Services (IIS) Manager for Remote Administration provides end users and administrators with the ability to securely manage remote IIS servers from Windows 7, Windows Vista, Windows XP, and Windows Server 2003. For more information, refer to the link: *[IIS Manager for Remote Administration](https://www.iis.net/downloads/microsoft/iis-manager)*. | -| Media Services 3.0 | IIS Media Services, an integrated HTTP-based media delivery platform, delivers true HD (720p+) live and on-demand streaming, DVR functionality, and real-time analytics support to computers, TVs, and mobile devices. For more information, refer to the link: [*IIS Media Services*](https://www.iis.net/media). | -| Microsoft Driver for PHP for SQL Server 2.0 in IIS | The Microsoft Drivers for PHP for SQL Server provide connectivity to Microsoft SQL Server from PHP applications. For more information, refer to the link: [*Microsoft Drivers for PHP for SQL Server*](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=80e44913-24b4-4113-8807-caae6cf2ca05&displaylang=en). | -| Microsoft SQL Server 2008 | SQL Server delivers on Microsoft's Data Platform vision by helping your organization manage your data by enabling you to store data from structured, semi-structured, and unstructured documents within the database. For more information, refer to the link: *[Microsoft SQL Server 2008](https://www.microsoft.com/sqlserver/2008/en/us/default.aspx)*. | -| Microsoft Web Deploy 2.0 | Web Deploy (Web Deployment Tool) simplifies the migration, management and deployment of IIS Web servers, Web applications and Web sites. For more information, refer to the link: [*Web Deploy*](https://www.iis.net/downloads/microsoft/web-deploy). | -| MySQL Connector/Net 6.2.3 | Connector/Net is a fully-managed ADO.NET driver for MySQL. For more information, refer to the link: [MySQL Download Connector/Net](http://dev.mysql.com/downloads/connector/net/6.2.html). | -| PHP Driver for SQL Server | The SQL Server Driver for PHP v1.1 is designed to enable reliable, scalable integration with SQL Server for PHP applications deployed on the Windows platform. For more information, refer to the link: [*SQL Server Driver for PHP*](https://www.microsoft.com/sqlserver/2005/en/us/php-driver.aspx). | -| PHP | PHP is a general-purpose scripting language that can be embedded into HTML and is especially suited for Web development. For more information, refer to the link: [*PHP*](http://www.php.net/). | -| SQL Server 2008 Management Objects | - The SQL Server Management Objects (SMO) is a .NET Framework object model that enables software developers to create client-side applications to manage and administer SQL Server objects and services. For more information, refer to the link: [*Microsoft TechNet SQL Server Management Objects (SMO)*](https://technet.microsoft.com/library/ms162169.aspx). | -| URL Rewrite 2.0 | IIS URL Rewrite 2.0 enables Web administrators to create powerful rules to implement URLs that are easier for users to remember and easier for search engines to find. For more information, refer to the link: [*URL Rewrite*](https://www.iis.net/downloads/microsoft/url-rewrite). | -| Windows Cache 1.1 for PHP | Windows Cache Extension for PHP is a PHP accelerator that is used to increase the speed of PHP applications running on Windows and Windows Server. For more information, refer to the link: [*Windows Cache Extension for PHP*](https://www.iis.net/downloads/microsoft/wincache-extension). | - -## Related Information - -- [*Web Deployment Tool (MS Deploy) Forum*](https://forums.iis.net/1144.aspx) -- [*PHP Manager for IIS 7 Community*](https://www.iis.net/downloads/community/2010/09/php-manager-for-iis-7) -- [*Configure and Optimize the Microsoft Web Platform for PHP Applications*](../../application-frameworks/install-and-configure-php-on-iis/index.md) diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/deploying-wordpress-via-packages-in-a-hosting-environment-992-wordpress-v051.zip b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/deploying-wordpress-via-packages-in-a-hosting-environment-992-wordpress-v051.zip deleted file mode 100644 index 8bc1fa378..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/deploying-wordpress-via-packages-in-a-hosting-environment-992-wordpress-v051.zip and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image1.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image1.jpg deleted file mode 100644 index 886358c98..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image10.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image10.jpg deleted file mode 100644 index 31328f1e4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image11.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image11.jpg deleted file mode 100644 index 32bc3db44..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image12.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image12.jpg deleted file mode 100644 index 32bc3db44..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image13.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image13.jpg deleted file mode 100644 index c4e75ac62..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image14.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image14.jpg deleted file mode 100644 index c4e75ac62..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image15.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image15.jpg deleted file mode 100644 index d27d63b43..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image16.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image16.jpg deleted file mode 100644 index d27d63b43..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image17.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image17.jpg deleted file mode 100644 index e96c6ab48..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image18.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image18.jpg deleted file mode 100644 index e96c6ab48..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image19.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image19.jpg deleted file mode 100644 index 9f2817ed8..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image2.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image2.jpg deleted file mode 100644 index 886358c98..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image20.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image20.jpg deleted file mode 100644 index 9f2817ed8..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image21.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image21.jpg deleted file mode 100644 index 12a8dc81a..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image22.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image22.jpg deleted file mode 100644 index 12a8dc81a..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image23.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image23.jpg deleted file mode 100644 index fbb1c030e..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image24.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image24.jpg deleted file mode 100644 index fbb1c030e..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image25.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image25.jpg deleted file mode 100644 index 4c67ffcca..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image26.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image26.jpg deleted file mode 100644 index 4c67ffcca..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image27.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image27.jpg deleted file mode 100644 index d01b822e7..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image28.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image28.jpg deleted file mode 100644 index d01b822e7..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image29.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image29.jpg deleted file mode 100644 index 06cb61009..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image3.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image3.jpg deleted file mode 100644 index 556f46599..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image30.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image30.jpg deleted file mode 100644 index 06cb61009..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image31.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image31.jpg deleted file mode 100644 index b37d9a4e6..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image32.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image32.jpg deleted file mode 100644 index b37d9a4e6..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image32.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image33.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image33.jpg deleted file mode 100644 index f9e59e0a2..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image34.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image34.jpg deleted file mode 100644 index f9e59e0a2..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image34.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image35.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image35.jpg deleted file mode 100644 index 14ca47668..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image36.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image36.jpg deleted file mode 100644 index 14ca47668..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image36.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image37.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image37.jpg deleted file mode 100644 index cfaa5456e..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image37.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image38.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image38.jpg deleted file mode 100644 index cfaa5456e..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image38.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image39.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image39.jpg deleted file mode 100644 index a9486e169..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image39.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image4.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image4.jpg deleted file mode 100644 index 556f46599..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image40.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image40.jpg deleted file mode 100644 index a9486e169..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image40.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image41.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image41.jpg deleted file mode 100644 index 5560252b0..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image41.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image42.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image42.jpg deleted file mode 100644 index 5560252b0..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image42.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image43.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image43.jpg deleted file mode 100644 index 899b4e8ee..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image43.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image44.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image44.jpg deleted file mode 100644 index 899b4e8ee..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image44.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image45.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image45.jpg deleted file mode 100644 index 5e1b1b27d..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image45.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image46.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image46.jpg deleted file mode 100644 index 5e1b1b27d..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image46.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image47.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image47.jpg deleted file mode 100644 index ba41b6c7b..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image47.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image48.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image48.jpg deleted file mode 100644 index ba41b6c7b..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image48.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image49.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image49.jpg deleted file mode 100644 index 0b76601b1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image49.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image5.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image5.jpg deleted file mode 100644 index 9a5820cc1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image50.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image50.jpg deleted file mode 100644 index 0b76601b1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image50.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image51.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image51.jpg deleted file mode 100644 index 549ecaa12..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image51.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image52.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image52.jpg deleted file mode 100644 index 549ecaa12..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image52.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image53.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image53.jpg deleted file mode 100644 index cacb0ac69..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image53.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image54.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image54.jpg deleted file mode 100644 index cacb0ac69..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image54.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image6.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image6.jpg deleted file mode 100644 index 9a5820cc1..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image7.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image7.jpg deleted file mode 100644 index bc8a7946f..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image8.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image8.jpg deleted file mode 100644 index bc8a7946f..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image9.jpg b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image9.jpg deleted file mode 100644 index 31328f1e4..000000000 Binary files a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample1.xml b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample1.xml deleted file mode 100644 index 1f3ab263b..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample1.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample2.cmd b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample2.cmd deleted file mode 100644 index 65c71c097..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample2.cmd +++ /dev/null @@ -1,4 +0,0 @@ -msdeploy.exe -verb:sync -source:package=C:\Websites\Packages\Temp\WordPressMSDeployPackage.zip - -dest:auto -setParam:name="SiteName",kind=ProviderPath,scope=iisApp,Value=WordPress/; - -setParam:name="ConnectionString",kind=ProviderPath,scope=dbMySql,Value=server=localhost; - database= WordPress;Uid= WordPress;Pwd=password; > DWSpackage7.log \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample3.cmd b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample3.cmd deleted file mode 100644 index b6757864d..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample3.cmd +++ /dev/null @@ -1,6 +0,0 @@ -[Array]$arguments = "-verb:sync", "-source:contentPath=`"$web_staging_directory`"", - "-dest:contentPath=`"\\$Server\$share\$appname\$web_project_name`"" - $proc = Start-Process $msdeploy -ArgumentList $arguments -NoNewWindow -Wait -PassThru -if($proc.ExitCode -ne 0) { -throw "Failed to deploy" -} \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample4.ps1 b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample4.ps1 deleted file mode 100644 index 9d603ad05..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample4.ps1 +++ /dev/null @@ -1,160 +0,0 @@ -# Web Deploy: Powershell script to setup IIS sites for Hosting. -# Copyright (C) Microsoft Corp. 2010 -# -# Requirements: IIS 7, Windows Server 2008 (or higher) -# -# You should use this script if you want to set up a Windows 2008 (or higher) -# server for delegated Web Deploy deployments. -# 1. Create an IIS Site -# 2. Creates an IIS Manager user and assigns it -# permissions to the IIS Site Created -# -# ================= PARAMS ======================= -# -# All of these parameters are required. -# -# $website IIS Web site. -# $iisManagerUsername User name of IIS Manager user -# $iisManagerPassword Password of above user. -# $hostheaderName Web site Host Header/FQDN -# -# All of these parameters are optional. -# -# $wmsvcUsername, -# $directory App physical directory c:\websites by default. -# $serverPort Web site Port 80 by default. -# -# sample usage AddHostingSite.ps1 -# -website MyWebSite01 -# -iisManagerUsername TestUser01 -# -iisManagerPassword TestPass01 -# -hostheaderName www.mysite.com -# -directory c:\Websites -serverPort 80 -param($website, $iisManagerUsername, $iisManagerPassword, $hostheaderName, $wmsvcUsername, $directory, $serverPort) -clear-host -sv APPCMD -value $env:systemroot\system32\inetsrv\AppCmd.exe -# Check if params are missing -if($website -eq $null){ - write-host 'Please specify a website. Script aborting.' - break -} -if($iisManagerUsername -eq $null){ - write-host 'Please supply an IIS Manager username to create account. Script aborting.' - break -} -if($iisManagerPassword -eq $null){ - write-host 'Please supply an IIS Manager password to create account. Script aborting.' - break -} -if($wmsvcUsername -eq $null){ - $wmsvcUsername = "LOCAL SERVICE" -} -if($directory -eq $null){ - $directory = "c:\Websites" -} -if($hostheaderName -eq $null){ - write-host 'Please specify a domain name for the websites host header. Script aborting.' - break -} -if($serverPort -eq $null){ - $serverPort = '80' -} -# ================= GLOBAL VARIABLES ==================== -# IIS management assemblies -$ENV_APPPOOL_NAME = $website + "_AP" -$global:mwaAssembly = $null -$global:mwmAssembly = $null -# the instance Microsoft.Web.Administration.ServerManager we use to interact -# with IIS's administration.config -$global:serverManager = $null -# collection of Web Deploy delegation rules -$global:delegationRulesCollection = $null -# ================ METHODS ======================= -function LoadAssemblies{ - trap [Exception]{ - write-host 'Failed to load Microsoft.Web.*.dll. Are you sure IIS 7 is installed?' - break - } - $global:mwaAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Administration.dll" ) - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:mwmAssembly = [System.Reflection.Assembly]::LoadFrom( [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + - "\system32\inetsrv\Microsoft.Web.Management.dll" ) -} - function NotServerOS{ - $sku = $((gwmi win32_operatingsystem).OperatingSystemSKU) - $server_skus = @(7,8,9,10,12,13,14,15,17,18,19,20,21,22,23,24,25) - - return ($server_skus -notcontains $sku) -} - function CheckDelegationRulesExist{ - trap [Exception]{ - write-host 'Did not find delegation rules in administration.config' - return $false - } - $global:delegationRulesCollection = $serverManager.GetAdministrationConfiguration().GetSection("system.webServer/management/delegation").GetCollection() - - if($global:delegationRulesCollection.Count -eq 0){ - return $false - } - else{ - return $true - } -} -function CreateAndAuthorizeIISManagerUser { - param ($username, $pwd) - trap [Exception]{ - write-host "Could not create and / or authorize IIS Manager user on Default Web Site: $username" - } - [Microsoft.Web.Management.Server.ManagementAuthentication]::CreateUser($username, $pwd) - [Microsoft.Web.Management.Server.ManagementAuthorization]::Grant($username, $website, $FALSE) - write-host "Created IIS Manager user: $username and granted it permissions on website: $website" -} - function GetPhysicalPathOfWebsite{ - $path = "" - if($website -eq $null){ - $path = $serverManager.Sites[0].Applications[0].virtualDirectories[0].physicalPath - } - else{ - $i = 0 - $found = $false - for ($i=0; $i -lt $serverManager.Sites.Count; $i++){ - if($serverManager.Sites[$i].Name -eq $website){ - $found = $true - break; - } - } - if($found){ - $path = $serverManager.Sites[$i].Applications[0].virtualDirectories[0].physicalPath - } - } - # if website doesn't exist, create it - if($path -eq ""){ - $fp = $directory+ "\" +$website - $global:serverManager = (New-Object Microsoft.Web.Administration.ServerManager) - $global:serverManager.Sites.Add($website, $fp, 8080) - $global:serverManager.CommitChanges() - new-item $fp -type directory - $path = $fp - # Create the AppPool for this site - Invoke-Expression "$APPCMD add apppool /name:$ENV_APPPOOL_NAME" - Invoke-Expression "$APPCMD set apppool /apppool.name:$ENV_APPPOOL_NAME /processModel.identityType:NetworkService" - Invoke-Expression "$APPCMD add app /site.name:$WebSite /path:/ /physicalPath:`"$path`" /applicationPool:$ENV_APPPOOL_NAME" - - #appcmd add site /name: $website /physicalPath: $path /bindings:http/*:$serverPort: $hostheaderName - - echo $error - write-host "Created new website name: $website, directory: $path , port:$serverport" - } - - return $path -} -#================= Main Script ================= -if(NotServerOS){ - write-host 'Please run this script on a server OS only. Script aborting.' - break -} -LoadAssemblies -$physicalPathOfWebSite = GetPhysicalPathOfWebsite -$physicalPathOfApplicationHost = [System.Environment]::ExpandEnvironmentVariables("%WINDIR%") + "\system32\inetsrv\config\applicationHost.config" -CreateAndAuthorizeIISManagerUser $iisManagerUsername $iisManagerPassword \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample5.ps1 b/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample5.ps1 deleted file mode 100644 index 96ef377e1..000000000 --- a/iis/publish/deploying-application-packages/deploying-wordpress-via-packages-in-a-hosting-environment/samples/sample5.ps1 +++ /dev/null @@ -1,30 +0,0 @@ -# Powershell Args -$dbusername = $args[0] # Administrative Username -$dbpassword = $args[1] # Administrative Password -$dbname = $args[2] # Database Name to Create -$appUsername = $args[3] # Application Username -$appPassword = $args[4] # Application Users Username -# Add MySQL Data Connector -[void][system.reflection.Assembly]::LoadWithPartialName("MySql.Data") -# Open Connection to SQL Server -$connStr = "server=127.0.0.1;port=3306;uid=root;pwd=SQLPassword" -$conn = New-Object MySql.Data.MySqlClient.MySqlConnection($connStr) -$conn.Open() -# Create MySQL Database -$createmysqldatabase = 'CREATE DATABASE `' + $dbname + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqldatabase, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Create MySQL User -$createmysqluser = 'CREATE USER `' + $appUsername + '`@`localhost` ' + ' identified by `' + $appPassword + '`' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($createmysqluser, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) -# Grant permissions to Database -$grantmysqldatabaseperms = 'Grant ALL on ' + $dbname + '.* to `' + $appUsername + '`@`localhost` ' -$cmd = New-Object MySql.Data.MySqlClient.MySqlCommand($grantmysqldatabaseperms, $conn) -$da = New-Object MySql.Data.MySqlClient.MySqlDataAdapter($cmd) -$ds = New-Object System.Data.DataSet -$da.Fill($ds) \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/dotnetnuke.md b/iis/publish/deploying-application-packages/dotnetnuke.md deleted file mode 100644 index c83a3af38..000000000 --- a/iis/publish/deploying-application-packages/dotnetnuke.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "DotNetNuke" -author: simtan -description: "DotNetNuke is an open source content management system (CMS) and application development framework for Microsoft .NET. For more information about DotNetNuke,..." -ms.date: 03/10/2011 -ms.assetid: 1f316db3-6a70-42c9-866f-168874c282d5 -msc.legacyurl: /learn/publish/deploying-application-packages/dotnetnuke -msc.type: authoredcontent ---- -# DotNetNuke - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -DotNetNuke (DNN) is an open source content management system (CMS) and application development framework for Microsoft .NET. For more information about DotNetNuke, refer to the [DNN Community](https://dnncommunity.org/) Web site. For step-by-step instructions on installing this application in an IIS environment, see the *Procedure* section of this document. - -> ***Note***: The steps listed below will ***not*** install a current version of DNN Platform. After following the steps below it is strongly suggested to upgrade to the current version of DNN Platform following the [Upgrade Process](https://docs.dnncommunity.org/content/getting-started/setup/upgrades/index.html). - -## Requirements - -For information about technical requirements for your IIS environment, refer to [Install Server Components](../../web-hosting/joining-the-web-hosting-gallery/install-server-components.md). - -## Procedure - -### Step 1. Install the application in an IIS test environment. - -To install the application, you can use Web Platform Installer or WebMatrix. These procedures are described in this step. - - - -#### Web Platform Installer - -The Microsoft Web Platform Installer 2.0 (Web PI) is a free tool that allows you to easily install and run the most popular free web applications for blogging, content management and more with the built-in Windows Web Application Gallery. For more information about Web PI, refer to the [Microsoft Web Platform Installer 2.0](https://www.microsoft.com/web/downloads/platform.aspx) Web site. - -To use Web PI to install this application, complete these steps: - -1. From the Windows Start menu, click **Programs**, and then click **Web Platform Installer**. - - The Web Platform Installation window appears. - [![Screenshot that shows the Web Platform Installer, with the Web Applications tab open and the Dot Net Nuke Community Edition checkbox selected.](dotnetnuke/_static/image2.jpg)](dotnetnuke/_static/image1.jpg) -2. Click the **Web Applications** tab, select the **DotNetNuke Community Edition** check box, and click **Install**. - [![Screenshot that shows the Web Platform Installation window, with the Dot Net Nuke Community Edition checkbox selected.](dotnetnuke/_static/image4.jpg)](dotnetnuke/_static/image3.jpg) -3. Select the **DotNetNuke Community Edition** check box, and click **I Accept**. - [![Screenshot that shows Web Platform Installation window, with Mixed Mode Authentication selected and a password entered.](dotnetnuke/_static/image6.jpg)](dotnetnuke/_static/image5.jpg) -4. Select **Mixed Mode Authentication**, enter a password, and click **Continue**. - - Once the preinstallation steps complete, the site information window appears. - [![Screenshot that shows the Web Platform Installation window, with field entries for Web Site, application name, Web Site Name, Physical path, and more.](dotnetnuke/_static/image8.jpg)](dotnetnuke/_static/image7.jpg) -5. In the Web Site list, click **New Web Site**. -6. Enter an application name in the application name field. -7. Enter a web site name in the Web Site Name field. -8. Enter a physical path in the Physical path field. -9. In the IP address list, click **All Unassigned**, and enter **80** in the Port field. -10. Enter a host name in the Host Name field, and click **Continue**. - - Once the installation process completes, the final installation window appears. - [![Screenshot of the Web Platform Installation window that says Congratulations, you have successfully installed the following products.](dotnetnuke/_static/image10.jpg)](dotnetnuke/_static/image9.jpg) -11. Click **Finish**. - - The DotNetNuke Installation Wizard web page appears. - [![Screenshot that shows the Dot Net Nuke Installation web page.](dotnetnuke/_static/image12.jpg)](dotnetnuke/_static/image11.jpg) -12. On the DotNetNuke Installation Wizard web page, select an installation method, choose your language, and click **Next**. - - The Checking File Permissions web page appears. - [![Screenshot that shows the Checking File Permissions web page.](dotnetnuke/_static/image14.jpg)](dotnetnuke/_static/image13.jpg) -13. Once your site passes the permissions check, click **Next**. - - The Configure Database Connection web page appears. - [![Screenshot that shows the Configure Database Connection web page.](dotnetnuke/_static/image16.jpg)](dotnetnuke/_static/image15.jpg) -14. Select the type of database. -15. Enter the name or IP address of the computer where the database is located. -16. Enter the name of the database file. -17. Click the **Integrated Security** check box. -18. Click **Next** to complete the installation. - - - -#### WebMatrix - -WebMatrix is a free, easy way to customize and build Web sites from popular open-source applications, such as WordPress, Drupal, and Joomla. In addition, you can build sites from the ground up using ASP.NET, PHP, HTML and a number of other leading technologies. For more information about WebMatrix, refer to the [WebMatrix](https://www.microsoft.com/web/webmatrix/) Web site. - -To use WebMatrix to install this application, complete these steps: - -1. Launch WebMatrix. - - The WebMatrix home page appears. - [![Screenshot that shows the Web Matrix home page.](dotnetnuke/_static/image18.jpg)](dotnetnuke/_static/image17.jpg) -2. Click **Site From Web Gallery**. - - The Site From Web Gallery page appears. [![Screenshot that shows the Site from Web Gallery page.](dotnetnuke/_static/image20.jpg)](dotnetnuke/_static/image19.jpg) -3. Click **DotNetNuke**, and then click **Next**. - - The Accept EULA page appears. - [![Screenshot that shows the Accept EULA page.](dotnetnuke/_static/image22.jpg)](dotnetnuke/_static/image21.jpg) -4. Click **I Accept** to agree to the end-user license agreement. - - WebMatrix installs the DotNetNuke software on your local computer. This page appears once installation is complete. - [![Screenshot of the Site from Web Gallery page that says Congratulations, you have successfully installed the following products.](dotnetnuke/_static/image24.jpg)](dotnetnuke/_static/image23.jpg) -5. Click **OK** - - The DotNetNuke application starts as indicated in bottom-left corner of the page. - [![Screenshot that shows the Dot Net Nuke application, with Dot Net Nuke Community Edition selected in the left pane.](dotnetnuke/_static/image27.jpg)](dotnetnuke/_static/image26.jpg) -6. Click **Settings** in the left navigation area. - - ![Screenshot that shows the Dot Net Nuke application, with Settings selected in the left pane.](dotnetnuke/_static/image29.jpg) -7. Select **.Net 4 (Integrated)** from the Select .NET Framework Version drop-down list. -8. Select **Publish > Configuration**. - - The Publishing Settings dialog box appears. - [![Screenshot that shows the Publishing Settings dialog box.](dotnetnuke/_static/image32.jpg)](dotnetnuke/_static/image31.jpg) -9. Add your hosting provide and domain-specific information, and click **Validate Connection**. -10. If the connection was successful, click **Apply**, and then click **Publish**. - - WebMatrix determines changes to be made. - [![Screenshot that shows the Publish Preview dialog box.](dotnetnuke/_static/image34.jpg)](dotnetnuke/_static/image33.jpg) -11. Once changes have been determined, check the **Publish to SQL Server** check box, and click **Continue**. - - Once the process completes, the Publish Preview dialog box appears. - [![Screenshot that shows the Publish Preview dialog box with a list of Changed Files and Databases.](dotnetnuke/_static/image36.jpg)](dotnetnuke/_static/image35.jpg) -12. Click **Continue**. - - The status of the publishing process is indicated in the bottom-left corner of the page. - [![Screenshot that shows the Dot Net Nuke application, that says Publish Starting, on the bottom left corner of the application.](dotnetnuke/_static/image40.jpg)](dotnetnuke/_static/image39.jpg) -13. Once publishing is complete, go to your domain, and verify DotNetNuke is running. - [![Screenshot that shows a published Dot Net Nuke web page.](dotnetnuke/_static/image42.jpg)](dotnetnuke/_static/image41.jpg) - -### Step 2. Build the application package from the IIS site. - -To build the application package from the IIS site, complete the steps described in [Export a Package through IIS Manager](../using-web-deploy/export-a-package-through-iis-manager.md). - -### Step 3. Install the application on the target server. - -To install the application on the target server, complete the steps described in [Import a Package through IIS Manager](../using-web-deploy/import-a-package-through-iis-manager.md). diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image1.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image1.jpg deleted file mode 100644 index 7f5a6e8b4..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image10.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image10.jpg deleted file mode 100644 index b6d603979..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image11.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image11.jpg deleted file mode 100644 index f26c97fae..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image12.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image12.jpg deleted file mode 100644 index f26c97fae..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image13.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image13.jpg deleted file mode 100644 index ca3f0a579..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image14.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image14.jpg deleted file mode 100644 index ca3f0a579..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image15.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image15.jpg deleted file mode 100644 index e5c28c77f..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image16.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image16.jpg deleted file mode 100644 index e5c28c77f..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image17.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image17.jpg deleted file mode 100644 index edb5ef2fe..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image18.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image18.jpg deleted file mode 100644 index edb5ef2fe..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image19.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image19.jpg deleted file mode 100644 index 38244ccce..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image2.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image2.jpg deleted file mode 100644 index 7f5a6e8b4..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image20.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image20.jpg deleted file mode 100644 index 38244ccce..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image21.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image21.jpg deleted file mode 100644 index 4850e20fd..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image22.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image22.jpg deleted file mode 100644 index 4850e20fd..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image23.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image23.jpg deleted file mode 100644 index d354e6483..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image24.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image24.jpg deleted file mode 100644 index d354e6483..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image25.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image25.jpg deleted file mode 100644 index 532d75e67..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image26.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image26.jpg deleted file mode 100644 index 975914009..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image27.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image27.jpg deleted file mode 100644 index 975914009..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image28.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image28.jpg deleted file mode 100644 index 02a8dd867..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image29.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image29.jpg deleted file mode 100644 index 02a8dd867..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image3.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image3.jpg deleted file mode 100644 index b5ccccf33..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image30.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image30.jpg deleted file mode 100644 index 532d75e67..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image31.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image31.jpg deleted file mode 100644 index 532d75e67..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image32.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image32.jpg deleted file mode 100644 index 532d75e67..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image32.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image33.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image33.jpg deleted file mode 100644 index b0ee0d51a..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image34.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image34.jpg deleted file mode 100644 index b0ee0d51a..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image34.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image35.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image35.jpg deleted file mode 100644 index f1983c54e..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image36.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image36.jpg deleted file mode 100644 index f1983c54e..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image36.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image37.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image37.jpg deleted file mode 100644 index 9c6fabba7..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image37.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image38.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image38.jpg deleted file mode 100644 index 07b26d3d4..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image38.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image39.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image39.jpg deleted file mode 100644 index 9c6fabba7..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image39.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image4.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image4.jpg deleted file mode 100644 index b5ccccf33..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image40.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image40.jpg deleted file mode 100644 index 9c6fabba7..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image40.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image41.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image41.jpg deleted file mode 100644 index f7a2830be..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image41.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image42.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image42.jpg deleted file mode 100644 index f7a2830be..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image42.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image5.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image5.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image6.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image6.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image7.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image7.jpg deleted file mode 100644 index d3c873643..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image8.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image8.jpg deleted file mode 100644 index d3c873643..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/dotnetnuke/_static/image9.jpg b/iis/publish/deploying-application-packages/dotnetnuke/_static/image9.jpg deleted file mode 100644 index b6d603979..000000000 Binary files a/iis/publish/deploying-application-packages/dotnetnuke/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/provision-an-iis-web-site-in-a-hosting-environment.md b/iis/publish/deploying-application-packages/provision-an-iis-web-site-in-a-hosting-environment.md deleted file mode 100644 index 6d05f7ffc..000000000 --- a/iis/publish/deploying-application-packages/provision-an-iis-web-site-in-a-hosting-environment.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Provision an IIS Web Site in a Hosting Environment" -author: simtan -description: "When provisioning a site, most hosters have some sort of control panel that allows them to capture the information required for provisioning. This informatio..." -ms.date: 03/10/2011 -ms.assetid: e74b2c7d-d37c-44df-9121-4bd9adb2a27d -msc.legacyurl: /learn/publish/deploying-application-packages/provision-an-iis-web-site-in-a-hosting-environment -msc.type: authoredcontent ---- -# Provision an IIS Web Site in a Hosting Environment - -by [Simon Tan](https://github.com/simtan) - -When provisioning a site, most hosters have some sort of control panel that allows them to capture the information required for provisioning. This information can then be passed to simple scripts to create the user, configure it for hosting, create a database, and import the application package. - -Here are the basic steps for provisioning a site: - -1. Gather information from user. - - - What package do they want? - - What is the FQDN? - - What are the database requirements? - - What is the user name for the site? - - What is the site password? - - What is database user name? - - What is the database password? -2. Create a DNS entry for the site that points to the server IP address. -3. Create SQL database(s) (MSSQL or MySQL) for the application (if required). -4. Create database user(s) and apply permissions. -5. Create the IIS site and application pool. - -For more detailed information on how to provision an IIS Web site in a hosting environment, refer to [Configuring Remote Administration and Feature Delegation in IIS](../../manage/remote-administration/configuring-remote-administration-and-feature-delegation-in-iis-7.md). diff --git a/iis/publish/deploying-application-packages/screwturn-wiki.md b/iis/publish/deploying-application-packages/screwturn-wiki.md deleted file mode 100644 index ad801d348..000000000 --- a/iis/publish/deploying-application-packages/screwturn-wiki.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "ScrewTurn Wiki" -author: simtan -description: "ScrewTurn Wiki is a free, open source wiki application that is based on Microsoft ASP.NET 3.5 and allows you to create, manage and share wikis. For more info..." -ms.date: 03/10/2011 -ms.assetid: 699208be-cc38-4579-bf6f-29e93c8d4c7f -msc.legacyurl: /learn/publish/deploying-application-packages/screwturn-wiki -msc.type: authoredcontent ---- -# ScrewTurn Wiki - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -ScrewTurn Wiki is a free, open source wiki application that is based on Microsoft ASP.NET 3.5 and allows you to create, manage and share wikis. - -## Requirements - -For information about technical requirements for your IIS environment, refer to [Install Server Components](../../web-hosting/joining-the-web-hosting-gallery/install-server-components.md). - -## Procedure - -### Step 1. Install the application in an IIS test environment. - -To install the application, you can use Web Platform Installer or WebMatrix. These procedures are described in this step. - -#### Web Platform Installer - -The Microsoft Web Platform Installer 2.0 (Web PI) is a free tool that allows you to easily install and run the most popular free web applications for blogging, content management and more with the built-in Windows Web Application Gallery. For more information about Web PI, refer to the [Microsoft Web Platform Installer 2.0](https://www.microsoft.com/web/downloads/platform.aspx) Web site. - -To use Web PI to install this application, complete these steps: - -1. From the Windows Start menu, click **Programs**, and then click **Web Platform Installer**. - - The Web Platform Installation window appears. - [![Screenshot shows Web Platform Installation window to select a web application and install.](screwturn-wiki/_static/image2.jpg)](screwturn-wiki/_static/image1.jpg) -2. Click the **Web Applications** tab, select the **ScrewTurn Wiki 3.0** check box, and click **Install**. - - [![Screenshot shows the web application license agreement.](screwturn-wiki/_static/image4.jpg)](screwturn-wiki/_static/image3.jpg) -3. Select the **ScrewTurn Wiki 3.0** check box, and click **I Accept**. - - [![Screenshot shows authentication modes and password fields to complete installation.](screwturn-wiki/_static/image6.jpg)](screwturn-wiki/_static/image5.jpg) -4. Select **Mixed Mode Authentication**, enter a password, and click **Continue**. - - Once the preinstallation steps complete, the site information window appears. - [![Screenshot shows site information fields to enter the site information.](screwturn-wiki/_static/image8.jpg)](screwturn-wiki/_static/image7.jpg) -5. In the Web Site list, click **New Web Site**. -6. Enter an application name in the application name field. -7. Enter a web site name in the Web Site Name field. -8. Enter a physical path in the Physical path field. -9. In the IP address list, click **All Unassigned**, and enter **80** in the Port field. -10. Enter a host name in the Host Name field, and click **Continue**. - - The application information window appears. - [![Screenshot shows application information window to enter database details.](screwturn-wiki/_static/image10.jpg)](screwturn-wiki/_static/image9.jpg) -11. In the Choose your database list, click **SQL Server**. -12. In the Create a new or use an existing database list, click **Create new database**. -13. Enter a database administrator user name in the Database Admin Username field. -14. Enter a password in the Database Admin Password field. -15. Click **Continue**. - - Once the installation process completes, the final installation window appears. - [![Screenshot shows that the products were installed successfully.](screwturn-wiki/_static/image12.jpg)](screwturn-wiki/_static/image11.jpg) -16. Click **Finish**. - - The ScrewTurn Wiki web page appears. From this web page, you can edit the ScrewTurn Wiki home page and create new pages. - [![Screenshot shows the ScrewTurn application home page.](screwturn-wiki/_static/image14.jpg)](screwturn-wiki/_static/image13.jpg) - -#### WebMatrix - -WebMatrix is a free, easy way to customize and build Web sites from popular open-source applications, such as WordPress, Drupal, and Joomla. In addition, you can build sites from the ground up using ASP.NET, PHP, HTML and a number of other leading technologies. For more information about WebMatrix, refer to the [WebMatrix](https://www.microsoft.com/web/webmatrix/) Web site. - -To use WebMatrix to install this application, complete these steps: - -1. Launch WebMatrix. - - The WebMatrix home page appears. - [![Screenshot shows the WebMatrix home page.](screwturn-wiki/_static/image16.jpg)](screwturn-wiki/_static/image15.jpg) -2. Click **Site From Web Gallery**. - - The Site From Web Gallery page appears. - [![Screenshot shows the Site from Web Gallery page.](screwturn-wiki/_static/image18.jpg)](screwturn-wiki/_static/image17.jpg) -3. Click **ScrewTurn Wiki**, and then click **Next**. - - [![Screenshot shows the type of database engine and the location to install.](screwturn-wiki/_static/image20.jpg)](screwturn-wiki/_static/image19.jpg) -4. Click **SQL Server**, and choose the location in which you want to install the database from the drop-down list. -5. Click **Next**. - - [![[Screenshot shows authentication modes and password fields to complete the installation.](screwturn-wiki/_static/image23.jpg)](screwturn-wiki/_static/image22.jpg) -6. Click **Mixed Mode Authentication**, and enter a password for your administrator. -7. Click **Next**. - - The Accept EULA page appears. - [![Screenshot shows E U L A End User License Agreement.](screwturn-wiki/_static/image25.jpg)](screwturn-wiki/_static/image24.jpg) -8. Click **I Accept** to agree to the end-user license agreement. - - WebMatrix installs the ScrewTurn Wiki software on your local computer. During installation, this page appears. - [![Screenshot shows the ScrewTurn wiki software installation fields.](screwturn-wiki/_static/image27.jpg)](screwturn-wiki/_static/image26.jpg) -9. Enter information based on your environment, and click **Next**. - - Once installation is complete, this page appears. - [![Screenshot shows the products were installed successfully.](screwturn-wiki/_static/image30.jpg)](screwturn-wiki/_static/image29.jpg) -10. Click **OK**. - - The ScrewTurn Wiki application starts as indicated in bottom-left corner of the page. - [![Screenshot shows the installation of ScrewTurn wiki 3 point zero application started.](screwturn-wiki/_static/image32.jpg)](screwturn-wiki/_static/image31.jpg) -11. Click **Settings** in the left navigation area. - - [![Screenshot shows Settings page to select the dot NET framework version.](screwturn-wiki/_static/image34.jpg)](screwturn-wiki/_static/image33.jpg) -12. Select **.Net 4 (Integrated)** from the Select .NET Framework Version drop-down list. -13. Select **Publish > Configure**. - - The Publishing Settings dialog box appears. - [![Screenshot shows the Publishing Settings dialog box to validate connection to the server and publish.](screwturn-wiki/_static/image36.jpg)](screwturn-wiki/_static/image35.jpg) -14. Add your hosting provide and domain-specific information, and click **Validate Connection**. -15. If the connection was successful, click **Apply**, and then click **Publish**. - - The Publish Preview dialog box appears. - [![Screenshot shows the preview of all the changed files.](screwturn-wiki/_static/image38.jpg)](screwturn-wiki/_static/image37.jpg) -16. Click **Continue**. - - The status of the publishing process is indicated in the bottom-left corner of the page. - [![Screenshot shows the status of the publish process.](screwturn-wiki/_static/image40.jpg)](screwturn-wiki/_static/image39.jpg) -17. Once publishing is complete, go to your domain, and verify DotNetNuke is running. - [![Screenshot shows the Main page of the ScrewTurn wiki application.](screwturn-wiki/_static/image42.jpg)](screwturn-wiki/_static/image41.jpg) - -### Step 2. Build the application package from the IIS site. - -To build the application package from the IIS site, complete the steps described in [Export a Package through IIS Manager](../using-web-deploy/export-a-package-through-iis-manager.md). - -### Step 3. Install the application on the target server. - -To install the application on the target server, complete the steps described in [Import a Package through IIS Manager](../using-web-deploy/import-a-package-through-iis-manager.md). diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image1.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image1.jpg deleted file mode 100644 index 4921a270b..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image10.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image10.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image11.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image11.jpg deleted file mode 100644 index d9765ddcd..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image12.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image12.jpg deleted file mode 100644 index d9765ddcd..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image13.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image13.jpg deleted file mode 100644 index 29491935a..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image14.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image14.jpg deleted file mode 100644 index 29491935a..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image15.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image15.jpg deleted file mode 100644 index 398a9780d..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image16.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image16.jpg deleted file mode 100644 index 398a9780d..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image17.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image17.jpg deleted file mode 100644 index f0c661d67..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image18.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image18.jpg deleted file mode 100644 index f0c661d67..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image19.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image19.jpg deleted file mode 100644 index 91e515977..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image2.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image2.jpg deleted file mode 100644 index 4921a270b..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image20.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image20.jpg deleted file mode 100644 index 91e515977..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image21.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image21.jpg deleted file mode 100644 index 532d75e67..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image22.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image22.jpg deleted file mode 100644 index abfa70806..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image23.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image23.jpg deleted file mode 100644 index abfa70806..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image24.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image24.jpg deleted file mode 100644 index d374d4711..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image25.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image25.jpg deleted file mode 100644 index d374d4711..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image26.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image26.jpg deleted file mode 100644 index 6c2f8b532..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image27.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image27.jpg deleted file mode 100644 index 6c2f8b532..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image28.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image28.jpg deleted file mode 100644 index d354e6483..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image29.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image29.jpg deleted file mode 100644 index 8e7b517e3..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image3.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image3.jpg deleted file mode 100644 index 190e6606a..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image30.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image30.jpg deleted file mode 100644 index 8e7b517e3..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image31.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image31.jpg deleted file mode 100644 index 464f6d718..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image32.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image32.jpg deleted file mode 100644 index 464f6d718..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image32.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image33.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image33.jpg deleted file mode 100644 index 3a4db9138..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image33.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image34.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image34.jpg deleted file mode 100644 index 3a4db9138..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image34.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image35.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image35.jpg deleted file mode 100644 index 0774f6111..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image35.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image36.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image36.jpg deleted file mode 100644 index 0774f6111..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image36.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image37.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image37.jpg deleted file mode 100644 index c8c41b8b5..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image37.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image38.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image38.jpg deleted file mode 100644 index c8c41b8b5..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image38.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image39.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image39.jpg deleted file mode 100644 index afe12f916..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image39.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image4.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image4.jpg deleted file mode 100644 index 190e6606a..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image40.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image40.jpg deleted file mode 100644 index afe12f916..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image40.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image41.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image41.jpg deleted file mode 100644 index 765b4f2bb..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image41.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image42.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image42.jpg deleted file mode 100644 index 765b4f2bb..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image42.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image5.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image5.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image6.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image6.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image7.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image7.jpg deleted file mode 100644 index 0dd95462c..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image8.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image8.jpg deleted file mode 100644 index 0dd95462c..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image9.jpg b/iis/publish/deploying-application-packages/screwturn-wiki/_static/image9.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/screwturn-wiki/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing.md b/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing.md deleted file mode 100644 index 93b07233f..000000000 --- a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Taking an Application Offline before Publishing" -author: rick-anderson -description: "In Web Deploy V3, we added support to automatically take an ASP.Net application offline before publishing to it. This is useful if a user wants to ensure tha..." -ms.date: 07/26/2012 -ms.assetid: 116712ee-4e7c-4042-8c7d-12dccbff8254 -msc.legacyurl: /learn/publish/deploying-application-packages/taking-an-application-offline-before-publishing -msc.type: authoredcontent ---- -# Taking an Application Offline before Publishing - -by [Harsh Mittal](https://twitter.com/harshmittal) - -In Web Deploy V3, we added support to automatically take an ASP.Net application offline before publishing to it. This is useful if a user wants to ensure that their application does not have a lock on a file (e.g. SQL CE sdf files which only allow one connection to the file at a time) being overwritten, or if they want to ensure that visitors to their site cannot affect the publish process. The way it works is if Web Deploy detects that a change needs to be made on the destination server, it will automatically drop a blank App\_Offline.htm file into the root of the application folder. When ASP.Net detects that a file by the name of "App\_Offline.htm" exists, it will automatically bring down the app domain hosting the application. When the publish process is completed, the App\_Offline.htm file will be removed and the site will be online again. - -## Enabling Application Offline - -Web Deploy takes an application offline by using the "AppOffline" rule, which is off by default. If a client wishes to turn it on during a publish operation, it simply needs to enable the rule. Here is an example of how to do this from the command line (executable lives under `%programfiles%\IIS\Microsoft Web Deploy V3`): - -[!code-console[Main](taking-an-application-offline-before-publishing/samples/sample1.cmd)] - -## What happens when a publish fails - -If an error occurred during publishing, the htm file will remain in the site root to keep it offline because it is now in an unknown state. After fixing your publishing issue, you will need to bring the application back online. To do this, you can either manually delete the App\_Offline.htm file from your application root on the server, or republish your site. Here is an example of how to delete the App\_Offline.htm file from the command line: - -[!code-console[Main](taking-an-application-offline-before-publishing/samples/sample2.cmd)] diff --git a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample1.cmd b/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample1.cmd deleted file mode 100644 index 8c3d2552b..000000000 --- a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy.exe -verb:sync -source:iisApp=mySite -dest:auto,computername= -enableRule:AppOffline \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample2.cmd b/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample2.cmd deleted file mode 100644 index 47d13ff93..000000000 --- a/iis/publish/deploying-application-packages/taking-an-application-offline-before-publishing/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy.exe -verb:delete -dest:contentPath=siteName/App_Offline.htm,computername= \ No newline at end of file diff --git a/iis/publish/deploying-application-packages/umbraco.md b/iis/publish/deploying-application-packages/umbraco.md deleted file mode 100644 index 5730fb2c9..000000000 --- a/iis/publish/deploying-application-packages/umbraco.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: "Umbraco" -author: simtan -description: "Umbraco is an open source content management system (CMS) built on the Microsoft ASP.NET Framework. For more information about Umbraco, refer to the Umbraco..." -ms.date: 03/10/2011 -ms.assetid: ab653acc-610e-4d26-b828-2d56a6927814 -msc.legacyurl: /learn/publish/deploying-application-packages/umbraco -msc.type: authoredcontent ---- -# Umbraco - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -Umbraco is an open source content management system (CMS) built on the Microsoft ASP.NET Framework. For more information about Umbraco, refer to the [Umbraco](http://www.umbraco.org/ "Umbraco") Web site. For step-by-step instructions for installing Umbraco in an IIS environment, see the *Procedure* section of this topic. - -## Requirements - -For information about technical requirements for your IIS environment, refer to [Install Server Components](../../web-hosting/joining-the-web-hosting-gallery/install-server-components.md). - -## Procedure - -### Step 1. Install the application in an IIS test environment. - -To install the application, you can use Web Platform Installer or WebMatrix. These procedures are described in this step. - -#### Web Platform Installer - -The Microsoft Web Platform Installer 2.0 (Web PI) is a free tool that allows you to easily install and run the most popular free web applications for blogging, content management and more with the built-in Windows Web Application Gallery. For more information about Web PI, refer to the [Microsoft Web Platform Installer 2.0](https://www.microsoft.com/web/downloads/platform.aspx) Web site. - -To use Web PI to install this application, complete these steps: - -1. From the Windows Start menu, click **Programs**, and then click **Web Platform Installer**. - - The Web Platform Installation window appears. - ![Screenshot of the Web Platform Installer wizard's Web Applications tab.](umbraco/_static/image1.jpg) -2. Click the **Web Applications** tab, select the **Umbraco CMS** check box, and click **Install**. - - ![Screenshot of the Web Platform with the Umbraco C M S option being selected.](umbraco/_static/image3.jpg) -3. Select the **Umbraco CMS** check box, and click **I Accept**. - - ![Screenshot of the Web Platform Installation screen showing the Mixed Mode Authentication option being selected.](umbraco/_static/image5.jpg) -4. Select **Mixed Mode Authentication**, enter a password, and click **Continue**. - - Once the preinstallation steps complete, the site information window appears. - ![Screenshot of the Enter your site information screen, showing various pre installation steps.](umbraco/_static/image7.jpg) -5. In the Web Site list, click **New Web Site**. -6. Enter an application name in the application name field. -7. Enter a web site name in the Web Site Name field. -8. Enter a physical path in the Physical path field. -9. In the IP address list, click **All Unassigned**, and enter **80** in the Port field. -10. Enter a host name in the Host Name field, and click **Continue**. - - The application information window appears. - ![Screenshot of the Enter application information window.](umbraco/_static/image9.jpg) -11. In the Choose your database list, click **SQL Server**. -12. In the Create a new or use an existing database list, click **Create new database**. -13. Enter a database administrator user name in the Database Admin Username field. -14. Enter a password in the Database Admin Password field. -15. Click **Continue**. - - Once the installation process completes, the final installation window appears. - ![Screenshot of the Web Platform Installation window stating that Launch Umbraco C M S has been successfully installed.](umbraco/_static/image11.jpg) -16. Click **Finish**. - - The Umbraco Configuration Wizard appears. From this window, you can configure the Umbraco application and view additional information about the Umbraco application. - ![Screenshot of the Umbraco Configuration Wizard.](umbraco/_static/image13.jpg) - -#### WebMatrix - -WebMatrix is a free, easy way to customize and build Web sites from popular open-source applications, such as WordPress, Drupal, and Joomla. In addition, you can build sites from the ground up using ASP.NET, PHP, HTML and a number of other leading technologies. For more information about WebMatrix, refer to the [WebMatrix](https://www.microsoft.com/web/webmatrix/) Web site. - -To use WebMatrix to install this application, complete these steps: - -1. Launch WebMatrix. - - The WebMatrix home page appears. - ![Screenshot of the Microsoft WebMatrix home page.](umbraco/_static/image15.jpg) -2. Click **Site from Web Gallery**. - - The Site from Web Gallery page appears. - ![Screenshot of the Site from Web Gallery page.](umbraco/_static/image17.jpg) -3. Click **Umbraco CMS**, and then click **Next**. - - The Accept EULA page appears. - ![Screenshot of the Accept E U L A page, showing an Umbraco C M S downloadable file.](umbraco/_static/image19.jpg) -4. Click **I Accept** to agree to the end-user license agreement. - - The Application Parameters page appears. - ![Screenshot of the Application Parameters page.](umbraco/_static/image21.jpg) -5. Enter information appropriate to your environment, and click **Next**. - - WebMatrix installs the Umbraco software on your local computer. This page appears once installation is complete. - ![Screenshot of the Site from Web Gallery page showing that Umbraco C M S has been installed.](umbraco/_static/image23.jpg) -6. Click **OK**. - - The Publishing Settings page appears. - ![Screenshot of the Publishing Settings page.](umbraco/_static/image25.jpg) -7. Add your hosting provide and domain-specific information, and click **Validate Connection**. -8. If the connection was successful, click **Apply**, and then click **Publish**. - - The Publish Preview page appears. - ![Screenshot of the Publish Preview page, showing the Change Files and Databases sections.](umbraco/_static/image27.jpg) -9. Click **Continue**. - - Once publishing is complete, the Deployment Details dialog box appears. - ![Screenshot of the Deployment Details dialog box.](umbraco/_static/image29.jpg) -10. Click **OK**. - -The Umbraco Configuration Wizard appears. From this window, you can configure the Umbraco application and view additional information about the Umbraco application. -![Screenshot of the Umbraco Configuration Wizard, reading Thank you for choosing umbraco.](umbraco/_static/image31.jpg) - -### Step 2. Build the application package from the IIS site. - -To build the application package from the IIS site, complete the steps described in [Export a Package through IIS Manager](../using-web-deploy/export-a-package-through-iis-manager.md). - -### Step 3. Install the application on the target server. - -To install the application on the target server, complete the steps described in [Import a Package through IIS Manager](../using-web-deploy/import-a-package-through-iis-manager.md). diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image1.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image1.jpg deleted file mode 100644 index 399b65b28..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image1.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image10.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image10.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image10.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image11.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image11.jpg deleted file mode 100644 index fbc84757c..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image11.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image12.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image12.jpg deleted file mode 100644 index fbc84757c..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image12.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image13.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image13.jpg deleted file mode 100644 index c375c50aa..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image13.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image14.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image14.jpg deleted file mode 100644 index c375c50aa..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image14.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image15.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image15.jpg deleted file mode 100644 index 9f726621e..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image15.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image16.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image16.jpg deleted file mode 100644 index 9f726621e..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image16.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image17.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image17.jpg deleted file mode 100644 index 459a84971..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image17.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image18.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image18.jpg deleted file mode 100644 index 459a84971..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image18.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image19.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image19.jpg deleted file mode 100644 index 9076576c2..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image19.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image2.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image2.jpg deleted file mode 100644 index 399b65b28..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image2.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image20.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image20.jpg deleted file mode 100644 index 9076576c2..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image20.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image21.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image21.jpg deleted file mode 100644 index b06cbf96e..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image21.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image22.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image22.jpg deleted file mode 100644 index b06cbf96e..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image22.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image23.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image23.jpg deleted file mode 100644 index a5c012bd3..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image23.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image24.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image24.jpg deleted file mode 100644 index a5c012bd3..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image24.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image25.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image25.jpg deleted file mode 100644 index ae80f48ae..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image25.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image26.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image26.jpg deleted file mode 100644 index ae80f48ae..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image26.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image27.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image27.jpg deleted file mode 100644 index a47df6e91..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image27.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image28.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image28.jpg deleted file mode 100644 index a47df6e91..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image28.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image29.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image29.jpg deleted file mode 100644 index 7ff3e79bc..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image29.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image3.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image3.jpg deleted file mode 100644 index 8332edbd8..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image3.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image30.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image30.jpg deleted file mode 100644 index 7ff3e79bc..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image30.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image31.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image31.jpg deleted file mode 100644 index a0e92ca12..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image31.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image32.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image32.jpg deleted file mode 100644 index a0e92ca12..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image32.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image4.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image4.jpg deleted file mode 100644 index 8332edbd8..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image4.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image5.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image5.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image5.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image6.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image6.jpg deleted file mode 100644 index e626c3469..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image6.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image7.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image7.jpg deleted file mode 100644 index d35f83aec..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image7.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image8.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image8.jpg deleted file mode 100644 index d35f83aec..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image8.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/umbraco/_static/image9.jpg b/iis/publish/deploying-application-packages/umbraco/_static/image9.jpg deleted file mode 100644 index 2e117492d..000000000 Binary files a/iis/publish/deploying-application-packages/umbraco/_static/image9.jpg and /dev/null differ diff --git a/iis/publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform.md b/iis/publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform.md deleted file mode 100644 index 04b237305..000000000 --- a/iis/publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Videocast: Simplified Application Deployment on the Microsoft Web Platform" -author: rick-anderson -description: "Mai-lan Tomsen Bukovec has published a series of videos that target developers and users who want to experience a simplified deployment experience for apps a..." -ms.date: 05/08/2009 -ms.assetid: 18e9b55a-025f-4053-a1ca-3a4a9fade24d -msc.legacyurl: /learn/publish/deploying-application-packages/videocast-simplified-application-deployment-on-the-microsoft-web-platform -msc.type: authoredcontent ---- -# Videocast: Simplified Application Deployment on the Microsoft Web Platform - -by IIS Team - -Mai-lan Tomsen Bukovec has published a series of videos that target developers and users who want to experience a simplified deployment experience for apps and the Web stack on Windows, focusing particularly on ASP.NET and PHP open source community applications. - -## For developers - -- **Make sure that you have the latest Microsoft Web platform tools** (including the Microsoft Web server, applications and frameworks, database and tools, as well as PHP), watch the [Staying Current with the Latest Web Platform with Web Platform Installer](https://blogs.iis.net/mailant/archive/2009/05/02/real-world-iis-staying-current-with-the-latest-microsoft-web-platform-with-web-platform-installer-videocast.aspx) videocast (7 minutes). -- **Add required Web Deployment tool integration for the Windows Web App Gallery** and/or simplify installation on Windows, watch [Adding Web Deployment Tool Support to Community Application Zip Packages](https://blogs.iis.net/mailant/archive/2009/05/04/real-world-iis-adding-web-deployment-tool.aspx) (12 minutes). This video explains how to add Web Deployment Tool manifest files to a community application zip file (WordPress in this case) for easier deployment on Windows. -- **Find a community application that deploys easily on Windows and learn how to re-package that app with customizations** for deployment to a rstrongote IIS Web server, see the [Packaging and Deploying an Open Source Application Using Web Deployment Tool](https://blogs.iis.net/mailant/archive/2009/05/01/real-world-iis-packaging-and-deploying-an-open-source-application-using-web-deployment-tool-screencast.aspx) videocast (11 minutes). This video walks through how to find and customize SilverStripe from the Web App Gallery, then re-package and deploy the customized SilverStripe package using Web Deployment Tool to a remote IIS server. - -## For Windows users - -- **Try out the Web Platform Installer**, start with the [Finding and Installing the Web Platform Installer 2.0](https://blogs.iis.net/mailant/archive/2009/04/30/real-world-iis-finding-and-installing-web-platform-installer-2-0.aspx) videocast (3 minutes). This video showing the different ways to find and install the Web Platform Installer, as well as provides a brief introduction to the Web Platform Installer Tool. -- ***Install a free open source community application*** easily on Windows, watch the [Installing a Free Community Application Using Web Platform Installer](https://blogs.iis.net/mailant/archive/2009/04/30/real-world-iis-installing-a-free-community-application-using-web-platform-installer-videocast.aspx) videocast (7 minutes). This video shows how to install Umbraco on Windows using the Web Platform Installer. - -## Technologies discussed - -- [Web Deployment Tool](https://www.iis.net/downloads/microsoft/web-deploy) -- [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) -- [Web Application Gallery](https://www.microsoft.com/web/gallery) - -These videos were encoded and are published using [IIS Smooth Streaming](https://www.iis.net/downloads/microsoft/smooth-streaming). diff --git a/iis/publish/using-the-ftp-service/configuring-ftp-firewall-settings-in-iis-7.md b/iis/publish/using-the-ftp-service/configuring-ftp-firewall-settings-in-iis-7.md index 812116f82..66ab75e4b 100644 --- a/iis/publish/using-the-ftp-service/configuring-ftp-firewall-settings-in-iis-7.md +++ b/iis/publish/using-the-ftp-service/configuring-ftp-firewall-settings-in-iis-7.md @@ -131,6 +131,7 @@ In this section, you configure the server-level port range for passive connectio - [929851 - The default dynamic port range for TCP/IP has changed in Windows Vista and in Windows Server 2008](https://support.microsoft.com/kb/929851/) 4. This port range will need to be added to the allowed settings for your firewall server. +5. After making the configuration changes, restart the Microsoft FTP Service via `Start` > `Run` > `services.msc` and locate the FTP service. diff --git a/iis/publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md b/iis/publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md index e03daa164..b82e168ad 100644 --- a/iis/publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md +++ b/iis/publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md @@ -294,5 +294,4 @@ Use the **FTP Messages** feature to modify the settings for messages sent when a - [Hosting-Friendly Web Server Platform (IIS): Scenario Overview](../../get-started/introduction-to-iis/hosting-friendly-web-server-platform-iis-scenario-overview.md) - [Build a Static Website on IIS](../../manage/creating-websites/scenario-build-a-static-website-on-iis.md) - [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) -- [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) - [Build a Web Farm with IIS Servers](../../web-hosting/scenario-build-a-web-farm-with-iis-servers/overview-build-a-web-farm-with-iis-servers.md) diff --git a/iis/publish/using-web-deploy/configure-the-web-deployment-handler.md b/iis/publish/using-web-deploy/configure-the-web-deployment-handler.md index fe209b8a1..34a263590 100644 --- a/iis/publish/using-web-deploy/configure-the-web-deployment-handler.md +++ b/iis/publish/using-web-deploy/configure-the-web-deployment-handler.md @@ -131,7 +131,7 @@ If you want to enable tracing for WMSvc, see [Configuring Web Management Service b. Click **Next**. c. On the **Parameters** page, change the application name to something that doesn't already exist in the Web site to verify that the user can create applications. d. Complete the wizard. -5. Finally, you should download an application package or using the Web Platform Installer to install an application to this Web site to verify that the database and other options are working. +5. Finally, you should download an application package to install an application to this Web site to verify that the database and other options are working. ## Troubleshooting diff --git a/iis/publish/using-web-deploy/export-a-package-through-iis-manager.md b/iis/publish/using-web-deploy/export-a-package-through-iis-manager.md index ab578ac07..57da034ae 100644 --- a/iis/publish/using-web-deploy/export-a-package-through-iis-manager.md +++ b/iis/publish/using-web-deploy/export-a-package-through-iis-manager.md @@ -23,8 +23,6 @@ This guide requires the following prerequisites: ### Prerequisites if you're using SQL -Note: The second and third pre-requisites will be installed automatically if you install the Web Deployment Tool using the Web Platform Installer - - SQL Server Express or Standard, either local or remote - SQL Server 2008 Management Objects (SMO) - (x86) or (x64) - SQL CLR Types - x86 or x64 diff --git a/iis/publish/using-web-deploy/import-a-package-through-iis-manager.md b/iis/publish/using-web-deploy/import-a-package-through-iis-manager.md index d08e360e2..874fab831 100644 --- a/iis/publish/using-web-deploy/import-a-package-through-iis-manager.md +++ b/iis/publish/using-web-deploy/import-a-package-through-iis-manager.md @@ -25,11 +25,9 @@ Note: If you have not already installed the Web Deployment Tool, see [Installing ## Prerequisites if you're using SQL -Note: The second and third prerequisites will be installed if you install the Web Deployment Tool using the Web Platform Installer - - SQL Server Express or Standard -- SQL Server 2008 Management Objects (SMO) - [x86](https://go.microsoft.com/fwlink/?LinkId=123708&clcid=0x409) or [x64](https://go.microsoft.com/fwlink/?LinkId=123709&clcid=0x409) -- SQL CLR Types - [x86](https://go.microsoft.com/fwlink/?LinkId=123721&clcid=0x409) or [x64](https://go.microsoft.com/fwlink/?LinkId=123722&clcid=0x409) +- SQL Server 2008 Management Objects (SMO) +- SQL CLR Types ## Import a Package diff --git a/iis/publish/using-web-deploy/powershell-scripts-for-automating-web-deploy-setup.md b/iis/publish/using-web-deploy/powershell-scripts-for-automating-web-deploy-setup.md index d242bbc3c..4de74c5db 100644 --- a/iis/publish/using-web-deploy/powershell-scripts-for-automating-web-deploy-setup.md +++ b/iis/publish/using-web-deploy/powershell-scripts-for-automating-web-deploy-setup.md @@ -23,7 +23,7 @@ The scripts that you will use are: ## Requirements - The server must have an operating system that comes with IIS7—this means either Windows Server 2008 or Windows Server 2008 R2. You must be an administrator on the machine. -- In the [Web Platform Installer](https://go.microsoft.com/fwlink/?LinkId=145510), search for "hosting" and install either the "Recommended Server Configuration for Hosting Providers" product bundle or "Web Deployment Tool 2.1 for Hosting Servers." Alternatively, make sure the following conditions are met: +- Make sure the following conditions are met: - PowerShell2 must be installed (this is built into Windows Server 2008 R2; for Windows Server 2008, you can get PowerShell2 as an update from here: . A restart may be required. - The Web Server (IIS) role must be enabled in Server Manager. diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php.md b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php.md deleted file mode 100644 index ae08ea620..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: "Synchronizing Two IIS Servers with PHP" -author: rick-anderson -description: "This article will guide you through the process of using Web Deploy to synchronize an entire IIS 7 or above Web server that has PHP installed to another IIS..." -ms.date: 03/26/2010 -ms.assetid: d8ca581b-fa82-4fca-824f-3456f71799b7 -msc.legacyurl: /learn/publish/using-web-deploy/synchronizing-two-iis-servers-with-php -msc.type: authoredcontent ---- -# Synchronizing Two IIS Servers with PHP - -by Tim Ammann - -This article will guide you through the process of using Web Deploy to synchronize an entire IIS 7 or above Web server that has PHP installed to another IIS 7 or above server. Article Goal: To synchronize a Web server from IIS that has PHP installed to another IIS server. - -### Part 1 - View dependencies of the source - -1. Get the dependencies of the Web site by running the following command: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample1.cmd)] -2. Review the output of the dependencies and look for any script maps or installed components that are in use by the site. - - > [!NOTE] - > In most cases on Windows Server 2008, PHP is installed by using the built-in FastCGI module, so the dependency check will show CGI as a dependency, not PHP. -3. Compile a list of the components needed on the destination. - -For detailed steps on analyzing the output of getDependencies, see [Viewing Dependencies](https://technet.microsoft.com/library/dd569091(WS.10).aspx "Viewing Dependencies"). - -### Part 2 - Configure the target or destination computer - -1. Review the list of dependencies and install them on the destination server. For example, let's assume you had the following in use for your Web site: - - - CGI (FastCGI with PHP). - -Based this analysis of your dependencies, you would install those components on the destination server. Because PHP can be installed by simply copying the files, we will add a custom manifest that also copies the PHP folder. - -### Part 3 – Create a custom manifest - -Create the following manifest, assuming that your PHP install location is `c:\php` (replace with your actual install directory): - -[!code-xml[Main](synchronizing-two-iis-servers-with-php/samples/sample2.xml)] - -Save this as **ServerManifest.xml**. For convenience, you can save it into the `%systemdrive%\program files\microsoft web deploy` directory, or to a directory of your choice. You should save it to both the source and destination computers. - -### Part 4 – Synchronize the source server to the destination server - -#### Synchronize by using a package file: - -1. Always make a backup of the destination server. Even if you are just testing, it allows you to easily restore the state of your server. Run the following command to backup an IIS server: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample3.cmd)] -2. Run the following command on the source server to create a package (compressed file) of the server: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample4.cmd)] -3. Run the following command on the destination server to validate what would happen if a synchronization were run: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample5.cmd)] -4. After verifying the output, run the same command again without the -whatif flag: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample6.cmd)] - -#### Synchronize by using the remote service: - -If you don't want to synchronize from a package, you can synchronize by using the Web Deployment Agent Service (MsDepSvc, also called the "remote service"). - -1. Make sure that the service is started on the destination computer by running the command: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample7.cmd)] -2. Run the following command on the source server. Use the **computerName** argument to specify the name of a remote server (for example, DestServer1). If the source is a remote server, you would change the source argument to source:manifest=servermanifest.xml,**computerName=Server1**. - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample8.cmd)] -3. After verifying the output, run the same command again without the whatif flag: - - [!code-console[Main](synchronizing-two-iis-servers-with-php/samples/sample9.cmd)] - -### Summary - -You are now done synchronizing your site. To verify, test browsing to the Web site on the destination server. For troubleshooting help, see [Troubleshooting Web Deploy](../troubleshooting-web-deploy/troubleshooting-web-deploy.md "Troubleshooting MS Deploy"). You synchronized a Web site from a source IIS server to a destination IIS server by viewing the dependencies, configuring the destination IIS server, and by using a package file or the Web Deployment Agent Service. diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample1.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample1.cmd deleted file mode 100644 index 9f893144d..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:getDependencies -source:webServer \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample2.xml b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample2.xml deleted file mode 100644 index e67286ddf..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample2.xml +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample3.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample3.cmd deleted file mode 100644 index eda84b73e..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -%windir%\system32\inetsrv\appcmd add backup "PreMsDeploy" \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample4.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample4.cmd deleted file mode 100644 index af7e8fe9f..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:sync -source:manifest=servermanifest.xml -dest:package=c:\WebServer.zip \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample5.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample5.cmd deleted file mode 100644 index e547c9c8d..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:sync -source:package=c:\WebServer.zip -dest:manifest=servermanifest.xml -whatif > msdeploysync.log \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample6.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample6.cmd deleted file mode 100644 index 4811fa28e..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample6.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:sync -source:package=c:\WebServer.zip -dest:manifest=servermanifest.xml > msdeploysync.log \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample7.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample7.cmd deleted file mode 100644 index 6221e0c70..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample7.cmd +++ /dev/null @@ -1 +0,0 @@ -net start msdepsvc \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample8.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample8.cmd deleted file mode 100644 index e923cc0a3..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:sync -source:manifest=servermanifest.xml -dest:manifest=servermanifest.xml,computerName=DestServer1 –whatif > msdeploysync.log \ No newline at end of file diff --git a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample9.cmd b/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample9.cmd deleted file mode 100644 index b7384582f..000000000 --- a/iis/publish/using-web-deploy/synchronizing-two-iis-servers-with-php/samples/sample9.cmd +++ /dev/null @@ -1 +0,0 @@ -msdeploy -verb:sync -source:manifest=servermanifest.xml -dest:manifest=servermanifest.xml,computerName=DestServer1 >msdeploysync.log \ No newline at end of file diff --git a/iis/publish/using-web-deploy/use-the-web-deployment-tool.md b/iis/publish/using-web-deploy/use-the-web-deployment-tool.md index 01d4ca3e7..43f3b2bb6 100644 --- a/iis/publish/using-web-deploy/use-the-web-deployment-tool.md +++ b/iis/publish/using-web-deploy/use-the-web-deployment-tool.md @@ -19,7 +19,7 @@ With the Web Deployment Tool, you can: - **Migrate Web applications between IIS 6.0 and IIS 7 and above** - Simplify the planning of your IIS 6.0 to IIS 7 and above migrations by determining incompatibilities and previewing the proposed changes before starting the process. Learning about any potential issues in advance gives you the chance to take corrective measures and simplifies migration. - **Synchronize your server farm** - The Web Deployment Tool makes it possible for you to efficiently synchronize sites, applications, or servers across your IIS server farm by detecting differences between the source and destination content and transferring only those changes which need synchronization. The tool simplifies the synchronization process by automatically determining the configuration, content, and certificates to be synchronized for a specific site. In addition to the default behavior, you still have the option to specify additional providers for the synchronization, including databases, Component Object Model (COM) objects, Global Assembly Cache (GAC) assemblies, and registry settings. -- **Package, archive, and deploy Web applications** - You can use the Web Deployment Tool to package configuration and content of your installed Web applications, including databases, and use the packages for storage or redeployment. These packages can be deployed using IIS Manager without requiring administrative privileges. The tool integrates with Microsoft® Visual Studio® 2010 to help developers streamline the deployment of Web applications to the Web server. The tool also integrates with the Microsoft® Web Platform Installer (Web PI) so you can simply and easily install community Web applications. You can submit your own application to the Web Application Gallery. +- **Package, archive, and deploy Web applications** - You can use the Web Deployment Tool to package configuration and content of your installed Web applications, including databases, and use the packages for storage or redeployment. These packages can be deployed using IIS Manager without requiring administrative privileges. The tool integrates with Microsoft® Visual Studio® 2010 to help developers streamline the deployment of Web applications to the Web server. ## Download and Install the Web Deployment Tool @@ -111,7 +111,6 @@ You can use the Web Deployment Tool to synchronize a Web site from a source to a The following information is an extensive list of the features of the Web Deployment Tool: - Seamless integration with IIS Manager and Visual Studio 2010 interface for creating packages and deploying them onto a machine, both locally and remotely. -- Seamless integration with the Web Platform Installer to install community Web applications simply and easily. - Web application packaging: - Can package a Web application or an entire site, including the associated databases. diff --git a/iis/publish/using-web-deploy/web-deploy-parameterization.md b/iis/publish/using-web-deploy/web-deploy-parameterization.md index 679130619..e0186a44f 100644 --- a/iis/publish/using-web-deploy/web-deploy-parameterization.md +++ b/iis/publish/using-web-deploy/web-deploy-parameterization.md @@ -15,79 +15,28 @@ by Web Deploy Team Web application development most often involves deploying code in different environments: development, staging, or production servers. Each environment might use a different set of resources, like database connection information, and Web Deploy is built with features that help transform web applications as they are deployed into different environments. In order to transform an application during deployment, different parts of the applications can be "parameterized", and, at deployment time, Web Deploy takes a user's input to replace different pieces of information within the application. -## Different Ways to Deploy Applications: Live Synchronization, Web Platform Installer, and Visual Studio +## Different Ways to Deploy Applications: Live Synchronization and Visual Studio -The Web Deploy tool can be used to deploy an application in a couple of different ways. A web application can be **synchronized live**, from one server (perhaps the development server) to another server (perhaps the server that hosts the application on the web). Web applications can also be packaged into a .zip file, to be downloaded and installed by a wider, more general audience of developers. This is a model commonly used by "platform"-like apps (for example, Wordpress), and the application can later be easily installed by using a guided UI, namely [**Microsoft Web Platform Installer**](https://www.microsoft.com/web/downloads/platform.aspx). Finally, Web Deploy is used behind the scenes by **Visual Studio** when developing and deploying web application (WAP) projects. In this case, Visual Studio automatically parameterizes most of the necessary parts of the web applications, with the ability to create custom parameters if necessary. +The Web Deploy tool can be used to deploy an application in a couple of different ways. A web application can be **synchronized live**, from one server (perhaps the development server) to another server (perhaps the server that hosts the application on the web). Web applications can also be packaged into a .zip file, to be downloaded and installed by a wider, more general audience of developers. This is a model commonly used by "platform"-like apps (for example, Wordpress). Finally, Web Deploy is used behind the scenes by **Visual Studio** when developing and deploying web application (WAP) projects. In this case, Visual Studio automatically parameterizes most of the necessary parts of the web applications, with the ability to create custom parameters if necessary. -## Creating and Parameterizing an Application to be Deployed with Microsoft Web Platform Installer +## Creating and Parameterizing an Application to be Deployed -Microsoft provides an easy way to install over 50 popular web applications, like Wordpress, Joomla, Drupal, and DotNetNuke. These applications can be installed relatively quickly and easily with a guided UI by using either the [Microsoft Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) or [Microsoft WebMatrix](https://www.microsoft.com/web/webmatrix/). Behind the scene, these UIs use the Web Deploy tool to install the application from a .zip package. In order to create an application package so that it can be installed by using one of these tools, a number of steps must be taken, including parameterizing parts of the application. +Microsoft provides an easy way to install over 50 popular web applications, like Wordpress, Joomla, Drupal, and DotNetNuke. These applications can be installed relatively quickly and easily. Behind the scene, these UIs use the Web Deploy tool to install the application from a .zip package. In order to create an application package so that it can be installed by using one of these tools, a number of steps must be taken, including parameterizing parts of the application. -The following steps are required to turn an application into a .zip package that can be deployed with the Web Platform Installer: +The following steps are required to turn an application into a .zip package that can be deployed: 1. Create an application. 2. Create a "manifest" file. This file tells the Web Deploy tool the different actions that are required to install the application. This includes things like copying files and setting up a database. 3. Create a parameter file. This is the "parameterization" file that Web Deploy uses to identify the parts of the application that need to be transformed at the time of installation based on user input. 4. Create a .zip file that contains the application, the manifest file, and the parameter file. -5. Create an XML file that the Web Platform Installer will use to display and install the application. This article presents each of these steps in detail. #### Step 1 - Create an Application -An easy way to create an application to experiment with web deploy parameterization is to use WebMatrix. WebMatrix can be installed using the Microsoft Web Platform Installer, which you can download [here](https://www.microsoft.com/web/downloads/platform.aspx). After installing Web Platform Installer, search for "WebMatrix" and **install** it: +Currently there is no easy way to create an application to experiment with web deploy parameterization, except cloning from an existing application. -[![Screenshot shows the Web Platform Installer 3 point zero window highlighting the Microsoft Web Matrix option to install.](web-deploy-parameterization/_static/image3.png)](web-deploy-parameterization/_static/image1.png) - -After WebMatrix finishes installing, run the program and at the start screen select **Site From Template**: - -[![Screenshot shows the directory of Microsoft Web Matrix to select the Site from Template folder.](web-deploy-parameterization/_static/image7.png)](web-deploy-parameterization/_static/image5.png) - -The **Site from Template** page appears. - -[![Screenshot shows the Site from Template folder with its templates.](web-deploy-parameterization/_static/image11.png)](web-deploy-parameterization/_static/image9.png) - -Since the photo gallery template application can use a Microsoft SQL Server database, it is a good choice for showing how Web Deploy parameterization can be used. - -On the **Site from Template** page, select **Photo Gallery**. In the **Site Name** box, enter the name "Vacation Pictures". Next, click **OK** to install the Photo Gallery application. - -Out of the box, the photo gallery application uses a file-based, SDF database. However, most real-world applications use a non-file based database, so you will convert (or "migrate") the SDF database into a Microsoft SQL Server database. If you don't have SQL Server, use Web Platform Installer to search for "SQL Server Express 2008 R2". Next, click **Add,** and then click **Install** to install it: - -[![Screenshot shows database search results highlighting S Q L Server Express 2 zero zero 8 R 2.](web-deploy-parameterization/_static/image15.png)](web-deploy-parameterization/_static/image13.png) - -During the application setup, remember the administrative username ("sa") and the password that you enter: - -[![Screenshot shows the Web Platform Installation window choosing the Mixed Mode Authentication option and specifying the password.](web-deploy-parameterization/_static/image19.png)](web-deploy-parameterization/_static/image17.png) - -Now that a SQL server instance is available, navigate back to WebMatrix. In the bottom left corner of WebMatrix, click the **Databases** tab to open the databases workspace. - -![Screenshot shows the Web Matrix dialogue box with navigation tabs to select Databases option.](web-deploy-parameterization/_static/image21.png) - -When the database workspace is open, click the database file **, PhotoGallery.sdf**, in the left pane: - -![Screenshot shows the files in Database workspace highlighting the PhotoGallery dot s d f file. ](web-deploy-parameterization/_static/image23.png) - -This should light up the **Migrate** button in the ribbon control at the top of the application. Click **Migrate** to begin the migration: - -![Screenshot shows the Microsoft Web Matrix window highlighting the Migrate navigation icon.](web-deploy-parameterization/_static/image25.png) - -The **Migrate Database** dialog box appears: - -![Screenshot shows the Migrate Database dialog box with database authentication details.](web-deploy-parameterization/_static/image27.png) - -Leave the default database name and SQL server name unchanged. Change the dropdown from **Windows Authentication** to **Database Authentication**. In **Login** and **Password** boxes, enter the database administrator's username and password (if you installed SQL Express, use the same values that you entered during installation.) - -Click **OK**. The database migration begins. - -After migration completes, you can verify that the application still works by running the application in a web browser. In the top control ribbon, click **Run** to launch the application in a web browser: - -![Screenshot shows a web browser window highlighting the Run navigation icon.](web-deploy-parameterization/_static/image29.png) - -This should bring up an application that looks similar to this: - -[![Screenshot shows that the application is launched successfully in a web browser.](web-deploy-parameterization/_static/image33.png)](web-deploy-parameterization/_static/image31.png) - -Now you have an application that is ready to be packaged and parameterized so that other developers can download and install it by using Web Platform Installer. The next step is to set up a file that will tell Web Deploy the steps required to install the application. +Now you have an application that is ready to be packaged and parameterized so that other developers can download and install it. The next step is to set up a file that will tell Web Deploy the steps required to install the application. #### Step 2 - Create a "manifest" file @@ -131,10 +80,6 @@ Make sure to replace <AdminPassword> with the appropriate SQL administrato At a basic level, the above command uses the **dbFullSql** provider to copy data from a database using a database connection string ("-source:dbfullsql=…") and copies it to a database script file ("-dest:dbfullsql=…") -##### More Information About Providers and Manifext.xml - -For more information about the above providers, and other providers that can be used in a manifest file, see the [web application package reference page](../../develop/windows-web-application-gallery/reference-for-the-web-application-package.md). - #### Step 3 - Create a parameter file After you create the manifest file that tells Web Deploy how to install the application, you need to create a parameter file that tells Web Deploy how to transform certain settings so that the application can be customized to work in a specific user's deployment environment. @@ -166,7 +111,7 @@ The second entry in the parameter file ('name="SetAclParameter1"') just makes su ##### Parameterizing the Database Name -The rest of the entries in the Parameters.xml file deal with parameterizing the database connection information. The 2nd-6th entries in the parameters file gather information from the UI when a user is installing the application through Web Platform Installer. These entries prompt the user for the database server which will host the database for the application ("Database Server"), the name of the database to create ("Database Name"), the database user to associate with the database ("Database Username"), and the password for that user ("Database Password"). To create the database and user, Web Deploy also needs the database administrator user ("Database Administrator") and password ("Database Administrator Password"). +The rest of the entries in the Parameters.xml file deal with parameterizing the database connection information. The 2nd-6th entries in the parameters file gather information from the UI when a user is installing the application. These entries prompt the user for the database server which will host the database for the application ("Database Server"), the name of the database to create ("Database Name"), the database user to associate with the database ("Database Username"), and the password for that user ("Database Password"). To create the database and user, Web Deploy also needs the database administrator user ("Database Administrator") and password ("Database Administrator Password"). Finally, all of the information entered by the user is used by Web Deploy to actually execute the scripts that create the database (CreateDBAndUser.sql) and setup the tables (VacPicDBSchema.sql). These are the 7th and 8th entries in Parameters.xml: @@ -176,13 +121,9 @@ Again, since Web Deploy uses a provider to synchronize database information (as Our "Vacation Pictures" application also keeps track of the database connection in the Web.config file. This parameterization is handled by the final entry in Parameters.xml. -##### More Information about Creating the Parameters.xml File - -For more information about creating the Parameters.xml file, including the meaning of various tags and the different kinds of parameter entries, see the [web application package reference page](../../develop/windows-web-application-gallery/reference-for-the-web-application-package.md). - #### Step 4 - Create a Zip File that Contains the Application, the Manifest File, and the Parameter File -You now have the basic building blocks needed to deploy the application using Web Platform Installer, so you can now package the application into the appropriate package format. The package just needs to contain the Parameters.xml file, the Manifest.xml file, and the database installation scripts at the top (root) level of the zip package, and the application content in a subfolder. +You now have the basic building blocks needed to deploy the application, so you can now package the application into the appropriate package format. The package just needs to contain the Parameters.xml file, the Manifest.xml file, and the database installation scripts at the top (root) level of the zip package, and the application content in a subfolder. In the lower left corner of WebMatrix, click the **Site** tab to navigate to the site's content. @@ -202,90 +143,4 @@ With all of the files selected, right click->Send to->Compressed (zipped) This zipped file can be named anything, but to work better with the demo, name it "VacationPicsWPIInstaller.zip". -This package now contains everything that is needed to deploy it with Web Platform Installer. - -#### Step 5 - Create an XML File that the Web Platform Installer Will Use to Display and Install the Application - -The applications and products listed by Web Platform Installer are defined inside an XML file. In turn, to install our application by using the Web Platform Installer, we need to create an XML "feed" that Web Platform Installer will use to display and install our application. - -##### Create a Custom Feed - -A feed that works with the application created in this demo can be [copied from here](web-deploy-parameterization.md#VacationFeed.xml): - -[![Screenshot shows the VacationFeed dot x m l icon.](web-deploy-parameterization/_static/image49.png)](web-deploy-parameterization.md#VacationFeed.xml) - -Two values need to be modified in order for the feed to work properly. First, in the middle of the feed is the path to where the "VacationPicsWPIInstaller.zip" is located on disk. It should look like: - -[!code-xml[Main](web-deploy-parameterization/samples/sample6.xml)] - -Change this value to point to wherever your application zip file lives. - -Second, the Web Platform Installer uses a hash to verify that the file the application hasn't been tampered with. To generate a hash for your zip package, download a tool called File Checksum Integrity Verifier, which can be found here (`https://download.microsoft.com/download/c/f/4/cf454ae0-a4bb-4123-8333-a1b6737712f7/windows-kb841290-x86-enu.exe`). - -After unpacking the application, run this command from the command line to generate a hash for your application package: - -[!code-console[Main](web-deploy-parameterization/samples/sample7.cmd)] - -This will output the hash of the file, which will look something like this: - -![Screenshot shows the hash output for the application package.](web-deploy-parameterization/_static/image51.png) - -Copy the long number and use it to replace the value in the feed XML that looks like: - -[!code-xml[Main](web-deploy-parameterization/samples/sample8.xml)] - -##### Add the Custom Feed to Web Platform Installer - -Now that we have a custom feed, we need to tell Web Platform installer to load this feed. Inside Web Platform installer, click the **options** link at the bottom of the application: - -![Screenshot shows the Web Platform Installer page with the Options link and Install buttons.](web-deploy-parameterization/_static/image53.png) - -Fill out the path to the custom application feed, and then click **Add Feed**: - -[![Screenshot shows a text field to add custom application feed.](web-deploy-parameterization/_static/image57.png)](web-deploy-parameterization/_static/image55.png) - -Finally, click **OK** to close the options dialog. - -If everything works, a new entry will be displayed in the Web Platform Installer: - -[![Screenshot shows the Web Platform Installer 3 point zero Sample Applications window highlighting Vacation Picture App.](web-deploy-parameterization/_static/image61.png)](web-deploy-parameterization/_static/image59.png) - -Click **Add** to test installing your application. If everything is working, you will be presented with a page to enter the parameters that you previously declared in the Parameters.xml file: - -[![Screenshot shows the Web Platform Installation window to enter application information.](web-deploy-parameterization/_static/image65.png)](web-deploy-parameterization/_static/image63.png) - -Fill out information for the application to finalize the installation. If everything is working, the application will launch inside WebMatrix after the installation completes. From there, you can click **Run** in the ribbon at the top of WebMatrix to view the application in a web browser. - -For reference, you can download a copy of the original application used to create this demo from here: - -[![Screenshot shows the VacationPics W P I Installer dot zip icon.](web-deploy-parameterization/_static/image67.png)](web-deploy-parameterization/_static/web-deploy-parameterization-1082-vacationpicswpiinstaller1.zip) - -##### More Information about Creating Custom Application Feeds - -The feed linked in this demo is missing a lot of information that Web Platform Installer will normally display to a user, like the date and time of the application's creation, a thumbnail image for the application icon, and the name of the author of the application. More information about creating custom feeds can be found on [this blog post](https://blogs.iis.net/kateroh/archive/2009/10/24/web-pi-extensibility-custom-feeds-installing-custom-applications.aspx). - -## Scripts for this demo - - - -## CreateDBAndUser.sql - -[!code-sql[Main](web-deploy-parameterization/samples/sample9.sql)] - - - -## Manifest.xml - -[!code-xml[Main](web-deploy-parameterization/samples/sample10.xml)] - - - -## Parameters.xml - -[!code-xml[Main](web-deploy-parameterization/samples/sample11.xml)] - - - -## VacationFeed.xml - -[!code-xml[Main](web-deploy-parameterization/samples/sample12.xml)] +This package now contains everything that is needed to deploy it. diff --git a/iis/publish/using-web-deploy/web-deploy-powershell-cmdlets.md b/iis/publish/using-web-deploy/web-deploy-powershell-cmdlets.md index 65a506427..4c8764dc0 100644 --- a/iis/publish/using-web-deploy/web-deploy-powershell-cmdlets.md +++ b/iis/publish/using-web-deploy/web-deploy-powershell-cmdlets.md @@ -47,7 +47,7 @@ Example: This example gets a credential object and then passes it to the new pub ## II. Backup -All backup cmdlets have a positional parameter (it's the second one except for backup-wdserver where it is the first positional parameter) called output. This takes a path to the folder where you want the backup created. Backup is always a Web Deploy zip package. You can read more about Web Deploy Packages at [Package Provider](https://msdn.microsoft.com/library/dd569019(v=WS.10).aspx) and [custom packages](../../develop/windows-web-application-gallery/package-an-application-for-the-windows-web-application-gallery.md). If no path is specified the backups are created in a folder named 'Web Deploy Backups' under the user's documents folder. The backups are named as machinename\_nameofproviderused\_[Siteorapporfoldername(Optional)]\_timestamp.zip. +All backup cmdlets have a positional parameter (it's the second one except for backup-wdserver where it is the first positional parameter) called output. This takes a path to the folder where you want the backup created. Backup is always a Web Deploy zip package. You can read more about Web Deploy Packages at [Package Provider](https://msdn.microsoft.com/library/dd569019(v=WS.10).aspx). If no path is specified the backups are created in a folder named 'Web Deploy Backups' under the user's documents folder. The backups are named as machinename\_nameofproviderused\_[Siteorapporfoldername(Optional)]\_timestamp.zip. All these cmdlets will work locally by default unless remote server information is provided by passing in a publish settings file for SourcePublishSettings parameter. @@ -108,7 +108,7 @@ Examples: [!code-powershell[Main](web-deploy-powershell-cmdlets/samples/sample7.ps1)] -Description: This will back up a web application using iisApp provider. Read more about this provider [here](https://technet.microsoft.com/library/dd569054(WS.10).aspx). Here is a good [article](http://learn.iis.net/page.aspx/150/understanding-sites-applications-and-virtual-directories-on-iis/) that explains what a web application is and what is the difference between a site, an app and a virtual directory in IIS. +Description: This will back up a web application using iisApp provider. Read more about this provider [here](https://technet.microsoft.com/library/dd569054(WS.10).aspx). Here is a good [article](/iis/get-started/planning-your-iis-architecture/understanding-sites-applications-and-virtual-directories-on-iis) that explains what a web application is and what is the difference between a site, an app and a virtual directory in IIS. Cmdlet Parameters: The name of the app specified by the application parameter or by the publish settings file is backed up. If none of them is specified it throws an error. Application parameter value overrides publish settings specification for site name. SkipFileList and SkipFolderList parameters allow you to selectively exclude one or more files or folders from the package. diff --git a/iis/publish/using-webdav/how-to-configure-webdav-with-request-filtering.md b/iis/publish/using-webdav/how-to-configure-webdav-with-request-filtering.md index 3c2edae41..d9fc6b217 100644 --- a/iis/publish/using-webdav/how-to-configure-webdav-with-request-filtering.md +++ b/iis/publish/using-webdav/how-to-configure-webdav-with-request-filtering.md @@ -17,7 +17,7 @@ by [Robert McMurray](https://github.com/rmcmurray) Microsoft released a new WebDAV extension module that was completely rewritten for Internet Information Services 7.0 (IIS 7.0) on Windows Server® 2008. This new WebDAV extension module incorporated many new features that enable web authors to publish content better than before, and offers web administrators more security and configuration options. Microsoft has released an update to the WebDAV extension module for Windows Server® 2008 that provides shared and exclusive locks support to prevent lost updates due to overwrites. -IIS 7.0 provides several great new security features, including the IIS 7.0 new Request Filtering. For IIS users who are familiar with [UrlScan](https://www.iis.net/downloads/microsoft/urlscan) from previous versions of IIS, the Request Filtering feature in IIS 7.0 is like having URLScan built-in. +IIS 7.0 provides several great new security features, including the IIS 7.0 new Request Filtering. For IIS users who are familiar with UrlScan from previous versions of IIS, the Request Filtering feature in IIS 7.0 is like having URLScan built-in. The new WebDAV module and Request Filtering were designed to work together, and this document walks you through configuring WebDAV-related Request Filtering settings together with WebDAV settings in order to set up a secure publishing environment. Note that if you use the IIS Manager UI to configure WebDAV then the request filtering settings are automatically updated and you do not need to follow the steps in this article. diff --git a/iis/publish/using-webdav/how-to-migrate-fpse-sites-to-webdav.md b/iis/publish/using-webdav/how-to-migrate-fpse-sites-to-webdav.md index d39c41f30..8a2cf9559 100644 --- a/iis/publish/using-webdav/how-to-migrate-fpse-sites-to-webdav.md +++ b/iis/publish/using-webdav/how-to-migrate-fpse-sites-to-webdav.md @@ -53,7 +53,7 @@ One of the great things about the FrontPage Server Extensions from their origina In addition to publishing functionality, FrontPage and FPSE also provided a variety of additional functionality through what were affectionately called "bots". These were subdivided into two categories: save-time bots and browse-time bots. Save-time bots were functionality that could be added to web pages when authoring that provided auto-generation of content, such as included content and tables of contents. Browse-time bots were designed to replace common CGI-based features, such as processing form-results. While these features offered web developers a plethora of functionality, they were also proprietary in nature and as such, industry adoption was limited. -Over the past several years Microsoft web authoring tools have moved away from bots: save-time bots are often replaced with other features, and browse-time bots are most often replaced by other dynamic features like ASP.NET or PHP applications. This leaves the remaining feature that FPSE provides as content publishing. That said, in July of 2006 Microsoft Office XP passed out of mainstream support, (Office 2000 was already out of mainstream support), and therefore FPSE was discontinued as a separate download. FPSE is still available and supported as a pre-installed Windows component in Windows Server® 2003, and recently Microsoft and [Ready-to-Run Software](http://www.rtr.com/) released a version of [FPSE for Windows Server 2008 and Windows Vista](https://go.microsoft.com/fwlink/?LinkId=86544). However, Microsoft web authoring tools are moving away from FPSE the publishing protocol of choice, which is where WebDAV enters the picture. +Over the past several years Microsoft web authoring tools have moved away from bots: save-time bots are often replaced with other features, and browse-time bots are most often replaced by other dynamic features like ASP.NET or PHP applications. This leaves the remaining feature that FPSE provides as content publishing. That said, in July of 2006 Microsoft Office XP passed out of mainstream support, (Office 2000 was already out of mainstream support), and therefore FPSE was discontinued as a separate download. FPSE is still available and supported as a pre-installed Windows component in Windows Server® 2003, and recently Microsoft and [Ready-to-Run Software](http://www.rtr.com/) released a version of FPSE for Windows Server 2008 and Windows Vista. However, Microsoft web authoring tools are moving away from FPSE the publishing protocol of choice, which is where WebDAV enters the picture. WebDAV stands for Web Distributed Authoring and Versioning, and it is an open-standard extension to HTTP that adds functionality in order to provide Internet-based web publishing without using a CGI-based or ISAPI-based protocol extension like FPSE. WebDAV has been in use for ten years now, and industry adoption is steadily growing. Windows now offers a great built-in WebDAV redirector that allows users to map drives to WebDAV-enabled web sites, therefore turning the Internet into an extension of your local network and delivering on the promise of seamlessly publishing content between disparate servers. diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image1.jpg b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image1.jpg deleted file mode 100644 index 48e7b449c..000000000 Binary files a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image1.jpg and /dev/null differ diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image2.jpg b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image2.jpg deleted file mode 100644 index 48e7b449c..000000000 Binary files a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image2.jpg and /dev/null differ diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image3.jpg b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image3.jpg deleted file mode 100644 index 48e7b449c..000000000 Binary files a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/_static/image3.jpg and /dev/null differ diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample1.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample1.cmd deleted file mode 100644 index 0f1ef1d40..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -notepad %windir%\logs\cbs\cbs.log \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample2.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample2.cmd deleted file mode 100644 index 45146b395..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -notepad %windir%\iis7.log \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample3.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample3.cmd deleted file mode 100644 index deb34fcf1..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -notepad %systemroot%\setuperr.log. \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample4.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample4.cmd deleted file mode 100644 index 5c3d93793..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -notepad %wsystemroot%\iis6.log. \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample5.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample5.cmd deleted file mode 100644 index ce56f8b58..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -%localappdata%\Microsoft\Web Platform Installer\logs\install \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample6.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample6.cmd deleted file mode 100644 index 7017016a4..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample6.cmd +++ /dev/null @@ -1 +0,0 @@ -eventvwr.msc \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample7.html b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample7.html deleted file mode 100644 index 8627a6558..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample7.html +++ /dev/null @@ -1,21 +0,0 @@ - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample8.cmd b/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample8.cmd deleted file mode 100644 index c31da5e38..000000000 --- a/iis/troubleshoot/web-platform-installer-issues/troubleshooting-problems-with-microsoft-web-platform-installer/samples/sample8.cmd +++ /dev/null @@ -1 +0,0 @@ -del /q "%localappdata%\Microsoft\web platform installer\*" \ No newline at end of file diff --git a/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method.md b/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method.md index c385fe784..95e207648 100644 --- a/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method.md +++ b/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method.md @@ -1,10 +1,10 @@ --- -title: "CHttpModule::CHttpModule Method" +title: "CHttpModule::CHttpModule Method 1.5" description: "Describes the CHttpModule::CHttpModule method and details its syntax, parameters, remarks, code example, and requirements." ms.date: 10/07/2016 ms.assetid: 8b95c504-0a60-4676-8708-1765f91d7f6d --- -# CHttpModule::CHttpModule Method +# CHttpModule::CHttpModule Method 1.5 Initializes a new instance of the [CHttpModule](../../web-development-reference/native-code-api-reference/chttpmodule-class.md) class. ## Syntax diff --git a/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method_1.md b/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method_1.md index fd58bb2c5..8c14004af 100644 --- a/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method_1.md +++ b/iis/web-development-reference/native-code-api-reference/chttpmodule-chttpmodule-method_1.md @@ -1,6 +1,6 @@ --- -title: CHttpModule::CHttpModule Method -TOCTitle: CHttpModule::CHttpModule Method +title: CHttpModule::CHttpModule Method 2.0 +TOCTitle: CHttpModule::CHttpModule Method 2.0 description: CHttpModule CHttpModule Method initializes a new instance of the CHttpModule class. ms:assetid: 8b95c504-0a60-4676-8708-1765f91d7f6d ms:mtpsurl: https://msdn.microsoft.com/library/ms692938(v=VS.90) @@ -11,7 +11,7 @@ dev_langs: - cpp --- -# CHttpModule::CHttpModule Method +# CHttpModule::CHttpModule Method 2.0 Initializes a new instance of the [CHttpModule](chttpmodule-class.md) class. diff --git a/iis/web-development-reference/native-code-api-reference/pfn-webhost-listener-application-pool-all-listener-channel-instance-function.md b/iis/web-development-reference/native-code-api-reference/pfn-webhost-listener-application-pool-all-listener-channel-instance-function.md index 9e3ab9b3b..e572a4ed5 100644 --- a/iis/web-development-reference/native-code-api-reference/pfn-webhost-listener-application-pool-all-listener-channel-instance-function.md +++ b/iis/web-development-reference/native-code-api-reference/pfn-webhost-listener-application-pool-all-listener-channel-instance-function.md @@ -1,10 +1,10 @@ --- -title: PFN_WEBHOST_LISTENER_APPLICATION_POOL_CAN_OPEN_NEW_LISTENER_CHANNEL_INSTANCE Function +title: PFN_WEBHOST_LISTENER_APPLICATION_POOL_CAN_OPEN_NEW_LISTENER_CHANNEL_INSTANCE Function reference description: Describes the PFN_WEBHOST_LISTENER_APPLICATION_POOL_CAN_OPEN_NEW_LISTENER_CHANNEL_INSTANCE function and details its parameters and requirements. ms.date: 10/07/2016 ms.assetid: pfn-webhost-listener-application-pool-all-listener-channel-instance-function --- -# PFN_WEBHOST_LISTENER_APPLICATION_POOL_CAN_OPEN_NEW_LISTENER_CHANNEL_INSTANCE Function +# PFN_WEBHOST_LISTENER_APPLICATION_POOL_CAN_OPEN_NEW_LISTENER_CHANNEL_INSTANCE Function reference Notifies the listener adapter that it is possible to launch other instances of this listener channel. ## Syntax diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/application-request-routing-arr-20-for-shared-hosting.md b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/application-request-routing-arr-20-for-shared-hosting.md index 2d590287d..055754eeb 100644 --- a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/application-request-routing-arr-20-for-shared-hosting.md +++ b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/application-request-routing-arr-20-for-shared-hosting.md @@ -47,7 +47,7 @@ In summary, ARR's benefits include: The following steps and articles constitute a complete guide for setting up an ARR server and a corresponding Web server farm, as described in the [Shared Hosting Configuration article](../planning-the-web-hosting-architecture/shared-hosting-configuration.md): 1. Designate a server connected to the Internet that will run ARR and will handle all Web requests between clients and the Web application servers. -2. Install ARR using [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) on the designated server. +2. Install ARR on the designated server. 3. Change the [application pool process model for ARR](../../extensions/installing-application-request-routing-arr/install-application-request-routing.md).[![Screenshot of the flow between the Front End and Back End with A P R Server highlighted.](application-request-routing-arr-20-for-shared-hosting/_static/image4.jpg)](application-request-routing-arr-20-for-shared-hosting/_static/image3.jpg) 4. Set up an ARR Web server farm, using the procedure in the following [article](../../extensions/configuring-application-request-routing-arr/define-and-configure-an-application-request-routing-server-farm.md). For more information about shared configuration, see: [https://www.iis.net/learn/manage/managing-your-configuration-settings/shared-configuration\_264](../../manage/managing-your-configuration-settings/shared-configuration_264.md). [![Screenshot of the flow between the Front End and Back End with Web Server farm highlighted and Web Farm Shared Configuration displayed.](application-request-routing-arr-20-for-shared-hosting/_static/image6.jpg)](application-request-routing-arr-20-for-shared-hosting/_static/image5.jpg) diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform.md b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform.md deleted file mode 100644 index b555870a6..000000000 --- a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform.md +++ /dev/null @@ -1,215 +0,0 @@ ---- -title: "Configure your Servers for the Windows Web Hosting Platform" -author: rmcmurray -description: "The Microsoft Web Platform gives you the framework, web server, database and tools your customers need to build and run Web sites and applications on Windows..." -ms.date: 08/24/2012 -ms.assetid: 1b984754-3cc1-4352-8d2f-7de6df40b10b -msc.legacyurl: /learn/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform -msc.type: authoredcontent ---- -# Configure your Servers for the Windows Web Hosting Platform - -by [Robert McMurray](https://github.com/rmcmurray) - -## Introduction to the Windows Web Platform - -The Microsoft Web Platform gives you the framework, web server, database and tools your customers need to build and run Web sites and applications on Windows. It provides a complete ecosystem of products, technologies, partners, and customers. You will be able to easily setup your servers with <link:WebPI>, test your environment using the same experience your users will have with <link:WebMatrix>, promote your offerings through the <link: Hosting Gallery>, and have quick access to the latest platform updates. The following sections will guide you through the process of configuring your servers using all the elements of the platform. - -| **Tools** | **Customer** | **Web Hosting Provider** | -| --- | --- | --- | -| **Web Platform Installer (Web PI)** | Installs Web Platform Tools and Apps | Installs Web Plat Tools and Apps | -| **WebMatrix** | Installs/Develops Applications, Customizes, and Publishes to Hosting Provider | Supports customers publishing through WebMatrix by configuring <link:Web Deploy> | -| **Web Hosting Gallery** | Browse/Search for hosting | Publishes offerings | -| **Web Application Gallery** | Browse/Search for Web Applications to customize and publish to a hosting provider | Supports these popular applications | -| **WebsitePanel** | Uses it to manage their Hosting Account and resources | Uses it to manage their plans, customers, resource allocation, and provisioning | - -![Diagram of the Microsoft Web Platform Ecosystem.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image1.png) - -Image 4: The Microsoft Web Platform Ecosystem - -## Configure your Hyper-v Host for Shared Web Hosting - -As we discussed earlier, you can setup a shared hosting environment with a basic configuration consisting of a single server. The following steps will guide you through the setup of a single server running as a Hyper-v host. This server will host the three VM Servers as described above. - -To get started, setup the hyper-v host server with Windows Server 2008 R2 Enterprise. This version of Windows includes four guest licenses (Windows Server Standard or Enterprise); it allows you to setup the host with four guests and pay monthly only for the host server after you have customer websites in any of the guest servers. - -a. Click the "Server Manager" button in the task bar; or click "Start" menu, type "Server Manager" and press Enter. This will bring up the Server Manager application. - - ![Screenshot of the task bar. The Server Manager button is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image3.png) - -b. On the left panel of Server Manager click on "Roles" - - ![Screenshot of the Server Manager dialog box. In the left panel Roles is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image5.png) - -c. Under "Roles Summary" click on "Add Roles". Follow the Add Roles Wizard to Add the Hyper-v role. The wizard will ask you to reboot the computer; when you log back in, the wizard will complete the Hyper-v configuration. - - ![Screenshot of the Server Manager dialog box. Add Roles is highlighted under Roles Summary.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image7.png) - - ![Screenshot of the Select Server Roles Wizard. The Hyper dash v role is selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image9.png) - -## Create your Web Server VM - -This section will guide you through the creation of a guest VM to be the Web Server using Windows Server 2008 R2 SP1 Standard. - -a. On the host machine, click the "Start" menu, type "Hyper-v Manager" and press Enter. This will bring up the Hyper-v Manager application. - - ![Screenshot of the Hyper dash v Manager application.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image11.png) - -b. On the "Actions" bar (right side) click "New" and select "Virtual Machine". The New virtual Machine Wizard will come up. - - ![Screenshot of the Actions bar. Virtual Machine is selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image13.png) - -c. Enter the name of the virtual machine, I usually use a descriptive name that refers to the OS version used, for example "WS2K8R2Std". - -d. On the same screen, select the location of where in disk the virtual machine will be stored. Do so by checking the check box and selecting the location you will use for the Web Server VM. - - ![Screenshot of the New Virtual Machine Wizard. In the Name box the text New Virtual Machine is written and highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image15.png) - -e. If you already have a prepared virtual hard disk available, this is the moment to specify to use it for your VM; otherwise you could create one from scratch or attach one later. - - ![Screenshot of the Connect Virtual Hard Disk page of the New Virtual Machine Wizard. Create a virtual hard disk is selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image17.png) - -f. The next step is to install the OS, you have several options, for some of them you need to have the OS media ready. If you have not visited the SPLA site to download Windows Server 2008 R2 SP1 Standard, now is the time. You can use the downloaded OS in this step or do it later from a DVD, network drive, or network-based installation server. - - ![Screenshot of the Installation page. Install an operating system later is selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image19.png) - -From this point on your VM will be ready for you to start and connect to, use the Hyper-v Manager and double click on the machine listed under "Virtual Machines" in the center panel. - -## Configure the Web Server Components to support WebMatrix - -This article will walk you through installing the required server components to be **WebMatrix compatible** and fulfill the **Spotlight requirements** for the Web Hosting Gallery. - -To simplify the installation of the **web server** components, we highly recommend installing Web Platform Installer, also known as WebPI, on both machines. WebPI is a tool that automates the installation of a vast majority of server components and other products for Microsoft's Web Platform. - - - -If you prefer to not use WebPI, all of the required components can also be installed by hand or via your own provisioning scripts. - -### Option 1: Via Web Platform Installer 3.0 (recommended) - -If you have WebPI 3.0 installed, the following link will automatically launch it with all of the basic web server components you'll need ready to install: - -1. Login in the VM created in the previous section, use your administration account. Notice that these instructions will work regardless of whether you are using a VM or an actual machine. -2. [Install Spotlight Components using Web PI](https://www.microsoft.com/web/gallery/install.aspx?appid=WHP_Recommended). This link will install WebPI (if you have not done so already) and will let you review the list of products and dependencies before you start the process of installing the components. Notice that this list of components completely fulfills the Spotlight requirements from the Web Hosting Gallery. - - ![Screenshot of the Install Now button. This is powered by the Microsoft Web Platform Installer.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image21.png) - -3. Once the Web PI window is displayed, click the "Items to be installed" link to review the list of products and dependencies. - - ![Screenshot of the Web Platform Installer 3 dot 0. The I I S Recommended Configuration is shown. The Items to be installed link is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image25.png) - -4. Scroll down to see the rest of the items in the list: - - ![Screenshot of a list of items ready to be installed.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image27.png) - - Here is the list of Products to install: - - 1. IIS 7 or above Web Server including the following modules: Web Deploy 2.0, FTP, IIS Remote Management Services, CGI, URL Rewrite 2.0, SQL Server 2008 Management Objects (SMO), Windows Cache 1.1 for PHP, MySQL Connector, Microsoft SQL Server Driver for PHP 2.0 - 2. Frameworks: .NET 3.5 SP1, .NET 4.0, ASP.NET, ASP.NET MVC, and PHP 5.2.14 or higher - -5. Review the license page and accept the terms to continue with the install: - - ![Screenshot of the license page. The I Accept button is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image29.png) - - ![Screenshot of the Web Platform Installation Wizard. The Installation progress bar is shown.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image33.png) - -6. If you are not using Windows Server 2008 R2 **SP1**, install the following Web Server Patch: [Extensionless URL Hotfix](https://support.microsoft.com/kb/980368). This hotfix is required for ASP.NET Web Pages to function correctly. -7. (Optional) [Install Spotlight Components plus PHP/MySQL related components using Web PI](https://www.microsoft.com/web/gallery/install.aspx?appid=IIS7;Tracing;NETFramework35;NETFramework4;ASPNET;MVC;WDeploy;FTPServer;ManagementService;CGI;URLRewrite2;SMO;PHP52;WinCache52;MySQLConnector;SQLDriverPHP52IIS). Many of the web applications that can be published by WebMatrix have PHP/MySQL components as requirements. To ensure you are able to support those applications, you can use this link to install everything above plus PHP/MySQL related components - -### Option 2: Manually install Web Server components - -Here is the full list of which components are installed by those links, so you can confirm against the list of products listed in WebPI. Note that many of them bring in dependencies – that is expected behavior – but the total download should not exceed 50 MB or so. - -Server: - -- [Required] [IIS 7 Web Server](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=IIS7;Tracing) basic components. Required for basic web server functionality. - -Frameworks: - -- [Required] [.NET Framework 3.5 SP1](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=NETFramework35). [Some applications](https://www.microsoft.com/web/gallery/) depend on this framework -- [Required] [.NET Framework 4.0](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=NETFramework40). [Some applications](https://www.microsoft.com/web/gallery/) depend on this framework -- [Optional] PHP (5.2.14 or higher). This is not required for Spotlight, but many applications that can be published by WebMatrix depend on this framework - -ASP.NET: - -- [Required] [ASP.NET](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=ASPNET). This framework is the backend of many of the most popular web applications -- [Required] [ASP.NET MVC 1.0](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=MVC). A handful of applications in the App Gallery depend on this installed centrally -- [Optional] You can also optionally install [ASP.NET MVC3](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=MVC3) and [ASP.NET Web Pages](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=Plan9), which gives you the ability to host applications written in the new "Razor" syntax of ASP.NET. However, note that the binaries required for these kinds of applications are automatically published by WebMatrix. That is, each end user who publishes applications of this type will automatically end up with the required binaries in a /bin/ folder within their site root directory, so it is not really necessary to install them centrally. - -IIS Modules: - -- [Required] [Microsoft Web Deploy](https://www.iis.net/downloads/microsoft/web-deploy). Web Deploy is a client-server tool that simplifies the deployment of sites and applications to IIS servers. While WebMatrix supports web application publishing using both FTP and Web Deploy protocols, the latter providers a faster, more secure, and richer experience. It also lets the user deploy whole apps, including databases, ensuring they work both locally and remotely. It is the highlight of the WebMatrix publishing story. -- [Required] [FTP Publishing Service](https://www.iis.net/downloads/microsoft/ftp). To ensure the option of FTP exists for maximum compatibility -- [Required] [IIS Remote Management Service](https://www.iis.net/downloads/microsoft/iis-manager). To allow your users to manage aspects of their accounts using the IIS console. Also a dependency for Web Deploy to function properly -- [Required] [FastCGI for IIS](https://www.iis.net/downloads/microsoft/fastcgi-for-iis). Provides a much faster CGI implementation than the default -- [Required] [URL Rewrite](https://www.iis.net/downloads/microsoft/url-rewrite). A dependency for many applications to function correctly -- [Required] [SQL Server 2008 Management Objects](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=ceb4346f-657f-4d28-83f5-aae0c5c83d52). A dependency for many applications to function correctly, and for WebDeploy to manage SQL Server db's. -- [Optional] [Windows Cache Extension 1.1 for PHP](https://www.iis.net/downloads/microsoft/wincache-extension). Highly recommended when running PHP on Windows. -- [Optional] [MySQL Connector/Net](http://dev.mysql.com/downloads/connector/net/) 6.2.3 or higher. Necessary for .NET applications using MySQL databases -- [Optional] [Microsoft Drivers for PHP for SQL Server](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=80e44913-24b4-4113-8807-caae6cf2ca05) in IIS. Necessary for PHP applications using SQL Server -- [Extensionless URL Hotfix](https://support.microsoft.com/topic/a-update-is-available-that-enables-certain-iis-7-0-or-iis-7-5-handlers-to-handle-requests-whose-urls-do-not-end-with-a-period-525f06bd-125b-9fb7-0564-327172f1912f). Needed only if you are not using Windows 2008 R2 **SP1**. Required for ASP.NET Web Pages to function correctly. It is discussed further in this blog post. - -Database Server Components (see next section): - -- [Optional] [PHP Driver for SQL Server](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=SQLDriverPHP). We highly recommended installing this component on your database server if you are supporting PHP. - -Next Steps: - -• Proceed to configure the database server machine. - -• Ensure that the Web Deploy 2.0 (or higher) component is [configured to allow delegated deployments](../joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md). This is critical, as it is the primary method that allows your customers to publish to your servers with WebMatrix. - - - -**Create & Configure your SQL Server VM** - -Create a second guest as the Database Server Virtual Machine - -1. Follow the same steps outlined in "Create your Web Server VM" to create the Database Server VM. -2. Add Database Server Components to the Database VM - - 1. Download the SQL Server 2008 R2 Web media from the SPLA site, find the link in the email you received confirming your SPLA agreement. - 2. [Required] Install SQL Server 2008 R2 Web on the Database VM. Follow the installation wizard instructions. WebPI supports installing [Microsoft SQL Server 2008 Express edition](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=SqlExpress), but we do not recommend this product in shared hosting environments, you should use the full version instead on a separate server. - 3. Install MySQL, use the following related [article](../joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support.md) to ensure the installation supports WebMatrix. - -## Configure your Content Server VM - -Create a third guest as the Content Server Virtual Machine - -1. Download the Windows Server 2008 R2 Enterprise media from the SPLA site, find the link in the email you received confirming your SPLA agreement. -2. Follow the same steps outlined in 2.a to create the VM Server. -3. Install the Windows Server Backup features in the content server: - - 1. Click the "Server Manager" button in the task bar; or click "Start" menu, type "Server Manager" and press Enter. This will run the Server Manager application. - - ![SCreenshot of the task bar. The Server Manager button is highlighted. This will run the Server Manager application.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image35.png) - - 2. On the left panel of Server Manager click on "Features" - - ![Screenshot of the Server Manager page. In the left panel of the Server Manager, Features is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image37.png) - - 3. Under "Features Summary" click on "Add Features". Follow the Add Features Wizard to Add the Backup service. - - ![Screenshot of the Server Manager page. Add Features is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image39.png) - - ![Screenshot of the Add Features Wizard. Windows Server Backup Features is highlighted and selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image41.png) - -1. Install the File Services role in the content server. - - 1. Click the "Server Manager" button in the task bar; or click the "Start" menu, type "Server Manager" and press Enter. This will run the Server Manager application. - - ![Screenshot of the Server Manager application. Under Server Manager, Roles is highlighted and selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image45.png) - - 2. On the left panel of Server Manager click on "Roles" - - ![Screenshot of the Server Manager application. Under Server Manager WALTER O H P W S, Roles is highlighted and selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image45.png) - - 3. Under "Roles Summary" click on "Add Roles". Follow the Add Roles Wizard to Add the "File Services" role. - - ![Screenshot of the Server Manager page. In the right pane, Roles is highlighted. In the Roles Summary category, Add Roles is highlighted.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image47.png) - - ![Screenshot of the Select Server Roles page. File Services is highlighted and selected.](configure-your-servers-for-the-windows-web-hosting-platform/_static/image49.png) - -## Configure your Control Panel Server VM - -Create a second Web Server VM, configure follow the same steps that you did for the first Web Server. This server will act as the Control Panel server; it will host WebsitePanel (we will install it in a subsequent section). It could also help you troubleshoot websites issues. This final VM will complete the four guests allowed by your Windows Server Enterprise 2008 R2 license. **If you are planning on a larger deployment, you may want to use the Windows Server 2008 R2 Datacenter edition which has no license limits on guests.** diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image1.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image1.png deleted file mode 100644 index 8ddf42fa1..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image11.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image11.png deleted file mode 100644 index 100b067cd..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image11.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image13.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image13.png deleted file mode 100644 index 1e54a4766..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image13.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image15.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image15.png deleted file mode 100644 index 34564fe90..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image15.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image17.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image17.png deleted file mode 100644 index e761651a5..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image17.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image19.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image19.png deleted file mode 100644 index 933803784..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image19.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image21.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image21.png deleted file mode 100644 index b75aa7ba6..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image21.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image25.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image25.png deleted file mode 100644 index bc6140e7b..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image25.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image27.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image27.png deleted file mode 100644 index 417ddaf72..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image27.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image29.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image29.png deleted file mode 100644 index a853cf6f9..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image29.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image3.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image3.png deleted file mode 100644 index 9c8b232a0..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image33.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image33.png deleted file mode 100644 index e395dfdee..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image33.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image35.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image35.png deleted file mode 100644 index 9c8b232a0..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image35.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image37.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image37.png deleted file mode 100644 index 0f7da57af..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image37.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image39.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image39.png deleted file mode 100644 index 36c95b928..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image39.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image41.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image41.png deleted file mode 100644 index b6fc58afb..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image41.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image43.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image43.png deleted file mode 100644 index 9c8b232a0..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image43.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image45.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image45.png deleted file mode 100644 index 656a3c831..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image45.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image47.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image47.png deleted file mode 100644 index 64cd51278..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image47.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image49.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image49.png deleted file mode 100644 index 4ecec8e8f..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image49.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image5.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image5.png deleted file mode 100644 index 5280ed45d..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image5.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image7.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image7.png deleted file mode 100644 index e1156b122..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image7.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image9.png b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image9.png deleted file mode 100644 index 7365105c4..000000000 Binary files a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/configure-your-servers-for-the-windows-web-hosting-platform/_static/image9.png and /dev/null differ diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md deleted file mode 100644 index b5f92505c..000000000 --- a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "Microsoft Web Platform Installer 2.0" -author: walterov -description: "Introduction The Web Platform Installer 2.0 (WPI) is a tool that installs Microsoft's entire Web Platform, including IIS, Visual Web Developer 2010 Express E..." -ms.date: 02/17/2009 -ms.assetid: f8593a22-c829-4cb3-b471-a6d2823aab5e -msc.legacyurl: /learn/web-hosting/configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20 -msc.type: authoredcontent ---- -# Microsoft Web Platform Installer 2.0 - -by [Walter Oliver](https://github.com/walterov) - -## Introduction - -The [Web Platform Installer 2.0](https://www.microsoft.com/web/downloads/platform.aspx) (WPI) is a tool that installs Microsoft's entire Web Platform, including IIS, Visual Web Developer 2010 Express Edition, SQL Server 2008 R2 Express Edition and the .NET 4 Framework. Using the Web Platform Installer's user interface, you can choose to install either specific products or the entire Microsoft Web Platform onto your computer. The Web PI also helps keep your products up to date by always offering the latest additions to the Web Platform. - -The following image shows the Web PI introductory screen: - -![Screenshot that shows the Web Platform Installer 2 point 0. The What's New tab is open.](microsoft-web-platform-installer-20/_static/image3.png) - -## For Hosters - -Web PI can help in the following scenarios: - -- Building reference machines used for the creation of images for dedicated or virtual dedicated offerings. Or when building the Web Server reference machine for a shared hosting environment. -- Updating existing machines with the latest components. -- Deploying an internal development or testing environment. -- Referring customers to use Web PI to setup their own dedicated machines or local environments for development and testing before deploying to hosted environments. - -The following image shows an example of the **Web Platform** tab and a subset of the available components: - -[![Screenshot that shows the Web Platform Installer 2 point 0. The Web Platform tab is open.](microsoft-web-platform-installer-20/_static/image5.png)](microsoft-web-platform-installer-20/_static/image4.png) - -## For Web Hosting Customers - -Web PI can help in the following scenarios: - -- Deploying a development environment with the entire Web Platform stack of components. Includes the latest Web, Database, and development tools and technologies. -- Updating the development environment with the latest components. - -The following image shows the **Web Applications** tab with the available components: - -![Screenshot that shows the Web Platform Installer 2 point 0. The Web Applications tab is open.](microsoft-web-platform-installer-20/_static/image6.png) - -## More Information - -- To install visit [Microsoft Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) page. It includes information about system requirements, installation steps, and an information video. -- For a walkthrough of the Web PI visit [Web Platform Installer Walkthrough](../../install/web-platform-installer/web-platform-installer-20-walkthrough.md) -- For support questions visit the [Web PI forum](https://forums.iis.net/1155.aspx) diff --git a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/shared-configuration_211.md b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/shared-configuration_211.md index 2a0d57ec4..da760c463 100644 --- a/iis/web-hosting/configuring-servers-in-the-windows-web-platform/shared-configuration_211.md +++ b/iis/web-hosting/configuring-servers-in-the-windows-web-platform/shared-configuration_211.md @@ -1,5 +1,5 @@ --- -title: "Shared Configuration" +title: "Shared Configuration in IIS versions" author: walterov description: "In IIS 6.0, synchronizing and replicating configuration between servers was difficult because no built-in functionality existed. Although the server administ..." ms.date: 12/02/2007 @@ -7,7 +7,7 @@ ms.assetid: 4c423bc4-1dac-4d0d-9be3-5c9b87b06e86 msc.legacyurl: /learn/web-hosting/configuring-servers-in-the-windows-web-platform/shared-configuration_211 msc.type: authoredcontent --- -# Shared Configuration +# Shared Configuration in IIS versions by [Walter Oliver](https://github.com/walterov) diff --git a/iis/web-hosting/frequently-asked-questions-faq/net-questions.yml b/iis/web-hosting/frequently-asked-questions-faq/net-questions.yml index 84a68bbfd..42c6bcce2 100644 --- a/iis/web-hosting/frequently-asked-questions-faq/net-questions.yml +++ b/iis/web-hosting/frequently-asked-questions-faq/net-questions.yml @@ -86,9 +86,7 @@ sections: - question: | Does the .NET 3.5 Framework include Entity Framework Beta 2? answer: | - No. It doesn't include Entity Framework beta2. You need to download here: - - [https://www.microsoft.com/downloads/details.aspx?FamilyId=F1ADC5D1-A42E-40A6-A68C-A42EE11186F7&displaylang=en](https://www.microsoft.com/downloads/details.aspx?FamilyId=F1ADC5D1-A42E-40A6-A68C-A42EE11186F7&displaylang=en) + No. It doesn't include Entity Framework beta2. Here is the release info: diff --git a/iis/web-hosting/frequently-asked-questions-faq/php-questions.md b/iis/web-hosting/frequently-asked-questions-faq/php-questions.md deleted file mode 100644 index 721444877..000000000 --- a/iis/web-hosting/frequently-asked-questions-faq/php-questions.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "PHP Questions" -author: walterov -description: "Microsoft does not support PHP. We started integration testing with 5.2.1. Most of the testing seen shows PHP working well, without specific integration issu..." -ms.date: 12/22/2007 -ms.assetid: 0539b3e4-7d7b-4e34-9406-28ed9965c500 -msc.legacyurl: /learn/web-hosting/frequently-asked-questions-faq/php-questions -msc.type: authoredcontent ---- -# PHP Questions - -by [Walter Oliver](https://github.com/walterov) - -#### What support is available for PHP running with FastCGI? - -Microsoft does not support PHP. We started integration testing with 5.2.1. Most of the testing seen shows PHP working well, without specific integration issues (other than bugs on our side which we are fixing, or bugs in PHP which are independent of the FastCGI). - -#### Can multiple versions of PHP run in the same Application Pool? - -Yes. Several web sites in the same app pool can use different PHP versions when using the FastCGI components that we are releasing for IIS 6.0 and IIS 7.0. Here's an example of an .ini file: - -[!code-console[Main](php-questions/samples/sample1.cmd)] - -The PHP:1 and PHP:2 means that the extension applies to Web Site #1 and #2 respectively. - -#### Is there a list of PHP applications that have been tested on Windows Server® 2008? - -These [applications](../../application-frameworks/install-and-configure-php-applications-on-iis/index.md "PHP Applications") have been used on Windows Server 2008 and have no known issues. diff --git a/iis/web-hosting/frequently-asked-questions-faq/php-questions/samples/sample1.cmd b/iis/web-hosting/frequently-asked-questions-faq/php-questions/samples/sample1.cmd deleted file mode 100644 index a516766f7..000000000 --- a/iis/web-hosting/frequently-asked-questions-faq/php-questions/samples/sample1.cmd +++ /dev/null @@ -1,7 +0,0 @@ -[Types] -PHP:1=PHPV4 -PHP:2=PHPV5 -[PHPV4] -ExePath=c:\PHP4\php-cgi.exe -[PHPV5] -ExePath=c:\PHP5\php-cgi.exe \ No newline at end of file diff --git a/iis/web-hosting/frequently-asked-questions-faq/tools-and-utilities-questions.yml b/iis/web-hosting/frequently-asked-questions-faq/tools-and-utilities-questions.yml index 4680bf77f..d2b528d19 100644 --- a/iis/web-hosting/frequently-asked-questions-faq/tools-and-utilities-questions.yml +++ b/iis/web-hosting/frequently-asked-questions-faq/tools-and-utilities-questions.yml @@ -78,9 +78,7 @@ sections: - question: | What kinds of tools are available to run stress tests? answer: | - WCAT is the tool that is being used now. It is part of IIS 6.0 Resource Kit which can be downloaded from the following link: - - [https://www.microsoft.com/downloads/details.aspx?FamilyID=56fc92ee-a71a-4c73-b628-ade629c89499&DisplayLang=en](https://www.microsoft.com/downloads/details.aspx?FamilyID=56fc92ee-a71a-4c73-b628-ade629c89499&DisplayLang=en) + WCAT is the tool that is being used now. It is part of IIS 6.0 Resource Kit. - question: | Will IIS Manager run on any other OS? diff --git a/iis/web-hosting/getting-started/quick-guides.md b/iis/web-hosting/getting-started/quick-guides.md index 25c95face..3f1e2de09 100644 --- a/iis/web-hosting/getting-started/quick-guides.md +++ b/iis/web-hosting/getting-started/quick-guides.md @@ -26,7 +26,6 @@ The following links provide valuable information on configuring and deploying.va - Guide for Installing [Active Directory DS Forest](../installing-infrastructure-components/active-directory-ds-forest.md). Contains guides for installing though the User Windows Interface, Command Line, and Answer File. - Preparation Activities for WDS](../installing-infrastructure-components/preparation-activities-for-wds.md). Contains a reference to [Windows Deployment Services Role Step-by-Step Guide. - [Quick Guide for Shared Hosting Deployment](../configuring-servers-in-the-windows-web-platform/quick-guide-for-shared-hosting-deployment.md). Includes the Web Server Role. -- [Install and Configure FastCGI](../web-server-for-shared-hosting/fastcgi-with-php.md) - [SQL Server 2005 Deployment Guidance for Web Hosting Environments](https://www.microsoft.com/technet/prodtechnol/sql/bestpractice/sql2005dgwhe.mspx "SQL 2005 Guide") ### Provisioning and Managing diff --git a/iis/web-hosting/getting-started/shared-hosting-content-map.md b/iis/web-hosting/getting-started/shared-hosting-content-map.md index f95ccd94e..9d18b4819 100644 --- a/iis/web-hosting/getting-started/shared-hosting-content-map.md +++ b/iis/web-hosting/getting-started/shared-hosting-content-map.md @@ -61,9 +61,7 @@ You can find additional resources for understanding Windows Server 2008 R2 with - [URL Rewrite for Hosters](../web-server-for-shared-hosting/url-rewrite-for-hosting-providers.md) - [Database Manager for Hosters](../web-server-for-shared-hosting/database-manager-for-hosters.md) - [Administration Pack](../web-server-for-shared-hosting/administration-pack.md) - - [FastCGI with PHP](../web-server-for-shared-hosting/fastcgi-with-php.md) - [ASP](../web-server-for-shared-hosting/asp.md) - - [Configuring IIS for Silverlight Applications](../web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md) - [SMB Commands Registry Keys](../web-server-for-shared-hosting/smb-commands-registry-keys_198.md) - [Backup](../web-server-for-shared-hosting/create-a-backup-with-appcmd.md) - [File Server For Content Storage](../configuring-servers-in-the-windows-web-platform/index.md) @@ -82,10 +80,8 @@ You can find additional resources for understanding Windows Server 2008 R2 with - [SQL 2008 for Hosters](../configuring-servers-in-the-windows-web-platform/sql-2008-for-hosters.md) - [SQL Server 2005](../configuring-servers-in-the-windows-web-platform/sql-server-2005.md) - - [MySQL Server](../../application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md) - [Guide to Deploy FTP and Publish with VWD](../configuring-servers-in-the-windows-web-platform/guide-to-deploy-ftp-and-publish-with-vwd.md) - [Publishing Components: FTP 7.5, WebDAV, and FPSE](../configuring-servers-in-the-windows-web-platform/publishing-components-ftp-70-webdav-and-fpse.md) -- [Web Platform Installer](../configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md) @@ -93,7 +89,6 @@ You can find additional resources for understanding Windows Server 2008 R2 with - [Verifying Remote Administration](../verifying-the-deployment/verifying-remote-administration.md) - [Verifying the Developer Experience – ASP.NET](../verifying-the-deployment/verifying-the-developer-experience-aspnet.md) -- [Verifying the Developer Experience - PHP](../verifying-the-deployment/verifying-the-developer-experience-php.md) @@ -167,4 +162,3 @@ You can find additional resources for understanding Windows Server 2008 R2 with - [Creating, Updating, and Publishing Web applications with Visual Web Developer](../using-shared-hosting-environments/creating-and-publishing-web-applications-with-visual-web-developer.md) - [Setting up Delegated Administration, Server and Client Experiences](../using-shared-hosting-environments/setting-up-delegated-administration-server-and-client-experiences.md) - [Using Delegated Administration](../using-shared-hosting-environments/using-delegated-administration.md) -- [Web Platform Installer](../configuring-servers-in-the-windows-web-platform/microsoft-web-platform-installer-20.md) diff --git a/iis/web-hosting/hosting-the-microsoft-web-platform-on-amazon-ec2/amazon-ec2-microsoft-web-platform-images-wordpress.md b/iis/web-hosting/hosting-the-microsoft-web-platform-on-amazon-ec2/amazon-ec2-microsoft-web-platform-images-wordpress.md index a8b628a51..6cfff2c42 100644 --- a/iis/web-hosting/hosting-the-microsoft-web-platform-on-amazon-ec2/amazon-ec2-microsoft-web-platform-images-wordpress.md +++ b/iis/web-hosting/hosting-the-microsoft-web-platform-on-amazon-ec2/amazon-ec2-microsoft-web-platform-images-wordpress.md @@ -13,7 +13,7 @@ by [Thomas Deml](https://github.com/thomasdeml) ## Introduction -One thing we often hear from Web developers, especially those who offer Web site design and consulting services, is the need to get a Web site up quickly, which runs fast and gives them total control of the server for maximum flexibility and scalability. Today's post offers a quick walkthrough on how to run [WordPress](http://wordpress.com/) on Amazon's [EC2](http://aws.amazon.com/ec2/) Cloud and the Microsoft Web Platform. After you followed the steps in this walkthrough you will have a live production Wordpress blog on the Internet. +One thing we often hear from Web developers, especially those who offer Web site design and consulting services, is the need to get a Web site up quickly, which runs fast and gives them total control of the server for maximum flexibility and scalability. Today's post offers a quick walkthrough on how to run [WordPress](https://wordpress.com/) on Amazon's [EC2](https://aws.amazon.com/ec2/) Cloud and the Microsoft Web Platform. After you followed the steps in this walkthrough you will have a live production Wordpress blog on the Internet. Here are quick summary of the steps you have to follow: diff --git a/iis/web-hosting/installing-infrastructure-components/planning-the-deployment.md b/iis/web-hosting/installing-infrastructure-components/planning-the-deployment.md index 0ece7e0ee..4ef2cbd67 100644 --- a/iis/web-hosting/installing-infrastructure-components/planning-the-deployment.md +++ b/iis/web-hosting/installing-infrastructure-components/planning-the-deployment.md @@ -55,7 +55,7 @@ Based on the existing environment and combination of scenarios, you can decide w - When installing Windows in new computers, use WDS and the scripts provided in this guide. - When refreshing or replacing a computer, use a combination of PowerShell scripts to backup the user data, use WDS to re-image the machine, and finally, scripts again to restore the user data. -- When upgrading a large set of computers preserving user data and file systems, evaluate using MD or SCCM. When using MD or SCCM, you can use a combination of the LTI and ZTI methods to deploy operating systems to the target computers. Microsoft Deployment, LTI and ZTI use the same common set of scripts and configuration files (such as CustomSettings.ini) for deploying the operating system. However, there are instances in which one method of deployment might be more advantageous. (For more information [download and install MD](https://www.microsoft.com/downloads/details.aspx?familyid=3bd8561f-77ac-4400-a0c1-fe871c461a89&displaylang=en&tm) and read the *Preparing for LTI Tools* document.) +- When upgrading a large set of computers preserving user data and file systems, evaluate using MD or SCCM. When using MD or SCCM, you can use a combination of the LTI and ZTI methods to deploy operating systems to the target computers. Microsoft Deployment, LTI and ZTI use the same common set of scripts and configuration files (such as CustomSettings.ini) for deploying the operating system. However, there are instances in which one method of deployment might be more advantageous. 1. **Deploy Operating Systems Using LTI**. LTI requires the MD Toolkit and minimal infrastructure to operate. The team can deploy operating systems over the network using a shared folder, or locally using removable storage (such as a CD, DVD, USB flash drive [UFD], or other device). You can initiate the deployment process automatically (using Windows Deployment Services) or manually. Initially configure LTI using Deployment Workbench, and then further customize CustomSettings.ini for the specific environment. In LTI deployment, the team provides configuration settings for groups of computers. The configuration settings for each individual computer are usually provided manually during the deployment process. As a result, customizing LTI usually requires less effort than customizing ZTI. 2. **Deploy Operating Systems Using ZTI**. ZTI requires System Center Configuration Manager or Systems Management Server 2003 with SP2, and the SMS 2003 OSD Feature Pack. The team deploys operating systems from System Center Configuration Manager or Systems Management Server 2003 distribution points. The installation process can be initiated by System Center Configuration Manager, Systems Management Server 2003, or Windows Deployment Services. The ZTI deployment process is always initiated automatically. Like LTI, the team initially configures ZTI using Deployment Workbench, and then further customizes CustomSettings.ini for their environment. In ZTI deployment, the team must provide all configuration settings for each target computer being migrated using ZTI. By definition, there is no manual configuration in ZTI. As a result, customizing ZTI usually requires more effort than customizing LTI. @@ -120,8 +120,6 @@ If you are planning to use Microsoft Deployment, see the detailed listing of req This is important if you are using MD Toolkit or SCCM. The ZTI and LTI deployment use processing rules that determine the steps and configuration parameters during the process of deploying the images to target computers. These settings are stored and managed in CustomSettings.ini. -[Download and install MD](https://www.microsoft.com/downloads/details.aspx?familyid=3bd8561f-77ac-4400-a0c1-fe871c461a89&displaylang=en&tm) to find more information about: - - Determining the processing rules required for minimal functionality in LTI: See "Configure the Appropriate Processing Rules," in *Preparing for LTI Tools.* - Determining the processing rules required for minimal functionality in ZTI: See "Configuring the Appropriate Processing Rules," in *Preparing for Microsoft Systems Management Server 2003* or *Preparing for Microsoft Systems Center Configuration Manager 2007.* - Extending functionality in LTI and ZTI: See *Deployment Customization Guide.* diff --git a/iis/web-hosting/installing-infrastructure-components/preparation-activities-for-wds.md b/iis/web-hosting/installing-infrastructure-components/preparation-activities-for-wds.md index 018c2a5ae..5c1c0a9ca 100644 --- a/iis/web-hosting/installing-infrastructure-components/preparation-activities-for-wds.md +++ b/iis/web-hosting/installing-infrastructure-components/preparation-activities-for-wds.md @@ -13,8 +13,6 @@ by [Walter Oliver](https://github.com/walterov) This article provides an overview of the preparation activities needed when deploying with Windows Deployment Services. The Deployment preparations activities may involve writing and testing the PowerShell scripts used in configuration and backup / restore tasks, preparing the servers used to back up computers, create and store operating system images, install applications, and migrate existing user data if needed. This article concentrates o using WDS and the PowerShell scripts provided in this guide. -For detailed information on the preparation activities for Microsoft Deployment [download and install MD](https://www.microsoft.com/downloads/details.aspx?familyid=3bd8561f-77ac-4400-a0c1-fe871c461a89&displaylang=en&tm), within the Deployment Workbench documentation find the section, "Prepare the Deployment Environment," in the *Preparing for LTI Tools* document. - ## Prepare the Deployment Environment Using WDS diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup.md b/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup.md deleted file mode 100644 index 625b70517..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: "Automating server setup" -author: bilalaslam -description: "This article explains how to provision an IIS frontend server with full WebMatrix compatibility in an automated manner. It fully automates all steps describe..." -ms.date: 01/05/2011 -ms.assetid: 75449e45-0fee-4250-99d0-34b10b3aa051 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/automating-server-setup -msc.type: authoredcontent ---- -# Automating server setup - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Introduction - -This article explains how to provision an IIS frontend server with full WebMatrix compatibility in an automated manner. It fully automates all steps described in the rest of this documentation, with one exception: a Microsoft SQL Server or MySQL Server is expected to be provisioned separately and is not covered here. - -## Requirements - -- Windows Server 2008 R2 -- Powershell v1 enabled on the above server -- Internet connectivity on the above server (to download software requirements) - -## Preparing to Run Scripts - -1. Download the scripts from the following location: - - - -2. Extract them to `%systemdrive%\Webmatrix` -3. Launch a Powershell console in Administrator mode -4. Run this command: *Set-Executionpolicy Unrestricted - force*. This will allow the unsigned scripts to execute. - -## Installing Software Requirements - -The script pack contains a program called webpicmdline.exe in the \webpicmdline folder. - -1. Open an elevated command prompt (cmd.exe, NOT Powershell) -2. Run this command to install the software stack: - -[!code-console[Main](automating-server-setup/samples/sample1.cmd)] - -## Configuring the Web Management Service - -Run *.\01\_InitializeWebManagementService.ps1*. This script will do the following: - -1. Set service startup type to Automatic -2. Enable remote connections -3. Enable tracing -4. Increase number of tracing logs files that are retained -5. Restart Web Management Service - -## Creating Web Deploy Delegation Rules - -The script .\02\_AddDelegationRules.ps1 creates Web Deploy delegation rules. This script will create the following delegation rules: - -- contentPath,iisApp -- dbFullSql -- dbMySql -- createApp -- setAcl -- recycleApp -- appPoolNetFx -- appPoolPipeline - -The script needs several parameter inputs for the rules to be created properly: - -- elevatedUsername: username of a user who has Write access to applicationHost.config. Required for createApp, appPoolNetFx, appPoolPipeline rules. -- elevatedPassword: password of above user -- adminUsername: username of a user who is in the Administrators group on the IIS server. Required for recyleApp rule. -- adminPassword: password of above user. - -Please note that the script CREATES these above users. - -*.\02\_AddDelegationRules.ps1 -elevatedUsername wdeploy\_elevated -elevatedPassword <password> -adminUsername wdeploy\_admin -adminPassword <password>* - -## Installing the Extensionless URL hotfix - -Run *.\InstallExtensionlessUrlHotfix.ps1* - -This will download and install the hotfix, KBKB980368. - -> [!NOTE] -> We suppress server reboots during the hotfix installation. You may need to restart the server (shutdown /r) after the update installs. - -## Virtual Dedicated: Creating and Assigning a New Self-signed Certificate - -The Web Management Service is installed by default with a self-signed certificate. If you run sysprep after installing IIS (as is common with virtual dedicated servers), the self-signed certificate is no longer valid as the machine SID has changed, and you may see errors when connecting to the Web Management Service. You need to create a new self-signed certificate and assign it to the Web Management Service. - -Run *.\00\_Certificate.ps1*. This script will: - -- Remove the SSL binding of the old certificate on port 8172 -- Create a new self-signed certificate -- Bind new self-signed certificate to port 8172 -- Configure Web Management Service to use new self-signed certificate -- Restart Web Management Service - -This script needs to run on the first logon into the image. If you do this as the very last step before running sysprep, it ensures the certificate script runs on the next login. - -1. Start regedit.exe -2. Navigate to HKCU\Software\Microsoft\Windows\CurrentVersion -3. Create a key called RunOnce if it doesn't already exist -4. Right-click the RunOnce key add a new String value. Name the value anything (for example – "CertInitScript") -5. Double click the string value and add the following for its data: `%WinDir%\System32\WindowsPowerShell\v1.0\powershell.exe C:\WebMatrix\00\_Certificate.ps1` - -Note: You can easily modify this script to assign an existing certificate (such as a trusted root certificate) to the Web Management Service. This is recommended so WebMatrix users do not see a certificate warning when publishing to your server. - -## Known Issues - -- 02\_AddDelegationRules.ps1 does not work with shared configuration. Workaround: change the GetApplicationHostConfigPath function in HostingCommon.psm1 to return the path to your shared configuration. - -## Debugging - -Scripts create a log file in the same folder they are run, starting with HostingLog. diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup/samples/sample1.cmd b/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup/samples/sample1.cmd deleted file mode 100644 index 99d3485fe..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/automating-server-setup/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -webpicmdline.exe /Products:IIS7,Tracing,NETFramework35,NETFramework4,ASPNET,MVC,WDeploy,FTPServer,ManagementService,CGI,URLRewrite2,SMO,PHP52,WinCache52,MySQLConnector,SQLDriverPHP52IIS \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md b/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md deleted file mode 100644 index 5df6d1c02..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "Configure Site for Web Deploy Publishing" -author: bilalaslam -description: "Configure Sites for Web Deploy Publishing At this point, your server is configured with all the software required to support WebMatrix publishing. The Web De..." -ms.date: 11/04/2010 -ms.assetid: f5310c01-2939-4b93-a9dc-1f0532eae2f9 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing -msc.type: authoredcontent ---- -# Configure Site for Web Deploy Publishing - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Configure Sites for Web Deploy Publishing - -At this point, your server is configured with all the software required to support WebMatrix publishing. The Web Deploy 2.0 installer created all the necessary Management Service Delegation Rules to allow non-administrators to deploy applications and databases. It also started the Web Management Service. - -Now we need to configure individual sites for Web Deploy publishing. This is similar to how you still need to enable FTP for individual sites in IIS even after you have installed FTP server features. - -### *Through the IIS Manager UI* - -[![Screenshot of Configure Web Deploy Publishing dialog box with boxes for file system permissions and Specify U R L for the Publishing Server Connection.](configure-site-for-web-deploy-publishing/_static/image2.png)](configure-site-for-web-deploy-publishing/_static/image1.png) - -Web Deploy's UI in IIS Manager contains a useful component for quickly configuring Web Deploy for a particular site: - -1. Start IIS Manager by clicking Start > Run and type "inetmgr.exe" -2. Right-click the site you want to publish to, click Deploy and then click "Configure Web Deploy Publishing…" -3. This dialog performs several useful tasks: - - - Sets appropriate file system permissions on the site's root folder so Web Deploy publishing will work. - - Generates a file containing Web Deploy publishing settings. This convenient file can be used in tools like WebMatrix and Visual Studio to publish to the site. - For now, you can just click "Setup" and copy the generated file to your development computer. If you are interested in customizing some of these options, here's an explanation of what each one of them does: - - | Select a user to give publishing permissions | If you have an IIS Manager that has IIS Manager Permissions to the site, it will be pre-populated here. Otherwise, select a Windows or IIS Manager. This is the user account the end user will publish with. | - | --- | --- | - | Enter a SQL Server / MySQL connection string to be used during publishing | If you enter database connection strings here, they will be saved to the publish settings file this dialog generates. Please note that databases need to be created outside of this UI. This UI will NOT create database artifacts such as users, logins etc. for you. Use a tool like SQL Server Management Studio or mysql.exe to provision databases for your users. | - | Specify the URL for the publishing server connection | This is the Web Deploy Management Service publishing endpoint. This value should be pre-filled. | -4. Click Setup. -5. Copy the .publishSettings file from your Desktop folder and to a computer running WebMatrix -6. Start WebMatrix and create a new site -7. Click Publish and "Import web hosting settings" and select this fileYou should now be able to publish to this site. - -### *Automating through PowerShell* - -Web Deploy 2.0 also contains scripts which automates the above process, plus scripts for creating SQL Server and MySQL databases. You can read more about these scripts [here](../../publish/using-web-deploy/web-deploy-powershell-cmdlets.md). We suggest that you use the SetupSiteForPublishing.ps1 script as guidance. A script solution which fully configures a site for Web Deploy must do the following: - -1. Create the site with appropriate port binding, application pool, name, directory etc. -2. Grant a Windows or IIS Manager user IIS Manager Permissions to the site's scope -3. If the user in the previous step is an IIS Manager User, the Web Management Service's identity needs to have permissions to the site's root physical folder. Alternatively, if the user is a Windows user, that user account needs to have permissions on the site's root phyiscal folder. - -## Next Steps - -After you have all your server components installed and configured, you should try [validating your setup](validate-your-server-configuration.md "Validate your server setup"). diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image1.png deleted file mode 100644 index effd3a29f..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image2.png b/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image2.png deleted file mode 100644 index effd3a29f..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/configure-site-for-web-deploy-publishing/_static/image2.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails.md b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails.md deleted file mode 100644 index 65223d07f..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: "Create Welcome E-mails" -author: crystalhoyer -description: "As customers sign up for your hosting service, you need to provision sites/users for them on your server and then send them their server credentials. One way..." -ms.date: 11/03/2010 -ms.assetid: 4b3b0288-37bf-44cd-9fc2-47b83ebe8ebc -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails -msc.type: authoredcontent ---- -# Create Welcome E-mails - -by [Crystal Hoyer](https://github.com/crystalhoyer) - -## Welcome E-mail Structure - -As customers sign up for your hosting service, you need to provision sites/users for them on your server and then send them their server credentials. One way to send them their credentials is over e-mail. With the changes you've made to support WebMatrix, we recommend the following additions to your welcome e-mails to make it simple for customers to begin publishing their new site: - -- Information on how to install WebMatrix, to easily develop and publish websites to you -- Profile XML file containing credential information (including database connection strings pre-created for the user), easily importable into WebMatrix -- Credentials in the body of the e-mail formatted in a way consistent with WebMatrix's user interface -- Control panel information so that the user can configure settings that are not available inside WebMatrix - -### Information on how to install WebMatrix - -WebMatrix is a solution that provides simple and seamless publishing from a development environment to a live site. We recommend in your introduction email to customers that you **direct them to install WebMatrix** using this link: - -[Install WebMatrix using Web Platform Installer](https://www.microsoft.com/web/gallery/install.aspx?appid=WebMatrix) - -### Profile XML file containing credential information - -We have created an XML schema that is **easily importable into WebMatrix** during your users' publishing process, rather than requiring them to manually enter information into a dialog box. To find out more about how to create this XML file, please refer to our article here : [Generate a Profile XML](generate-a-profile-xml-file.md). We recommend that you provide the customer's new credentials in this profile XML format **as an attachment** to their welcome e-mail. - -We recommend that this **includes databases** pre-created for the user, so as to make their first publishing experience successful with minimal configuration/setup needed. - -### Credentials formatted consistently with WebMatrix's interface - -For those customers that do wish to type in their connection information rather than loading a Profile XML file, you should provide the credentials as follows. This will enable customers to easily map the information from the email they receive from you with the information they need to enter in WebMatrix to publish their site. - -[![Screenshot of credentials for Web Deploy Information, F T P Information and Database Connections.](create-welcome-e-mails/_static/image2.png)](create-welcome-e-mails/_static/image1.png) - -### Control Panel Information - -You should also provide control panel access for your customers so that they can easily manage settings/databases/etc. on their remote server, as these are outside the realm of WebMatrix. One suggestion is to set up [WebsitePanel](http://www.websitepanel.net/ "WebsitePanel") and integrate it into your IIS-based offering. - -## Template - -We have created an HTML e-mail template you can customize for your customers. Given this and an attached publish Profile XML file, the path from sign-up to first publish is seamless for the end-user: - -[HTML e-mail template](create-welcome-e-mails/_static/create-welcome-e-mails-960-hosting email1.zip) - -There are several places in the template where you can add branding and other messages. - -## Next Steps - -That's it! You're ready to apply to the Web Hosting Gallery and go for the Spotlight status! - -Keep in mind that as you apply, you will need to provide a test account to the WebMatrix team using [Profile XML format](generate-a-profile-xml-file.md "Generating a Profile XML file"), as well as some **Control Panel access**. We'll be testing your servers by publishing our web applications to that test account, and will let you know if we encounter any problems. - -Good luck! diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/create-welcome-e-mails-960-hosting email1.zip b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/create-welcome-e-mails-960-hosting email1.zip deleted file mode 100644 index 46825cff9..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/create-welcome-e-mails-960-hosting email1.zip and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image1.png deleted file mode 100644 index 957b90fdd..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image2.png b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image2.png deleted file mode 100644 index 957b90fdd..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image2.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image3.png b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image3.png deleted file mode 100644 index 5dfbce215..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image4.png b/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image4.png deleted file mode 100644 index 5dfbce215..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/create-welcome-e-mails/_static/image4.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file.md b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file.md deleted file mode 100644 index 5bbaf6737..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: "Generate a Profile XML File" -author: bilalaslam -description: "Generate a Profile XML File When a user signs up for an account, your welcome email should contain an attachment containing account settings (also known as a..." -ms.date: 11/02/2010 -ms.assetid: e0a83e33-4d4f-448b-a85b-caa7289ced0f -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file -msc.type: authoredcontent ---- -# Generate a Profile XML File - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Generate a Profile XML File - -When a user signs up for an account, your welcome email should contain an attachment containing account settings (also known as a Profile XML file) that can be imported into WebMatrix so the user can easily publish to their new site. - -- The extension of the file should be **.publishsettings** -- The file should contain at most *one* Web Deploy profile, and at most *one* FTP profile. -- If both Web Deploy and FTP profiles are present, WebMatrix will pick the Web Deploy profile, but the user will be able to switch to FTP later if they so choose. -- Database connection strings (SQLServerDBConnectionString, mySQLDBConnectionString) should be **duplicated** between Web Deploy and FTP profiles. - -### Example File - -Example profile XML that describes two independent sets of publishing settings, one for Web Deploy and one for FTP **(this is a preliminary schema and is subject to change until WebMatrix v1 is released)**: - -[!code-xml[Main](generate-a-profile-xml-file/samples/sample1.xml)] - -[!code-xml[Main](generate-a-profile-xml-file/samples/sample2.xml)] - -[!code-xml[Main](generate-a-profile-xml-file/samples/sample3.xml)] - -[!code-console[Main](generate-a-profile-xml-file/samples/sample4.cmd)] - -### Schema Definition - -| **Attribute** | **Comments** | -| --- | --- | -| profileName | *Optional. Used by Visual Studio only.*

*Valid values: String containing only characters valid in Win32 filenames*

A name to refer to this profile by; shown in Visual Studio. | -| publishMethod | *Required for all profiles.*

*Valid values: MSDeploy, FTP*

WebMatrix does not support the FTPS protocol. | -| PublishURL | *Required for all profiles.*

If publishMethod is "MSDeploy", this is simply the URL of the Web Management Service (wmsvc) endpoint.
For example:
- `server.contoso.com`
- `server.contoso.com:8080` (for example, if you are using a non-standard port 8080 for wmsvc)

If publishMethod is "FTP", this is the URL of the FTP server.

If your FTP server is configured to change-directory the user to the appropriate root physical folder for their site upon login, then this can simply be the URL of the FTP server (for example, `ftp://ftp.contoso.com:21`).

Otherwise, you need to specify the site root path (this shows up as the "Site path" setting in the WebMatrix Publish Settings dialog when the protocol is FTP). This can be done in one of two ways:
- Relative: `ftp://ftp.contoso.com:21/username/wwwroot`
- Absolute: `ftp://ftp.contoso.com:21//hosting_spaces/username/wwwroot` | -| msdeploySite | *Required for Web Deploy profile.*

This is the name of the IIS site the user is publishing to. | -| ftpPassiveMode | *Optional, only applies to a profile where publishMethod is "FTP".*

Specifies whether WebMatrix should connect using FTP passive mode or not. If omitted, the default is to connect with passive mode. | -| userName | *Required for all profiles.* | -| userPWD | *Optional. This is a plain text (that is, not encrypted) string.* | -| destinationAppUrl | *Required for all profiles.*

This is the public-facing URL of the customer's site. This is required for Publish Compatibility tests. Moreover, several applications such as Wordpress require the destinationAppUrl to be inserted into the database for the application to function correctly. WebMatrix does this insertion automatically, hence this field is required. | -| SQLServerDBConnectionString | *Optional, but highly recommended for ease of publishing.*

WebMatrix will use this database connection string to publish Microsoft SQL Server databases. We recommend that you pre-create the database when the user signs up for an account so they do not have to do this themselves from the hosting provider control panel. | -| mySQLDBConnectionString | *Optional, but highly recommended for ease of publishing.*

WebMatrix will use this database connection string to publish MySQL databases. We recommend that you pre-create the database when the user signs up for an account so they do not have to do this themselves from the hosting provider control panel. | -| hostingProviderForumLink | *Optional, but recommended.*

If provided, this URL will show up in the Publish Compatibility wizard. Providing this link can reduce your support cost by guiding users to online help in case they have problems publishing the site. | -| controlPanelLink | *Optional, but recommended.*

If provided, this URL will show up in various places in WebMatrix. It provides users with an easy way to launch the hosting provider's control panel in a browser. | - -### Extra Information - -You'll notice that there is an XML comment section at the bottom of the file that includes extra information: - -- **Control Panel credentials** - the username and password used to log into the Control Panel used to manage the site -- **Technical Contacts** - a support alias or the contact e-mail of a company representative - -This is generally *optional*, but useful to your customers since they can keep their control panel credentials and have a support e-mail address stored along with their publishing credentials in one file. - -This information is actually *required* in the instance of the Profile XML file given to the [Web Hosting Gallery](https://www.microsoft.com/web/hosting/home "Web Hosting Gallery") team with the submission of an offer for consideration. - -### How it works with WebMatrix - -To test that your profile XML works: - -1. Start WebMatrix -2. Create a new site -3. Click the Publish button in the ribbon -4. Click the "Import Profile…" button - - [![Screenshot of the Publishing Settings page. The Import Profile button is highlighted.](generate-a-profile-xml-file/_static/image5.png)](generate-a-profile-xml-file/_static/image3.png) -5. Choose a profile, import it and click "Validate Connection" to make sure that the profile was imported correctly. - -The items in the Publish Settings dialog should be filled out automatically according to the following mapping: - -#### Web Deploy Settings Mapping - -[![Screenshot of the Publish Settings page. The Protocol, Server, User name, Password, Site name, and Destination U R L boxes are shown.](generate-a-profile-xml-file/_static/image4.jpg)](generate-a-profile-xml-file/_static/image3.jpg) - -#### FTP Settings Matching - -[![Screenshot of the Publish Settings page. The Protocol, Server, Site path, User name, password, and Destination boxes are filled.](generate-a-profile-xml-file/_static/image6.jpg)](generate-a-profile-xml-file/_static/image5.jpg) - -## Next Steps - -Once you are able to generate Profile XML files easily, you should [include them in the welcome e-mails](create-welcome-e-mails.md) that you send to users who create new accounts on your service. diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.jpg deleted file mode 100644 index 4ad374dd7..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.jpg deleted file mode 100644 index 92ec0cfba..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image2.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.jpg deleted file mode 100644 index 4ad374dd7..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.jpg deleted file mode 100644 index 4ad374dd7..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image4.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.jpg deleted file mode 100644 index 92ec0cfba..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image5.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.jpg deleted file mode 100644 index 92ec0cfba..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.png b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.png deleted file mode 100644 index 5bc553491..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/_static/image6.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample1.xml b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample1.xml deleted file mode 100644 index 4b85a3ad6..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample1.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample2.xml b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample2.xml deleted file mode 100644 index cb3309615..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample2.xml +++ /dev/null @@ -1,14 +0,0 @@ - - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample3.xml b/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample3.xml deleted file mode 100644 index 1c314e476..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/generate-a-profile-xml-file/samples/sample3.xml +++ /dev/null @@ -1,4 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works.md b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works.md deleted file mode 100644 index 12bfa3014..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: "How WebMatrix Verification Works" -author: simtan -description: "After you install the required server components and have validated your server configuration, you supply a sample account to the Microsoft Web Hosting Gall..." -ms.date: 12/12/2010 -ms.assetid: 4ed60479-9fb5-4abe-8f3f-649d8a8cdf06 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works -msc.type: authoredcontent ---- -# How WebMatrix Verification Works - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -After you [install the required server components](install-server-components.md "Install Server Components") and have [validated your server configuration](validate-your-server-configuration.md "Validate your server configuration"), you supply a sample account to the Microsoft Web Hosting Gallery team in the form of a [Profile XML file](generate-a-profile-xml-file.md "Generate a Profile XML file") and a WebMatrix verification test suite is run from our side. The test is composed of publishing a series of web applications to the provided test account and ensuring that they run on your servers. - -This document describes the testing process, so that you may also try it for yourself to catch problems early. This process is also known as "client-side validation". - -## Applications Tested - -The following web applications (mostly from the [Web Application Gallery](https://www.microsoft.com/web/gallery/ "Web Application Gallery")) are published to your servers in sequence: - -- Bakery (from a WebMatrix site template) -- [DotNetNuke](https://www.microsoft.com/web/webmatrix/) [using SQL database] -- [WordPress](https://www.microsoft.com/web/webmatrix/)\* -- [nopCommerce](https://www.microsoft.com/web/webmatrix/) -- [Moodle](https://www.microsoft.com/web/webmatrix/)\* -- [Umbraco](https://www.microsoft.com/web/webmatrix/) (requires Full Trust, not recommended for Shared Hosting) -- [mojoPortal](https://www.microsoft.com/web/webmatrix/) -- [Gallery](https://www.microsoft.com/web/webmatrix/)\* [using MySQL database] -- [Joomla!](https://www.microsoft.com/web/webmatrix/)\* -- [Drupal](https://www.microsoft.com/web/webmatrix/)\* -- [BlogEngine.NET](https://www.microsoft.com/web/webmatrix/) -- [ResourceBlender](https://www.microsoft.com/web/webmatrix/) -- [KenticoCMS](https://www.microsoft.com/web/webmatrix/) -- [Atomsite](https://www.microsoft.com/web/webmatrix/) -- [DasBlog](https://www.microsoft.com/web/webmatrix/) (requires Full Trust, not recommended for Shared Hosting) -- [PHPBB](https://www.microsoft.com/web/webmatrix/)\* [using MySQL database] -- [SugarCRM](https://www.microsoft.com/web/webmatrix/)\* - -\* These applications are built on PHP/MySQL and are **not required** to pass testing in order for you to obtain the Spotlight status on the Hosting Gallery. - -## Test Process - -1. **Launch WebMatrix** and click on **My Sites**. We have all of the applications above pre-installed on our test machine, but others may need to install them anew. To do so, please refer to the [app-specific documentation](https://www.microsoft.com/web/webmatrix/ "Installing and Publishing Apps with WebMatrix"). - - [![Image of My Sites console in Web Matrix with Acquia Drupal application selected.](how-webmatrix-verification-works/_static/image2.png)](how-webmatrix-verification-works/_static/image1.png) - - Choose one of the applications to test with. -2. Open the **Publish Settings** dialog box. - - [![Screenshot of Publish Settings dialog box with Settings highlighted.](how-webmatrix-verification-works/_static/image4.png)](how-webmatrix-verification-works/_static/image3.png) -3. Choose to **Import** a publishing settings file, and select a \*.publishsettings file that defines the test account. - - [![Image of Publish Settings dialog box displaying Import Publish Settings in the Common Tasks pane highlighted.](how-webmatrix-verification-works/_static/image6.png)](how-webmatrix-verification-works/_static/image5.png) -4. When prompted to use the Web Deploy or FTP protocol, choose **Web Deploy**. - - [![Image of Select Settings dialog box with Web Deploy selected.](how-webmatrix-verification-works/_static/image8.png)](how-webmatrix-verification-works/_static/image7.png) - - **Validate** the connection. This may result in a prompt about unverified certificates, which is fine. (We accept the certificate and continue.) - - [![Screenshot of Publish Settings dialog box with Validate Connection selected and highlighted.](how-webmatrix-verification-works/_static/image10.png)](how-webmatrix-verification-works/_static/image9.png) - - If validate fails in any way, record the error and consider the publish test a failure. -5. Save and close (or Apply and Cancel) the Publish Settings dialog. Check for **Publish Compatibility** before you move on. This has the beneficial side-effect of automatically correcting the .NET App Pool version on the server. - - [![Image of Publish Settings dialog box with Check Compatibility option highlighted in Publish drop down menu.](how-webmatrix-verification-works/_static/image12.png)](how-webmatrix-verification-works/_static/image11.png) - - [![Image of Publish Compatibility note in Web Matrix asking for permission to run test for publish compatibility with Yes and No options.](how-webmatrix-verification-works/_static/image14.png)](how-webmatrix-verification-works/_static/image13.png) - - [![Screenshot of results of checking sites Compatibility with test dot april dot arvixe dot com.](how-webmatrix-verification-works/_static/image16.png)](how-webmatrix-verification-works/_static/image15.png) - - If any of the checks fail, we still **continue through to publishing**. -6. Click **Publish** from the Ribbon. On the Publish Preview screen, ensure that **all items are checked** – especially all **databases** whether they are just SDF files or full SQL databases. - - [![Image of Publish Preview screen displaying all items are checked with Databases selected and highlighted.](how-webmatrix-verification-works/_static/image18.png)](how-webmatrix-verification-works/_static/image17.png) - - Continue and wait for Publishing to complete. - - [![Image of the dialog for Publish operation in progress.](how-webmatrix-verification-works/_static/image20.png)](how-webmatrix-verification-works/_static/image19.png) - - If there are any errors during the generation of the Publish Preview or during the actual Publishing operation, record the error and consider the publish test a failure. -7. At the end of the publish operation, click the destination URL that is provided and check to see if the remote website loads in the browser. - - [![Image of dialog for Publish operation completed with the provided U R L highlighted.](how-webmatrix-verification-works/_static/image22.png)](how-webmatrix-verification-works/_static/image21.png) - - Perform operations such as logging in and playing with things in the application (e.g. creating a blog entry). If any errors are encountered, record the error and consider the publish test a failure. - - [![Screenshot of an online store page as an example for testing the application.](how-webmatrix-verification-works/_static/image24.png)](how-webmatrix-verification-works/_static/image23.png) - - If the application works fine at this point, you have passed testing for this application. -8. Once you've finished testing an application, regardless of whether the publish test passed or failed, you need to clean up the server before attempting another publish. To do this, the control panel associated with the account must be used. The control panel should provide a way to delete databases, sites, and files. Here is the process for any hosting provider using WebsitePanel: - - - ***Resetting Databases*** - - The control panel should allow you to navigate to individual SQL Server or MySQL databases to delete them. - - [![Screenshot of control panel in Hosting Spaces page with Databases selected and S Q L Server 2008 and My S Q L s highlighted.](how-webmatrix-verification-works/_static/image26.png)](how-webmatrix-verification-works/_static/image25.png) - - [![Image of S Q L Server 2008 databases page displaying Create Database button with Web deploy test highlighted in the Name box.](how-webmatrix-verification-works/_static/image28.png)](how-webmatrix-verification-works/_static/image27.png) - - [![Image of S Q L Database Properties dialog box displaying Web deploy test selected and Delete button highlighted.](how-webmatrix-verification-works/_static/image30.png)](how-webmatrix-verification-works/_static/image29.png) - - Before deleting the database, note its name. You'll need to recreate a database of the same name immediately afterwards. You'll also need to assign the same database user to it. - - [![Screenshot of S Q L Server 2008 databases with Create Database button highlighted.](how-webmatrix-verification-works/_static/image32.png)](how-webmatrix-verification-works/_static/image31.png) - - [![Screenshot of S Q L Databases Properties dialog box showing Web deploy test typed in Database name box with Web deploy test selected and highlighted.](how-webmatrix-verification-works/_static/image34.png)](how-webmatrix-verification-works/_static/image33.png) - - ***Resetting the Site*** - - You'll need to remove the website entry off of the control panel and recreate it. - - [![Screenshot of Hosting Spaces control panel displaying web icon selected and Web Sites from the list highlighted.](how-webmatrix-verification-works/_static/image36.png)](how-webmatrix-verification-works/_static/image35.png) - - [![Screenshot of Web Sites dialog box with m soft dot palm dot arvixe dot com typed and highlighted in Name field.](how-webmatrix-verification-works/_static/image38.png)](how-webmatrix-verification-works/_static/image37.png) - - [![Image of Web Sites Properties with folder path typed in the path field and Delete button highlighted.](how-webmatrix-verification-works/_static/image40.png)](how-webmatrix-verification-works/_static/image39.png) - - Note the name of the website for restoring later. - - [![Screenshot of Web Sites dialog box with Create Web Site button highlighted.](how-webmatrix-verification-works/_static/image42.png)](how-webmatrix-verification-works/_static/image41.png) - - Recreate the site on the same domain as the one that was deleted. - - [![Image of Add Web Site dialog box with m soft dot palm dot arvixe dot com selected from Domain drop down list and Create Web Site button highlighted.](how-webmatrix-verification-works/_static/image44.png)](how-webmatrix-verification-works/_static/image43.png) - - Note that you'll also have to re-enable Remote Management in order to publish again. - - [![Image of Web Site Properties page displaying Remote Management option selected and Enable button highlighted.](how-webmatrix-verification-works/_static/image46.png)](how-webmatrix-verification-works/_static/image45.png) - - Use the same password as the Web Deploy password in the account settings file. - - ***Deleting Files*** - - The control panel should have a "File Manager" you can use to delete all the files under the site root folder. - - [![Image of File Manager highlighted in control panel of Hosting Space menu.](how-webmatrix-verification-works/_static/image48.png)](how-webmatrix-verification-works/_static/image47.png) - - Usually, all the files you published end up under the site folder in "wwwroot" or something similar. Delete all files underneath that node using the file manager interface. - - [![Screenshot of File Manager interface displaying files under File Name node.](how-webmatrix-verification-works/_static/image50.png)](how-webmatrix-verification-works/_static/image49.png) - - [![Image of File Manager interface with all files under File Name node selected and the checked box for File Name node highlighted.](how-webmatrix-verification-works/_static/image52.png)](how-webmatrix-verification-works/_static/image51.png) - - Alternatively, you can use an FTP client like FileZilla to remotely connect to the FTP server (listing the same files) and delete all files that way. If you have IIS Remote Management access, you can also use IIS Manager to connect to the site and delete the content of the site. - -That's it! That is the testing process for one application; we repeat this process for each of the applications above. - -## Known Issues - -- **Default document handling** - Because Web Deploy cannot assign/create entries for Default Documents, the user (and the person testing these applications) may have to go into the control panel to add these entries manually. For example, Wordpress may seem to fail but may only need "index.php" to be added to the list of Default Documents via a control panel before operating fine. -- **Application-specific bugs** - Some applications may require a trailing slash on your Destination URL to work, and some require it **not** to be there. Some applications require Full Trust on the server, while we recommend your accounts run in only Medium trust. These application bugs are not your concern; we continually work with applicaton owners to resolve these issues, with updates published regularly on the [Web Application Gallery](https://www.microsoft.com/web/gallery/ "Web Application Gallery"). diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image1.png deleted file mode 100644 index 1212b552c..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image10.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image10.png deleted file mode 100644 index 97adf0074..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image10.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image11.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image11.png deleted file mode 100644 index 8b4082094..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image11.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image12.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image12.png deleted file mode 100644 index 8b4082094..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image12.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image13.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image13.png deleted file mode 100644 index 10b364b78..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image13.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image14.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image14.png deleted file mode 100644 index 10b364b78..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image14.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image15.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image15.png deleted file mode 100644 index c1d0913ee..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image15.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image16.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image16.png deleted file mode 100644 index c1d0913ee..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image16.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image17.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image17.png deleted file mode 100644 index 9bf4a6c0b..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image17.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image18.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image18.png deleted file mode 100644 index 9bf4a6c0b..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image18.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image19.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image19.png deleted file mode 100644 index fbef1ec2d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image19.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image2.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image2.png deleted file mode 100644 index 1212b552c..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image2.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image20.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image20.png deleted file mode 100644 index fbef1ec2d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image20.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image21.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image21.png deleted file mode 100644 index 81a22662d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image21.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image22.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image22.png deleted file mode 100644 index 81a22662d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image22.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image23.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image23.png deleted file mode 100644 index bd9960f8e..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image23.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image24.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image24.png deleted file mode 100644 index bd9960f8e..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image24.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image25.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image25.png deleted file mode 100644 index d8eed040f..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image25.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image26.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image26.png deleted file mode 100644 index d8eed040f..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image26.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image27.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image27.png deleted file mode 100644 index 2c835966b..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image27.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image28.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image28.png deleted file mode 100644 index 2c835966b..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image28.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image29.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image29.png deleted file mode 100644 index d144e7f8d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image29.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image3.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image3.png deleted file mode 100644 index 82e3852c7..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image30.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image30.png deleted file mode 100644 index d144e7f8d..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image30.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image31.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image31.png deleted file mode 100644 index 1903066a2..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image31.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image32.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image32.png deleted file mode 100644 index 1903066a2..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image32.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image33.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image33.png deleted file mode 100644 index 250651fd8..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image33.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image34.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image34.png deleted file mode 100644 index 250651fd8..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image34.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image35.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image35.png deleted file mode 100644 index 44fb03788..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image35.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image36.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image36.png deleted file mode 100644 index 44fb03788..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image36.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image37.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image37.png deleted file mode 100644 index 63c147d53..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image37.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image38.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image38.png deleted file mode 100644 index 63c147d53..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image38.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image39.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image39.png deleted file mode 100644 index 3405d6792..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image39.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image4.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image4.png deleted file mode 100644 index 82e3852c7..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image4.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image40.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image40.png deleted file mode 100644 index 3405d6792..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image40.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image41.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image41.png deleted file mode 100644 index 5aa8a4467..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image41.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image42.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image42.png deleted file mode 100644 index 5aa8a4467..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image42.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image43.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image43.png deleted file mode 100644 index ca5c315f6..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image43.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image44.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image44.png deleted file mode 100644 index ca5c315f6..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image44.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image45.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image45.png deleted file mode 100644 index 44a4d0782..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image45.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image46.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image46.png deleted file mode 100644 index 44a4d0782..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image46.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image47.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image47.png deleted file mode 100644 index 9df4dad03..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image47.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image48.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image48.png deleted file mode 100644 index 9df4dad03..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image48.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image49.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image49.png deleted file mode 100644 index 670e70f04..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image49.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image5.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image5.png deleted file mode 100644 index 98ec92149..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image5.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image50.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image50.png deleted file mode 100644 index 670e70f04..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image50.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image51.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image51.png deleted file mode 100644 index a1e525941..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image51.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image52.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image52.png deleted file mode 100644 index a1e525941..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image52.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image6.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image6.png deleted file mode 100644 index 98ec92149..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image6.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image7.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image7.png deleted file mode 100644 index 87e68b5c5..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image7.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image8.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image8.png deleted file mode 100644 index 87e68b5c5..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image8.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image9.png b/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image9.png deleted file mode 100644 index 97adf0074..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/how-webmatrix-verification-works/_static/image9.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components.md b/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components.md deleted file mode 100644 index 1d4f7694e..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components.md +++ /dev/null @@ -1,145 +0,0 @@ ---- -title: "Install Server Components" -author: simtan -description: "Introduction This article will walk you through installing the required server components to be WebMatrix compatible and fulfill the Spotlight requirements f..." -ms.date: 11/03/2010 -ms.assetid: cf0a1d31-1926-4e35-8b34-544c414905f8 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/install-server-components -msc.type: authoredcontent ---- -# Install Server Components - -by [Simon Tan](https://github.com/simtan) - -## Introduction - -This article will walk you through installing the required server components to be **WebMatrix compatible** and fulfill the **Spotlight requirements** for the Web Hosting Gallery. - -## Prerequisites - -We recommend having two separate machines both running Windows Server 2008 R2: - -- One acting as the web server -- One acting as the database server - -While it is possible to run both the web server and database server on the same machine, it is not recommended for performance and security reasons. - -You will need both machines connected to the Internet to download required server components. - -To simplify the installation of the **web server** components, we highly recommend installing **Web Platform Installer**, also known as **WebPI**, on both machines. WebPI is a tool that automates the installation of a vast majority of server components and other products for Microsoft's Web Platform. - - -If you prefer to not use WebPI, all of the required components can also be installed by hand or via your own provisioning scripts. - -## Web Server Components - -### Option 1 : Via Web Platform Installer 3.0 (recommended) - -If you have **WebPI 3.0** installed, the following link will **automatically launch it** with all of the basic **web server** components you'll need ready to install: - -> [Install Spotlight Components using Web PI](https://www.microsoft.com/web/gallery/install.aspx?appid=WHP_Recommended "Install Components using Web PI") (you will be able to review the list of products before installation begins) - -(This list of components completely fulfills the **Spotlight requirements** from the Web Hosting Gallery.) - -Note that many of the web applications that can be published by WebMatrix have **PHP/MySQL** components as requirements. To ensure you are able to support those applications, you can use this alternative link to install **everything above plus PHP/MySQL** related components: - -> [Install Spotlight Components plus PHP/MySQL related components using Web PI](https://www.microsoft.com/web/gallery/install.aspx?appid=IIS7;Tracing;NETFramework35;NETFramework4;ASPNET;MVC;WDeploy;FTPServer;ManagementService;CGI;URLRewrite2;SMO;PHP52;WinCache52;MySQLConnector;SQLDriverPHP52IIS "Install Components including PHP/MySQL components using WebPI") - -After WebPI launches from the links above, you'll just need to click the "Install" button to review the list of components and proceed with installation. - -> [!NOTE] -> Even when using the links above, you'll still have to install the [Extensionless URL Hotfix](https://support.microsoft.com/kb/980368) separately, discussed below. - -### Option 2 : Manually install Web Server components - -Here is the full list of which components are installed by those links, so you can confirm against the list of products listed in WebPI. Note that many of them bring in dependencies – that is expected behavior – but the total download should not exceed 50 MB or so. - -#### Server - -- [Required] [IIS 7 Web Server](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=IIS7;Tracing "IIS 7 basic components") basic components - - - Required for basic web server functionality - -#### Frameworks - -- [Required] [.NET Framework 3.5 SP1](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=NETFramework35) - - - [Some applications](https://www.microsoft.com/web/gallery/) depend on this framework -- [Required] [.NET Framework 4.0](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=NETFramework40) - - - [Some applications](https://www.microsoft.com/web/gallery/) depend on this framework -- [Optional] [PHP](http://windows.php.net/download/ "PHP for Windows") (5.3.2 or higher) - - - This is not required for Spotlight, but many applications that can be published by WebMatrix depend on this framework - -#### ASP.NET - -- [Required] [ASP.NET](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=ASPNET) - - - This framework is the backend of many of the most popular web applications -- [Required] [ASP.NET MVC](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=MVC) 1.0 - - - A handful of applications in the App Gallery depend on this installed centrally -- [Optional] - - Note that you can also optionally install [ASP.NET MVC3](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=MVC3) and [ASP.NET Web Pages](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=Plan9), which gives you the ability to host applications written in the new "Razor" syntax of ASP.NET. However, note that the binaries required for these kinds of applications are **automatically published** by WebMatrix. That is, each end user who publishes applications of this type will automatically end up with the required binaries in a */bin/* folder within their site root directory, so it is not really necessary to install them centrally. - - In fact, we actually recommend that you do **not** install anything except **MVC 1**. - - Also, note that this ASP.NET Web Pages is not a final release of the product. If you choose to install ASP.NET Web Pages, you will need to re-install it when future versions are released. - -#### IIS Modules - -- [Required] [Microsoft Web Deploy](https://www.iis.net/downloads/microsoft/web-deploy "Web Deploy") 2.0 - - - Web Deploy is a client-server tool that simplifies the deployment of sites and applications to IIS servers. While WebMatrix supports web application publishing using both FTP and Web Deploy protocols, the latter providers a faster, more secure, and richer experience. It also lets the user deploy whole apps, including databases, ensuring they work both locally and remotely. It is the highlight of the WebMatrix publishing story. -- [Required] [FTP Publishing Service](https://www.iis.net/downloads/microsoft/ftp "FTP Publishing Service") - - - To ensure the option of FTP exists for maximum compatibility - -- [Required] [IIS Remote Management](https://www.iis.net/downloads/microsoft/iis-manager "IIS Manager for Remote Administration") Service - - - To allow your users to manage aspects of their accounts using the IIS console - - Also a dependency for Web Deploy to function properly -- [Required] [FastCGI for IIS](https://www.iis.net/downloads/microsoft/fastcgi-for-iis "FastCGI for IIS") - - - Provides a much faster CGI implementation than the default -- [Required] [URL Rewrite 2.0](https://www.iis.net/downloads/microsoft/url-rewrite "URL Rewrite") - - - A dependency for many applications to function correctly -- [Required] [SQL Server 2008 Management Objects](https://www.microsoft.com/downloads/en/details.aspx?FamilyID=ceb4346f-657f-4d28-83f5-aae0c5c83d52 "SQL Server 2008 R2 feature pack") - - - A dependency for many applications to function correctly -- [Optional] [Windows Cache Extension 1.1 for PHP](https://www.iis.net/downloads/microsoft/wincache-extension "Windows Cache Extension for PHP") - - - Highly recommended when running PHP on Windows -- [Optional] [MySQL Connector/Net](http://dev.mysql.com/downloads/connector/net/ "MySQL Connector/NET") 6.2.3 or higher - - - Necessary for .NET applications using MySQL databases -- [Optional] [Microsoft Drivers for PHP for SQL Server](https://www.microsoft.com/downloads/details.aspx?FamilyID=80e44913-24b4-4113-8807-caae6cf2ca05 "Microsoft Drivers for PHP for SQL") 2.0 in IIS - - - Necessary for PHP applications using SQL Server - -### Install Web Server Patches - -- [Extensionless URL Hotfix](https://support.microsoft.com/topic/a-update-is-available-that-enables-certain-iis-7-0-or-iis-7-5-handlers-to-handle-requests-whose-urls-do-not-end-with-a-period-525f06bd-125b-9fb7-0564-327172f1912f) - - - Required for ASP.NET Web Pages to function correctly. It is discussed further in [this blog post](https://blogs.msdn.com/b/tmarq/archive/2010/04/01/asp-net-4-0-enables-routing-of-extensionless-urls-without-impacting-static-requests.aspx). - -## Database Server Components - -### SQL Server - -- [Required] Microsoft SQL Server 2008 - - WebPI supports installing [Microsoft SQL Server 2008 Express edition](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=SqlExpress), but we do not recommend this product in shared hosting environments. (You should use the full version instead.) -- [Optional] [PHP Driver for SQL Server](https://www.microsoft.com/web/gallery/install.aspx?appsxml=&appid=SQLDriverPHP) - We highly recommended installing this component on your **database server** if you are supporting PHP. - -### MySQL - -For more information on configuring a MySQL installation for WebMatrix support, please see [this article](setup-mysql-with-webmatrix-support.md "Set up MySQL with WebMatrix support"). - -## Next Steps - -You should ensure that the Web Deploy 2.0 component is [configured to allow delegated deployments](configure-site-for-web-deploy-publishing.md "Configure Web Deploy for delegated deployments"). This is critical, as it is the primary method that allows your customers to publish to your servers with WebMatrix. diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components/_static/image1.png deleted file mode 100644 index 46001b2c8..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/install-server-components/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot.md b/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot.md deleted file mode 100644 index b7af560be..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot.md +++ /dev/null @@ -1,212 +0,0 @@ ---- -title: "Microsoft Web Platform Hosting Program -Pilot" -author: walterov -description: "As part of the Microsoft Web Platform Hosting Program, Microsoft created the Shared Hosting Guidance Content Map ; it references a set of guides, step-by-ste..." -ms.date: 02/18/2009 -ms.assetid: b9579222-51b6-4479-938c-732de2f491f9 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot -msc.type: authoredcontent ---- -# Microsoft Web Platform Hosting Program -Pilot - -by [Walter Oliver](https://github.com/walterov) - -As part of the Microsoft Web Platform Hosting Program, Microsoft created the [Shared Hosting Guidance Content Map](../getting-started/shared-hosting-content-map.md); it references a set of guides, step-by-step instructions, best practices, and script samples to guide in the planning, deployment, configuration, migration, and provisioning of Microsoft Web Platform technologies for Hosters. It provides a map to the latest content across the entire set of Microsoft documentation libraries and associated sample scripts relevant to hosting professionals. It is technical guidance documentation intended to lower operational costs while increasing average revenue per user. The entire content is available for download (download I) and (download II). - -This document provides an offline snapshot of the [Shared Hosting Guidance Content Map](../getting-started/shared-hosting-content-map.md) web page as well as references to the following offline content: - -1. Shared Hosting Guidance: is an overview and the best starting point in the document collection. The live and most up to date version of this material can be found in the [Shared Hosting Guidance Content Map](../getting-started/shared-hosting-content-map.md) web page. -2. [Developing with Shared Hosting](../using-shared-hosting-environments/creating-and-publishing-web-applications-with-visual-web-developer.md): is a video that demonstrates how developers and web hosting customers can use, create, and edit web sites hosted on the Microsoft Web Platform. Developers will be able to learn about the development and publishing environment, and Hosters will learn about the experience that their customers go through when interacting with their services. You will find: - - -Steps a developer should follow to host their applications in a Shared Hosting Environment. - -Typical activities performed when interacting with a shared hosting provider. - -Publishing Content using FTP from Internet Explorer and Windows Explorer. - -Using Visual Web Developer (VWD) to connect to a hoster FTP site and deploy the application. - -Installing and configuring IIS Manager for Remote Administration of the web site. - -Installing IIS Manager new Modules. - -Using IIS Manager Remote Administration. - -Modifying and publishing an update for the application. - -Deploying the application database (ASP.NET Membership database). -3. [Setting up Delegated Administration Server and Client Experience](../using-shared-hosting-environments/setting-up-delegated-administration-server-and-client-experiences.md): is a video that demonstrates the Hoster and User experiences of setting up Delegated Administration. Hosters will learn how to setup Delegated Administration and what their users will need to set it up in their client computers. You will find: - - -Introduction to Delegated Administration (also known as Remote Administration), it explains why it is useful in hosting scenarios. - -Configuring Delegated Administration at the server through the Management Service UI module - -Creating an IIS Manager User and assigning permissions to it. Explaining the difference between an IIS User and a Windows user account. - -Uses an Windows XP client machine to remotely administer the site through delegated administration. - -Installing IIS in XP. - -Connect to the server/site from the client. - Installs extensions, explaining the server and client experience. -4. [Using Delegated Administration](../using-shared-hosting-environments/using-delegated-administration.md) is a video that provides a specific example of delegating a particular feature and how the user can take advantage of it. Hosters will learn how a currently blocked feature can be unblocked and their users can learn how to take advantage of the newly unblocked feature. You will find: - - -A detailed explanation of using an actual configuration feature for administration of the site, error pages. - -Shows the client experience when the feature is locked for a site. - -The server experience when unlocking a feature for a site. - -Shows the client experience of configuring the newly unlocked feature, error page setting for the site. -5. Within the content donwload (download I) and (download II) you will find critical technology areas like **IIS**, **SQL Server 2008**, **Hyper-V**, and **System Center** sections subdivided into 4 major subsections: - - -*Learn*: An in-depth technical drill down on the particular technology. - -*Engage*: Explains the value of the technology. - -*Deploy*: Instructions and pointers from where to download relevant bits. - -*Market*: Collateral that Hosters and their Sales force can use to take an offering to market. -6. Content To Share with End Users: - -- [Developing with Shared Hosting](../using-shared-hosting-environments/creating-and-publishing-web-applications-with-visual-web-developer.md) video. -- [Setting up Delegated Administration Server and Client Experience](../using-shared-hosting-environments/setting-up-delegated-administration-server-and-client-experiences.md) video. -- [Using Delegated Administration](../using-shared-hosting-environments/using-delegated-administration.md) video. -- [Administering your Site Remotely](../verifying-the-deployment/verifying-remote-administration.md). -- [Deploying a ASP.NET](../verifying-the-deployment/verifying-the-developer-experience-aspnet.md). -- [Deploying a PHP Application](../verifying-the-deployment/verifying-remote-administration.md). - -## Step by Step Hosting Instructions - -### Content Map - -- [Planning the Web Hosting Architecture](#plan) -- [Deploying the Windows Web Platform in Shared Hosting Environments](#deploying) -- [Verifying the Deployment](#Verify) -- [Installing Infrastructure Components](#infra) -- [Configuring IIS](#configiis) -- [Migrating](#migrate) -- [Provisioning and Managing](#provision) -- [PowerShell Scripts and C# Code Samples](#scripts) -- [Using Shared Hosting Environments](#using)] - - - -### [Planning the Web Hosting Architecture](../planning-the-web-hosting-architecture/index.md) - -- [Shared Hosting Configuration](../planning-the-web-hosting-architecture/shared-hosting-configuration.md) -- [IIS Extensibility](../planning-the-web-hosting-architecture/iis-extensibility.md) -- [MIX08: Bringing Hosters and Developers Together with IIS](../using-shared-hosting-environments/mix08-bringing-hosters-and-developers-together-with-iis7.md) - - - -### [Deploying the Windows Web Platform in Shared Hosting Environments](../configuring-servers-in-the-windows-web-platform/index.md) - -- [Quick Guide for Shared Hosting Deployment](../configuring-servers-in-the-windows-web-platform/quick-guide-for-shared-hosting-deployment.md) -- [Web Server for Shared Hosting](../web-server-for-shared-hosting/index.md) - - -[IIS Components for Shared Hosting](../web-server-for-shared-hosting/iis-components-for-shared-hosting.md) - -[Installing the Web Server Role](../web-server-for-shared-hosting/installing-the-web-server-role.md) - -[Configuring IIS for Shared Hosting](../web-server-for-shared-hosting/index.md) - - - [32-bit Mode Worker Processes](../web-server-for-shared-hosting/32-bit-mode-worker-processes.md) - - [Application Pool Identity as Anonymous User](../web-server-for-shared-hosting/application-pool-identity-as-anonymous-user.md) - - [Default Documents](../web-server-for-shared-hosting/default-documents.md) - - [HTTP Response Cache](../web-server-for-shared-hosting/http-response-cache.md) - - [dynamicIdleThreshold](../web-server-for-shared-hosting/dynamicidlethreshold.md) - - [Dynamic Compression](../web-server-for-shared-hosting/dynamic-compression.md) - - [Delegated Administration](../web-server-for-shared-hosting/delegated-administration.md) - - [Delegating errorMode in httpErrors](../web-server-for-shared-hosting/delegating-errormode-in-httperrors.md) - -[ASP.NET](../web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration.md) - -[URL Rewrite for Hosters](../web-server-for-shared-hosting/url-rewrite-for-hosting-providers.md) - -[Database Manager for Hosters](../web-server-for-shared-hosting/database-manager-for-hosters.md) - -[Administration Pack](../web-server-for-shared-hosting/administration-pack.md) - -[FastCGI with PHP](../web-server-for-shared-hosting/fastcgi-with-php.md) - -[ASP](../web-server-for-shared-hosting/asp.md) - -[Configuring IIS for Silverlight Applications](../web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md) - -[SMB Commands Registry Keys](../web-server-for-shared-hosting/smb-commands-registry-keys_198.md) - -[Backup](../web-server-for-shared-hosting/create-a-backup-with-appcmd.md) -- [File Server For Content Storage](../configuring-servers-in-the-windows-web-platform/index.md) - - -[Separate Partitions for Improved Performance](../configuring-servers-in-the-windows-web-platform/preparing-the-file-serve-deployment.md) - -[Share and NTFS Permissions](../configuring-servers-in-the-windows-web-platform/configuring-share-and-ntfs-permissions.md) - -[Directory Quotas and FSRM](../configuring-servers-in-the-windows-web-platform/enabling-directory-quotas.md) - -[SMB Command Registry Keys](../configuring-servers-in-the-windows-web-platform/smb-commands-registry-keys_196.md) -- [Web Farm Support](../configuring-servers-in-the-windows-web-platform/index.md) - - -[Application Request Routing for Shared Hosting](../configuring-servers-in-the-windows-web-platform/application-request-routing-arr-20-for-shared-hosting.md) - -[Shared Configuration](../configuring-servers-in-the-windows-web-platform/shared-configuration_211.md) - -[Offline Files for Shared Configuration](../configuring-servers-in-the-windows-web-platform/offline-files-for-shared-configuration.md) - -[Network Load Balancing](../configuring-servers-in-the-windows-web-platform/network-load-balancing.md) -- [Database Servers](../configuring-servers-in-the-windows-web-platform/index.md) - - -[SQL 2008 for Hosters](../configuring-servers-in-the-windows-web-platform/sql-2008-for-hosters.md) - -[SQL Server 2005](../configuring-servers-in-the-windows-web-platform/sql-server-2005.md) - -[MySQL Server](../../application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md) -- [Guide to Deploy FTP and Publish with VWD](../configuring-servers-in-the-windows-web-platform/guide-to-deploy-ftp-and-publish-with-vwd.md) -- [Publishing Components: FTP 7.0, WebDAV, and FPSE](../configuring-servers-in-the-windows-web-platform/publishing-components-ftp-70-webdav-and-fpse.md) - - - -### [Verifying the Deployment](../verifying-the-deployment/index.md) - -- [Verifying Remote Administration](../verifying-the-deployment/verifying-remote-administration.md) -- [Verifying the Developer Experience – ASP.NET](../verifying-the-deployment/verifying-the-developer-experience-aspnet.md) -- [Verifying the Developer Experience - PHP](../verifying-the-deployment/verifying-the-developer-experience-php.md) - - - -### [Installing Infrastructure Components](../installing-infrastructure-components/index.md) - -- [Hyper-V Guides](../installing-infrastructure-components/hyper-v-guides.md) -- [System Center Solutions (VMM & SCOM)](../installing-infrastructure-components/system-center-solutions-vmm-amp-scom.md) -- [DNS Server](../installing-infrastructure-components/dns-server.md) -- [Active Directory DS Forest](../installing-infrastructure-components/active-directory-ds-forest.md) -- [Introduction to Deploying Windows Server 2008](../installing-infrastructure-components/introduction-to-deploying-windows-server-2008-r2.md) - - - -### [Configuring IIS](../configuring-components/index.md) - -- [The Configuration System in IIS](../../get-started/planning-your-iis-architecture/the-configuration-system-in-iis-7.md) -- [C# and PowerShell Scripts Samples](../configuring-components/powershell-scripts.md) -- [Configuring Server Components](../configuring-components/configuring-server-components.md) -- [Using WSRM to manage IIS AppPool CPU Utilization](../../manage/managing-performance-settings/using-wsrm-to-manage-iis-7-apppool-cpu-utilization.md) -- [Enabling LINQ with ASP.NET](../configuring-components/deploying-linq-with-net-35.md) - - - -### [Migrating](../migrate-to-the-microsoft-web-platform/index.md) - -- [Integrated vs Classic Mode](microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode1.zip) -- [Breaking Changes for ASP.NET 2.0 Apps Running on IIS Integrated Mode](../migrate-to-the-microsoft-web-platform/breaking-changes-for-aspnet-4-apps-running-on-iis-7-integrated-mode.md) - - - -### [Provisioning and Managing](../../manage/provisioning-and-managing-iis/index.md) - -- [IIS Management and Administration](../../manage/provisioning-and-managing-iis/iis-management-and-administration.md) -- [Provisioning IIS](../../manage/provisioning-and-managing-iis/index.md) - - -[Provisioning IIS Sites](../../manage/creating-websites/provisioning-iis-7-sites.md) - -[Provisioning Options in IIS](../../manage/provisioning-and-managing-iis/provisioning-options-in-iis-7.md) - -[Using Managed APIs in IIS](../../manage/provisioning-and-managing-iis/using-managed-apis-in-iis-7.md) - -[Shared Configuration and Remote Provisioning](../../manage/provisioning-and-managing-iis/shared-configuration-and-remote-provisioning.md) - -[Provisioning IIS Sites for Shared Hosting](../../manage/creating-websites/provisioning-iis-7-sites-for-shared-hosting.md) -- [Provisioning and Managing Samples](../../manage/provisioning-and-managing-iis/index.md) - - -[Provisioning Sample in C#](../../manage/provisioning-and-managing-iis/provisioning-sample-in-c.md) - -[Hosting Services Code Sample](../../manage/provisioning-and-managing-iis/index.md) - - - [Services Overview](../../manage/provisioning-and-managing-iis/services-overview.md) - - [Services Implementation](../../manage/provisioning-and-managing-iis/setting-up-components.md) - - [Consuming the Services](../../manage/provisioning-and-managing-iis/consuming-the-services.md) - -[Code Samples and Scripts](../../manage/provisioning-and-managing-iis/index.md) - - - [Microsoft.Web.Administration](../../manage/provisioning-and-managing-iis/microsoftwebadministration.md) - - [IIS WMI Provider](../../manage/provisioning-and-managing-iis/iis-7-wmi-provider.md) - - [AppCmd.exe](../../manage/provisioning-and-managing-iis/appcmdexe.md) - - [Other Managed Code Samples](../../manage/provisioning-and-managing-iis/other-managed-code-samples.md) -- [Provisioning FTP 7.0 Sites](../../manage/creating-websites/provisioning-ftp-75-sites.md) - - - -### PowerShell Scripts and C# Code Samples - -- [IIS 7.0 Configuration Reference with Code Samples](https://www.iis.net/configreference) -- [Managing IIS with the IIS PowerShell Snap-in](../../manage/powershell/index.md) -- [C# and PowerShell Scripts Samples](../configuring-components/powershell-scripts.md) -- [Provisioning Sample in C#](../../manage/provisioning-and-managing-iis/provisioning-sample-in-c.md) -- [Code Samples and Scripts](../../manage/provisioning-and-managing-iis/index.md) - - - -### [Using Shared Hosting Environments](../using-shared-hosting-environments/index.md) - -- [Creating, Updating, and Publishing Web applications with Visual Web Developer](../using-shared-hosting-environments/creating-and-publishing-web-applications-with-visual-web-developer.md) -- [Administering your Site Remotely](../verifying-the-deployment/verifying-remote-administration.md) -- [Deploying a ASP.NET](../verifying-the-deployment/verifying-the-developer-experience-aspnet.md) -- [Deploying a PHP Application](../verifying-the-deployment/verifying-remote-administration.md) - -Please send your questions and feedback to [iisnet@microsoft.com](mailto:iisnet@microsoft.com). diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode1.zip b/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode1.zip deleted file mode 100644 index a9a7300d3..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode1.zip and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode2.zip b/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode2.zip deleted file mode 100644 index a9a7300d3..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/microsoft-web-platform-hosting-program-pilot/_static/microsoft-web-platform-hosting-program---pilot-238-iis7integratedpipelinemodevsclassicmode2.zip and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/overview.md b/iis/web-hosting/joining-the-web-hosting-gallery/overview.md deleted file mode 100644 index 75b13f09b..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/overview.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: "Overview" -author: simtan -description: "This set of documentation describes how hosting providers can prepare to join the Microsoft Web Hosting Gallery —a comprehensive marketplace of hosting provi..." -ms.date: 11/04/2010 -ms.assetid: 95fe9975-d6f3-4cfd-8a40-39ff01b19553 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/overview -msc.type: authoredcontent ---- -# Overview - -by [Simon Tan](https://github.com/simtan) - -## Overview - -This set of documentation describes how hosting providers can prepare to join the Microsoft Web Hosting Gallery — a comprehensive marketplace of hosting providers—while standing out as 100% [**WebMatrix**](https://www.microsoft.com/web/webmatrix/ "Microsoft WebMatrix")**compatible** for maximum visibility. This is also known as having **Spotlight status**. - -Being WebMatrix compatible means that you can make a guarantee to your end users: that they can publish applications from [WebMatrix](https://www.microsoft.com/web/webmatrix/ "Microsoft WebMatrix") and the [Web Application Gallery](https://www.microsoft.com/web/gallery/ "Microsoft Web Application Gallery") to your servers with confidence. - -**What is covered:** This documentation outlines how to extend an existing Windows/IIS7 shared hosting environment so users can publish to it using the WebMatrix web development tool. - -**What is not covered:** This document does not describe how to create a Windows hosting environment "from scratch". - -It assumes that you have a hosting environment that runs on IIS7, offers ASP.NET hosting, and that you have experience with managing such environments. Please see [this article](../planning-the-web-hosting-architecture/shared-hosting-configuration.md "Basics of setting up shared hosting") to learn more about the basics of setting up a Windows shared hosting environment if you do not have one already. - -This documentation will walk you through the following setup steps: - -1. [Installing the required server components](install-server-components.md "Install server components") -2. [Configuring the server to allow remote publishing of websites by end-users](configure-site-for-web-deploy-publishing.md "Configuring Web Deploy settings") -3. [Validating your server configuration using a small tool](validate-your-server-configuration.md "Validating your server configuration using ServerValidator") -4. [Crafting a publishing Profile XML file containing server credentials for your end users](generate-a-profile-xml-file.md "Creating a publishing Profile XML file") -5. [Composing new account welcome e-mails that make it easy for your customers to get started with WebMatrix](create-welcome-e-mails.md "Creating welcome e-mails for new accounts") - -After completing the above steps, you will then need to formally submit an application to the Web Hosting Gallery. To be considered for Spotlight status, this application will need to include a sample test account (in the form of a Profile XML file) that represents a typical account from your WebMatrix compatible offer. - -## How your customers will publish to you - -[![Diagram that shows Web Platform Installer, Visual Studio, and the Web Matrix being deployed to the Web Management Service, then to the Hosting Server.](overview/_static/image2.jpg)](overview/_static/image1.jpg) - -1. Customer finds your offer in the Web Hosting Gallery, and signs up for an account -2. You provision required resources (including a SQL Server and/or MySQL database) for the customer - - - IIS site provisions: - - - Creates a IIS Management username and password - - Applies deployment and management permission to the IIS Site - - SQL Database provisions: - - - Creates SQL account and password - - Applies permissions to the database for the SQL account -3. You send the customer their server credentials in the form of a [Profile XML](generate-a-profile-xml-file.md "Generating a Profile XML file") -4. Customer uses WebMatrix or other tools to deploy their web applications to your servers. - -## Next Steps - -First, you need to make sure you have the [necessary server components](install-server-components.md "Install required server components") to fully support WebMatrix and fulfill the Spotlight requirements of the Web Hosting Gallery. diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image1.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image1.jpg deleted file mode 100644 index 5007bee27..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image1.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image2.jpg b/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image2.jpg deleted file mode 100644 index 5007bee27..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/overview/_static/image2.jpg and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/servervalidator-demo.md b/iis/web-hosting/joining-the-web-hosting-gallery/servervalidator-demo.md deleted file mode 100644 index e72657901..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/servervalidator-demo.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: "ServerValidator Demo" -author: bilalaslam -description: "ServerValidator Demo" -ms.date: 12/13/2010 -ms.assetid: c7e16c40-8078-45a1-9b46-e376ef68eb20 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/servervalidator-demo -msc.type: video ---- -# ServerValidator Demo - -by [Bilal Aslam](https://github.com/bilalaslam) - diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support.md b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support.md deleted file mode 100644 index a2b8da181..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "Setup MySQL with WebMatrix Support" -author: bilalaslam -description: "MySQL Installation WebPI supports installing MySQL in developer mode, but this is not suitable for a shared hosting environment. Instead, you should download..." -ms.date: 11/03/2010 -ms.assetid: 29f4c760-525f-4c61-9e06-ab37014a7dc8 -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support -msc.type: authoredcontent ---- -# Setup MySQL with WebMatrix Support - -by [Bilal Aslam](https://github.com/bilalaslam) - -## MySQL Installation - -WebPI supports installing MySQL in developer mode, but this is not suitable for a shared hosting environment. - -Instead, you should download the latest stable version of MySQL from the [official website](http://www.mysql.com/ "MySQL website") and install it on a **dedicated database server** with these settings: - -[![Image of My S Q L Server Instance Configuration Wizard displaying Dedicated My S Q L Server Machine option selected.](setup-mysql-with-webmatrix-support/_static/image3.png)](setup-mysql-with-webmatrix-support/_static/image2.png)[![Image of My S Q L Server Instance Configuration Wizard displaying INNO D B Table Space Settings and Drive Info box.](setup-mysql-with-webmatrix-support/_static/image5.png)](setup-mysql-with-webmatrix-support/_static/image4.png) - -For concurrent connections, choose OLTP since that reflects the workload of a typical shared hosting database server: - -[![Screenshot of My S Q L Server Instance Configuration Wizard with online Transaction Processing O L T P selected.](setup-mysql-with-webmatrix-support/_static/image7.png)](setup-mysql-with-webmatrix-support/_static/image6.png) - -Enable TCP/IP networking, add the firewall exception and disable the strict mode: - -[![Screenshot of My S Q L Server Instance Configuration Wizard with T C P slash forward I P Networking enabled and Enable Strict Mode option disabled.](setup-mysql-with-webmatrix-support/_static/image9.png)](setup-mysql-with-webmatrix-support/_static/image8.png) - -Enable UTF-8 character set – ***this is very important***, because several applications in the Web Application Gallery require UTF-8 support in the database: - -[![Image of My S Q L Server Instance Configuration Wizard with Best Support for Multiligualism enabled and latin 1 typed in the character set box.](setup-mysql-with-webmatrix-support/_static/image11.png)](setup-mysql-with-webmatrix-support/_static/image10.png) - -[![Image of My S Q L Instance Configuration Wizard displaying My S Q L typed in the Service Name box and Include Bin Directory in Windows Path checked.](setup-mysql-with-webmatrix-support/_static/image13.png)](setup-mysql-with-webmatrix-support/_static/image12.png) - -Since MySQL is installed on the database server, which is different than the web server which runs the Web Deploy web server component, you'll need to take a few extra steps to make sure Web Deploy can access the database server: - -1. Copy mysqldump.exe (typically from `C:\Program Files\MySQL\MySQL Server 5.1\bin`) to your **web server** in `c:\mysqldump\mysqldump.exe` -2. On the **web server**, set a registry key (`HKEY\_LOCAL\_MACHINE\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\2\mysqldumppath`) to string value == "c:\mysqldump\mysqldump.exe") - -## Resetting Permissions - -If you happen to lose the credentials to your MySQL database, this article may help: - -[http://dev.mysql.com/doc/refman/5.1/en/resetting-permissions.html#resetting-permissions-windows](http://dev.mysql.com/doc/refman/5.1/en/resetting-permissions.html#resetting-permissions-windows) diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image1.png deleted file mode 100644 index 945c7d451..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image10.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image10.png deleted file mode 100644 index 70e6416a8..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image10.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image11.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image11.png deleted file mode 100644 index 70e6416a8..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image11.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image12.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image12.png deleted file mode 100644 index 272ff0d16..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image12.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image13.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image13.png deleted file mode 100644 index 272ff0d16..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image13.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image2.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image2.png deleted file mode 100644 index 8fdb68240..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image2.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image3.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image3.png deleted file mode 100644 index 8fdb68240..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image4.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image4.png deleted file mode 100644 index d373ddff9..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image4.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image5.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image5.png deleted file mode 100644 index d373ddff9..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image5.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image6.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image6.png deleted file mode 100644 index 87237008c..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image6.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image7.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image7.png deleted file mode 100644 index 87237008c..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image7.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image8.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image8.png deleted file mode 100644 index 32c1f9731..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image8.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image9.png b/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image9.png deleted file mode 100644 index 32c1f9731..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/setup-mysql-with-webmatrix-support/_static/image9.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md deleted file mode 100644 index 4ec04a493..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration.md +++ /dev/null @@ -1,193 +0,0 @@ ---- -title: "Validate Your Server Configuration" -author: bilalaslam -description: "Introduction ServerValidator is an extensible, plugin-based tool which checks if your server is ready to support WebMatrix. Typically, ServerValidator is run..." -ms.date: 11/02/2010 -ms.assetid: 4e59e385-50fa-4ba5-afb2-b361a22fcefc -msc.legacyurl: /learn/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration -msc.type: authoredcontent ---- -# Validate Your Server Configuration - -by [Bilal Aslam](https://github.com/bilalaslam) - -## Server-side validation using ServerValidator - -ServerValidator is an extensible, plugin-based tool which checks if your server is ready to support WebMatrix. Typically, ServerValidator is run by a system administrator after they have configured the server. It comes with a command line version (ServerValidatorCommandline.exe) and a user-interface (ServerValidatorUI.exe). - -### What ServerValidator does - -- Checks if you are running the correct operating system. -- Checks if required software is installed, including products that can be installed using WebPI and otherwise as well as Windows Updates. -- Checks if Web Deploy delegation rules are set up correctly. -- Checks if services are installed and in the correct state. -- It is capable of checking if GAC assemblies and COM objects are installed. While these checks are not required for WebMatrix, shared hosting providers commonly install 3rd party components on their servers. -- Can be extended with your own plug-ins. - -### What ServerValidator does not do - -- It does not actually do a test publish. This is because a realistic test would be to publish to the server from outside your network so firewalls, etc. are taken into account. -- It does not check firewall settings. -- It does not validate if file system permissions required for certain Web Deploy providers are set up correctly. For example, it does not check that createApp provider has write access to applicationHost.config, or that the identity for setAcl provider has appropriate permissions to the site's folders. - -### Installation - -Download a version that works with both x86 and x64 server architectures: [ServerValidator](https://go.microsoft.com/fwlink/?LinkId=207733 "ServerValidator Download") - -### Example Usage - -You can watch a screencast demo of ServerValidator [here](servervalidator-demo.md "ServerValidator Demo Video"). - -The ServerValidator ZIP file comes with a sample configuration file, WebMatrixValidation.xml, which contains validation checks for WebMatrix support. - -1. Open the folder where you unzipped ServerValidator -2. Right-click ServerValidatorUI.exe and click "**Run as Administrator**". This is required for several of the validations to succeed because they require elevated privileges on your server. -3. Inspect the results in the UI - - ![Screenshot that shows the Server Validator U I window.](validate-your-server-configuration/_static/image1.png) - - - -### Input File Format - -The input file is a well-formatted XML file. It looks like this: - -[!code-xml[Main](validate-your-server-configuration/samples/sample1.xml)] - -Comments are allowed in the input XML using standard comment tags. - -- Each validation is specified by a <Validation></Validation> tag, and is handles by a specific Validator in the ServerValidator.Validators namespace. - - - *Type* is a required attribute - - - The value for this attribute specifies a .NET type in the ServerValidator.Validators namespace that implements the IValidator interface. For example, let's say type ="MyValidator". ServerValidator ships with a number of built-in Validators – it first searches the ServerValidator.dll assembly for "ServerValidator.Validators.MyValidator". If one is not found, it tries to load the "MyValidator.dll" assembly from disk and looks for the "ServerValidator.Validators.MyValidator" type in it. - - *description* attribute is required. It should be a simple description of the Validation. - - *detailsUrlBase* attribute is required. It should be a URI of the documentation. - - The remaining attributes are optional and are passed as key-value pairs to the Validator itself. - - - -### Output File Format - -The output file is named localhost\_<timestamp>.xml and is placed in the same folder as ServerValidator. A sample report looks like this: - -[!code-xml[Main](validate-your-server-configuration/samples/sample2.xml)] - -**Important Note:** Not everything that ServerValidator checks for is **required** by WebMatrix or the Spotlight program in the Web Hosting Gallery. The ServerValidator is simply a tool to aid in checking your installed components against the [list of required components](install-server-components.md). It also is useful for verifying that your [Web Deploy settings](configure-site-for-web-deploy-publishing.md) are correct. - - - -### Included Validators - -| Validator | Description | -| --- | --- | -| COMValidator | Checks for the presence of a COM component | -| DelegationRuleValidator | Checks if Web Deploy delegation rules are set up correctly | -| GacAssemblyValidator | Checks if a assembly is GAC'ed | -| OsValidator | Checks if the operating system is in the list of valid operating systems | -| RegistryValidator | Checks if a registry key is present and has a specific value | -| ServiceValidator | Checks if a service is installed and is the expected state | -| WebPIInstalledProductValidator | Checks if a product that can be installed via WebPI is installed. Also checks if all applications in the Application Gallery have dependencies installed. | -| WindowsInstalledComponentValidator | Checks if a product in the Windows Programs Control Panel is installed or not. Use this for programs that are not installed using WebPI. | - -#### Example: COMValidator - -Check if a specific COM component is installed: - -[!code-xml[Main](validate-your-server-configuration/samples/sample3.xml)] - -#### Example: DelegationRuleValidator - -Checks if the following delegation rules are set up correctly in administration.config: createApp, iisApp, contentPath, dbFullSql, dbMySql, recycleApp, setAcl. This Validator does not take any input: - -[!code-xml[Main](validate-your-server-configuration/samples/sample4.xml)] - -Note that this Validator does **NOT** check the following: - -- createApp: RunAs identity has write access to applicationHost.config -- recycleApp: RunAs identity is a member of the Administrators security group - -#### Example: OsValidator - -Checks if the current operating system is in the comma-seperated list of valid operating systems specifed in the *validOperatingSystems* attribute: - -[!code-xml[Main](validate-your-server-configuration/samples/sample5.xml)] - -#### Example: RegistryValidator - -Checks the registry for the presence of a key and, optionally, a registry value, kind and data - -[!code-xml[Main](validate-your-server-configuration/samples/sample6.xml)] - -The regKey attribute is required, all other attributes are optional. - -**Valid values for regKey:** HKEY\_LOCAL\_MACHINE\..., HKEY\_CURRENT\_USER\..., HKEY\_CLASSES\_ROOT\..., HKEY\_USERS\..., HKEY\_CURRENT\_CONFIG\... - -**Valid values for regValueKind:** String, ExpandString, Binary, DWord, MultiString, QWord. - -#### Example: ServiceValidator - -Checks if a Windows service is installed and, optionally, in the correct state: - -[!code-xml[Main](validate-your-server-configuration/samples/sample7.xml)] - -The serviceName attribute is required. serviceState attribute is optional. - -**Valid values for serviceState:** Paused, Running, Stopped. - -#### Example: WebPiInstalledComponentValidator - -This Validator serves two purposes. First, it can be used to check if a product installed using the WebPI 3.0 feed is installed or not. This snippet checks if Microsoft ASP.NET is installed. Valid values for the productId are productIds in the WebPI feed. - -[!code-xml[Main](validate-your-server-configuration/samples/sample8.xml)] - - Second, it can be used to check if dependencies for all applications that can be installed using the Web Application Gallery are installed. This is valuable if you want to see if your server supports being a publishing target for Wordpress, Joomla! etc. It will highlight any missing components so you can install them: - -[!code-xml[Main](validate-your-server-configuration/samples/sample9.xml)] - -#### Example: WindowsInstalledComponentValidator - -This Validator uses WMI to check if a product is in Win32\_Products. It's an alternative to the WebPIInstalledComponentValidator, because it checks the same list as the Programs Control Panel, and can also check for Windows Updates. - -**Valid values for *category* attribute:** product and update. - -[!code-xml[Main](validate-your-server-configuration/samples/sample10.xml)] - -### Building your own Validator - -1. Start Visual Studio -2. Create *.NET 2.0*, C# class library project: - - ![Screenshot that shows the Add New Project window. Class Library is selected.](validate-your-server-configuration/_static/image3.png) -3. Add a reference to ServerValidator.dll: - - ![Screenshot that shows the Solution Explorer window.](validate-your-server-configuration/_static/image5.png) -4. Paste the following code into MyCustomValidator.cs: - - [!code-csharp[Main](validate-your-server-configuration/samples/sample11.cs)] - - Each Validator implements the IValidator interface. It *must* be in the ServerValidator.Validators namespace. It overrides two methods: - - - *Initialize* method. Called to set up the Validator with input data: - - - context: set of key-value pairs specified for this Validator in the input XML. - - server: reserved for future use - - serverValidation- *Validate* method. This method actually does the work of validation. Use the Reporter field on the instance of ServerValidationManager to perform logging. - -5. Compile the DLL and place it in the same directory as ServerValidatorCommandLine.exe - -6. Add the following snippet to the input file: - - [!code-xml[Main](validate-your-server-configuration/samples/sample12.xml)] - -7. Run ServerValidator - - - -## Client-side validation using WebMatrix - -Once ServerValidator shows valid results, the logical next step is to try website publishing from the WebMatrix client. [Learn more about how we do this publish testing](how-webmatrix-verification-works.md "How WebMatrix verification works"). - -## Next Steps - -Now that you have checked to make sure your server is set up correctly, it is time to start provisioning hosting user accounts. To make it easier for end users to consume your server credentials, we suggest giving out user accounts using our Profile XML format. Create a sample test account and [generate a Profile XML for it](generate-a-profile-xml-file.md). diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image1.png b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image1.png deleted file mode 100644 index 0d4a8836e..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image3.png b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image3.png deleted file mode 100644 index 6f6f4bcfb..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image5.png b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image5.png deleted file mode 100644 index 94afc885f..000000000 Binary files a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/_static/image5.png and /dev/null differ diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample1.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample1.xml deleted file mode 100644 index d5bddf69d..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample1.xml +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample10.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample10.xml deleted file mode 100644 index e1d75fb99..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample10.xml +++ /dev/null @@ -1,9 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample11.cs b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample11.cs deleted file mode 100644 index bb9bc882c..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample11.cs +++ /dev/null @@ -1,28 +0,0 @@ -using System.Collections.Generic; -using ValidationResult = ServerValidator.ILog.ValidationResult; - -namespace ServerValidator.Validators -{ - public class MyCustomValidator : ServerValidator.Validators.IValidator - { - private Dictionary _context; - private Server _server; - private ServerValidationManager _serverValidationManager; - - public override void Initialize(Dictionary context, Server server, ServerValidationManager serverValidationManager) - { - _context = context; - _server = server; - _serverValidationManager = serverValidationManager; - - _serverValidationManager.Reporter.Log(ILog.LogEvent.LogEventType.Informational, "Initialized my custom validator"); - - } - - public override ValidationResult Validate() - { - _serverValidationManager.Reporter.Log(ILog.LogEvent.LogEventType.Informational, "Called Validate() in my custom validator"); - return ValidationResult.Pass; - } - } -} \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample12.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample12.xml deleted file mode 100644 index 4db9e285b..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample12.xml +++ /dev/null @@ -1,7 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample2.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample2.xml deleted file mode 100644 index aba5537b8..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample2.xml +++ /dev/null @@ -1,18 +0,0 @@ - - - 12/2/2010 2:33:32 PM - 0.0.0.0 - localhost - - - - Current OS Microsoft Windows 7 Enterprise is not in list of valid operating systems - - - - - Product .NET Framework 3.5 SP 1 is installed. - - - - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample3.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample3.xml deleted file mode 100644 index e2cd7f54d..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample3.xml +++ /dev/null @@ -1,6 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample4.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample4.xml deleted file mode 100644 index 7084e0e1c..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample4.xml +++ /dev/null @@ -1,6 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample5.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample5.xml deleted file mode 100644 index 466b0817b..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample5.xml +++ /dev/null @@ -1,7 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample6.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample6.xml deleted file mode 100644 index 49afa46b0..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample6.xml +++ /dev/null @@ -1,9 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample7.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample7.xml deleted file mode 100644 index a5b1c0ddd..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample7.xml +++ /dev/null @@ -1,8 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample8.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample8.xml deleted file mode 100644 index 4d8305457..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample8.xml +++ /dev/null @@ -1,8 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample9.xml b/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample9.xml deleted file mode 100644 index 864d6df79..000000000 --- a/iis/web-hosting/joining-the-web-hosting-gallery/validate-your-server-configuration/samples/sample9.xml +++ /dev/null @@ -1,7 +0,0 @@ - \ No newline at end of file diff --git a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/overview-of-the-web-farm-framework-20-for-iis.md b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/overview-of-the-web-farm-framework-20-for-iis.md index dfc054aad..fb37d763d 100644 --- a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/overview-of-the-web-farm-framework-20-for-iis.md +++ b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/overview-of-the-web-farm-framework-20-for-iis.md @@ -32,7 +32,6 @@ The Web Farm Framework 2.0 provides one view and user interface to see the statu The main features of the Web Farm Framework 2.0 include: - One-step provisioning of servers added to a farm. -- Platform provisioning using Web Platform Installer. - Application provisioning using Microsoft Web Deploy. - Policy-based provisioning. - Installation of additional platform components and content. diff --git a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis.md b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis.md index ba1bb2993..749861ffc 100644 --- a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis.md +++ b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis.md @@ -11,7 +11,7 @@ msc.type: authoredcontent by Randall DuBois -You can use the Web Farm Framework 2.0 for IIS 7 and above to perform both platform and application provisioning on the servers in your server farm. You can also install applications and components by selecting them from a list of products offered by the Microsoft Web Platform Installer. +You can use the Web Farm Framework 2.0 for IIS 7 and above to perform both platform and application provisioning on the servers in your server farm.. @@ -19,8 +19,6 @@ You can use the Web Farm Framework 2.0 for IIS 7 and above to perform both platf Platform provisioning is the process of synchronizing a secondary server with the web platform components and additional modules installed on the primary server. You can select the applications to provision, as well as the interval between synchronization cycles. -You can install any web platform components that are available in the Web Platform Installer. For more information, see [Microsoft Web Platform Installer](https://go.microsoft.com/?linkid=9739157 "Microsoft Web Platform Installer"). - ### To configure platform provisioning 1. Start **IIS Manager**, and then in the **Connections** pane, select the name of the server farm you want to configure settings for. @@ -62,23 +60,3 @@ Application provisioning is similar to platform provisioning, but instead of syn 5. Enter a path in which to install the provider on the secondary servers. This must be a file system path, such as `C:\inetpub\`. The field cannot be empty. 6. In the **Settings** field, specify the provider settings that you want to use for the selected provider. Click the field and use the browse **(…)** button to open the **Provider Settings** dialog box. For more information, see [Web Deploy Provider Settings](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/dd569001(v=ws.10)). 7. Add the providers you want, and then in the **Actions** pane click **Apply**. - -## Installing Applications on Servers - -You can also install web platform products on a selected server or all servers in the farm using the **Install Products** dialog box. When you open this dialog box for a specific server, it displays web platform products offered in the Web Platform Installer whether or not they are already installed on that server. You can select the products and components you want to install, and they will be installed by the Web Farm Framework using Web Platform Installer. - -### To install products using the Install Products dialog - -1. Open **IIS Manager**, expand the nodes in the **Connections** pane to display your server farm, and then do one of the following: - - - If you want to install products on all the servers in your server farm, select your server farm in the **Connections** pane, and then in the **Actions** pane click **Install Products**. - - ![Screenshot of the I I S Manager Window on the Server Farm page. Install Products option is circled in the Actions menu.](provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image18.png) - - If you want to install products on a specific server, expand the server farms node and then select the **Servers** node. In the **Servers** pane select the server you want, and then in the **Actions** pane click **Install Products**. -2. In the **Install Products** dialog box, select the products you want to install, and then click **OK**. - - ![Screenshot of the Install Products dialog box.](provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image20.png) - -You can view the installation status using the trace messages displayed on the **Servers** page. - -![Screenshot of the Servers page displaying the installation status trace messages.](provisioning-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image22.png) diff --git a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis.md b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis.md index 521a78e2e..a6761a8fc 100644 --- a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis.md +++ b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis.md @@ -21,7 +21,7 @@ The article also describes how WFF automatically provisions the secondary server After you complete the steps to install and configure WFF, your server farm does not require any additional configuration or manual monitoring. Any application you install or deploy to the primary server is automatically updated on the secondary servers. -WFF uses the Microsoft Web Platform Installer (Web PI) and Web Deploy as the mechanisms to update products and applications. You can perform each of the tasks described using the UI, APIs, and Windows PowerShell cmdlets. For information about using APIs or Windows PowerShell, see [Web Farm Framework 2.0 for IIS 7 and Above Code Sample](web-farm-framework-20-for-iis-code-sample.md) or [Web Farm Framework 2.0 for IIS 7 and Above cmdlets for Windows PowerShell](web-farm-framework-20-for-iis-cmdlets-for-windows-powershell.md). +WFF uses the Microsoft Web Deploy as the mechanisms to update products and applications. You can perform each of the tasks described using the UI, APIs, and Windows PowerShell cmdlets. For information about using APIs or Windows PowerShell, see [Web Farm Framework 2.0 for IIS 7 and Above Code Sample](web-farm-framework-20-for-iis-code-sample.md) or [Web Farm Framework 2.0 for IIS 7 and Above cmdlets for Windows PowerShell](web-farm-framework-20-for-iis-cmdlets-for-windows-powershell.md). ## Setting Up a Server Farm @@ -42,22 +42,11 @@ Setting up a server farm consists of the following tasks: You need to install the Web Farm Framework only on the computer that will be the Web Farm Framework *controllerserver*. The controller service installs the Web Farm Framework agent on the other servers in the server farm. -You can install Web Farm Framework 2.0 using Microsoft Web Platform Installer: - -[![Screenshot that shows the install button for Microsoft Web Platform Installer.](setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image3.png)](https://go.microsoft.com/?linkid=9739157) - -Alternatively, you can download the .msi file appropriate for your computer architecture ([x86](https://go.microsoft.com/fwlink/?LinkId=287165) or [x64](https://go.microsoft.com/fwlink/?LinkId=287166)). +You can download the .msi file appropriate for your computer architecture ([x86](https://go.microsoft.com/fwlink/?LinkId=287165) or [x64](https://go.microsoft.com/fwlink/?LinkId=287166)). > [!IMPORTANT] > WFF requires the Web Deploy module. If you install WFF using an .msi installer, you must also install the [Web Deploy](https://www.iis.net/downloads/microsoft/web-deploy) module version 1.1 or later on the controller server. -**To install Web Farm Framework 2.0 using Web Platform Installer** - -1. Install and run Web Platform Installer. -2. Select the **Products** tab, and then select **Server**. -3. Find **Web Farm Framework 2.0**, and then click Add. [![Screenshot that shows the Web Platform Installer. Web Farm Framework is selected and the Add button is highlighted, along with Products and Server.](setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image5.png)](setting-up-a-server-farm-with-the-web-farm-framework-20-for-iis/_static/image4.png) -4. Click **Install**. - ## Configuring the Primary Server @@ -66,9 +55,7 @@ These steps should be performed on the computer that will be the primary server **To configure the primary server** -1. Download and install the [Microsoft Web Platform Installer](https://go.microsoft.com/?linkid=9739157 "Microsoft Web Platform Installer"). -2. Start the Web Platform Installer and select the web platform components and applications you want to install on the primary server. -3. Follow the steps in Web Platform Installer to complete the installation of the components you selected. +Manually install the web platform components and applications you want to install on the primary server. diff --git a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/system-and-platform-requirements-for-the-web-farm-framework-20-for-iis.md b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/system-and-platform-requirements-for-the-web-farm-framework-20-for-iis.md index 8d7907563..56f1021dd 100644 --- a/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/system-and-platform-requirements-for-the-web-farm-framework-20-for-iis.md +++ b/iis/web-hosting/microsoft-web-farm-framework-20-for-iis-7/system-and-platform-requirements-for-the-web-farm-framework-20-for-iis.md @@ -41,7 +41,6 @@ To provision your server farm, you first set up a primary server, and then Web F The Controller server must have the following: - Windows Vista with SP1, Windows 7, Windows Server 2008 with SP1, or Windows Server R2 installed. -- The Microsoft Web Platform Installer V3 (Web PI v3) installed. To download Web PI, see [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx "Web Platform Installer"). - IIS installed (IIS 7.0, IIS 7.5 or above). If you do not have IIS installed, you can use the Web PI to install it. - The Microsoft Web Deploy v2 module for IIS. If Web Deploy is not installed on the computer, it will automatically be installed by the Web PI with the Web Farm Framework as a required dependency. diff --git a/iis/web-hosting/migrate-to-the-microsoft-web-platform/how-to-migrate-to-the-microsoft-web-platform.md b/iis/web-hosting/migrate-to-the-microsoft-web-platform/how-to-migrate-to-the-microsoft-web-platform.md deleted file mode 100644 index b01ab4c83..000000000 --- a/iis/web-hosting/migrate-to-the-microsoft-web-platform/how-to-migrate-to-the-microsoft-web-platform.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "How to Migrate to the Microsoft Web Platform" -author: rick-anderson -description: "PHP is quite portable, and cross-platform development has been a major goal in its development. In most cases, PHP scripts are easily ported from Linux to th..." -ms.date: 11/15/2009 -ms.assetid: 7aa6674b-c24c-4c8e-b3eb-c8ac5bf5f3a2 -msc.legacyurl: /learn/web-hosting/migrate-to-the-microsoft-web-platform/how-to-migrate-to-the-microsoft-web-platform -msc.type: authoredcontent ---- -# How to Migrate to the Microsoft Web Platform - -by Tali Smith - -PHP is quite portable, and cross-platform development has been a major goal in its development. In most cases, PHP scripts are easily ported from Linux to the Windows® operating system with very few problems. Microsoft has also produced a rich set of PHP migration documentation and a toolkit to assist in basic PHP application deployment; these are located on the Internet Information Services (IIS) Web site ([https://www.iis.net/](https://www.iis.net/)). - -Many popular PHP applications that have been written on and currently run on the LAMP (Linux–Apache–MySQL–PHP) stack can be successfully migrated to a Windows-based stack (Windows–IIS–MySQL–PHP). The article [IIS for Apache Administrators](iis-for-apache-administrators.md) compares common IIS 7 and above tools and management scenarios with Apache tools and management scenarios. The SQL Server Driver for PHP can also make it possible to migrate applications to a Windows–IIS–SQL Server–PHP stack. This lets customers enjoy the convenience and familiarity of the Windows operating system. - -There are also many other migration scenarios. You may want to migrate to a newer version of IIS, or you may want to migrate to Microsoft® SQL Server® 2008 from MySQL. The following articles can provide guidance for various migration scenarios: - -- [Migrate to a Windows-Based Platform](migrate-to-a-windows-based-platform.md). Provides general migration guidance. -- [Import Apache mod\_rewrite Rules](../../extensions/url-rewrite-module/importing-apache-modrewrite-rules.md). Guides you through the process of converting Apache mod\_rewrite rules to IIS URL rewrite rules. -- [Migrate from MySQL to SQL Server 2008](migrate-from-mysql-to-sql-server-2008.md). Provides guidance on migrating from MySQL to SQL Server 2008. -- [Migrate from IIS 6.0 to IIS 7 or Above](../../publish/using-web-deploy/migrate-a-web-site-from-iis-60-to-iis-7-or-above.md). Helps you migrate a Web site from IIS 6.0 to IIS 7.0 or above using the Microsoft® Web Deployment Tool. diff --git a/iis/web-hosting/migrate-to-the-microsoft-web-platform/iis-for-apache-administrators.md b/iis/web-hosting/migrate-to-the-microsoft-web-platform/iis-for-apache-administrators.md index 6c534d7c0..1d08be86a 100644 --- a/iis/web-hosting/migrate-to-the-microsoft-web-platform/iis-for-apache-administrators.md +++ b/iis/web-hosting/migrate-to-the-microsoft-web-platform/iis-for-apache-administrators.md @@ -308,5 +308,4 @@ Dynamic IP Restrictions for IIS is a module that provides protection against den ## Links for Further Information - [My Take: IIS vs. Apache](https://blogs.iis.net/bills/archive/2007/05/07/iis-vs-apache.aspx) -- [Benefits of Running IIS7 Over IIS6 Or Apache](http://ezinearticles.com/?Benefits-of-Running-IIS7-Over-IIS6-Or-Apache&id=2131887) - See: diff --git a/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-from-mysql-to-sql-server-2008.md b/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-from-mysql-to-sql-server-2008.md index 90443a5bc..b703edb3a 100644 --- a/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-from-mysql-to-sql-server-2008.md +++ b/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-from-mysql-to-sql-server-2008.md @@ -13,11 +13,7 @@ by Tali Smith ## Introduction -PHP, a powerful server-side scripting language used for creating dynamic Web sites and applications, is one of the most widely used Web programming languages in use today. More than 4.5 million PHP developers and more than 22 million Internet domains use PHP [[1]](#_ftn1 "_ftnref1"). PHP has been widely deployed on Linux systems via the "LAMP" (Linux-Apache-MySQL-PHP) stack; this open-source Web development platform uses the Linux operating system, an Apache Web server, and a MySQL database with the PHP development language. - -However, PHP can also be implemented on the Windows® operating system, bringing a familiar user interface and legendary ease of use to the server platform. Windows Server® 2008, with the Internet Information Services (IIS) role, supports and improves the interoperability of PHP on Windows Server®, providing a solid, hardened, scalable Web server platform. - -With the advent of the SQL Server Driver for PHP and with the inclusion of FastCGI in IIS, PHP developers now have a strong platform for developing and running Web applications: Windows Server 2008, Internet Information Services (IIS), and Microsoft® SQL Server® 2008. +With the advent of the SQL Server Driver for PHP, PHP developers now have a strong platform for developing and running Web applications: Windows Server 2008 and Microsoft® SQL Server® 2008. ## Migrate from MySQL to SQL Server 2008 diff --git a/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-to-a-windows-based-platform.md b/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-to-a-windows-based-platform.md deleted file mode 100644 index ea9ff7946..000000000 --- a/iis/web-hosting/migrate-to-the-microsoft-web-platform/migrate-to-a-windows-based-platform.md +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: "Migrate to a Windows-Based Platform" -author: rick-anderson -description: "Microsoft embraces hosting PHP applications on the Windows ® operating system, both by building enabling technologies and by working with the PHP community t..." -ms.date: 11/15/2009 -ms.assetid: 98902a0b-c6f3-420b-b7e5-23afb2b640e8 -msc.legacyurl: /learn/web-hosting/migrate-to-the-microsoft-web-platform/migrate-to-a-windows-based-platform -msc.type: authoredcontent ---- -# Migrate to a Windows-Based Platform - -by Tali Smith - -## Introduction - -Microsoft embraces hosting PHP applications on the Windows® operating system, both by building enabling technologies and by working with the PHP community to ensure that popular PHP applications run well on the Windows platform. Customers appreciate the convenience of being able to run PHP applications on a Windows-based system because they are likely to have other computers running the operating system and are familiar with the user interface. The capabilities built into Windows Server® 2008, such as Internet Information Services 7 (IIS 7) and above, and FastCGI, make seamless operation of PHP applications possible. With the advent of the SQL Server Connector for PHP, users can add Microsoft® SQL Server® 2008 to the software stack if they desire, providing a top-to-bottom solution for PHP applications based on Microsoft® technology. - -PHP is quite portable. Cross-platform development has been a major goal in the development of PHP since the days of version 3. In most cases, PHP scripts are easily ported from Linux to Windows with very few problems. Microsoft has also produced a rich set of PHP migration documentation and a toolkit to assist in basic PHP application deployment; these are located on the [IIS Web site](../../application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis-60.md). - -Many popular PHP applications that have been written on and currently run on the LAMP (Linux–Apache–MySQL–PHP) stack can be successfully migrated to a Windows-based stack (Windows–IIS–MySQL–PHP. The SQL Server Driver for PHP can also make it possible to migrate applications to a Windows–IIS–SQL Server–PHP) stack. This lets customers enjoy the convenience and familiarity of the Windows operating system. - -Note that a Web site already hosted in the Apache/Windows environment takes less time to migrate than a Web site completely hosted in a LAMP (Linux, Apache, MySQL and PHP) environment. There are two types of migration processes (depending on the base operating system): - -- Migration of a Web site from Apache on Linux to IIS 7 or above on Windows Server 2008 or Windows Server® 2008 R2. -- Migration of a Web site from Apache on Windows Server® 2003, Windows® 2000, or Windows® XP to IIS 7.0 or above on Windows Server 2008 or Windows Server 2008 R2. - - - -## Basic Steps in Server Migration - -The basic steps for migration of a PHP application from Linux to Windows are: - -1. Plan your migration. -2. Install the Windows environment. Articles on the learn.iis.net Web site can step you through these procedures. -3. Migrate files. Migrating Web site files from one server to another can be done using the three different methods: - - - Migrating files using Windows Sharing - - Migrating files using File Transfer Protocol (FTP) - - Migrating files using Hypertext Transfer Protocol (HTTP) -4. Move databases. The two methods for migrating databases from one server to another include: - - - Migrating a database from MySQL on Windows Server 2003 to MySQL on Windows Server 2008 or Windows Server 2008 R2. - - Migrating a database from MySQL on Linux to Microsoft® SQL Server® 2005 or Microsoft® SQL Server® 2008 on Windows Server 2008. -5. Update configurations. -6. Migrate applications. -7. Fine-tune any issues. See the [Troubleshoot](#_Troubleshoot) section below. - - - -## Plan Your Migration - -Before initiating the migration, it is important to plan ahead to effectively prepare for all of the issues that may occur during the migration process and to outline an overall migration framework and steps. Some of the issues to consider before you begin migration include: - -- **Total time required for the migration**. The number of files (static HTML or PHP) and the number of tables and procedures have a significant impact on the overall time required to complete the migration, the type of migration process undertaken, and the database implemented. - A Web site consisting of a large number of PHP files and that has no centralized database management takes more time to migrate than a site using a centralized database configuration, because the aspects of the application, such as modifying queries and connection strings, need to be configured to work with the new database. - Similarly, a Web site with relatively high number of database tables may require modification of column types for the new database to run on SQL Server instead of MySQL. -- **Selection of database**. Databases can be migrated either from one MySQL instance of one server (Linux on Windows) to another MySQL instance of another server (Windows Server 2008 or Windows Server 2008 R2) or from MySQL on one server (Linux Windows) to SQL Server on another server (Windows Server 2008 or Windows Server 2008 R2). - Migrating data from MySQL to MySQL is simpler and more straightforward compared with migration from MySQL to SQL Server. Migration of data from MySQL to SQL Server requires migrating not just the tables and their fields, but the data types of the fields, indexes, keys, and others. - Migration of a database from MySQL to SQL Server also requires the installation of a MySQL Open Database Connectivity (ODBC) connector on Windows Server 2008. This driver helps create a link between the two types of database servers and facilitates the migration of tables. On the other hand, migrating data from MySQL on one server to MySQL on Windows Server 2008 does not require an ODBC driver. -- **Web site compatibility with IIS 7 and above and Windows Server 2008 or Windows Server 2008 R2**. The compatibility of an Apache-based Web site with IIS 7.0 and above and Windows Server 2008 or Windows Server 2008 R2 should be determined before proceeding with the actual migration. Web sites hosted on Apache and Linux have different dependencies compared with Web sites hosted on IIS 7 and above and Windows Server 2008 or Windows Server 2008 R2. - -## Migration Considerations - -Migration is easy, but you must test and fine-tune. Note that PHP, Apache HTTP server, and MySQL all run very well on Windows Server 2008 or Windows Server 2008 R2 and on the Server Core installation of Windows Server 2008 or Windows Server 2008 R2. You can easily replace Apache with IIS, and applications continue to run well. IIS stores a lot of configuration data in XML for easy editing, but unlike Apache, IIS can pick up changes dynamically without a restart of the system. - -Consider the following information about how PHP interacts with Web servers: - -- Php.ini settings on different servers can cause differences in how global variables are handled and what the PHP program accepts as legal PHP code. -- Many of the file system functions are Linux/UNIX-specific. Check each function in the PHP manual to find out whether or not the function works with Windows. -- Make sure that the parameters and file names you pass are case sensitive. Although you can set case sensitivity off in MySQL, most servers prefer to leave it on by default. On the Windows NT® version of MySQL, case sensitivity is off by default. - -Currently, PHP uses more than 80 extensions, covering a wide range of services and functionality. Only about half of these extensions are available on both platforms. A handful of extensions, such as the Component Object Model (COM), Microsoft® .NET, and IIS extensions, are specific to Windows. If an extension you use in your scripts is not currently available for Windows, you must look at either porting that extension or converting your scripts to use functionality that is available for Windows. - -Note that PHP has the following additional limitations: - -- Support for XML is low compared to the Microsoft XML implementation. However, XML support has greatly improved under Windows as of PHP 4.3.11 and more recently PHP 5.0.4. -- Support for SOAP is low, though it has improved as of PHP 5.x. -- PHP cannot access the Windows registry. -- PHP does not include support for handling users and groups on Windows. -- PHP does not include full support for Unicode, as of version 4.0.5. However, Unicode in PHP works well as of version 4.3.x, especially with the mbstring extension. Using the Php.ini directive mbstring.func\_overload = 7 replaces all non-UTF-8 safe functions with the mbstring equivalent functions. - - - -## Troubleshoot - -The following information may help you troubleshoot issues that you may encounter. - -- The file transfer may require some "helper" applications: - - - Smbclient is required for the Server Message Block (SMB) transfer. - - The Net::FTP Perl module is required for FTP. - - The Net::FTPSSL Perl module is required for FTP over Secure Sockets Layer (FTPS). - - The Net::SFTP Perl module is required for SSH FTP (SFTP). - - Openssh is required for the secure copy (SCP) transfer. -- If your PHP applications are timing out, you may be reaching the execution limit. Increase the value of max\_execution\_time in Php.ini. -- If your PHP applications are running out of memory, check the value of upload\_max\_filessize. Ensure that the value is adequate for your application. - -> [!NOTE] -> This article is based on the whitepaper: Apache to IIS 7.0 Migration Guide (`https://download.microsoft.com/download/2/D/8/2D863347-3AFF-48A6-9FCF-EC6554C18DCF/Apache%20to%20IIS%207%200%20Migration%20Guide.doc`) published in March, 2009.* - -## Links for Further Information - -- [Linux-Apache-MySQL PHP Migration webcasts](/archive/blogs/keithcombs/running-lamp-on-windows-server-2008-webcast-and-screencasts-now-available) -- [Migrating Linux-Apache-MySQL-PHP to Windows 2000](https://www.microsoft.com/technet/archive/interopmigration/linux/mvc/miglamp.mspx?mfr=true.) diff --git a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-1-install-iis-web-farm-infrastructure.md b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-1-install-iis-web-farm-infrastructure.md index 9214a40fa..5055c7cd2 100644 --- a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-1-install-iis-web-farm-infrastructure.md +++ b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-1-install-iis-web-farm-infrastructure.md @@ -69,17 +69,13 @@ Install IIS on all servers in your web farm except your back-end file servers (c ## 1.2 Install ARR for Load Balancing -Once you have a default installation of IIS on a server, you can use [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) to install the current version of Application Request Routing (ARR). +Once you have a default installation of IIS on a server, you can install the current version of Application Request Routing (ARR). ### To install ARR load balancing and its dependencies -1. Open a browser to the [Application Request Routing](https://www.iis.net/downloads/microsoft/application-request-routing) website, and click the **Install** button. -2. Click **Allow**, and then click **Yes**. -3. In the **Web Platform Installer** window, click **Install**. -4. Look over the components to be installed, and then click **I Accept**. - - When the installer completes the installation, it displays and summary showing what was installed. -5. Click **Finish**, and then click **Exit**. +1. Open a browser to the [Application Request Routing](https://www.iis.net/downloads/microsoft/application-request-routing) website. +2. Locate the MSI packages for the current version of ARR and download them to your server. +3. Run the MSI package to install ARR and its dependencies. @@ -92,8 +88,7 @@ If you need help configuring your website on your web server, refer to one of th 1. [Build a Static Website on IIS](../../manage/creating-websites/scenario-build-a-static-website-on-iis.md) 2. [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) 3. [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) -4. [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) -5. [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) +4. [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) ## See also diff --git a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-5-configure-application-deployment.md b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-5-configure-application-deployment.md index dee6a8f2e..62e9ed614 100644 --- a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-5-configure-application-deployment.md +++ b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/configuring-step-5-configure-application-deployment.md @@ -67,17 +67,15 @@ The procedures in this section guide you through installing and configuring FTP ## 5.2. Install and Test Web Deploy for Your Web Farm -Install Web Deploy on your source computer (your development machine with IIS installed). Install Web Deploy on each of your web application servers. Use [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx) to install the current version of Web Deploy and its dependencies. +Install Web Deploy on your source computer (your development machine with IIS installed). Install Web Deploy on each of your web application servers. To test your Web Deploy installation, use it to update your website. ### To install Web Deploy for your farm -1. Open a browser to the [Web Deployment Tool](https://www.iis.net/downloads/microsoft/web-deploy) website, and click the **Install** button. -2. Click **Allow**, and then click **Yes**. -3. In the **Web Platform Installer** window, click **Install**. -4. Look over the components to be installed, and then click **I Accept**. When the installer completes the installation, it displays and summary showing what was installed. -5. Click **Finish**, and then click **Exit**. +1. Open a browser to the [Web Deployment Tool](https://www.iis.net/downloads/microsoft/web-deploy) website. +2. Locate the MSI packages for the current version of Web Deploy and download them to your server. +3. Run the MSI package to install Web Deploy. ### To update your website with Web Deploy diff --git a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-1-plan-iis-web-farm-infrastructure.md b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-1-plan-iis-web-farm-infrastructure.md index fcb3e8179..d43625453 100644 --- a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-1-plan-iis-web-farm-infrastructure.md +++ b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-1-plan-iis-web-farm-infrastructure.md @@ -71,8 +71,6 @@ This web farm infrastructure requires you to configure the following servers: Microsoft Application Request Routing (ARR) is a proxy-based routing module that forwards HTTP requests to content servers based on HTTP headers, server variables, and load balance algorithms. For more information about ARR, see [Step 3: Plan IIS Web Farm Load Balancing](planning-step-3-plan-iis-web-farm-load-balancing.md). -The easiest way to install ARR and its dependencies is with [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx). - To configure ARR load balancing, you need the IP address for all of your servers. To find an IP address, use the Ipconfig.exe command-line tool. @@ -83,8 +81,7 @@ The easiest way to configure your web farm is to start by getting your website w 1. [Build a Static Website on IIS](../../manage/creating-websites/scenario-build-a-static-website-on-iis.md) 2. [Build a Classic ASP Website on IIS](../../application-frameworks/running-classic-asp-applications-on-iis-7-and-iis-8/scenario-build-a-classic-asp-website-on-iis.md) 3. [Build an ASP.NET Website on IIS](../../application-frameworks/scenario-build-an-aspnet-website-on-iis/overview-build-an-asp-net-website-on-iis.md) -4. [Build a PHP Website on IIS](../../application-frameworks/scenario-build-a-php-website-on-iis/overview-build-a-php-website-on-iis.md) -5. [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) +4. [Build an FTP Site on IIS](../../publish/using-the-ftp-service/scenario-build-an-ftp-site-on-iis.md) > [!NOTE] > To keep this scenario simple, it is assumed that your web farm servers only one site. However, you can set up multiple sites with little difficulty. diff --git a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-5-plan-application-deployment.md b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-5-plan-application-deployment.md index 2575b3a18..f7f2b2325 100644 --- a/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-5-plan-application-deployment.md +++ b/iis/web-hosting/scenario-build-a-web-farm-with-iis-servers/planning-step-5-plan-application-deployment.md @@ -27,7 +27,7 @@ File Transfer Protocol (FTP) simple is a protocol for transferring files between The Web Deployment Tool (Web Deploy) enables IIS to synchronize, package, and deploy web applications, websites, or web server content and configuration. It has numerous features that let you include those components that you want to process and exclude those components that you do not. For you to be able to use Web Deploy, first install IIS on the source and destination computers. -The easiest way to install Web Deploy is by using the Web Platform Installer. You can install Web Deploy by running the Web Deploy Windows® Installer or from the command line by using Msiexec.exe. The Web Platform Installer requires fewer steps, while the other methods allow you to customize your installation. In all cases, log on as an administrator. +You can install Web Deploy by running the Web Deploy Windows® Installer or from the command line by using Msiexec.exe. And this allows you to customize your installation. In all cases, log on as an administrator. For more information about Web Deploy, see [Web Deployment Tool Overview](https://technet.microsoft.com/library/dd569058(v=ws.10)) and [Introduction to Web Deploy](https://www.iis.net/learn/publish/using-web-deploy/introduction-to-web-deploy). diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-aspnet.md b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-aspnet.md index 179ba38a3..378dda9fc 100644 --- a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-aspnet.md +++ b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-aspnet.md @@ -17,7 +17,7 @@ In this case we'll play the role of the developer and use the Microsoft Web Patf In summary this walkthrough covers: -1. Using Web Platform Installer to install Graffiti CMS in a developer machine +1. Install Graffiti CMS in a developer machine 2. Configuring the application to use SQL Server and test it locally 3. Using Visual Web Developer to modify and publish the application to the remote server. 4. Using IIS Manager Remote Administration feature to change the application Connection String to point to the new SQL Server. @@ -27,11 +27,10 @@ In summary this walkthrough covers: 1. The hoster must have provided the developer with credentials that have access to an FTP site that shared its content with the corresponding Web Site. See FTP and VWD articles link: [Guide to Deploy FTP and Publish with VWD](../configuring-servers-in-the-windows-web-platform/guide-to-deploy-ftp-and-publish-with-vwd.md) for details on how to setup this configuration so that users are isolated from each other. 2. The hoster must have provided the developer with a SQL Server database. 3. The developer must have installed Visual Web Developer (VWD) and SQL Server. -4. The developer must have installed the Web Platform Installer (WPI). Follow the instructions at link: . -## Step 1: Using WPI, install the Graffiti CMS application on your development machine +## Step 1: Install the Graffiti CMS application on your development machine -As of the writing of this article a new version of Web Platform Installer is being released to the Web. Please visit for more information. The set of applications include Graffiti CMS. +Follow the official guide to install Graffiti CMS on IIS/Windows. ## Step 2: Verify the existence of the Graffiti CMS Site and corresponding Database @@ -110,7 +109,7 @@ Now you are ready to publish the application. This walkthrough covered: -1. Using Web Application Installer to install Graffiti CMS in a developer machine +1. Install Graffiti CMS in a developer machine 2. Configuring the application to use SQL Server and test it locally 3. Using Visual Web Developer to modify and publish the application to the remote server. 4. Using IIS Manager Remote Administration feature to change the application Connection String to point to the new SQL Server. diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php.md b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php.md deleted file mode 100644 index 1d0ac71fc..000000000 --- a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Verifying the Developer Experience - PHP" -author: walterov -description: "Introduction This walkthrough is intended to help hosters verify that their customers can use the Windows Web Platform tools and services to download, custom..." -ms.date: 01/18/2009 -ms.assetid: f1580123-265c-440b-ae5b-0120fe5dd786 -msc.legacyurl: /learn/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php -msc.type: authoredcontent ---- -# Verifying the Developer Experience - PHP - -by [Walter Oliver](https://github.com/walterov) - -## Introduction - -This walkthrough is intended to help hosters verify that their customers can use the Windows Web Platform tools and services to download, customize, publish, and manage their applications in a Hosted Environment. - -In this case we'll play the role of the developer and use the Microsoft Web Platform Installer to deploy a popular blogging PHP application called "WordPress" in the local developer machine. Once we verify that works we'll proceed to deploy it in the hosted server. - -In summary this walkthrough covers: - -1. Using Web Application Installer to install WordPress in a developer machine -2. Configuring the application to use MySQL and test it locally -3. Using Visual Web Developer to modify and publish the application to the remote server. -4. Using IIS Manager Remote Administration feature to change the application Default document list. - -## Prerequisites - -1. The hoster must have provided the developer with credentials that have access to an FTP site that shared its content with the corresponding Web Site. See FTP and VWD article <link: to FTP and VWD article> for details on how to setup this configuration so that users are isolated from each other. -2. The hoster must have PHP installed <link: [https://www.iis.net/learn/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis](../../application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis.md)>. -3. The hoster must have provided the developer with a MySQL database <link: [https://www.iis.net/learn/application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above](../../application-frameworks/install-and-configure-php-on-iis/install-and-configure-mysql-for-php-applications-on-iis-7-and-above.md)>. -4. The developer must have installed Visual Web Developer (VWD) and MySQL. -5. The developer must have installed the Web Platform Installer (WPI). Follow the instructions at <link: [https://go.microsoft.com/fwlink/?LinkId=145510](https://go.microsoft.com/fwlink/?LinkId=145510) > - -## Step 1: Using WPI, install the WordPress application on your development machine - -As of the writing of this article a new version of Web Platform Installer is being released to the Web. Please visit [https://go.microsoft.com/fwlink/?LinkId=145510](https://go.microsoft.com/fwlink/?LinkId=145510) for more information. The set of applications include WordPress. - -## Step 2: Test the local WordPress Site and corresponding Database: - -Use IE to browse to the site: - -[![Screenshot of the Word Press Blog on Windows Internet Explorer.](verifying-the-developer-experience-php/_static/image3.jpg)](verifying-the-developer-experience-php/_static/image2.jpg) - -Now you are ready to publish the application. - -## Step 3: Use Visual Web Developer (VWD) to Modify and Publish Your Application - -1. Open your WordPress Site with VWD. The following dialog will display, press Yes. - - [![Screenshot of the dot NET Framework two dot zero Web Site Found dialog box. The Yes button is located at the bottom of the dialog box.](verifying-the-developer-experience-php/_static/image5.jpg)](verifying-the-developer-experience-php/_static/image4.jpg) - [![Screenshot of the Visual Web Developer two thousand eight Express Edition.](verifying-the-developer-experience-php/_static/image7.jpg)](verifying-the-developer-experience-php/_static/image6.jpg) -2. Modify the server name for the database and any other values provided by the hoster. - [![Screenshot of the database with values provided by the hoster. The server name is highlighted.](verifying-the-developer-experience-php/_static/image9.jpg)](verifying-the-developer-experience-php/_static/image8.jpg) -3. Open the menu Website and select "Copy Web Site": - - [![Screenshot of the database. The Website tab in the menu is selected. Copy Web Site is highlighted.](verifying-the-developer-experience-php/_static/image11.jpg)](verifying-the-developer-experience-php/_static/image10.jpg) - [![Screenshot of the Word Press Visual Web Developer two thousand and eight Express Edition Administrator page. A list of website names are shown.](verifying-the-developer-experience-php/_static/image13.jpg)](verifying-the-developer-experience-php/_static/image12.jpg) -4. Click Connect. Select FTP Site and enter the Server name, Port and user account credentials. Ensure that "Passive Mode" is checked and press Open: - - [![Screenshot of the Open Web Site dialog box. The Server name, Port, and User account credential boxes are shown. Passive mode is checked.](verifying-the-developer-experience-php/_static/image15.jpg)](verifying-the-developer-experience-php/_static/image14.jpg) -5. Proceed to publish the entire content to the target server. - -## Step 4: Deploy the WordPress MySQL Database Schema and Test Site. - -When WordPress runs for a first time it checks to see if the database schema is present, if it is not, it will allow the admin user to generate it. - -1. Using Internet Explorer browse to the new site, the following screen is displayed, enter the information requested: - - [![Screenshot of the Word Press website on Internet Explorer. The Blog Title and Email boxes are shown.](verifying-the-developer-experience-php/_static/image18.jpg)](verifying-the-developer-experience-php/_static/image17.jpg) -2. WordPress will auto-generate a random password for the admin user, make note of it and proceed to login: - [![Screenshot of the Word Press installation page. The text on the page says Success Word Press has been installed.](verifying-the-developer-experience-php/_static/image20.jpg)](verifying-the-developer-experience-php/_static/image19.jpg) -3. Enter the Admin credentials obtain in the previous step: - - [![Screenshot of the Word Press log in page. The Admin credentials have been inputted.](verifying-the-developer-experience-php/_static/image22.jpg)](verifying-the-developer-experience-php/_static/image21.jpg) -4. Now you can browse to the wp-admin page: - [![Screenshot of the Word press admin page. The Dashboard is shown.](verifying-the-developer-experience-php/_static/image24.jpg)](verifying-the-developer-experience-php/_static/image23.jpg) - -## Step 5: Use IIS Manager Remote Administration to change the WordPress Site Default Document List. - -1. Start IISMgr, if you are running Vista ensure that you are running the remote version of IISMgr: - - [![Screenshot of the WALTER O H P W S Home page. In the connections pane the Connect to a Site option is highlighted.](verifying-the-developer-experience-php/_static/image26.jpg)](verifying-the-developer-experience-php/_static/image25.jpg) -2. Connect to the Remote Site: - - [![Screenshot of the Connect to Site dialog box. The Server name box and the Site name box are shown.](verifying-the-developer-experience-php/_static/image28.jpg)](verifying-the-developer-experience-php/_static/image27.jpg) -3. Enter the Hoster provided user credentials: - - [![Screenshot of the Connect to Site dialog box. The username and password boxes are shown. The header text says Provide Credentials.](verifying-the-developer-experience-php/_static/image31.jpg)](verifying-the-developer-experience-php/_static/image30.jpg) -4. Assign a name to the new connection: - - [![Screenshot of the Connect to Site dialog box. The Connection Name box is shown. The text above it says Created a new connection successfully.](verifying-the-developer-experience-php/_static/image33.jpg)](verifying-the-developer-experience-php/_static/image32.jpg) -5. Install any IIS Manager extension modules that are offered in the following dialog: - - [![Screenshot of the New Feature Available dialog. The I I S Manager extension modules offered are shown in the box.](verifying-the-developer-experience-php/_static/image35.jpg)](verifying-the-developer-experience-php/_static/image34.jpg) -6. Select your new WordPress site, find the Default Document icon and double click on it: - - [![Screenshot of the Default Document page. The index dot p h p file is selected.](verifying-the-developer-experience-php/_static/image37.jpg)](verifying-the-developer-experience-php/_static/image36.jpg) -7. Select the index.php default document and move it up to the first place in the list. This will improve the performance. - - [![Screenshot of the Default Document page.The index dot p h p file is selected and has been moved to the top of the list of files.](verifying-the-developer-experience-php/_static/image39.jpg)](verifying-the-developer-experience-php/_static/image38.jpg) -8. WordPress deployment is complete. - -## Conclusion - -This walkthrough covered: - -1. Using Web Application Installer to install the WordPress PHP application in a developer machine. -2. Configuring the application to use MySQL and test it locally. -3. Using Visual Web Developer to modify and publish the application to the remote server. -4. Using IIS Manager Remote Administration feature to change the list of Default Documents for the site. diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image1.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image1.jpg deleted file mode 100644 index 08054436c..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image1.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image10.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image10.jpg deleted file mode 100644 index ef5ce2e29..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image10.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image11.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image11.jpg deleted file mode 100644 index ef5ce2e29..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image11.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image12.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image12.jpg deleted file mode 100644 index 2cfd2c365..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image12.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image13.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image13.jpg deleted file mode 100644 index 2cfd2c365..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image13.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image14.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image14.jpg deleted file mode 100644 index 29f0daf1a..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image14.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image15.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image15.jpg deleted file mode 100644 index 29f0daf1a..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image15.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image16.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image16.jpg deleted file mode 100644 index 2cfd2c365..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image16.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image17.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image17.jpg deleted file mode 100644 index 84564b761..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image17.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image18.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image18.jpg deleted file mode 100644 index 84564b761..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image18.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image19.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image19.jpg deleted file mode 100644 index 2a42c4991..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image19.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image2.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image2.jpg deleted file mode 100644 index 1465763cb..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image2.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image20.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image20.jpg deleted file mode 100644 index 2a42c4991..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image20.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image21.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image21.jpg deleted file mode 100644 index 45da890ea..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image21.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image22.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image22.jpg deleted file mode 100644 index 45da890ea..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image22.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image23.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image23.jpg deleted file mode 100644 index 420a64df1..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image23.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image24.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image24.jpg deleted file mode 100644 index 420a64df1..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image24.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image25.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image25.jpg deleted file mode 100644 index a2e38d65f..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image25.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image26.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image26.jpg deleted file mode 100644 index a2e38d65f..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image26.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image27.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image27.jpg deleted file mode 100644 index 9d58b2fb7..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image27.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image28.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image28.jpg deleted file mode 100644 index 9d58b2fb7..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image28.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image29.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image29.jpg deleted file mode 100644 index a2e38d65f..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image29.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image3.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image3.jpg deleted file mode 100644 index 1465763cb..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image3.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image30.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image30.jpg deleted file mode 100644 index 07cf2f559..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image30.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image31.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image31.jpg deleted file mode 100644 index 07cf2f559..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image31.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image32.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image32.jpg deleted file mode 100644 index a7b2a6ee7..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image32.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image33.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image33.jpg deleted file mode 100644 index a7b2a6ee7..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image33.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image34.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image34.jpg deleted file mode 100644 index 77d3b6cb4..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image34.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image35.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image35.jpg deleted file mode 100644 index 77d3b6cb4..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image35.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image36.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image36.jpg deleted file mode 100644 index 4d0897aca..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image36.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image37.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image37.jpg deleted file mode 100644 index 4d0897aca..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image37.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image38.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image38.jpg deleted file mode 100644 index 8f89ffe33..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image38.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image39.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image39.jpg deleted file mode 100644 index 8f89ffe33..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image39.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image4.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image4.jpg deleted file mode 100644 index 40a46b174..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image4.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image5.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image5.jpg deleted file mode 100644 index 40a46b174..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image5.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image6.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image6.jpg deleted file mode 100644 index 29204b57f..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image6.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image7.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image7.jpg deleted file mode 100644 index 29204b57f..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image7.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image8.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image8.jpg deleted file mode 100644 index 08054436c..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image8.jpg and /dev/null differ diff --git a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image9.jpg b/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image9.jpg deleted file mode 100644 index 08054436c..000000000 Binary files a/iis/web-hosting/verifying-the-deployment/verifying-the-developer-experience-php/_static/image9.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/administration-pack.md b/iis/web-hosting/web-server-for-shared-hosting/administration-pack.md index babbbd0fd..f43f2d21d 100644 --- a/iis/web-hosting/web-server-for-shared-hosting/administration-pack.md +++ b/iis/web-hosting/web-server-for-shared-hosting/administration-pack.md @@ -59,9 +59,7 @@ Some IIS configuration settings come in the form of a collection. This article & The FastCGI module lets you configure FastCGI settings that are used by Web sites on the server. It lets the user add and remove FastCGI applications and change these settings. The following image depicts the Add FastCGI Application dialog box. -[![Screenshot that shows the Fast C G I Settings pane. The Add Fast C G I Application dialog box is open.](administration-pack/_static/image6.jpg)](administration-pack/_static/image5.jpg) - -For a complete guide about hosting PHP applications with FastCGI, see this article <link: [https://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis-70/#Install\_Administration\_Pack\_for\_IIS\_7.0](https://www.iis.net/learn/application-frameworks/install-and-configure-php-applications-on-iis/using-fastcgi-to-host-php-applications-on-iis#Install_Administration_Pack_for_IIS_7.0) >. +[![Screenshot that shows the Fast C G I Settings pane. The Add Fast C G I Application dialog box is open.](administration-pack/_static/image6.jpg)](administration-pack/_static/image5.jpg) ### .NET Authorization Rules Module diff --git a/iis/web-hosting/web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration.md b/iis/web-hosting/web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration.md index bd37997e2..f373dcb72 100644 --- a/iis/web-hosting/web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration.md +++ b/iis/web-hosting/web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration.md @@ -4,7 +4,6 @@ author: walterov description: "IIS offers enhancements for dynamic content, especially ASP.NET. In IIS 7 and above, the ASP.NET runtime extensibility model is integrated into the core serv..." ms.date: 10/30/2007 ms.assetid: cf9bd511-eb48-49e1-83bb-2848794cc7a4 -ms.prod: iis msc.legacyurl: /learn/web-hosting/web-server-for-shared-hosting/aspnet-20-35-shared-hosting-configuration msc.type: authoredcontent --- diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md deleted file mode 100644 index aa6bb1a76..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: "Configuring IIS for Silverlight Applications" -author: walterov -description: "Introduction Microsoft® Silverlight TM is a cross-browser, cross-platform plug-in for delivering the next generation of .NET-based media experiences and rich..." -ms.date: 12/06/2007 -ms.assetid: b4e289bd-faa9-4bd1-91d1-0fbab5a721ff -msc.legacyurl: /learn/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications -msc.type: authoredcontent ---- -# Configuring IIS for Silverlight Applications - -by [Walter Oliver](https://github.com/walterov) - -## Introduction - -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 offers a flexible programming model that supports AJAX, VB, C#, Python, and Ruby, and integrates with existing Web applications. Silverlight supports fast, cost-effective delivery of high-quality video to all major browsers running on the Mac OS or Windows. - -In most cases, hosters do not need to perform particular deployments to support Silverlight. However, check for the following basic items that could prevent Silverlight from functioning correctly. - -## MIME Types - -### IIS in Windows Server 2008 - -All MIME types needed to support Silverlight are implemented by default in IIS 7 and above in Windows Server 2008 and Windows Vista SP1. Windows Vista customers can add MIME types by running IIS Manager, clicking **MIME Types**, then clicking **Add,** and then adding the following MIME types: - -- .xap application/x-silverlight-app -- .xaml application/xaml+xml -- .xbap application/x-ms-xbap - -[![Screenshot of the Edit MIME Type dialog box, showing application/x-silverlight-app in the M I M E Type field.](configuring-iis-for-silverlight-applications/_static/image2.jpg)](configuring-iis-for-silverlight-applications/_static/image1.jpg) - -Alternatively, you can add the following MIME types to your %*windir*%\system32\inetsrv\config\applicationHost.config file in the <staticContent> section. - -[!code-xml[Main](configuring-iis-for-silverlight-applications/samples/sample1.xml)] - -### In Windows Server 2003 IIS 6.0 - -To enable IIS 6.0 in Windows Server 2003 or IIS 7 in Windows Vista with the appropriate MIME Types, add: - -- .xap application/x-silverlight-app -- .xaml application/xaml+xml -- .xbap application/x-ms-xbap - -Here is a VBS script you could run to enable each of these types: - -[!code-vb[Main](configuring-iis-for-silverlight-applications/samples/sample2.vb)] - -If you copy and paste the code above into a VBS file and save it as ADDMIMETYPE.VBS, the syntax to add each type would be: - -[!code-console[Main](configuring-iis-for-silverlight-applications/samples/sample3.cmd)] - -[!code-console[Main](configuring-iis-for-silverlight-applications/samples/sample4.cmd)] - -[!code-console[Main](configuring-iis-for-silverlight-applications/samples/sample5.cmd)] - -### Using the IIS Manager User Interface in IIS 6.0 in Windows Server 2003 - -1. Go to Start\Administrative Tools and run IIS Manager. See the figure below: - [![Screenshot of the Windows Start menu's All Programs option leading to the Administrative Tools folder, then to the Internet Information Services (I I S) Manager application.](configuring-iis-for-silverlight-applications/_static/image4.jpg)](configuring-iis-for-silverlight-applications/_static/image3.jpg) -2. Right click on the server name and select **Properties.** See the figure below: - [![Screenshot of the right-click menu's Properties option being highlighted over the selected server's name.](configuring-iis-for-silverlight-applications/_static/image6.jpg)](configuring-iis-for-silverlight-applications/_static/image5.jpg) -3. In the **Properties** dialog box, click **MIME Types.** See the figure below: - [![Screenshot of the Properties dialog box, showing the M I M E types field.](configuring-iis-for-silverlight-applications/_static/image8.jpg)](configuring-iis-for-silverlight-applications/_static/image7.jpg) -4. In the **MIME Types** dialog box, click **New.** See the figure below: - [![Screenshot of the MIME Types dialog box, with a focus on the New option.](configuring-iis-for-silverlight-applications/_static/image10.jpg)](configuring-iis-for-silverlight-applications/_static/image9.jpg) -5. In the **MIME Types** dialog box, enter one of these MIME types: - - - .xap application/x-silverlight-app - - .xaml application/xaml+xml - - .xbap application/x-ms-xbap - - See the figure below: - - [![Screenshot of the MIME Types dialog box, showing the Extension and M I M E type fields.](configuring-iis-for-silverlight-applications/_static/image12.jpg)](configuring-iis-for-silverlight-applications/_static/image11.jpg) - -For detailed information on Silverlight, visit [here](https://www.microsoft.com/silverlight/). diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image1.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image1.jpg deleted file mode 100644 index 11bce7117..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image1.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image10.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image10.jpg deleted file mode 100644 index 1f822ee8c..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image10.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image11.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image11.jpg deleted file mode 100644 index b4a9b7190..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image11.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image12.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image12.jpg deleted file mode 100644 index b4a9b7190..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image12.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image2.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image2.jpg deleted file mode 100644 index 11bce7117..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image2.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image3.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image3.jpg deleted file mode 100644 index c76f184aa..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image3.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image4.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image4.jpg deleted file mode 100644 index c76f184aa..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image4.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image5.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image5.jpg deleted file mode 100644 index d912f41b8..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image5.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image6.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image6.jpg deleted file mode 100644 index d912f41b8..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image6.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image7.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image7.jpg deleted file mode 100644 index d89fe946d..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image7.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image8.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image8.jpg deleted file mode 100644 index d89fe946d..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image8.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image9.jpg b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image9.jpg deleted file mode 100644 index 1f822ee8c..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/_static/image9.jpg and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample1.xml b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample1.xml deleted file mode 100644 index 887d35223..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample1.xml +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample2.vb b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample2.vb deleted file mode 100644 index fbf05dc6c..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample2.vb +++ /dev/null @@ -1,25 +0,0 @@ -Const ADS_PROPERTY_UPDATE = 2 -' -if WScript.Arguments.Count < 2 then - WScript.Echo "Usage: " + WScript.ScriptName + " extension mimetype" - WScript.Quit -end if -' -'Get the mimemap object. -Set MimeMapObj = GetObject("IIS://LocalHost/MimeMap") -' -'Get the mappings from the MimeMap property. -aMimeMap = MimeMapObj.GetEx("MimeMap") -' -' Add a new mapping. -i = UBound(aMimeMap) + 1 -Redim Preserve aMimeMap(i) -Set aMimeMap(i) = CreateObject("MimeMap") -aMimeMap(i).Extension = WScript.Arguments(0) -aMimeMap(i).MimeType = WScript.Arguments(1) -MimeMapObj.PutEx ADS_PROPERTY_UPDATE, "MimeMap", aMimeMap -MimeMapObj.SetInfo -' -WScript.Echo "MimeMap successfully added: " -WScript.Echo " Extension: " + WScript.Arguments(0) -WScript.Echo " Type: " + WScript.Arguments(1) \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample3.cmd b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample3.cmd deleted file mode 100644 index 697058761..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -ADDMIMETYPE.VBS .xap application/x-silverlight-app \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample4.cmd b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample4.cmd deleted file mode 100644 index b427a7bcc..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -ADDMIMETYPE.VBS .xaml application/xaml+xml \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample5.cmd b/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample5.cmd deleted file mode 100644 index 276d9ca42..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/configuring-iis-for-silverlight-applications/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -ADDMIMETYPE.VBS .xbap application/x-ms-xbap \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php.md b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php.md deleted file mode 100644 index 6d90162ce..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: "FastCGI with PHP" -author: ruslany -description: "Overview The FastCGI support in IIS enables popular application frameworks that support FastCGI protocol to be hosted on the IIS web server in a high-perform..." -ms.date: 12/01/2007 -ms.assetid: b9580403-5f10-4397-a8d0-daa76abd8379 -msc.legacyurl: /learn/web-hosting/web-server-for-shared-hosting/fastcgi-with-php -msc.type: authoredcontent ---- -# FastCGI with PHP - -by [Ruslan Yakushev](https://github.com/ruslany) - -The FastCGI support in IIS enables popular application frameworks that support FastCGI protocol to be hosted on the IIS web server in a high-performance and reliable way. FastCGI provides a high-performance alternative to the Common Gateway Interface (CGI), a standard way of interfacing external applications with Web servers that has been supported as part of the IIS feature-set since the very first release. - -CGI programs are executables launched by the web server for each request in order to process the request and generate dynamic responses that are sent back to the client. Because many of these frameworks do not support multi-threaded execution, CGI enables them to execute reliably on IIS by executing exactly one request per process. Unfortunately, it provides poor performance due to the high cost of starting and shutting down a process for each request. - -FastCGI addresses the performance issues inherent to CGI by providing a mechanism to reuse a single process over and over again for many requests. Additionally, FastCGI maintains compatibility with non-thread-safe libraries by providing a pool of reusable processes and ensuring that each process will only handle one request at a time. - - - -## Enabling FastCGI Support in IIS 7.0 - -**To enable FastCGI on IIS 7.0** - -- Add CGI role service by going to Server Manager > Roles > Add Role Services. This enables both CGI and FastCGI services. - -![Screenshot of the Add Role Services Wizard. C G I is selected under Role Services.](fastcgi-with-php/_static/image3.png) - - - -## Install and Configure PHP - -It is recommended to use a non-thread safe build of PHP with IIS 7.0 FastCGI. Non-thread safe build of PHP provides significant performance gains over the standard build by not doing any thread-safety checks, which are not necessary, since FastCGI ensures a single threaded execution environment. - -> [!NOTE] -> There is no installer package for non-thread safe build of PHP. - -1. Download the latest non-thread safe binaries of PHP from . - -2. Unpack the files to a directory of your choice (e.g. `C:\PHP`). Rename the php.ini-recommended to php.ini. - -3. Open php.ini file, then uncomment and modify settings as follows: - - a. Set fastcgi.impersonate = 1. FastCGI under IIS supports the ability to impersonate security tokens of the calling client. This allows IIS to define the security context that the request runs under. - - b. Set cgi.fix\_pathinfo=1. cgi.fix\_pathinfo provides \*real\* PATH\_INFO/PATH\_TRANSLATED support for CGI. PHP's previous behavior was to set PATH\_TRANSLATED to SCRIPT\_FILENAME, and to not care what PATH\_INFO is. For more information on PATH\_INFO, see the cgi specs. Setting this to 1 will cause PHP CGI to fix it's paths to conform to the spec - - c. Set cgi.force\_redirect = 0. - - d. Set open\_basedir to point to a folder or network path where the content of the web site(s) is located. - -4. To test if the PHP installation is successful, run the following from the command line prompt: - - [!code-console[Main](fastcgi-with-php/samples/sample1.cmd)] - -If PHP was installed correctly and all its dependencies are available on the machine, then this command will output the current PHP configuration information. - - - -## Configure IIS 7.0 to Handle PHP Requests - -In order for IIS 7.0 to host PHP applications, it is necessary to add a handler mapping that tells IIS to pass all requests for PHP files to PHP application framework via FastCGI protocol. - -### To add a handler mapping at a server level - -1. Open IIS Manager and then select and open "Handler Mappings" at the server level: - - ![Screenshot of the W I N two K eight Home page. The Handler Mappings icon is selected.](fastcgi-with-php/_static/image7.png) - -2. Select "Add Module Mapping" action and specify the configurations settings as below: - - ![Screenshot of the Add Module Mapping dialog box. The configuration settings are shown.](fastcgi-with-php/_static/image9.png) - - - Request path: **\*.php** - - Module: **FastCgiModule** - - Executable: `C:\[Path to your PHP installation]\php-cgi.exe` - - Name: **PHP via FastCGI** - -3. Click OK. The dialog box appears asking if you want to create a FastCGI application for this executable. Click Yes. - -4. Test that the handler mapping works correctly by creating a phpinfo.php file in the `C:\inetpub\wwwroot` folder that contains the following: -`.` - -5. Open a browser and navigate to `http://localhost/phpinfo.php`. If everything was setup correctly, then you see the standard PHP information page. - -Alternatively, the above mentioned steps can be completed by using command line tool appcmd. - -1. To create the FastCGI application process pool, run the following command: - - [!code-console[Main](fastcgi-with-php/samples/sample2.cmd)] - -2. After that, create the handler mapping: - - [!code-console[Main](fastcgi-with-php/samples/sample3.cmd)] - -> [!NOTE] -> If you are using a PHP version 4.X, instead of php-cgi.exe, you can use php.exe. - - - -## Best Practices for Configuring FastCGI and PHP - -### Security Isolation for PHP Web Sites - -The recommendation for isolating PHP web sites in a shared hosting environment is consistent with all general security isolation recommendations for IIS 7.0. In particular, it is recommended to: - -- Use one application pool per web site -- Use user account as an identity for application pool -- Configure anonymous user identity to use the application pool identity -- Ensure that FastCGI impersonation is enabled in php.ini file (fastcgi.impersonate=1) - -For more details about security isolation in shared hosting environment, refer to [Isolating Sites with Application Pools](../../manage/creating-websites/provisioning-iis-7-sites-for-shared-hosting.md#Isolating "Isolating Sites with Application Pools"). - -### PHP Process Recycling Behavior - -Make sure that FastCGI always recycles php-cgi.exe processes before the native PHP recycling kicks in. The FastCGI process recycling behavior is controlled by the configuration property instanceMaxRequests. This property specifies how many requests FastCGI process will process before recycling. PHP also has a similar process recycling functionality that is controlled by an environment variable PHP\_FCGI\_MAX\_REQUESTS. By setting instanceMaxRequests to be smaller or equal to PHP\_FCGI\_MAX\_REQUESTS, you can ensure that native PHP process recycling logic will never kick in. - -To set these configuration properties use the following commands: - -[!code-console[Main](fastcgi-with-php/samples/sample4.cmd)] - -[!code-console[Main](fastcgi-with-php/samples/sample5.cmd)] - -> [!NOTE] -> If those parameters have not been set, then the following default settings are used: instanceMaxRequests = 200, PHP\_FCGI\_MAX\_REQUESTS = 500 (on most PHP builds). - -### PHP Versioning - -Many PHP applications may rely on functions or features available only in certain versions of PHP. - -It is a common requirement in a shared hosting environment to support multiple versions of PHP on the same server. IIS 7.0 FastCGI handler fully supports running multiple versions of PHP on the same web server. For example, let's assume that on your web server you plan to support PHP 4.4.8, PHP 5.2.1 and PHP 5.2.5 non-thread safe. To enable that, you must place corresponding PHP binaries in separate folders on files system (e.g. `C:\php448\`, `C:\php521\` and `C:\php525nts`) and then create the FastCGI application process pools for each version: - -[!code-console[Main](fastcgi-with-php/samples/sample6.cmd)] - -Now, if you have 3 web sites (site1, site2, site3), where each site needs to use a different PHP version, you can define handler mappings on each of those sites to reference a corresponding FastCGI application process pool. - -> [!NOTE] -> Each FastCGI process pool is uniquely identified by a combination of fullPath and arguments properties. - -[!code-console[Main](fastcgi-with-php/samples/sample7.cmd)] - -### PHP Security Recommendations - -The following recommendations describe how to tighten security of PHP in shared hosting environment. To make the recommended changes locate and open php.ini file and edit it as described below: - -1. Disable remote URL's for file handling functions: - - - Set allow\_url\_fopen=Off - - Set allow\_url\_include=Off -2. Disable register\_globals: - - - register\_globals=Off -3. Restrict where PHP can read and write on a file system, e.g.: - - - open\_basedir="c:\inetpub\" -4. Disable safe mode: - - - safe\_mode=Off - - safe\_mode\_gid=Off -5. Limit script execution time: - - - max\_execution\_time=30 - - max\_input\_time=60 -6. Limit memory usage and file sizes: - - - memory\_limit=16M - - upload\_max\_filesize=2M - - post\_max\_size=8M - - max\_input\_nesting\_levels=64 -7. Configure error messages and logging: - - - display\_errors=Off - - log\_errors=On - - error\_log="C:\path\of\your\choice" -8. Hide presence of PHP: - - - expose\_php=Off - - - -## Enabling per-site PHP configuration - -Very often it may be necessary to allow customers to override the PHP configuration values specified in php.ini. For example, if customer installs a popular PHP application then this application may require certain PHP settings to be modified in order to function correctly. The section describes the recommended way of enabling per-site PHP configuration . Note that this recommendation was discovered and validated by Radney Jasmin with hosting provider [GoDaddy.com](http://www.godaddy.com/) who now offers PHP hosting on Windows Server 2008 via FastCGI. - -### Per-site PHP process pools - -When each web site has its own application pool (which is a recommended practice for shared hosting on IIS 7.0), it is possible to associate a dedicated FastCGI process pool with each web site. A FastCGI process pool is uniquely identified by the combination of **fullPath** and **arguments** attributes. So, if it is necessary to create several FastCGI process pools for the same process executable, such as php-cgi.exe, the **arguments** attribute can be used to make process pools unique. In addition, with php-cgi.exe processes the command line switch "-d" can be used to define an INI entry for PHP process. This switch can be used to set some fake PHP setting that makes the arguments string unique. - -For example, if there are two web sites "website1" and "website2" that need to have their own set of PHP settings, the FastCGI process pools can be defined as follows: - -[!code-xml[Main](fastcgi-with-php/samples/sample8.xml)] - -Then website1 can have the PHP handler mapping as follows: - -[!code-xml[Main](fastcgi-with-php/samples/sample9.xml)] - -and website2 can have the PHP handler mapping as follows: - -[!code-xml[Main](fastcgi-with-php/samples/sample10.xml)] - -### Specifying php.ini location - -When PHP process starts it determines the location of configuration php.ini file by using various settings. [The PHP documentation](http://www.php.net/manual/en/configuration.php) provides detailed description of the PHP start up process. Note that one of the places where PHP process searches for php.ini location is the PHPRC environment variable. If PHP process finds a php.ini file in the path specified in this environment variable then it will use it, otherwise it will revert to default location of php.ini. This environment variable can be used to allow hosting customers to use their own versions of php.ini files. - -For example if there are two websites: website1 and website2; located at the following file paths: `C:\WebSites\website1` and `C:\WebSites\website2` then the php-cgi.exe process pools in `` section of applicationHost.config can be configured as below: - -[!code-xml[Main](fastcgi-with-php/samples/sample11.xml)] - -This way owner of website1 can place their own version of php.ini into the `C:\WebSites\website1`, while the owner of website2 can use their own version of php.ini located in `C:\WebSites\website2`. This configuration also ensures that if there is no php.ini found in location specified by PHPRC environment variable then PHP will fall back to using the default php.ini file located in the same folder where php-cgi.exe is located. - - - -## Providing URL rewriting functionality for PHP applications - -Majority of popular PHP applications rely on the URL rewriting functionality in web servers to enable user friendly and search engine friendly URL's. IIS7 will provide URL rewriting capabilities via [URL rewrite module](../../extensions/url-rewrite-module/using-the-url-rewrite-module.md "URL rewrite module"), which is currently available as a [technical preview](https://www.iis.net/downloads/microsoft/url-rewrite "URL Rewrite TP"), There is no URL rewriting support provided for IIS versions earlier than 7.0 so the most commonly used options today for enabling URL rewriting on IIS 5.0, IIS 5.1 and IIS 6.0 are the following products: - -- [ISAPI\_Rewrite](https://www.iis.net/downloads?tabid=34&g=6&i=1599 "ISAPI_Rewrite download") developed by [Helicon Tech](http://www.helicontech.com/ "Helicon Tech"). ISAPI\_Rewrite is a flexible, rule-base URL manipulation mechanism for IIS that closely matches the functionality and feature set of Apache mod\_rewrite. In fact, the latest version of ISAPI\_Rewrite is fully compatible with Apache mod\_rewrite syntax, which means that rewrite rules in .htaccess files, which are included with or generated by PHP applications, will work with ISAPI\_Rewrite without any modifications. -- [Ionics Isapi Rewrite Filter](http://www.codeplex.com/IIRF "IIRF") (IIRF), is an open source URL rewriting ISAPI filter that is easy to use and has a set of good features. It works on IIS 5.0, 5.1, 6.0, and 7.0. You can download the binaries as well as source code for the IIRF from the [codeplex](http://www.codeplex.com/IIRF "Codeplex project"). diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image1.png b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image1.png deleted file mode 100644 index 6e55bce10..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image1.png and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image3.png b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image3.png deleted file mode 100644 index 1633432a7..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image3.png and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image7.png b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image7.png deleted file mode 100644 index 43a70e680..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image7.png and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image9.png b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image9.png deleted file mode 100644 index 6e55bce10..000000000 Binary files a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/_static/image9.png and /dev/null differ diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample1.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample1.cmd deleted file mode 100644 index 91d448c70..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample1.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\PHP>php –info \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample10.xml b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample10.xml deleted file mode 100644 index 784d9a782..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample10.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample11.xml b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample11.xml deleted file mode 100644 index 259fcf631..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample11.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample2.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample2.cmd deleted file mode 100644 index e82b6d26e..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample2.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\{php_folder}\php-cgi.exe'] \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample3.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample3.cmd deleted file mode 100644 index 68ee40bb4..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample3.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers /+[name='PHP_via_FastCGI',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='c:\{php_folder}\php-cgi.exe',resourceType='Either'] \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample4.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample4.cmd deleted file mode 100644 index 5c083bfb4..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample4.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='c:\{php_folder}\php-cgi.exe'].instanceMaxRequests:10000 \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample5.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample5.cmd deleted file mode 100644 index e76e6831d..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample5.cmd +++ /dev/null @@ -1 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /+[fullPath='c:\{php_folder}\php-cgi.exe'].environmentVariables.[name=’PHP_FCGI_MAX_REQUESTS’, value='10000'] \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample6.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample6.cmd deleted file mode 100644 index 49757df97..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample6.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php448\php.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php521\php-cgi.exe'] - -C:\>%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='c:\php525nts\php-cgi.exe'] \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample7.cmd b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample7.cmd deleted file mode 100644 index 35360f672..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample7.cmd +++ /dev/null @@ -1,5 +0,0 @@ -C:\>%windir%\system32\inetsrv\appcmd set config site1 –section:system.webServer/handlers /+"..[name=’PHP448_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php448\php.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site2 –section:system.webServer/handlers /+"..[name=’PHP521_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php521\php-cgi.exe’,resourceType=’Either’] - -C:\>%windir%\system32\inetsrv\appcmd set config site3 –section:system.webServer/handlers /+"..[name=’PHP525nts_via_FastCGI’,path=’*.php’,verb=’*’,modules=’FastCgiModule’,scriptProcessor=’c:\php525nts\php-cgi.exe’,resourceType=’Either’] \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample8.xml b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample8.xml deleted file mode 100644 index 73012290e..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample8.xml +++ /dev/null @@ -1,4 +0,0 @@ - - - - \ No newline at end of file diff --git a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample9.xml b/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample9.xml deleted file mode 100644 index 1633336cf..000000000 --- a/iis/web-hosting/web-server-for-shared-hosting/fastcgi-with-php/samples/sample9.xml +++ /dev/null @@ -1,5 +0,0 @@ - - - - - \ No newline at end of file diff --git a/iis/wmi-provider/directorybrowsesection-class.md b/iis/wmi-provider/directorybrowsesection-class.md index 7668f455b..5927fdf46 100644 --- a/iis/wmi-provider/directorybrowsesection-class.md +++ b/iis/wmi-provider/directorybrowsesection-class.md @@ -41,7 +41,7 @@ class DirectoryBrowseSection : ConfigurationSection ## Remarks If directory browsing is enabled for a directory in IIS, users receive a page that lists the contents of the directory when the following are true: -- The user does not specify a file in the URL (for example, the user goes to http://www.contoso.com/ instead of http://www.contoso.com/default.htm). +- The user does not specify a file in the URL (for example, the user goes to ```http://www.contoso.com/``` instead of ```http://www.contoso.com/default.htm)```.) - Default documents are disabled in IIS, or IIS is unable to locate a file in the directory that matches a name specified in the IIS default document list.