(:groupheader:)>>recipeinfo<< Summary: Install PmWiki on Windows Home Server and IIS6 Version: 2009-12-20 Prerequisites: See [[#prerequisites|below]] Status: Living document Maintainer: [[~skiwi]] Categories: [[!Administration]] [[!Install]] [[!System tools]] (:if exists {$Name}-Talk:)Discussion: [[{$Name}-Talk]](:ifend:) >><< !! Questions answered by this recipe <:vspace> %comment% This section is optional; use it to indicate the types of questions (if any) this recipe is intended to answer. <:vspace> <:vspace> !! Description (:Description Hosting your PmWiki website on %newwin%[[http://www.microsoft.com/windows/products/winfamily/windowshomeserver/default.mspx|Windows Home Server]]:){$Description}. <:vspace> <:vspace> [[#prerequisites]] !! Prerequisites * change WHS to have a fixed IP address * create shared folders on WHS for your website data * if your website is external ** ensure your domain name is registered to your external static IP address ** ensure your router is configured to forward traffic on port 80 to your WHS machine <:vspace> !! Instructions Use the [[http://www.microsoft.com/Web/|Microsoft Web platform installer]] * install [[http://www.iis.net/extensions/FastCGI|Fast CGI for IIS6]] * install [[http://www.microsoft.com/web/platform/phponwindows.aspx|PHP]] <:vspace> <:vspace> Create a shared folders on WHS, -> eg @@\\Home-server\home\mywebsite\@@ * install or copy your PmWiki website to (say) -> eg @@\\Home-server\home\mywebsite\public_html\pmwiki\@@ [-Note: physically this is a directory such as @@D:\shares\home\mywebsite\@@.-] <:vspace> %rfloat width=300%Attach:IISExecutePermissions.jpeg !!! IIS configuration Configure IIS according to Cookbook:InstallOnIIS * ensure that on the HomeDirectory tab execute permissions are set to scripts and executables <:vspace> !!! File Permissions Ensure the "Internet Guest Account" (@@IUSR_SERVERNAME@@) permissions are set for the folder in which your @@pmwiki.php@@ or @@index.php@@ resides. The defaults values of "Read & Execute, List Contents, Read" are sufficient. <:vspace> For the folder @@wiki.d@@ add to the "Internet Guest Account" (@@IUSR_SERVERNAME@@) permissions "Modify, Write". <:vspace> If you wish to [[PmWiki/UploadsAdmin|enable uploads]] add the "Internet Guest Account" (@@IUSR_SERVERNAME@@) permissions "Modify, Write" to the folder @@uploads@@. <:vspace> <:vspace> <:vspace> [[#notes]] !!! Notes If you copied your PmWiki site from elsewhere you may have to delete the @@.flock@@ file in the @@wiki.d@@ directory. <:vspace> To increase the file upload size above 4MB ensure that * you have set $UploadExtSize for the extensions required (eg @@ $UploadExtSize['jpeg'] = 6000000; # limit .jpeg files to 6MB@@) * edit the file @@C:\windows\sytem32\inetserv\metabase.xml@@ and increase the value of @@AspBufferingLimit@@, eg @@AspBufferingLimit="10485760"@@ to set to 10MB. ** to save file user @@iisreset /stop@@ from the command line, then save file, then @@iisreset /start@@,[[<]]or in IIS, right click the name of the server and select properties, check "Enable Direct Metabase Edit". <:vspace> <:vspace> [[#relnotes]] !! Release notes <:vspace> %comment% If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers". <:vspace> [[#seealso]] !! See also * install [[Cookbook:PHP]] {Cookbook/PHP$:Summary} * [[PmWiki/installation]] {PmWiki.Installation$:Summary} * [[Cookbook:InstallOnIIS]] {Cookbook.InstallOnIIS$:Summary} <:vspace> <:vspace> [[#contributors]] !! Contributors <:vspace> <:vspace> [[#comments]] !! Comments >>comment<< This space is for User-contributed commentary and notes. Please include your name and a date (eg 2007-05-19) along with your comment. Optional alternative: create a new page with a name like "ThisRecipe-Talk" (e.g. PmCalendar-Talk). >><< (:if exists {$Name}-Talk:)See discussion at [[{$Name}-Talk]](:ifend:) >>faq display=none<< <:vspace> Q: A: (:groupfooter:) <:block>