Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Difference between revisions of "Installing on Microsoft IIS"

m (added Japanese interlanguage link)
m (grammar, typo, punctuation)
 
(26 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
{{ja|Microsoft IIS サーバーへのインストール}}
 
{{ja|Microsoft IIS サーバーへのインストール}}
 
}}
 
}}
==Install Internet Information Services 7.0 and WordPress 3.x by Using the Microsoft Web Platform Installer 3.0==
+
==Install Internet Information Services 8.5 and WordPress 3.x by Using the Microsoft Web Platform Installer 5.0==
   
  +
NOTE: As of 12.02.2020. Microsoft WPI (5.1) does not install PHP support correctly on Windows 10, thus the WordPress installation fails.
This article describes how to install and configure WordPress 3.x on Windows Server 2008 R2 by using the Microsoft Web Platform Installer (Web PI) version 3.0. As of May 17, 2011, the latest version of WordPress is 3.1.2.
 
   
 
This article describes how to install and configure WordPress 3.x on Windows clients and servers (see Prerequisites) using the Microsoft Web Platform Installer (Web PI) version 5.0. As of May 28, 2014, the latest version of WordPress is 3.9.1.
The Web PI is a free tool that makes getting the latest components of the Microsoft Web Platform—including Internet Information Services (IIS), MySQL, the Microsoft .NET Framework, and Visual Web Developer—quick and easy. The Web PI also lets you install web applications such as WordPress with the built-in [http://www.microsoft.com/web/gallery/ Windows Web App Gallery].
 
   
 
The Web PI is a free tool that makes getting the latest components of the Microsoft Web Platform—including Internet Information Services (IIS), MySQL, PHP, the Microsoft .NET Framework, and Visual Web Developer—quick and easy. The Web PI also lets you install web applications such as WordPress with the built-in [http://www.microsoft.com/web/gallery/ Windows Web App Gallery].
To install WordPress on IIS 7.0 by using the Web PI 3.0, follow these steps:
 
   
 
To install WordPress on IIS 8.5 by using the Web PI 5.0, follow these steps:
[[Installing_on_Microsoft#Prerequisites|Prequisites]]
 
   
[[Installing_on_Microsoft#Step 1. Install the Web Platform Installer 3.0|Step 1. Install the Web Platform Installer 3.0]]
+
[[Installing_on_Microsoft#Prerequisites|Prerequisites]]
  +
  +
[[Installing_on_Microsoft#Step 1. Install Microsoft Web Platform Installer 5.0|Step 1. Install Microsoft Web Platform Installer 5.0]]
   
 
[[Installing_on_Microsoft#Step 2. Select the products and applications to install|Step 2. Select the products and applications to install]]
 
[[Installing_on_Microsoft#Step 2. Select the products and applications to install|Step 2. Select the products and applications to install]]
Line 22: Line 24:
   
 
[[Installing_on_Microsoft#Step 5. Enable clean URLs (Pretty Permalinks)|Step 5. Enable clean URLs (Pretty Permalinks)]]
 
[[Installing_on_Microsoft#Step 5. Enable clean URLs (Pretty Permalinks)|Step 5. Enable clean URLs (Pretty Permalinks)]]
  +
  +
[[Installing_on_Microsoft#Step 6. Running Microsoft WebMatrix with WordPress|Step 6. Running Microsoft WebMatrix with WordPress]]
   
 
==Prerequisites==
 
==Prerequisites==
   
The supported operating systems for the Web PI 3.0 are Windows 7, Windows Vista Service Pack 1 (SP1), Windows Vista, Windows XP Service Pack 2 (SP2) and later versions, Windows Server 2008 R2, Windows Server 2008, and Windows Server 2003 Service Pack 1 (SP1) and later versions.
+
The supported operating systems for the Microsoft Web Platform Installer (Web PI) 5.0 are Windows 8.1, Windows 8, Windows 7, Windows Vista Service Pack 1 (SP1), Windows Vista, Windows XP Service Pack 2 (SP2), and later versions, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, and Windows Server 2003 Service Pack 1 (SP1) and later versions.
   
For this guide, it is assumed that you have Windows Server 2008 R2 installed on your computer. You will also need an Internet connection and administrator privileges for your computer.
+
For this guide, it is assumed that you have either Windows Server 2012 R2 or Windows 8.1 Pro client installed on your computer. You will also need an Internet connection and administrator privileges for your computer.
   
It is a good idea to confirm that your system meets the hardware requirements for IIS 7.0. See http://technet.microsoft.com/en-us/library/cc268240.aspx for more information.
+
It is a good idea to confirm that your system meets the hardware requirements for IIS 8.5. See http://technet.microsoft.com/en-us/library/dn303418.aspx for more information.
   
==Step 1. Install the Web Platform Installer 3.0==
+
==Step 1. Install Microsoft Web Platform Installer 5.0==
   
In this step, you begin to install the Web PI 3.0, which is a 1.3 MB download.
+
In this step, you download, install, and launch the MS Web Platform Installer (Web PI 5.0, which is a 1.4 MB download).
   
# Log on to Windows Server 2008 R2 as a user who has administrative privileges.
+
# Log into your Windows machine as a user with administrative privileges.
# Start Windows Internet Explorer.
+
# Launch Internet Explorer (other browsers work too).
# Go to http://www.microsoft.com/web/downloads/platform.aspx, and then click '''Download It Now'''.<br/>[[Image:Microsoft_Web_Platform_Installer_3.0_webpage.png|Microsoft Web Platform Installer 3.0 webpage]]
+
# Go to http://www.microsoft.com/web/downloads/platform.aspx, and then click the '''Free Download''' button.<br/>[[Image:Microsoft_Web_Platform_install_5-0_WebPage.png|Microsoft Web Platform Installer 5.0 webpage]]
 
# Click '''Run'''.<br/>[[Image:File_Download_Security_Warning_1.png|File download security warning]]
 
# Click '''Run'''.<br/>[[Image:File_Download_Security_Warning_1.png|File download security warning]]
 
# Click '''Run''' again.<br/>[[Image:Internet_Explorer_Security_Warning_2.png|Internet Explorer security warning]]
 
# Click '''Run''' again.<br/>[[Image:Internet_Explorer_Security_Warning_2.png|Internet Explorer security warning]]
# Wait a few seconds for the Web PI 3.0 to start.
+
# Wait a few seconds for the Web PI 5.0 to start.
   
 
==Step 2. Select the products and applications to install==
 
==Step 2. Select the products and applications to install==
   
In this step, you select the version of WordPress that you want to install. WordPress 3.0.3 is used in this guide.
+
In this step, you select the version of WordPress that you want to install. WordPress 3.9.1 is used in this guide.
   
  +
# On the "Web Platform Installer" start screen click the <b>Applications</b> tab, and then click the <b>Add</b> button associated to the right with "WordPress".<br/>[[Image:WebPI_Installing_WordPress_Step1.png|List of apps on WebPI]]
# Next to '''WordPress''', click '''Add'''.<br/>'''Note:''' If WordPress is not in the items list, click '''Applications''' in the left navigation pane.<br/>[[Image:Application_selection.png|Application selection]]
 
# Click '''Install'''.<br/>[[Image:Application_selection_2.png|Application selection (continued)]]
+
# Click '''Install'''.<br/>[[Image:WebPI_Installing_WordPress_Step2.png|Select WordPress on WebPI]]
   
 
==Step 3. Review and configure the selected products and applications==
 
==Step 3. Review and configure the selected products and applications==
   
In this step, you review and configure what you have added. Additionally, you add the database, name the MySQL database, and name the WordPress 3.x site.
+
In this step, you review and configure what you have added. Additionally, you add the database and configure the password for it.
   
# When you are asked which type of database you want to use, leave '''MySQL''' selected.<br/>'''Note:''' This will install MySQL 5.1 for Windows to handle all the database transactions that are required by WordPress.
+
# When you are asked which type of database you want to use, leave '''MySQL (Not installed)''' selected.<br/>'''Note:''' This will install MySQL 5.1 for Windows to handle all the database transactions that are required by WordPress.
# In the list, select '''Install it on my machine''', and then click '''Continue'''.<br/>[[Image:Database_engine_selection.png|Database engine selection]]
+
# In password fields, type in a password for your database, and then click '''Continue'''.<br/>[[Image:WebPI_Installing_WordPress_Step3.png|Database engine configuration]]
 
# Review the files to be downloaded and installed, as well as the license agreements, and then click '''I Accept'''.<br/>[[Image:WebPI_Installing_WordPress_Step4.png|Application installation summary]]
# Scroll down to confirm that all the following items have been automatically included as dependencies:
 
  +
# Allow the Web PI installation to complete.<br/>[[Image:WebPI_Installing_WordPress_Step5.png|WordPress Installation process]]
#* IIS 7.0
 
  +
# Configure Security Keys.<br/>The WordPress [[Editing_wp-config.php#Security_Keys|Security Keys]] section describes what these keys are and how they're used.<br/>[[Image:WebPI5_Installing_WordPress_Step6.png|Configure Security Keys]]<br/>The keys don't need to be remembered, they should just be long, random, and complicated. An easy way to generate the keys is to use the [https://api.wordpress.org/secret-key/1.1/salt/ online key generator]. Each time you click browser refresh, the [https://api.wordpress.org/secret-key/1.1/salt/ online key generator] creates a new set of keys.<br/> <br/><i>Note:</i> The [https://api.wordpress.org/secret-key/1.1/salt/ online key generator] produces keys that may contain dollar signs ('$') which cannot be used with keys entered into Web-PI. Until this Web-PI issue is resolved, a simple solution is to check for dollar sign characters and simply replace '$' with 'S' (any alpha character will work).<br/> <br/>Here's an example set of keys - <i>don't use these, use the [https://api.wordpress.org/secret-key/1.1/salt/ online key generator] to create your own unique keys!</i><br/>[[Image:WebPI5_Step5B_Example-Security-Keys.png|Example Security Keys]]
#* PHP 5.3.5
 
  +
# Finish.<br/>On the FINISH dialog click the <b>copy to clipboard</b> link (this copies your database settings and password to the clipboard), paste and save this information in a file for future reference, and then click the <b>Finish</b> button.<br/>[[Image:WebPI5_Installing_WordPress_Step7.png|Installation completed]]
#* IIS URL Rewrite 2.0
 
  +
# Microsoft WebMatrix will open, allowing you to configure additional settings related to your WordPress site:[[Image:WebPI_Installing_WordPress_WebMatrixSite.png|WebMatrix summary screen]]
#* Windows Cache Extension 1.1 for PHP 5.3
 
#* MySQL 5.1 for Windows<br/>'''Note:''' Windows Cache Extension is used to increase the speed of PHP applications that are running on your web host. IIS URL Rewrite allows “Pretty Permalinks” to be enabled for WordPress.
 
# Review the files to be downloaded and installed, as well as the license agreements, and then click '''I Accept'''.<br/>[[Image:Application_installation_summary.png|Application installation summary]]
 
# Specify a password for the MySQL administrator user name (root), and then click '''Continue'''.<br/>'''Note:''' It is important to remember this password because you will be asked for this password in the steps that follow.<br/>[[Image:MySQL_root_password_setup.png|MySQL root password setup]]
 
# Allow the Web PI installation to complete.
 
# In the '''Web Site''' box, leave '''Default Web Site''' selected.
 
# In the ''''WordPress' application name''' box, type a name for the WordPress 3.x site, and then click '''Continue'''. For example, type '''myWordPress'''.<br/>[[Image:Site_information.png|Site information]]
 
# Leave '''Create new database''' selected.
 
# Type the database administrator user name (root) and password.<br/>'''Note:''' This account is used to create and manage the database that is needed for WordPress.<br/>[[Image:Application_configuration.png|Application configuration]]
 
# Type the database user name.<br/>'''Note''' WordPress will use this account to access and write to the database as needed.
 
# Type the password for the database user name.
 
# Leave the default database server name, '''localhost'''.<br/>[[Image:Application_configuration_continued.png|Application configuration (continued)]]
 
# You may customize the name of the WordPress database as desired.
 
# Use the WordPress key generator at http://api.wordpress.org/secret-key/1.1/ to generate four unique keys, and then copy the keys into the following fields:
 
#* '''Unique Key for Passwords'''
 
#* '''Unique Key for Secure Passwords'''
 
#* '''Unique Key for Authentication'''
 
#* '''Second Unique Key for Authentication'''<br/>'''Note:''' You will not be required to recall these keys later.
 
# Click '''Continue'''.<br/>[[Image:Application_configuration_continued_2.png|Application configuration (continued)]]
 
# Click '''Finish'''.<br/>[[Image:Installation_completed.png|Installation completed]]
 
# Click '''Exit''' to close the Web PI 3.0.
 
   
 
==Step 4. Complete the installation and configuration==
 
==Step 4. Complete the installation and configuration==
Line 101: Line 85:
 
# Scroll down, and then click '''Permalinks'''.<br/>[[Image:Settings.png|Settings]]
 
# Scroll down, and then click '''Permalinks'''.<br/>[[Image:Settings.png|Settings]]
 
# Under '''Common settings''', select a common Permalink setting or select '''Custom Structure''' to create your own Permalink, and then click '''Save Changes'''.<br/>[[Image:Permalink_settings.png|Permalink settings]]
 
# Under '''Common settings''', select a common Permalink setting or select '''Custom Structure''' to create your own Permalink, and then click '''Save Changes'''.<br/>[[Image:Permalink_settings.png|Permalink settings]]
  +
<!-- START COMMENT --------------------------------------------------
  +
Jack.Davis: The following sections do not appear to be relevant with the current Microsoft Web Platform Installer (Web PI) 5.0 install (was possibly needed with prior versions?). It's not even clear in the following section-title what "Click in the gray text field" means (what "gray text field"?). The following sections seem to describe how to create a web.config file. With Web PI 5.0 a working web.config file is provided. Unless there's some specific use and further detail for what this is all about, I'm commenting these sections out for now.
  +
PS: IMHO, this entire section would better simply as links to the existing [[Settings_Permalinks_Screen]] and [[Using_Permalinks]] pages (don't duplicate).
  +
----
 
# Click in the gray text field, press '''CTRL + A''', and then press '''CTRL + C'''.<br/>[[Image:Web.config_file_contents.png|Web.config file contents]]
 
# Click in the gray text field, press '''CTRL + A''', and then press '''CTRL + C'''.<br/>[[Image:Web.config_file_contents.png|Web.config file contents]]
 
# Start Notepad as an administrator. To do this, click '''Start''', type '''notepad''' in the search box, right-click '''Notepad''' in the list of results, and then click '''Run as administrator'''.<br/>[[Image:Start_menu.png|Start menu]]<br/>[[Image:Run_as_administrator_command.png|Run as administrator command]]
 
# Start Notepad as an administrator. To do this, click '''Start''', type '''notepad''' in the search box, right-click '''Notepad''' in the list of results, and then click '''Run as administrator'''.<br/>[[Image:Start_menu.png|Start menu]]<br/>[[Image:Run_as_administrator_command.png|Run as administrator command]]
Line 110: Line 98:
 
# In the '''Save as type''' box, click '''All Files'''.
 
# In the '''Save as type''' box, click '''All Files'''.
 
# Click '''Save''', and then close Notepad.<br/>[[Image:Save_As_dialog_box.png|Save As dialog box]]
 
# Click '''Save''', and then close Notepad.<br/>[[Image:Save_As_dialog_box.png|Save As dialog box]]
  +
--- END COMMENT ---------------------------------------------------------- -->
   
 
The installation is now complete, and you are ready to use WordPress!
 
The installation is now complete, and you are ready to use WordPress!
  +
  +
==Step 6. Running Microsoft WebMatrix with WordPress==
  +
  +
The Microsoft Web Platform Installer (Web PI) installs WordPress to run in a localhost configuration in combination with Microsoft WebMatrix (which was also installed as part of the Web PI installation). When WebMatrix is not running (e.g., after a reboot or if you terminate WebMatrix) you will not be able to access your localhost WordPress site until WebMatrix is restarted. Use the following steps to start WebMatrix and launch your localhost WordPress site.
  +
  +
# Click '''Start''', click '''All Programs''', click-open the '''Microsoft WebMatrix''' folder, and then click to launch the '''Microsoft WebMatrix''' app.<br/>[[Image:MS-Web-Matrix-1_Launch-Web-Matrix.png|Launch Microsoft WebMatrix]]<br/>&nbsp;
  +
# On the WebMatrix start page, click the '''My Sites''' button to display the installed sites, and then click your '''wordpress''' site that displays in the pop-up context menu.<br/>[[Image:MS-Web-Matrix-2_Launch-My-Sites.png|Open your WordPress site]]<br/>&nbsp;
  +
# After the site opens, click the lower-left '''Site''' tab to display links for the WordPress launch URL and file Path.<br/>[[Image:MS-Web-Matrix-3_Select-Site-tab.png|Open the "Site" tab]]<br/>&nbsp;
  +
# Click on the site URL link to launch your '''localhost''' WordPress site.<br/>[[Image:MS-Web-Matrix-4_Launch-Site-URL.png|Launch the localhost WordPress site]]<br/>&nbsp;
  +
# At this point WebMatrix will open a browser window to your localhost WordPress site which you can customize and add content to.<br/>[[Image:MS-Web-Matrix-5_Browser-localhost.png|Browser window opens with your localhost WordPress site.]]
  +
  +
''Remember:'' WebMatrix must be left running while you interact with your localhost WordPress site.
   
 
==Additional Information==
 
==Additional Information==
Line 134: Line 135:
 
** http://windows.php.net/
 
** http://windows.php.net/
 
** http://forums.iis.net/1102.aspx
 
** http://forums.iis.net/1102.aspx
  +
* For information on media upload permission errors, or 500 errors when loading uploaded images, visit these sites:
  +
** https://www.bluevalleytech.com/techtalk/blog/iis-500-errors-when-loading-a-static-image-in-wordpress.aspx
  +
** http://www.amixa.com/blog/2011/04/29/iis-wordpress-images-500-error/
   
 
{{Copyedit}}
 
{{Copyedit}}

Latest revision as of 06:06, 20 November 2021

Install Internet Information Services 8.5 and WordPress 3.x by Using the Microsoft Web Platform Installer 5.0

NOTE: As of 12.02.2020. Microsoft WPI (5.1) does not install PHP support correctly on Windows 10, thus the WordPress installation fails.

This article describes how to install and configure WordPress 3.x on Windows clients and servers (see Prerequisites) using the Microsoft Web Platform Installer (Web PI) version 5.0. As of May 28, 2014, the latest version of WordPress is 3.9.1.

The Web PI is a free tool that makes getting the latest components of the Microsoft Web Platform—including Internet Information Services (IIS), MySQL, PHP, the Microsoft .NET Framework, and Visual Web Developer—quick and easy. The Web PI also lets you install web applications such as WordPress with the built-in Windows Web App Gallery.

To install WordPress on IIS 8.5 by using the Web PI 5.0, follow these steps:

Prerequisites

Step 1. Install Microsoft Web Platform Installer 5.0

Step 2. Select the products and applications to install

Step 3. Review and configure the selected products and applications

Step 4. Complete the installation and configuration

Step 5. Enable clean URLs (Pretty Permalinks)

Step 6. Running Microsoft WebMatrix with WordPress

Prerequisites

The supported operating systems for the Microsoft Web Platform Installer (Web PI) 5.0 are Windows 8.1, Windows 8, Windows 7, Windows Vista Service Pack 1 (SP1), Windows Vista, Windows XP Service Pack 2 (SP2), and later versions, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, and Windows Server 2003 Service Pack 1 (SP1) and later versions.

For this guide, it is assumed that you have either Windows Server 2012 R2 or Windows 8.1 Pro client installed on your computer. You will also need an Internet connection and administrator privileges for your computer.

It is a good idea to confirm that your system meets the hardware requirements for IIS 8.5. See http://technet.microsoft.com/en-us/library/dn303418.aspx for more information.

Step 1. Install Microsoft Web Platform Installer 5.0

In this step, you download, install, and launch the MS Web Platform Installer (Web PI 5.0, which is a 1.4 MB download).

  1. Log into your Windows machine as a user with administrative privileges.
  2. Launch Internet Explorer (other browsers work too).
  3. Go to http://www.microsoft.com/web/downloads/platform.aspx, and then click the Free Download button.
    Microsoft Web Platform Installer 5.0 webpage
  4. Click Run.
    File download security warning
  5. Click Run again.
    Internet Explorer security warning
  6. Wait a few seconds for the Web PI 5.0 to start.

Step 2. Select the products and applications to install

In this step, you select the version of WordPress that you want to install. WordPress 3.9.1 is used in this guide.

  1. On the "Web Platform Installer" start screen click the Applications tab, and then click the Add button associated to the right with "WordPress".
    List of apps on WebPI
  2. Click Install.
    Select WordPress on WebPI

Step 3. Review and configure the selected products and applications

In this step, you review and configure what you have added. Additionally, you add the database and configure the password for it.

  1. When you are asked which type of database you want to use, leave MySQL (Not installed) selected.
    Note: This will install MySQL 5.1 for Windows to handle all the database transactions that are required by WordPress.
  2. In password fields, type in a password for your database, and then click Continue.
    Database engine configuration
  3. Review the files to be downloaded and installed, as well as the license agreements, and then click I Accept.
    Application installation summary
  4. Allow the Web PI installation to complete.
    WordPress Installation process
  5. Configure Security Keys.
    The WordPress Security Keys section describes what these keys are and how they're used.
    Configure Security Keys
    The keys don't need to be remembered, they should just be long, random, and complicated. An easy way to generate the keys is to use the online key generator. Each time you click browser refresh, the online key generator creates a new set of keys.

    Note: The online key generator produces keys that may contain dollar signs ('$') which cannot be used with keys entered into Web-PI. Until this Web-PI issue is resolved, a simple solution is to check for dollar sign characters and simply replace '$' with 'S' (any alpha character will work).

    Here's an example set of keys - don't use these, use the online key generator to create your own unique keys!
    Example Security Keys
  6. Finish.
    On the FINISH dialog click the copy to clipboard link (this copies your database settings and password to the clipboard), paste and save this information in a file for future reference, and then click the Finish button.
    Installation completed
  7. Microsoft WebMatrix will open, allowing you to configure additional settings related to your WordPress site:WebMatrix summary screen

Step 4. Complete the installation and configuration

In this step, you complete the installation.

  1. Switch to Internet Explorer.
  2. Go to your WordPress website. For example, go to http://localhost/myWordPress.
  3. In the Site Title box, type the name of your site.
  4. In the Password, twice boxes, type a password for the admin account.
    WordPress site configuration
  5. In the Your E-mail box, type the email address for the admin account.
  6. Click Install WordPress.
    WordPress site configuration (continued)
  7. Click Log In.
    WordPress site configuration completed
  8. Type admin, type the password, and then click Log In.
    WordPress login

Step 5. Enable clean URLs (Pretty Permalinks)

In this step, you enable Pretty Permalinks now that WordPress has been installed.

  1. In the Dashboard menu, click Settings.
    WordPress dashboard menu
  2. Scroll down, and then click Permalinks.
    Settings
  3. Under Common settings, select a common Permalink setting or select Custom Structure to create your own Permalink, and then click Save Changes.
    Permalink settings

The installation is now complete, and you are ready to use WordPress!

Step 6. Running Microsoft WebMatrix with WordPress

The Microsoft Web Platform Installer (Web PI) installs WordPress to run in a localhost configuration in combination with Microsoft WebMatrix (which was also installed as part of the Web PI installation). When WebMatrix is not running (e.g., after a reboot or if you terminate WebMatrix) you will not be able to access your localhost WordPress site until WebMatrix is restarted. Use the following steps to start WebMatrix and launch your localhost WordPress site.

  1. Click Start, click All Programs, click-open the Microsoft WebMatrix folder, and then click to launch the Microsoft WebMatrix app.
    Launch Microsoft WebMatrix
     
  2. On the WebMatrix start page, click the My Sites button to display the installed sites, and then click your wordpress site that displays in the pop-up context menu.
    Open your WordPress site
     
  3. After the site opens, click the lower-left Site tab to display links for the WordPress launch URL and file Path.
    Open the "Site" tab
     
  4. Click on the site URL link to launch your localhost WordPress site.
    Launch the localhost WordPress site
     
  5. At this point WebMatrix will open a browser window to your localhost WordPress site which you can customize and add content to.
    Browser window opens with your localhost WordPress site.

Remember: WebMatrix must be left running while you interact with your localhost WordPress site.

Additional Information

This article is marked as in need of editing. You can help Codex by editing it.