Amazon EC2: Microsoft Web Platform Images - Wordpress

by Thomas Deml

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 on Amazon's 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:

  1. Sign up for Amazon EC2
  2. Start an "Microsoft Web Platform - Wordpress " instance via the Amazon Web Services Management Console.
  3. Retrieve the Administrator password and connect to the instance via RDP.
  4. Finalize the Wordpress installation.
  5. Enter blog posts and browse to your blog.

1. Amazon EC2 Sign-up

Signing up for Amazon EC2 is a straightforward process. All you need is

  • a valid e-mail address,
  • a valid phone number you can be reached at (make sure the phone is nearby, you will be called during sign-up!),
  • and a valid credit card number

The sign-up URL is here. It's even easier if you are already an Amazon customer because you can use your existing credit card information and e-mail address.

Note: Billing data verification usually happens within minutes. It might take a couple of hours though. Currently (April 2010) the error message you get is not very meaningful:
"It looks like you don't have an EC2 account*. To use the Amazon EC2 Console you must first sign up for Amazon EC2. It's quick & free to sign up."
Just be patient and wait for a little longer.

2. Starting an "Microsoft Web Platform – Wordpress" Instance

Once you are signed up successfully you will have access to the Amazon EC2 Management Console. The URL is here.

Screenshot of the Amazon E C 2 tab with the U S West option being highlighted.

Once you are logged in make sure you switch your region to "US West". The Microsoft Web Platform images are currently only available in the US West region. Before we do anything lets set up the firewall rules (called Security Groups in Amazon lingo) for your Wordpress instance.

Firewall Rules

Select the item "Security Groups" on the left hand side. Your existing Security Groups will show in the center pane. Click the "Create Security Group" button on top.

Screenshot of the Security Groups section, showing the Create Security Group option.

Name the new group you are about to create, for example "Microsoft Web Platform Firewall Rules".

Screenshot of the Create Security Group dialog with Microsoft Web Platform Firewall Rules entered into the Security Group Name field.

You want to configure the following rules:

Screenshot of the Security Group selected section showing a table to configure rules for allowed connections.

  • RDP is needed so you can connect via Remote Desktop to your Amazon EC2 instance. The current "Source (IP or group)" settings allows these connections from any IP address. Please lock down this settings if you have more stringent security requirements.
  • HTTP is needed so your customers can connect via HTTP your Amazon EC2 instance.
  • HTTPS is needed if you plan to use SSL. You don't need this setting if you do not plan to use SSL.
  • Port 8172 is opened to allow remote administration of IIS and publishing of content via Visual Studio 2010. You don't have to open port 8172 if you do not plan to use remote administration or remote content publishing.

Now we are ready to launch an EC2 DotNetNuke instance.

Launching an DotNetNuke Instance

Click the "Instances" menu item on the left hand side and click the "Launch Instance" button.
Screenshot of the Launch Instance option.

Now select "Community Images" in the resulting dialog.

Screenshot of the Quick Start, My A M I's, and Community A M I's tabs.

By typing "microsoft/" in the "Community AMIs" dialog you will reduce the selection to the four Microsoft images:
Screenshot of the Request Instances Wizard showing the Community A M Is tab.

Press "Select" in the "Microsoft Web Platform – Wordpress …" row.

In the next dialog page (Instance Details) you can select how much computing power you want to have for your Wordpress instance. It's probably prudent to start with type small. Click the "Continue" button. Nothing to worry about on the next page either. Just click "Continue" at the bottom of the "Advanced Instance Options" dialog. Now we are getting to the "Create Key Pair" dialog.
Screenshot of the Create a new Key Pair dialog.

If you already have a key, simply use it. If not you have to create one by entering a name for your key pair and clicking the "Create & Download Key Pair" button. As soon as you click the button a key pair will be created by Amazon an you are asked by your browser to download it. Save the file in a location where you will find it later. The key pair you created will allow you to decrypt the Administrator password that Amazon creates for your Wordpress instance. Click the "Continue" button.

Note: Internet Explorer might not show the download dialog that asks you where to save the key pair file. If that happens to you, please look for the file (<key pair name>.pem) in Internet Explorers Temporary Files folder. On Windows 7 search for *.pem in %userprofile%\ AppData\Local\Microsoft\Windows\Temporary Internet Files. Make sure you copy the .pem file to a more permanent directory .

Once you created your key pair you can configure firewall rules. You could for example only allow HTTP requests to the machine. Amazon calls firewall rules "Security Groups" which is a bit confusing if you ask me. For this demo we are picking the "default" Security Group which doesn't put any firewall restrictions on the instance. You might want to configure these settings to be a bit more restrictive later on.
Click "Continue" to move to the "Launch" page. The only thing left to do on the summary page is to press the big "Launch" button. Once you do that Amazon EC2 will spin up your personal virtual instance of our Wordpress image. Good job. It's time to get some coffee. Spinning up your instance will take some time, usually around 3 to 5 minutes.

3. Retrieving the Administrator Password

After finishing the "Launch Instance" wizard you should be back on the main page of the AWS Management Console. Click the "Instances" link to figure out how your Wordpress instance is doing.

