Written by Douglas Robar     For umbraco versions: umbraco3.0

Install and setup
A step-by-step guide to install and configure everything you need to run umbraco 3.0.x on Windows XP Pro. (including IIS, MSXML, .NET Framework, AJAX, SQL Server 2005 Express, SQL Server Management Studios Express, and umbraco 3.0.x)

Contents

Configure SQL Server 2005 Express

There are many steps here, so take your time and be sure you perform each step. Various problems can occur if you don't have SQL Server configured properly.

Special thanks to Brian on the umbraco forum for his excellent outline of the steps to configure SQL Server 2005 Express for umbraco 2.1.x.

Trouble-shooting notes are shown at the end, if you have any problems.

SQL Server 2005 Configuration Manager
  1. Click Start, click All Programs, click Microsoft SQL Server 2005, click Configuration Tools, and click SQL Server Configuration Manager.
    image
  2. Expand the SQL Server 2005 Network Configuration folder, click on Protocols for MSSQLSEVER.
  3. Right-click on the TCP/IP protocol, and select Properties.
    image
  4. On the Protocol tab, select Yes for Enabled.
    image
  5. On the IP Addresses tab, select Yes for both Active and Enabled for all IP Address entries.
    image
  6. Click OK.
  7. Click OK.
  8. Select the SQL Server 2005 Services folder
  9. Right-click SQL Server (MSSQLSERVER), and click Restart.
    image
  10. Exit SQL Server Configuration Manager.

SQL Server 2005 Surface Area Configuration

  1. Click Start, click All Programs, click Microsoft SQL Server 2005, click Configuration Tools, and click SQL Server Surface Area.
    image
  2. Click Surface Area Configuration for Services and Connections.
    image
  3. Expand the MSSQLSERVER folder, expand the Database Engine folder, and click on Remote Connections.
    image
  4. Select the radio button next to "Local and remote connections".
  5. Select the radio button next to "Using TCP/IP only".
  6. Click OK.
  7. Exit SQL Server 2005 Surface Area Configuration.
  8. Restart SQL Server using the SQL Server Configuration Manager, as shown above.
  9. Exit SQL Server Configuration Manager.

SQL Server Management Studio Express

  1. Click Start, click All Programs, click Microsoft SQL Server 2005, and click SQL Server Management Studio Express.
    image
  2. Select SQL Server Authentication, enter sa for the login, and type the password you specified when you installed SQL Server 2005 Express, above.
    image
  3. Click Connect.
  4. Right-click on the Databases folder, and select New Database.
    image
  5. Enter a Database name.
    (we'll use 'umbracoCMS' in these instructions)
  6. Leave the Owner as <default>.
    image
  7. Click OK.
  8. Expand the Security folder.
  9. Right-click on the Logins folder, and select New Login.
    image
  10. Select the General page:
    1. Enter a Login name.
      (we'll use 'umbracoUser' in these instructions)
    2. Select the radio button next to "SQL Server authentication", and enter and confirm a Password.
    3. Remove the check mark in the box next to "Enforce password policy".
      (note: this is optional and should not be done in a production environment)
      image
  11. Select the User Mapping page:
    1. Place a check mark in the box next to the Database you created.
      ('umbracoCMS' in these instructions)
    2. Place a check mark in the boxes next to the following Database role memberships:
          db_datareader
          db_datawriter
          db_owner
          public
      image
  12. Click OK.
  13. Right-click on the root server folder (the parent of Databases, Security, etc.), and select Properties.
    image
  14. Select the radio button next to "SQL Server and Windows Authentication mode".
    image
  15. Click OK.
  16. Right-click on the root server folder (the parent of Databases, Security, etc.), and select Restart.
    image
  17. Click Yes.

Test the configuration by disconnecting and logging in as the user you just created.

  1. Click File, click Disconnect Object Explorer.
  2. Click File, click Connect Object Explorer.
  3. Select SQL Server Authentication, enter the name of the login user you create ('umbracoUser' in these instructions), and type the password you specified when you created the login user, above..
    image
  4. Click Connect.

If you cannot log in with SQL Server authentication…

  • Check the log files after a failed attempt.
  • The default log location is C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\LOG\ERRORLOG and can be opened with Notepad.
  • Look for an entry in the ERRORLOG such as:
    2007-05-16 16:43:42.75 Logon Error: 18456, Severity: 14, State: 8.
  • "State: 8" indicates a problem with the user password.
  • You can find a list of the meaning of each state message at
    http://blogs.msdn.com/sql_protocols/archive/2006/02/21/536201.aspx