Screenshot of the A W S Management Console with the Instances link being highlighted.

You should see something like this:

Screenshot of the My Instances wizard showing the Instance Management and Instance Lifecycle panes.

Right click on the row and select the "Get Windows Password" menu item.

Screenshot of the right-click dropdown menu, showing the Get Windows Password option.

Now it's time to use the key pair file (<your key pair name>.PEM) that you created before. If the password is already available (you might have to wait a couple of minutes as said before) you will see the following dialog:

Screenshot of the Encrypted Password, Key Pair, and Private Key fields.

Open the .PEM file in notepad and copy it to the clipboard (Ctrl+A selects all, Ctrl+C copies it into the clipboard). Now paste the contents into the textbox of the dialog (Ctrl+V). Click the "Decrypt" button.

Note: Because decryption is a very CPU intensive operation you might run into the following security dialog if you use Internet Explorer:

Screenshot of a security dialog asking the user to stop running this script.

Contrary to intuition you have to press "No" to go on. You probably have to hit "No" a couple of times to get your password decrypted. More details on this security feature can be found here.
If you are interested in a more permanent fix you can execute the following command on command-line:

reg add "HKCU\Software\Microsoft\Internet Explorer\Styles" /v MaxScriptStatements /t REG_DWORD /d 0x5F5E100

By setting the MaxScriptStatements to 100,000,000 (0x5F5E100) I don't see any security popups anymore.

Once the password is decrypted write it down or copy it to the clipboard and close the dialog. Finally we are ready to connect to the Wordpress instance. Right click the instance and select "Connect".

Screenshot of the right-click dropdown menu showing the Connect option in the Instance Management section.

Click "Download shortcut file" in the dialog that follows:

Screenshot of the Console Connect Remote Desktop Connection dialog with a focus on the Download shortcut file option.

The file to be downloaded is an .RDP file that has all the right settings to connect you to the EC2 instance in the cloud. Click "Open" if you use IE or double click the file in Firefox's Download window and a Remote Desktop session is established. When Remote Desktop asks you for credentials you simply enter the username "Administrator" and the password that we retrieved previously.
Once connected you will get logged on to the remote machine. Don't get to impatient because after the logon it will take a few moments until the Wordpress install kicks in.

4. Finalization of the Wordpress Installation

The initial logon will automatically launch the Wordpress installation via the Web Platform Installer. You should see the following dialog:

Screenshot of the Install WordPress dialog.

Just click "Install" and you will be asked if it is ok to download the latest Wordpress and MySQL bits. Most likely a local copy will be used for the install. Only if newer bits are available Web Platform Installer will go out and download new binaries. This should only take seconds given Amazon's bandwidth.

Next you get asked for your MySQL password. Pick a good one!

After the MySQL install Web Platform Installer asks you some additional questions with regards to your Wordpress installation.

Step 1 of 2 in Web Platform Installer

Screenshot of the Web Platform Installation dialog with a focus on the WordPress application name field.

You can leave everything as it is. Only one change you might want to consider:
If you want to install wordpress as the root of your site you might want to remove the string "wordpress" in the "Application name" textbox. If you don't do that you have to always enter http://%3cname-of-your-site/wordpress. Leaving the field empty will put the wordpress files into the root of the Default Web Site, i.e. you can enter http://%3cname-of-your-website/ to get to your Wordpress blog. If you install Wordpress in the root you will get a popup that warns you about overwriting content. That's ok though. It only overwrites IIS's default home page.

Screenshot of the Overwrite dialog with a focus on the Yes option.
Click "Yes" and then "Continue".

Now the last few settings - Step 2 of 2

To make the Wordpress install successful you need to configure Wordpress's MySQL connection and the credentials you want to use to administer Wordpress. Enter the MySQL password you picked previously as the Database Administrator Password. These credentials will be used to create the wordpress database within MySQL.

Screenshot of the Web Platform Installation dialog with a focus on the Database Administrator Password field.

Then pick some new credentials for the user account that Wordpress itself uses to connect to the Wordpress database in MySQL:

Screenshot of the Web Platform Installation dialog with a focus on the Database Password section.

Everything else can be left in place without impacting the installation.
Once the install finishes you can get started with Wordpress. Click the "Launch Wordpress" link on the final Web Platform Installer page:

Screenshot of the Web Platform Installation dialog's confirmation screen, showing the Launch WordPress option.

Now you are ready to go and you can customize Wordpress to your liking.

One last tip: You can get to your blog from outside the Remote Desktop session. Your instance has a public DNS address you can use.

Screenshot of the Public D N S field in the A W S Management Console and the Description tab.

Copy the public DNS name shown in the AWS Management Console to the clipboard and enter it into the browser. If you need a more permanent DNS address you have to register a DNS name and also get an Elastic IP address from Amazon. But this is a story for another day.

Summary

It's amazing how easy it now is to get a dedicated Web server on the internet and get started. With the help of Amazon EC2, the Microsoft Web Platform Installer and Wordpress we just deployed a working and fully configured blog application to the cloud. Let us know what you think about this:Questions or feedback? Send it to ec2@microsoft.com.